Cómo integrar Magento con Odoo: inventario, pedidos, precios y facturación

• Odoo 19 trae una API nueva, JSON-2, con llaves de API; XML-RPC y JSON-RPC están programados para retirarse en Odoo 22 (otoño de 2028) y en Odoo Online 21.1 (invierno de 2027).
• En Odoo Online, el acceso a la API externa solo está disponible en el plan Custom, no en One App Free ni en Standard.
• Lo típico: inventario y precios de Odoo a Magento; pedidos y clientes de Magento a Odoo; factura (CFDI) desde Odoo.
• Un conector sirve si tu operación es estándar. Si tienes varias empresas, precios por cliente o reglas propias, conviene una integración a la medida.

¿Cómo se conecta Magento con Odoo?

Con un intermediario que lee y escribe en las dos APIs. Del lado de Magento está su API REST; del lado de Odoo, su API externa. En medio vive el conector o la integración, que traduce los datos, decide cuándo moverlos y qué hacer cuando algo falla.

Hay tres formas de armarlo:

• Módulo conector: un módulo instalado en Magento, en Odoo o en ambos, que trae la sincronización básica ya resuelta.
• Integración a la medida: un servicio propio que conecta las dos APIs con las reglas exactas de tu operación.
• Plataforma intermedia: una herramienta de integración que orquesta los flujos entre los dos sistemas.

Antes de escoger una, hay una decisión más importante: quién es la fuente de verdad de cada dato. Si eso no está claro, cualquier conector va a terminar sobrescribiendo precios o duplicando clientes.

¿Conviene un conector Odoo–Magento o una integración a la medida?

Depende de qué tan estándar sea tu operación. Un conector funciona bien cuando tienes una sola empresa, un solo almacén o pocos, precios generales y un flujo de pedido sin excepciones.

Se queda corto cuando aparecen cosas como estas:

• Varias empresas o razones sociales en Odoo vendiendo desde una sola tienda.
• Precios por cliente, por volumen o límites de crédito para clientes B2B.
• Reglas de inventario propias: apartados, kits, productos que se surten de otro almacén.
• Personalizaciones en Odoo que el conector no conoce.

En esos casos, forzar un conector genérico sale más caro que hacer la integración correcta, porque terminas parchando el conector y peleando con cada actualización.

Lo vimos con Águila Azteca, mayorista y minorista de llantas con unos 50,000 SKUs. Su ERP era Zoho, no Odoo, pero el problema era el mismo: operación B2B y B2C con varias empresas. El módulo que necesitaban no existía, así que construimos la integración bidireccional con Zoho multiempresa. Con Odoo aplicamos el mismo criterio: primero el proceso, después la herramienta.

¿Qué API de Odoo se usa: XML-RPC, JSON-RPC o JSON-2?

Para un proyecto nuevo sobre Odoo 19, JSON-2. Según la documentación oficial de Odoo, la API JSON-2 es nueva en la versión 19 y las APIs XML-RPC y JSON-RPC están programadas para retirarse en Odoo 22 (otoño de 2028) y en Odoo Online 21.1 (invierno de 2027).

Lo que conviene saber de la API de Odoo antes de integrar:

• Autenticación con llave de API: JSON-2 usa una llave tipo bearer en lugar de usuario y contraseña. Odoo no permite crear llaves de más de tres meses, así que la integración tiene que contemplar su rotación.
• Usuario dedicado: Odoo recomienda un usuario bot con los permisos mínimos para cada integración. Así sabes qué hizo la integración y limitas el daño si una llave se filtra.
• Una transacción por llamada: cada llamada a JSON-2 corre en su propia transacción. Para operaciones encadenadas, como confirmar un pedido y reservar inventario, hay que usar un método que haga todo junto o crear uno en un módulo propio.
• Plan de Odoo: en Odoo Online, la API externa solo está disponible en el plan Custom. Revísalo antes de presupuestar la integración.

Si tu Odoo está en una versión anterior a la 19, la integración se hace con XML-RPC o JSON-RPC, pero planéala para migrar a JSON-2 antes de que esas APIs se retiren.

¿Cómo sincronizar el inventario de Odoo con Magento?

Con actualizaciones frecuentes de las existencias que cambiaron, no con cargas completas del catálogo cada vez. El inventario es el dato que más daño hace cuando falla: vendes lo que no tienes o dejas de vender lo que sí tienes.

• Por almacén: si en Odoo tienes varios almacenes, cada uno se mapea a una fuente de inventario en Magento.
• Solo lo disponible: a Magento se manda lo que de verdad se puede vender, ya descontado lo apartado o comprometido.
• Frecuencia según tu rotación: una tienda con poco movimiento aguanta sincronizaciones espaciadas; una con promociones fuertes necesita algo casi en tiempo real.
• Pedido como reserva: cuando entra un pedido en Magento, Odoo debe recibirlo rápido para apartar las piezas.

¿Cómo pasan los pedidos y los clientes de Magento a Odoo?

Como órdenes de venta en Odoo, ligadas a un cliente. El punto delicado es no duplicar clientes: hay que decidir con qué dato se identifica a cada uno (correo, RFC o un ID propio) y respetarlo siempre.

Al mapear el pedido revisa que viajen bien los impuestos, los descuentos, el costo de envío, la forma de pago y los datos fiscales cuando el cliente pide factura. Y define qué pasa con las cancelaciones y devoluciones, porque es donde más integraciones se desordenan.

¿Cómo se sincronizan los precios de Odoo en Magento?

Odoo es la fuente y Magento solo publica. Las listas de precios de Odoo se traducen a precios de Magento: precio general, precios por grupo de cliente y precios por volumen si vendes mayoreo.

Las promociones de la tienda (cupones, reglas de carrito) suelen quedarse en Magento, porque son parte de la experiencia de compra. Lo importante es que el precio que llega a Odoo con el pedido sea el que el cliente pagó, para que la factura cuadre.

¿Y la facturación electrónica (CFDI)?

Se resuelve en Odoo. Según su documentación, la localización mexicana de Odoo genera CFDI 4.0, complementos de pago y factura global, y tiene un portal de autofacturación.

El flujo práctico: el pedido entra a Odoo desde Magento, se factura y timbra en Odoo, y la factura se comparte con el cliente desde su cuenta o por correo. Así no tienes dos sistemas emitiendo facturas ni dos consecutivos que conciliar. Si un cliente no pide factura, la venta puede entrar a la factura global.

Lo que hemos visto integrando Magento con ERPs

Desde 2011 hemos hecho unos 300 proyectos de ecommerce y hemos integrado Magento con SAP, NetSuite, Zoho, Dynamics, Odoo y desarrollos internos. Las funciones B2B que más nos piden son precios variables por volumen, límites de crédito y facturación con CFDI.

Lo que más se repite: el reto casi nunca es Magento, es el ERP. Los consultores de ERP tienden a adaptar el sistema a los procesos del cliente aunque sean malos, y esas personalizaciones son las que complican la integración. Por eso cada proyecto empieza con una auditoría y un mapa de qué dato vive dónde.

Los peores casos son los sistemas internos sin documentación de API. Odoo, en cambio, documenta bien su API, y eso ayuda.

¿Cuándo NO conviene integrar Magento con Odoo?

No conviene si vendes pocos productos y pocos pedidos al día: capturar a mano puede salir más barato que mantener una integración. Tampoco tiene sentido si tu catálogo tiene menos de unos 10 productos.

Y no conviene integrar un Odoo que todavía no está bien implementado. Si los inventarios o las listas de precios no cuadran en Odoo, la integración solo va a llevar ese desorden a tu tienda. Primero se ordena el ERP, después se conecta.

Hacemos este tipo de proyectos en integraciones de Magento y, si tu tienda corre con Hyvä, en integraciones de Hyvä Commerce. Si todavía estás evaluando Odoo, lee Odoo ERP open source para PYMES y nuestro manual para integrar Magento con ERP, CRM e inventarios. Para mantener la integración viva después, revisa cómo asegurar que tus sistemas sigan conectados.

Si quieres saber si tu caso se resuelve con un conector o necesita una integración a la medida, agenda un diagnóstico de integración gratis de 30 minutos.

Preguntas frecuentes

¿Existe un conector para integrar Odoo con Magento?

Sí, hay módulos conectores en el mercado. Funcionan bien para operaciones estándar; si tienes varias empresas, precios por cliente o personalizaciones en Odoo, revisa si cubren tu caso antes de comprarlos.

¿Necesito un plan especial de Odoo para integrarlo con Magento?

En Odoo Online, sí: según Odoo, el acceso a la API externa solo está disponible en el plan Custom, no en One App Free ni en Standard. Si tienes Odoo instalado en tu propio servidor, revisa la configuración con tu implementador.

¿Qué API de Odoo debo usar?

En Odoo 19, la API JSON-2. XML-RPC y JSON-RPC siguen funcionando, pero están programadas para retirarse en Odoo 22 (otoño de 2028) y en Odoo Online 21.1 (invierno de 2027).

¿Quién emite la factura: Magento u Odoo?

Lo recomendable es Odoo. Su localización mexicana genera CFDI 4.0, complementos de pago y factura global, así que el pedido entra desde Magento y se factura en Odoo.

¿Cada cuánto se sincroniza el inventario?

Depende de tu rotación. Una tienda con poco movimiento aguanta sincronizaciones espaciadas; una con promociones fuertes necesita actualizaciones casi en tiempo real de lo que cambió.

¿La integración funciona si mi tienda usa Hyvä?

Sí. La integración trabaja con los datos de Magento, no con el frontend, así que Hyvä no la limita.

Fuentes

• Odoo 19: API externa JSON-2 y retiro de XML-RPC / JSON-RPC
• Odoo 19: localización fiscal de México (CFDI 4.0)
• Adobe Commerce: API REST

Transparencia: Panamerik es partner de Cloudways (hosting) y de Hyvä. No obligamos a nadie a usarlos: trabajamos con el hosting y las herramientas que tú prefieras. Los datos de experiencia de este artículo son aproximados y vienen de nuestros proyectos desde 2011.