Integrar duanes amb els teus marketplaces des d'Odoo: declaració, valor per línia, IOSS i documents de l'enviament

Qui busca «integració API duanes per a marketplaces» sol imaginar un servei al qual Odoo envia la comanda i que li retorna el despatx fet. Això, tal qual, no existeix. Hi ha tres peces que cal encaixar: les dades de cada línia, que viuen a Odoo; el canal pel qual arriben a la duana, que és el transportista o el teu representant aduaner; i el règim fiscal, que decideix si hi ha exportació, IOSS o res.

Primer: el teu enviament passa per duana?

Entre països de la UE no hi ha duana. Una comanda d'Amazon Alemanya que surt del teu magatzem de Barcelona no porta declaració: porta l'IVA de destinació i el seu OSS, com s'explica a vendre a diversos Amazon amb un sol Odoo. La duana apareix quan la mercaderia surt de la UE (Regne Unit, Suïssa, Noruega, Andorra) i quan hi entra des de fora: estoc en un magatzem britànic o un proveïdor que envia directe des d'Àsia al teu client. Sense sortir d'Espanya, també amb Canàries, Ceuta i Melilla.

Què demana la declaració, línia a línia

La declaració ho demana per línia: partida aranzelària (el codi HS de sis dígits, que la UE allarga a vuit en l'exportació i a deu en la importació), descripció concreta, quantitat, pes net, valor amb la seva divisa i país d'origen. Per enviament: incoterm, número EORI de l'exportador i número de factura. A Odoo 19 el producte ja té partida i país d'origen; el error habitual és que ningú els omple o que no viatgen al transportista, com vam veure a els mòduls OCA de DHL i GLS. I «regal» o «accessoris» no són una descripció: són motiu de retenció.

I el valor de la línia no és el preu del marketplace. La comanda porta descomptes, ports cobrats al client i de vegades un cupó sobre el total. La duana vol el valor de cada línia, i ha de coincidir amb la factura: el descompte global es reparteix entre línies amb un criteri fix i els ports van a part, no amagats a l'última línia. Aquí és on fallen les integracions fetes de pressa.

No hi ha una «API de duanes»: hi ha dos camins

En paqueteria exprés o postal, el despatx el fa el transportista. La seva API accepta les dades de duana amb l'expedició, com a factura comercial electrònica, i ell presenta la declaració. Integrar és que Odoo enviï partida, origen i valor per línia en generar l'etiqueta.

En palets, B2B o imports alts, la declaració la presenta un representant aduaner davant l'AEAT. Fer-ho directament des del teu ERP és possible, però per a una pime gairebé mai compensa. Integrar és que Odoo li lliuri les dades en el format que accepti i recuperi l'MRN, el número de la declaració, per arxivar-lo amb l'albarà i la factura.

IOSS: només quan la mercaderia entra a la UE

Des del juliol de 2021 tot el que entra a la UE paga IVA. En vendes a consumidors de fins a 150 € (sense ports ni assegurança si van a part, i excepte alcohol, tabac i altres productes amb impostos especials), el venedor pot cobrar l'IVA de destinació en la venda i declarar-lo cada mes per l'IOSS. El número IOSS viatja en les dades electròniques de duana, no escrit a la caixa, i el client no paga res a la porta. Sense IOSS paga IVA i gestió en rebre, i qui no esperava pagar rebutja el paquet.

Amb marketplaces canvia qui és qui: la plataforma es considera el proveïdor a efectes d'IVA, cobra l'impost i fa servir el seu número IOSS, que et facilita per a l'enviament. El teu Odoo no ha de tornar a repercutir l'IVA a la factura i ha d'enviar al transportista l'IOSS del marketplace, no el teu. El Regne Unit va per lliure: fins a 135 lliures, l'IVA britànic es cobra en la venda, i si hi ha marketplace el cobra ell.

Quins documents acompanyen l'enviament

• Factura comercial, o proforma si no hi ha venda: partida, origen i valor per línia, incoterm i EORI.
• CN22 o CN23 si va per correu postal, segons el valor.
• Declaració d'exportació amb el seu MRN. Guarda-la: prova l'exempció d'IVA.
• Declaració d'origen a la factura si la destinació té acord comercial amb la UE, com el Regne Unit o Suïssa, i la mercaderia compleix les regles d'origen.
• En devolucions, la referència a l'exportació original. Sense ella, el que torna pot tractar-se com una importació nova.

Què tenim i què no

No tenim un connector de duanes publicat: cada transportista i cada representant demana les dades a la seva manera. Sí que estan publicats els connectors que porten les comandes a Odoo, com Amazon, Temu o AliExpress i la resta del catàleg, a Odoo 17, 18 i 19, i la majoria també a Odoo 20 (cada fitxa diu les seves versions). La capa de duanes és desenvolupament a mida, i el seu abast depèn de quantes destinacions i canals de despatx tinguis. I si treus de la UE uns pocs paquets al mes, no integris res: omple partida i origen, fes servir el formulari del transportista i guarda les factures.

Preguntes freqüents

Enllaços útils dins de FlexigoTech

El que fem sobre això