API de Odoo: JSON-2, API keys y cómo integrarla

Qué es Odoo

Odoo es un software de gestión empresarial formado por aplicaciones que se instalan por separado y comparten la misma base de datos: ventas, inventario, contabilidad, CRM, sitio web, eCommerce, punto de venta y muchas más. Según su sitio, tiene 28 millones de usuarios y más de 21.000 partners.

Existe en dos ediciones:

Odoo Community: de código abierto. El código está publicado en GitHub, en el repositorio odoo/odoo.
Odoo Enterprise: con licencia. Según Odoo, Community es la base sobre la que se construye Enterprise, y se puede cambiar de una a otra.

Y en tres formas de alojamiento: Odoo Online (en los servidores de Odoo), Odoo.sh (la plataforma en la nube de Odoo) y on-premise (en tus propios servidores). Las tres cosas, edición, alojamiento y plan, influyen en lo que puedes hacer con la API.

Qué APIs tiene Odoo

Odoo expone sus modelos de datos por HTTP. Hoy conviven dos generaciones de API externa.

La API JSON-2

Es la API actual, nueva en la versión 19.0. Se llama enviando un POST con un JSON a /json/2/<modelo>/<método>. Por ejemplo, /json/2/res.partner/search_read busca contactos y devuelve los campos que pidas.

Lo que define la documentación:

Encabezado Authorization con bearer y una API key. Es obligatorio.
Content-Type: application/json.
X-Odoo-Database con el nombre de la base de datos, cuando un mismo servidor aloja varias.
En el cuerpo van los ids de los registros (si el método los necesita), un context opcional y los parámetros del método.
Si todo sale bien, responde 200 con el resultado en JSON. Si falla, responde 4xx o 5xx con un objeto de error que trae el nombre de la excepción y su mensaje.

En el código fuente, el endpoint está en el módulo rpc del repositorio público odoo/odoo, que se instala automáticamente. Es decir, también está en Community.

Cada base de datos publica en /doc sus modelos, campos y métodos, que dependen de los módulos instalados.

XML-RPC y JSON-RPC: en retiro

Las APIs antiguas, en los endpoints /xmlrpc, /xmlrpc/2 y /jsonrpc, están deprecadas desde la versión 19.0. La documentación oficial dice textualmente que están programadas para eliminarse en Odoo 22 (otoño de 2028) y en Odoo Online 21.1 (invierno de 2027). Las estaciones son las del hemisferio norte.

API	Endpoint	Estado	Se elimina en
JSON-2	`/json/2/<modelo>/<método>`	Vigente, desde Odoo 19.0	No aplica
XML-RPC	`/xmlrpc`, `/xmlrpc/2`	Deprecada desde 19.0	Odoo 22 y Odoo Online 21.1
JSON-RPC	`/jsonrpc`	Deprecada desde 19.0	Odoo 22 y Odoo Online 21.1

Fuente: documentación oficial de Odoo 19.0, External JSON-2 API y External RPC API, consultada el 8 de noviembre de 2026.

En Odoo Online el plazo real es la versión 21.1, antes que Odoo 22. Si tienes una integración con XML-RPC, conviene migrarla a JSON-2 ahora: la documentación trae una guía con la equivalencia de cada servicio antiguo.

Autenticación con API keys

La API JSON-2 no usa usuario y contraseña. Cada llamada lleva una API key asociada a un usuario de Odoo.

Se crea desde Preferencias ‣ Seguridad de la cuenta ‣ Nueva clave API. Pide una descripción y una duración. Lo que conviene saber:

Duración máxima de tres meses. Odoo no permite crear claves que duren más, así que una integración permanente tiene que rotar su clave al menos cada tres meses.
La clave tiene 160 bits y se muestra una sola vez. Si la pierdes, la borras y creas otra.
También se pueden generar y revocar claves por API (res.users.apikeys.generate y revoke).

La API respeta los permisos normales de Odoo: derechos de acceso, reglas de registro y acceso a campos del usuario dueño de la clave. Para una integración, Odoo recomienda crear un usuario bot dedicado, con los permisos mínimos y sin contraseña para que no pueda iniciar sesión por la interfaz.

Transacciones: un detalle que importa en stock

Cada llamada a JSON-2 corre en su propia transacción SQL. Si sale bien se confirma, y si falla se descarta. No se pueden encadenar varias llamadas en una misma transacción.

La documentación advierte que esto es delicado en reservas y pagos: entre una llamada y otra, otro proceso puede cambiar los datos. La recomendación es usar un solo método que haga todo, como search_read en vez de search y luego read, o action_confirm para confirmar un pedido.

Qué modelos importan para una tienda

En Odoo cada tipo de dato es un modelo con un nombre técnico. Para sincronizar una tienda o un marketplace, los principales son:

Dato	Modelo	Para qué sirve
Producto	`product.template`	La ficha general del producto
Variante	`product.product`	Cada variante vendible (talla, color), que es lo que normalmente se cruza con el SKU
Stock	`stock.quant`	Cantidades por producto y ubicación
Precios	`product.pricelist`	Listas de precios
Clientes	`res.partner`	Contactos, empresas y direcciones
Pedidos	`sale.order`	Cotizaciones y pedidos de venta

Fuente: código fuente de Odoo 19.0 en GitHub (odoo/odoo, módulos product, stock y sale), consultado el 8 de noviembre de 2026.

Si vendes productos con variantes, el stock y el SKU de cada una viven en product.product, no en product.template.

Qué planes permiten usar la API

La API existe en todas las ediciones, pero en las suscripciones de Odoo su uso externo depende del plan. La documentación de JSON-2 lo dice así: el acceso a datos por la API externa solo está disponible en el plan Custom. No está disponible en One App Free ni en Standard.

Plan	Dónde corre	API externa
One App Free	Odoo Online	No incluida
Standard	Odoo Online	No incluida
Custom	Odoo Online, Odoo.sh u on-premise	Incluida

Fuente: página de precios de Odoo y documentación de la API JSON-2, consultadas el 8 de noviembre de 2026.

La página de precios define “API externa” como software externo que llama a Odoo para consultar o actualizar datos. Cuando es Odoo el que llama a un servicio externo, como un medio de pago o un courier, no cuenta como API externa.

Odoo Community en tus propios servidores no pasa por una suscripción, y el endpoint está en su código. Los precios varían por país: revísalos en la página de Odoo.

Límites

La documentación de la API no publica un límite de llamadas por minuto ni por mes. Los límites que sí están escritos son:

API keys de tres meses como máximo.
Hasta 10 claves generadas por API por usuario, un valor configurable.
Una transacción por llamada, sin posibilidad de encadenarlas.

Para enterarte de cambios sin consultar a cada rato, Odoo tiene reglas de automatización con la acción Enviar notificación webhook, que manda un POST con los campos que elijas a una URL externa cuando ocurre un evento. Están documentadas dentro de Studio, que en la página de precios aparece en el plan Custom.

Localización chilena y DTE

Odoo tiene localización para Chile. La documentación oficial lista estos módulos:

Módulo	Nombre técnico	Qué agrega
Chile - Accounting	`l10n_cl`	Contabilidad mínima según la normativa del SII
Chile - Accounting Reports	`l10n_cl_reports`	Propuesta F29 y Balance Tributario de 8 columnas
Chile - E-invoicing	`l10n_cl_edi`	Emisión y recepción de facturas y boletas electrónicas
Electronic Exports of Goods	`l10n_cl_edi_exports`	Facturas electrónicas de exportación
E-Invoicing Delivery Guide	`l10n_cl_edi_stock`	Guías de despacho electrónicas
Factoring Extension	`l10n_cl_edi_factoring`	Archivos AEC para ceder facturas a factoring

Fuente: documentación de Odoo 19.0, localización fiscal de Chile, consultada el 8 de noviembre de 2026.

Dos condiciones: todas las funciones exigen que la empresa haya completado la certificación del Sistema de Facturación de Mercado del SII, y el módulo base l10n_cl está en el repositorio público de Community, pero l10n_cl_edi no aparece ahí.

En una integración con tiendas, la integración entrega el pedido y Odoo emite la boleta o factura con su localización.

Conectores propios de Odoo con tiendas

Odoo tiene su propia aplicación de eCommerce, que vende directo desde el stock y los precios de Odoo, sin integración. Para canales externos, la documentación de Odoo 19.0 incluye estos conectores oficiales:

Amazon: sincroniza pedidos confirmados (FBA y FBM) hacia Odoo, crea los clientes que falten, avisa a Amazon de los envíos y envía a Amazon el stock disponible de productos FBM. Admite varias cuentas de vendedor y varios marketplaces por cuenta.
Shopify: sincroniza pedidos, productos, clientes, devoluciones y reembolsos desde Shopify, y el inventario y los despachos en ambos sentidos. No es en tiempo real: usa tareas programadas, por defecto cada 10 minutos para pedidos. La documentación de configuración dice que solo funciona con Odoo.sh y que requiere la versión 19.0 o 20.0.
Shopee, Lazada y TikTok Shop, también listados en la documentación de Ventas.

En la documentación oficial no aparecen conectores con WooCommerce, Mercado Libre, Falabella, Ripley ni Paris. Para esos canales, la tienda de apps de Odoo (apps.odoo.com) tiene módulos de terceros: una búsqueda para la versión 19.0 devuelve varios conectores de WooCommerce y de Mercado Libre de distintos desarrolladores.

Ojo con el alojamiento: según la documentación, Odoo Online no es compatible con aplicaciones no estándar, así que un módulo de terceros requiere Odoo.sh u on-premise.

Qué hace falta para conectar WooCommerce, Shopify o Mercado Libre

Tienes tres caminos. Antes, confirma que tu plan incluye API externa.

Conector oficial. Si vendes en Shopify o Amazon y estás en un escenario compatible (en Shopify, Odoo.sh con versión 19.0 o 20.0), es lo más directo.

Módulo de terceros. Para WooCommerce o Mercado Libre. Corre dentro de Odoo, así que necesitas Odoo.sh u on-premise y mantenerlo en cada actualización de versión.

Desarrollo propio o integrador con JSON-2. Un sistema externo que lee y escribe en Odoo por la API. Antes de partir, define:

Qué variante (product.product) corresponde a cada SKU publicado y que el código sea el mismo en ambos lados.
De qué ubicaciones o almacenes sale el stock publicado.
Qué lista de precios usa cada canal.
En qué estado se crea el pedido en Odoo, quién emite el DTE y qué pasa con las cancelaciones.
Cómo vas a rotar la API key cada tres meses sin cortar la integración.

Mercado Libre agrega un punto: el stock publicado cambia con cada venta en otro canal. Lo explicamos en cómo evitar la sobreventa en varios canales y en vender en Mercado Libre con tu ERP. Si estás evaluando un hub intermedio en vez de una conexión directa, revisa la comparación de Multivende, Centry y Anymarket.

ERPSync con Odoo

ERPSync conecta el ERP con tiendas y marketplaces: WooCommerce, Shopify, VTEX, Magento, PrestaShop, Jumpseller, Mercado Libre, Falabella, Ripley, Paris y Walmart. Nuestra especialidad es Softland, y con Odoo trabajamos previa revisión técnica de tu caso, usando su API.

Cuesta 0,80 UF al mes por integración, sin límite de pedidos (ver precios). Puede haber un costo inicial, que cotizamos después de revisar tu caso. Hay prueba de 14 días.

Preguntas frecuentes

¿Odoo tiene API?

Sí. Desde la versión 19.0 la API externa es JSON-2: llamadas POST con JSON a /json/2/<modelo>/<método>, autenticadas con una API key. Las versiones anteriores usan XML-RPC y JSON-RPC.

¿Cuándo dejan de funcionar XML-RPC y JSON-RPC?

Según la documentación oficial, se eliminan en Odoo 22, previsto para otoño de 2028, y en Odoo Online 21.1, previsto para invierno de 2027. Están deprecadas desde la versión 19.0.

¿Puedo usar la API con el plan Standard o One App Free?

No. La documentación de Odoo indica que el acceso por API externa solo está disponible en el plan Custom.

¿Odoo se conecta con WooCommerce o Mercado Libre?

No con un conector oficial. Hay módulos de terceros en la tienda de apps de Odoo, que requieren Odoo.sh u on-premise, o puedes integrarlos por la API.

¿Odoo emite DTE en Chile?

Sí, con el módulo de facturación electrónica de la localización chilena. Requiere que la empresa haya completado la certificación del SII como facturador de mercado.

Fuentes

Consultadas el 8 de noviembre de 2026.

Escrito por el equipo de ERPSync, especialistas en integraciones con Softland. Quiénes somos