Quien busca «integración API aduanas para marketplaces» suele imaginar un servicio al que Odoo le manda el pedido y le devuelve el despacho hecho. Eso, tal cual, no existe. Hay tres piezas que encajar: los datos de cada línea, que viven en Odoo; el canal por el que llegan a la aduana, que es el transportista o tu representante aduanero; y el régimen fiscal, que decide si hay exportación, IOSS o nada.
Primero: ¿tu envío pasa por aduana?
Entre países de la UE no hay aduana. Un pedido de Amazon Alemania que sale de tu almacén de Barcelona no lleva declaración: lleva el IVA del destino y su OSS, como se cuenta en vender en varios Amazon con un solo Odoo. La aduana aparece cuando la mercancía sale de la UE (Reino Unido, Suiza, Noruega, Andorra) y cuando entra desde fuera: stock en un almacén británico o un proveedor que envía directo desde Asia a tu cliente. Sin salir de España, también con Canarias, Ceuta y Melilla.
Si todo lo que vendes sale de un almacén peninsular hacia países de la UE, este artículo no es tu problema. No integres aduanas «por si acaso»: revisa las posiciones fiscales y el OSS, que es donde de verdad se escapa el dinero.
Lo que pide la declaración, línea a línea
La declaración lo pide por línea: partida arancelaria (el código HS de seis dígitos, que la UE alarga a ocho en la exportación y a diez en la importación), descripción concreta, cantidad, peso neto, valor con su moneda y país de origen. Por envío: incoterm, número EORI del exportador y número de factura. En Odoo 19 el producto ya tiene partida y país de origen; el fallo habitual es que nadie los rellena o que no viajan al transportista, como vimos en los módulos OCA de DHL y GLS. Y «regalo» o «accesorios» no son una descripción: son motivo de retención.
Y el valor de la línea no es el precio del marketplace. El pedido trae descuentos, portes cobrados al cliente y a veces un cupón sobre el total. La aduana quiere el valor de cada línea, y tiene que coincidir con la factura: el descuento global se reparte entre líneas con un criterio fijo y los portes van aparte, no escondidos en la última línea. Aquí es donde fallan las integraciones hechas deprisa.
No hay una «API de aduanas»: hay dos caminos
En paquetería exprés o postal, el despacho lo hace el transportista. Su API acepta los datos de aduana con la expedición, como factura comercial electrónica, y él presenta la declaración. Integrar es que Odoo mande partida, origen y valor por línea al generar la etiqueta.
En palés, B2B o importes altos, la declaración la presenta un representante aduanero ante la AEAT. Hacerlo directamente desde tu ERP es posible, pero para una pyme casi nunca compensa. Integrar es que Odoo le entregue los datos en el formato que acepte y recupere el MRN, el número de la declaración, para archivarlo con el albarán y la factura.
IOSS: solo cuando la mercancía entra en la UE
Desde julio de 2021 todo lo que entra en la UE paga IVA. En ventas a consumidores de hasta 150 € (sin portes ni seguro si van aparte, y excepto alcohol, tabaco y otros productos con impuestos especiales), el vendedor puede cobrar el IVA del destino en la venta y declararlo cada mes por el IOSS. El número IOSS viaja en los datos electrónicos de aduana, no escrito en la caja, y el cliente no paga nada en la puerta. Sin IOSS paga IVA y gestión al recibir, y quien no esperaba pagar rechaza el paquete.
Con marketplaces cambia quién es quién: la plataforma se considera el proveedor a efectos de IVA, cobra el impuesto y usa su número IOSS, que te facilita para el envío. Tu Odoo no debe volver a repercutir el IVA en la factura y tiene que mandar al transportista el IOSS del marketplace, no el tuyo. Reino Unido va por libre: hasta 135 libras, el IVA británico se cobra en la venta, y si hay marketplace lo cobra él.
Qué documentos acompañan al envío
- Factura comercial, o proforma si no hay venta: partida, origen y valor por línea, incoterm y EORI.
- CN22 o CN23 si va por correo postal, según el valor.
- Declaración de exportación con su MRN. Guárdala: prueba la exención de IVA.
- Declaración de origen en la factura si el destino tiene acuerdo comercial con la UE, como Reino Unido o Suiza, y la mercancía cumple las reglas de origen.
- En devoluciones, la referencia a la exportación original. Sin ella, lo que vuelve puede tratarse como una importación nueva.
Qué tenemos y qué no
No tenemos un conector de aduanas publicado: cada transportista y cada representante pide los datos a su manera. Sí están publicados los conectores que traen los pedidos a Odoo, como Amazon, Temu o AliExpress y el resto del catálogo, en Odoo 17, 18 y 19, y en Odoo 20 el día que salga. La capa de aduanas es desarrollo a medida, y su alcance depende de cuántos destinos y canales de despacho tengas. Y si sacas de la UE unos pocos paquetes al mes, no integres nada: rellena partida y origen, usa el formulario del transportista y guarda las facturas.
Preguntas frecuentes
¿Necesito IOSS para vender en Amazon Francia desde España?
No. Entre países de la UE no hay importación, así que no hay IOSS. Lo que aplica es el IVA del país de destino, declarado por OSS.
¿Los envíos a Canarias pasan por aduana?
Sí. Canarias está dentro del territorio aduanero de la UE pero fuera del IVA, así que los envíos desde la Península llevan declaración y en destino se aplica el IGIC, no el IVA. Ceuta y Melilla quedan directamente fuera de la unión aduanera.
¿Quién decide la partida arancelaria, el marketplace o yo?
Tú, o quien declare en tu nombre. El marketplace puede pedírtela en la ficha, pero clasificar bien es responsabilidad de quien declara. Si dudas entre dos partidas, puedes pedir a la AEAT una información arancelaria vinculante (IAV) para tu producto.
Enlaces útiles dentro de FlexigoTech
Lo que hacemos sobre esto
¿Vendes fuera de la UE y la aduana se hace a mano?
Cuéntanos a qué países envías, con qué transportistas, si trabajas con representante aduanero y desde qué marketplaces entran los pedidos. Te decimos qué parte se resuelve con datos bien puestos en Odoo y cuál necesita integración. Escribe a comercial@flexigobe.com o agenda una llamada.