Guida Utente

Tutto ciò che ti serve per installare Odoo–Shopify Order Check e leggere il suo verdetto con sicurezza.

download Installazione

Prerequisiti

  • Browser: Google Chrome (o qualsiasi browser basato su Chromium) con le estensioni abilitate.
  • Odoo: Odoo 14–19+, su Odoo Online (*.odoo.com) o Odoo.sh, con un account utente a cui puoi accedere.
  • Shopify: Un negozio Shopify collegato a Odoo tramite un connettore supportato (attualmente Emipro).

Installazione dell'estensione

  1. Apri la scheda nel Chrome Web Store
    Vai alla pagina di Odoo–Shopify Order Check nel Chrome Web Store.
  2. Aggiungila a Chrome
    Clicca "Aggiungi a Chrome" e conferma il messaggio. L'estensione si installa in pochi secondi.
  3. Fissa l'icona (facoltativo)
    Fissa l'estensione alla barra degli strumenti così il popup delle impostazioni è sempre a un clic di distanza.
  4. Accedi a Odoo
    Apri la tua istanza Odoo nello stesso browser e accedi. È l'unico passaggio necessario prima di iniziare a confrontare gli ordini.
In sola lettura e sicura. L'estensione non scrive mai su Odoo o Shopify. Legge solo i dati degli ordini per costruire il confronto, quindi è sicura da usare in produzione.

rocket_launch Per Iniziare

Non c'è nulla da configurare. Una volta installata l'estensione e dopo aver effettuato l'accesso a Odoo, apri un ordine e il confronto appare automaticamente.

  1. Accedi a Odoo
    Apri la tua istanza Odoo e accedi come di consueto. L'estensione legge la tua sessione attiva per rilevare l'istanza e il database — nessuna chiave API, nessun URL da digitare.
  2. Apri un ordine
    Apri qualsiasi ordine di vendita in Odoo (o l'ordine corrispondente in Shopify). L'estensione lo rileva automaticamente e inserisce un pannello di confronto.
  3. Leggi il verdetto
    Il pannello mostra un verdetto globale di corrispondenza o discrepanza, e ti permette di espandere il riepilogo campo per campo su richiesta.
Zero configurazione. Non ci sono istanze da registrare, nessuna chiave API da incollare e nessuna pagina delle opzioni. L'istanza e il database provengono direttamente dalla tua sessione browser Odoo, cookie-first.
La rete rimane in background. Tutte le richieste di rete vengono eseguite nel service worker dell'estensione. Il token Admin di Shopify viene letto da Odoo tramite il connettore, mantenuto solo in memoria e non viene mai salvato né esposto alla pagina.

verified Leggere il Verdetto

La parte superiore del pannello ti fornisce un verdetto immediato e a colpo d'occhio per l'ordine:

  • Corrispondenza: Odoo e Shopify concordano sull'ordine. Non sono state trovate discrepanze tra i campi confrontati.
  • Discrepanza: Almeno un campo differisce tra i due sistemi. Il riepilogo elenca esattamente cosa e dove.
  • Impossibile confrontare: L'estensione non è riuscita a costruire un confronto — ad esempio, la sessione Odoo è scaduta o l'ordine non è ancora collegato a Shopify. Il pannello ti indica cosa fare.

Espandere i dettagli

Il verdetto è immediato; il riepilogo è su richiesta. Espandi il pannello per vedere ogni campo confrontato, il valore su ciascun lato e una sezione di contesto per tutto ciò che spiega una differenza senza essere un errore.

dashboard Il Riepilogo delle Discrepanze

Quando c'è una discrepanza, il riepilogo ti mostra campo per campo dove Odoo e Shopify non concordano:

  • Totali: Il totale dell'ordine, confrontato con l'importo netto fatturato di Odoo (vedi la sezione successiva per capire perché).
  • Imposte: Gli importi delle imposte su ciascun lato. Per gli ordini confrontati con il totale fatturato, la base imponibile e le imposte potrebbero essere contrassegnate come non confrontabili in questa versione.
  • Quantità: Quantità per riga. La quantità fatturata di Odoo è trattata come riferimento autorevole rispetto alla quantità corrente di Shopify.
  • Righe dell'ordine: Prodotti abbinati per SKU, con gli artefatti del connettore (come righe di sconto o regalo) esclusi in modo che non compaiano come differenze fantasma.
  • Indirizzi: Indirizzi di spedizione e fatturazione, confrontati per le loro parti significative (via, città, CAP) piuttosto che per un singolo nome visualizzato.
Gravità. Ogni discrepanza ha un peso, così una differenza di arrotondamento non viene letta allo stesso modo di una riga mancante o di un totale errato. Il verdetto riflette la differenza più significativa trovata.

swap_horiz Fatturato vs Corrente

Il verdetto economico confronta l'ordine corrente di Shopify con quanto è stato effettivamente fatturato in Odoo — non con l'ordine di vendita originale.

Perché l'importo netto fatturato?

Quando un ordine viene fatturato, il connettore blocca l'ordine di vendita. Confrontare quell'ordine bloccato con un ordine Shopify che nel frattempo è cambiato produce falsi positivi. Al contrario, l'estensione usa l'importo netto fatturato di Odoo — fatture cliente registrate meno rimborsi registrati — che è ciò che corrisponde genuinamente allo stato corrente di Shopify.

Come viene letto ciascun lato

  • Odoo: Totale netto fatturato (somma delle fatture cliente registrate meno i rimborsi registrati) e la quantità fatturata per riga come riferimento autorevole.
  • Shopify: Il totale dell'ordine corrente e la quantità corrente per riga — la fonte di verità live per ciò che il cliente ha effettivamente.
Non ancora fatturato? Se l'ordine non ha fatture registrate, l'estensione torna a confrontare gli importi ordinati e contrassegna il verdetto come provvisorio, così sai che una fattura lo confermerà in seguito.

history Rimborsi, Resi e Cancellazioni

Rimborsi, resi e modifiche all'ordine raramente significano che qualcosa è rotto — fanno parte della normale vita di un ordine. L'estensione li mostra come contesto, separati dall'elenco delle discrepanze in modo da non generare false discrepanze:

  • Rimborsi: L'importo originale, i rimborsi applicati e l'importo netto fatturato risultante sono mostrati insieme affinché la matematica sia trasparente.
  • Resi: Un reso in corso è mostrato come contesto sul lato evasione piuttosto che essere contato come discrepanza di quantità.
  • Modifiche all'ordine: Quando un ordine Shopify viene modificato, la cronologia (originale, rimborsi, modifiche) è mostrata in modo che una variazione legittima non sembri un errore.

Ordini cancellati

Quando un ordine viene cancellato, il pannello mostra un banner chiaro affinché tu capisca immediatamente perché i numeri sono come sono, invece di leggere la cancellazione come una discrepanza.

Contesto, non discrepanze. Tutto in questa sezione è informativo. Spiega le differenze; non contribuisce mai da solo al verdetto di corrispondenza o discrepanza.

business Partire da Shopify

Puoi aprire il confronto anche da un ordine Shopify — non solo da Odoo. Per farlo, l'estensione deve sapere a quale istanza Odoo appartiene il negozio, e apprende questa corrispondenza la prima volta che confronti l'ordine da Odoo.

Come funziona la corrispondenza appresa

  1. Accedi a Odoo e apri l'ordine lì una volta. L'estensione risolve il negozio e ricorda a quale istanza e database Odoo corrisponde.
  2. Da quel momento, aprire l'ordine corrispondente in Shopify funziona direttamente — l'estensione sa già dove cercare.
  3. La corrispondenza è memorizzata localmente nel tuo browser; non viene inviata da nessuna parte.
Negozio non ancora appreso? Se apri un ordine Shopify per un negozio che l'estensione non ha ancora visto da Odoo, ti chiede di aprire prima l'ordine in Odoo invece di fare ipotesi. Una volta appresa la corrispondenza, i confronti a partire da Shopify funzionano senza problemi.

settings Impostazioni

Una piccola home delle impostazioni ti consente di verificare il tuo stato di accesso, gestire la licenza e leggere alcune informazioni diagnostiche — senza lasciare la pagina in cui ti trovi.

Dove trovarla

  • Popup dell'icona dell'estensione: Clicca l'icona dell'estensione nella barra degli strumenti per aprire le impostazioni da qualsiasi scheda.
  • Ingranaggio nel pannello: Apri l'ingranaggio ⚙ nel pannello di confronto per vedere le stesse impostazioni in loco, proprio accanto all'ordine che stai visualizzando.

Cosa puoi fare

  • Visualizza il tuo stato di accesso: Controlla se sei nella prova gratuita o con una licenza attiva, e quanti giorni di prova rimangono.
  • Attiva una chiave di licenza: Incolla una chiave di licenza Polar per sbloccare l'estensione in qualsiasi momento — durante la prova o dopo la sua scadenza.
  • Acquista un piano: Vai direttamente al checkout per acquistare un piano Starter, Growth o Agency.
  • Gestisci il tuo abbonamento: Apri il portale clienti ospitato di Polar per modificare o cancellare il tuo abbonamento.

Diagnostica in sola lettura

Il pannello diagnostico è puramente informativo e mostra:

  • Giorni di prova rimanenti.
  • Il tuo piano e livello.
  • L'istanza Odoo rilevata.
  • La versione dell'estensione installata.

credit_card Abbonamento

La tua prova gratuita di 14 giorni

Ogni installazione inizia con una prova gratuita di 14 giorni che sblocca l'estensione completa. La prova viene tracciata localmente sul tuo dispositivo su base fiduciaria — nessuna registrazione e nessuna chiamata di rete per avviarla.

Piani

  • Starter: Copre 1 istanza Odoo e 1 negozio Shopify.
  • Growth: Copre 1 istanza Odoo e negozi Shopify illimitati.
  • Agency: Copre istanze Odoo e negozi Shopify illimitati.

Come acquistare

  1. Apri le impostazioni dal popup dell'icona dell'estensione o dall'ingranaggio ⚙ nel pannello.
  2. Scegli Acquista e seleziona il piano Starter, Growth o Agency.
  3. Completa il checkout. Riceverai una chiave di licenza per attivare l'estensione.

Attivazione della chiave di licenza

  1. Apri le impostazioni e trova il campo della chiave di licenza.
  2. Incolla la chiave ricevuta dopo il checkout.
  3. Attiva. L’estensione completa si sblocca subito per tutto il tuo team.
Abbonamento per tutta l’azienda. Un abbonamento copre tutta la tua azienda: la stessa chiave di licenza funziona in tutto il team, senza limite per utente. I piani differiscono solo per l’ambito: quante istanze Odoo e negozi Shopify coprono.

Gestire o cancellare il tuo abbonamento

Fatturazione, modifiche al piano e cancellazione vengono gestite nel portale clienti ospitato di Polar — l'estensione ti collega semplicemente lì.

  1. Apri le impostazioni dal popup o dall'ingranaggio nel pannello.
  2. Scegli Gestisci abbonamento per aprire il portale clienti di Polar.
  3. Aggiorna il tuo piano, i dati di pagamento o cancella da lì.

L'estensione non memorizza mai i tuoi dati di pagamento. Tutta la fatturazione vive nel portale di Polar.

help Risoluzione Problemi

Nessuna sessione Odoo rilevata

Se non hai effettuato l'accesso a Odoo, l'estensione non può rilevare la tua istanza e mostra un messaggio operativo "accedi a Odoo" invece di fare ipotesi.

  1. Apri la tua istanza Odoo nello stesso browser.
  2. Accedi come di consueto.
  3. Torna all'ordine — il pannello rileva automaticamente la tua sessione.

Ordine non collegato a Shopify

  • Non è un ordine Shopify: Se l'ordine non ha una controparte Shopify, non c'è nulla da confrontare e il pannello si ritira silenziosamente.
  • Apri prima da Odoo: Quando parti da un negozio Shopify che l'estensione non ha ancora visto, apri l'ordine in Odoo una volta in modo che possa apprendere la corrispondenza negozio-istanza.

Istanza non rilevata

  • Sessione scaduta: Se la tua sessione Odoo è scaduta, riesegui l'accesso e riapri l'ordine.
  • Hosting non supportato: Il rilevamento automatico punta a Odoo Online (*.odoo.com) e Odoo.sh in questa versione. Odoo su un dominio completamente personalizzato non è ancora supportato.

Il pannello non appare

  1. Ricarica la pagina: Aggiorna la scheda dell'ordine in modo che il content script venga rieseguito e rilevi nuovamente l'ordine.
  2. Verifica che l'estensione sia abilitata: Apri chrome://extensions e conferma che Odoo–Shopify Order Check sia attivo.
Ancora bloccato? La diagnostica nelle impostazioni mostra l'istanza Odoo rilevata e la versione dell'estensione — dettagli utili da includere quando contatti il supporto.

quiz Domande Frequenti

Generale

Cosa fa Odoo–Shopify Order Check?

Quando apri un ordine in Odoo o Shopify, l'estensione confronta entrambi i sistemi campo per campo — totali, imposte, quantità, righe dell'ordine e indirizzi — e mostra un verdetto globale di corrispondenza o discrepanza con un riepilogo di eventuali differenze.

Modifica qualcosa in Odoo o Shopify?

No. L'estensione è strettamente in sola lettura. Non crea, modifica o elimina dati in nessuno dei due sistemi — legge soltanto, quindi è sicura da usare in produzione.

Devo configurare qualcosa?

No. L'estensione rileva automaticamente la tua istanza e il database Odoo dalla tua sessione attiva. Non ci sono istanze da registrare, nessuna chiave API e nessuna pagina delle opzioni.

Abbonamento

C'è una prova gratuita?

Sì. Ogni installazione include una prova gratuita di 14 giorni con tutte le funzionalità. Dopo la prova sono disponibili i piani Starter, Growth e Agency — ciascuno copre tutto il tuo team ed è definito da quante istanze Odoo e negozi Shopify include.

Come faccio a cancellare?

Apri le impostazioni, scegli Gestisci abbonamento e cancella dal portale clienti ospitato di Polar. L'estensione ti collega soltanto lì; non memorizza mai i dati di pagamento.

Privacy e Sicurezza

Da dove proviene il token Shopify?

Viene letto da Odoo tramite il connettore e mantenuto solo in memoria all'interno del service worker dell'estensione. Non viene mai salvato su disco né esposto alla pagina che stai visualizzando.

I dati dei miei ordini lasciano il browser?

Non c'è nessun backend. L'estensione legge Odoo e Shopify direttamente dal tuo browser per costruire il confronto, e la corrispondenza negozio-istanza appresa viene memorizzata localmente sul tuo dispositivo.

support Ottenere Assistenza

Contatta il supporto

Se qualcosa non funziona o hai una domanda, contattaci e ti aiuteremo:

  • Email: odoointegrations.team@gmail.com
  • Includi la versione dell'estensione (mostrata nella diagnostica delle impostazioni).
  • Gli screenshot del pannello e dell'ordine rendono molto più rapido l'aiuto.