Integrare le dogane con i tuoi marketplace da Odoo: dichiarazione, valore per riga, IOSS e documenti di spedizione

Chi cerca «integrazione API dogane per marketplace» di solito immagina un servizio a cui Odoo invia l'ordine e che restituisce lo sdoganamento già fatto. Così com'è, non esiste. Ci sono tre pezzi da far combaciare: i dati di ogni riga, che vivono in Odoo; il canale con cui arrivano alla dogana, cioè il vettore o il tuo rappresentante doganale; e il regime fiscale, che decide se c'è esportazione, IOSS o niente.

Prima cosa: la tua spedizione passa in dogana?

Tra i paesi dell'UE non c'è dogana. Un ordine di Amazon Germania che parte dal tuo magazzino di Barcellona non porta dichiarazione: porta l'IVA della destinazione e il relativo OSS, come spieghiamo in vendere su più Amazon con un solo Odoo. La dogana compare quando la merce esce dall'UE (Regno Unito, Svizzera, Norvegia, Andorra) e quando entra da fuori: stock in un magazzino britannico o un fornitore che spedisce direttamente dall'Asia al tuo cliente. Anche senza uscire dalla Spagna, vale per le Canarie, Ceuta e Melilla.

Cosa richiede la dichiarazione, riga per riga

La dichiarazione lo richiede per riga: voce doganale (il codice HS di sei cifre, che l'UE allunga a otto nell'esportazione e a dieci nell'importazione), descrizione concreta, quantità, peso netto, valore con la sua valuta e paese di origine. Per spedizione: termine di resa, numero EORI dell'esportatore e numero di fattura. In Odoo 19 il prodotto ha già voce doganale e paese di origine; l'errore abituale è che nessuno li compila o che non arrivano al vettore, come abbiamo visto nei moduli OCA di DHL e GLS. E «regalo» o «accessori» non sono una descrizione: sono motivo di blocco.

E il valore della riga non è il prezzo del marketplace. L'ordine porta sconti, spese di spedizione addebitate al cliente e a volte un coupon sul totale. La dogana vuole il valore di ogni riga, e deve coincidere con la fattura: lo sconto globale si ripartisce tra le righe con un criterio fisso e le spese di spedizione vanno a parte, non nascoste nell'ultima riga. È qui che falliscono le integrazioni fatte in fretta.

Non esiste una «API doganale»: ci sono due strade

Nei corrieri espressi o postali, lo sdoganamento lo fa il vettore. La sua API accetta i dati doganali con la spedizione, come fattura commerciale elettronica, ed è lui a presentare la dichiarazione. Integrare significa che Odoo invia voce doganale, origine e valore per riga al momento di generare l'etichetta.

Per bancali, B2B o importi elevati, la dichiarazione la presenta un rappresentante doganale presso l'AEAT. Farlo direttamente dal tuo ERP è possibile, ma per una PMI quasi mai conviene. Integrare significa che Odoo gli consegna i dati nel formato accettato e recupera l'MRN, il numero della dichiarazione, per archiviarlo con l'ordine di consegna e la fattura.

IOSS: solo quando la merce entra nell'UE

Da luglio 2021 tutto ciò che entra nell'UE paga l'IVA. Nelle vendite a consumatori fino a 150 € (escluse spese di spedizione e assicurazione se indicate a parte, e salvo alcol, tabacco e altri prodotti soggetti ad accise), il venditore può riscuotere l'IVA della destinazione al momento della vendita e dichiararla ogni mese tramite lo IOSS. Il numero IOSS viaggia nei dati doganali elettronici, non scritto sulla scatola, e il cliente non paga nulla alla porta. Senza IOSS paga IVA e spese di gestione alla consegna, e chi non si aspettava di pagare rifiuta il pacco.

Con i marketplace cambiano i ruoli: la piattaforma è considerata il fornitore ai fini IVA, riscuote l'imposta e usa il suo numero IOSS, che ti fornisce per la spedizione. Il tuo Odoo non deve applicare di nuovo l'IVA in fattura e deve inviare al vettore lo IOSS del marketplace, non il tuo. Il Regno Unito fa da sé: fino a 135 sterline, l'IVA britannica si riscuote alla vendita, e se c'è un marketplace la riscuote lui.

Quali documenti accompagnano la spedizione

• Fattura commerciale, o proforma se non c'è vendita: voce doganale, origine e valore per riga, termine di resa ed EORI.
• CN22 o CN23 se viaggia per posta, a seconda del valore.
• Dichiarazione di esportazione con il suo MRN. Conservala: prova l'esenzione IVA.
• Dichiarazione di origine in fattura se la destinazione ha un accordo commerciale con l'UE, come Regno Unito o Svizzera, e la merce rispetta le regole di origine.
• Nei resi, il riferimento all'esportazione originale. Senza, ciò che rientra può essere trattato come una nuova importazione.

Cosa abbiamo e cosa no

Non abbiamo un connettore doganale pubblicato: ogni vettore e ogni rappresentante chiede i dati a modo suo. Sono pubblicati invece i connettori che portano gli ordini in Odoo, come Amazon, Temu o AliExpress e il resto del catalogo, su Odoo 17, 18 e 19, e la maggior parte anche su Odoo 20 (ogni scheda indica le sue versioni). Il livello doganale è sviluppo su misura, e il suo ambito dipende da quante destinazioni e canali di sdoganamento hai. E se spedisci fuori dall'UE pochi pacchi al mese, non integrare nulla: compila voce doganale e origine, usa il modulo del vettore e conserva le fatture.

Domande frequenti

Link utili dentro FlexigoTech

Cosa facciamo su questo