Importare gli ordini di Amazon in Odoo: cosa contiene ogni ordine e dove si rompe

«Gli ordini di Amazon entrano da soli in Odoo.» Entrano, sì. La domanda utile è un'altra: entrano con tutto ciò che serve per preparare, fatturare e far quadrare i conti? Perché a rompersi non è la connessione (quella si vede subito), ma la mappatura. Un ordine importato male non dà errore: dà un prelievo duplicato a ottobre e un'IVA che non quadra a gennaio.

Cosa contiene un ordine di Amazon e cosa non contiene ancora

L'intestazione contiene l'identificativo dell'ordine, la data di acquisto, lo stato, il canale (FBA o FBM), il marketplace in cui è stato venduto e la data limite di spedizione. Le righe arrivano a parte, con l'ASIN, il tuo SKU di venditore, la quantità, il prezzo, l'imposta e l'importo di spedizione separati, più gli sconti promozionali. E c'è un momento in cui un ordine esiste ma non ha ancora nulla di utile: finché il pagamento non è autorizzato, l'ordine risulta in sospeso, con righe senza prezzi né imposte e senza un indirizzo utilizzabile. Se la tua importazione lo crea in quell'istante, crea un ordine a metà che poi nessuno sa riparare.

L'identificativo comanda: senza, duplicati

Ogni ordine arriva con il suo identificativo di Amazon. Quel numero deve restare salvato nell'ordine di Odoo ed essere la prima cosa che si controlla prima di creare qualsiasi cosa. Se l'importazione crea prima e controlla dopo, qualsiasi nuovo tentativo (una caduta di rete a metà ciclo, un cron che si sovrappone al precedente, una sincronizzazione lanciata a mano mentre girava quella automatica) ti lascia due ordini identici e due prelievi. Salva anche l'identificativo di ogni riga: è ciò che permette di riconoscere una riga modificata senza cancellare e ricreare l'intero ordine.

Indirizzi: arrivano con restrizioni e vanno cancellati

I dati dell'acquirente non arrivano con la lettura normale dell'ordine. L'indirizzo di spedizione e il contatto si richiedono a parte, con un'autorizzazione specifica per i dati con restrizioni, e l'e-mail che ti danno è un alias di Amazon che smette di funzionare. Inoltre c'è l'obbligo di non conservarli: trascorso il termine previsto dalla politica di protezione dei dati di Amazon, i dati personali si cancellano e si conserva solo ciò che la normativa fiscale obbliga a conservare. In Odoo questo ha due conseguenze pratiche: creare un contatto permanente per ogni acquirente non sempre è una buona idea, e serve un meccanismo di eliminazione progettato apposta da qualcuno, non una dimenticanza.

Imposte: in molti casi non le riscuoti tu

In parecchi mercati è Amazon a trattenere e versare l'imposta sulla vendita, e le righe dell'ordine possono indicare chi ne è il responsabile. Se la tua importazione applica sempre la stessa imposta senza guardare quel dato, la contabilità esce sbagliata in entrambe le direzioni possibili: dichiarando di più o di meno. Quello che va predisposto prima del primo ordine è una Posizioni fiscali per paese di destinazione, un listino per valuta e una regola chiara per il caso in cui il responsabile è Amazon. Il dettaglio per paese è in vendere su più Amazon con un solo Odoo.

Annullamenti: leggere solo gli ordini nuovi non basta

Un ordine può essere annullato mentre era in sospeso, e allora non è mai diventato un ordine vero. E può essere annullato dopo essere entrato in Odoo e prima di uscire dal magazzino: se la sincronizzazione sa solo creare, l'annullamento non arriva e finisci per spedire merce che nessuno pagherà. L'importazione deve rileggere gli ordini già noti entro una finestra di tempo, ordinando per data di ultima modifica, non solo chiedere quelli nuovi. E se il prelievo è già convalidato, quello non è più annullare: è un reso, e si contabilizza come reso.

Cosa fa il nostro connettore

Il connettore Amazon per Odoo risolve l'acquisizione degli ordini in Odoo 17, 18, 19 e 20: non crea l'ordine di vendita finché Amazon lo tiene in sospeso, salva l'identificativo di Amazon con un vincolo univoco per account e riutilizza l'ordine di vendita già esistente invece di duplicarlo, conserva l'identificativo di ogni riga, richiede l'indirizzo di spedizione in una chiamata a parte e rilegge gli ordini per data di ultima modifica, in modo che i cambi di stato, annullamenti inclusi, si riflettano sull'ordine di vendita. Con le imposte non decide al posto tuo: per impostazione predefinita l'ordine entra senza imposte e, se attivi la fatturazione da Odoo, applica quelle del prodotto attraverso la Posizioni fiscali che configuri. Se quello che hai è un connettore che già non funziona, la diagnosi è in errori frequenti di SP-API con Odoo, e a volte la risposta giusta è sistemare quello che c'è, non comprarne un altro.

Domande frequenti

Link utili all'interno di FlexigoTech

Cosa facciamo in merito