Odoo dejará de responder en /xmlrpc, /xmlrpc/2 y /jsonrpc, que son las APIs por las que se conectan con tu ERP casi todas las integraciones de los últimos diez años. Según la documentación oficial de Odoo, quedaron obsoletas en la versión 19 y desaparecerán en Odoo Online 21.1 (invierno de 2027) y en Odoo 22 (otoño de 2028) para Odoo.sh y servidores propios. Las sustituye la API JSON-2. Si tu tienda, tu herramienta de BI, tus automatizaciones o tu app de almacén leen o escriben datos en Odoo, tienes que revisar cómo lo hacen y migrar las llamadas antes de esas fechas. Si no, un día dejarán de sincronizarse los pedidos y nadie sabrá por qué.

Calendario de la retirada de XML-RPC y JSON-RPC en Odoo

No pasa todo a la vez, y la fecha que te toca depende de dónde tengas Odoo alojado. Este es el calendario oficial:

Versión / plataformaQué ocurreFecha
Odoo 19XML-RPC y JSON-RPC pasan a estar obsoletas (siguen funcionando, pero dejan avisos en el log). Llega la API JSON-2.Septiembre de 2025
Odoo 20Se elimina el servicio db (crear, listar, duplicar o borrar bases de datos por RPC). Los servicios common y object siguen funcionando.Otoño de 2026
Odoo Online 21.1Desaparecen /xmlrpc, /xmlrpc/2 y /jsonrpcInvierno de 2027
Odoo 22 (Odoo.sh y servidor propio)Desaparecen /xmlrpc, /xmlrpc/2 y /jsonrpcOtoño de 2028

La eliminación del servicio db en Odoo 20 y la retirada de common y object en Odoo 22 vienen en la guía de migración de la API JSON-2.

Si estás en Odoo Online (la versión SaaS), el margen es menor de lo que parece. Odoo actualiza estas bases de datos de forma continua y tú no eliges cuándo llega la 21.1. En Odoo.sh o en servidor propio tienes hasta 2028, pero solo si no actualizas antes. Lo normal es aprovechar el próximo salto de versión para dejar la migración hecha.

Qué integraciones de Odoo se rompen y cuáles no

Lo primero es saber qué tienes conectado. Estas son las integraciones que en pymes suelen depender de XML-RPC o JSON-RPC:

  • Conectores de e-commerce con Magento, Shopify, WooCommerce o PrestaShop que sincronizan pedidos, stock, precios y clientes.
  • Automatizaciones en n8n, Make o Zapier que crean contactos, oportunidades o facturas en Odoo.
  • Scripts propios en Python o PHP, a menudo programados por un freelance hace años, que importan tarifas, exportan informes o cuadran datos por la noche.
  • Herramientas de BI (Power BI, Looker Studio, Metabase) que leen las ventas directamente de Odoo.
  • Apps de almacén, de transportistas o de preventa que consultan o actualizan albaranes.
  • Scripts de copias de seguridad o de bases de datos de prueba que usan el servicio db. Estos ya fallan en Odoo 20.

Lo que no se ve afectado: la interfaz web de Odoo, los módulos instalados dentro del propio Odoo y los controladores que tu desarrollador haya declarado con @route(type='jsonrpc'). La documentación oficial deja claro que estos últimos no entran en la retirada.

Cómo detectar si una integración usa la API antigua

Pide a quien mantenga el código que busque /xmlrpc, /jsonrpc, execute_kw, ServerProxy o librerías como odoorpc. En Odoo 19 y 20 también puedes revisar el log del servidor, porque cada llamada antigua deja un aviso de obsolescencia. Con conectores comerciales, la vía más rápida es preguntar al proveedor si ya usan JSON-2 y para qué versión.

XML-RPC frente a JSON-2: diferencias que importan

Lo que cambia no es solo la dirección (URL). La forma de autenticarse y de enviar los datos también es distinta, así que una integración antigua no se arregla cambiando una línea:

AspectoXML-RPC / JSON-RPCAPI JSON-2
Endpoint/xmlrpc/2/object fijo para todo/json/2/<modelo>/<método>
AutenticaciónLogin y contraseña (o clave API como contraseña) más un paso previo de authenticateClave API en la cabecera Authorization: bearer, en una sola petición
ArgumentosPosicionales (por orden)Solo con nombre: domain, fields, ids, vals…
ErroresLlegan dentro de la respuestaCódigos HTTP reales (4xx, 5xx)
Versión del servidorServicio commonGET /web/version
Gestión de bases de datosServicio dbNo existe en la API externa

Ejemplo: la misma consulta antes y después

Antes, para leer las 10 primeras empresas con su email:

models.execute_kw(db, uid, password, 'res.partner', 'search_read', [[['is_company', '=', True]]], {'fields': ['name', 'email'], 'limit': 10})

Con JSON-2 es una petición POST a https://tuempresa.odoo.com/json/2/res.partner/search_read con la cabecera Authorization: bearer TU_CLAVE y este cuerpo:

{"domain": [["is_company", "=", true]], "fields": ["name", "email"], "limit": 10}

Si en el mismo servidor conviven varias bases de datos, añade la cabecera X-Odoo-Database.

Cómo migrar tus integraciones de Odoo a JSON-2, paso a paso

  1. Haz inventario. Anota cada integración, qué datos mueve, en qué sentido, con qué frecuencia y quién la mantiene. Muchas empresas encuentran aquí scripts que nadie recordaba.
  2. Comprueba tu plan. Según la documentación de Odoo, el acceso a la API externa solo está disponible en el plan Personalizado, no en el Estándar ni en el gratuito de una aplicación. Puedes comparar planes en la página de precios de Odoo.
  3. Comprueba tu versión. JSON-2 llegó con Odoo 19. Si estás en Odoo 17 o 18 en servidor propio o en Odoo.sh, migrar la integración va de la mano de actualizar Odoo. Lo explicamos en cómo migrar de Odoo 17 a Odoo 18, 19 o 20 sin riesgos.
  4. Crea un usuario técnico por integración. Odoo recomienda usuarios «bot» dedicados con los permisos justos, sin acceso con contraseña y con registros de auditoría separados. Así, si una clave se filtra, solo queda expuesta esa integración.
  5. Genera las claves API y guárdalas bien. Odoo enseña la clave una sola vez. Guárdala en un gestor de secretos o en variables de entorno, nunca en el código. Las claves creadas desde la interfaz duran como máximo tres meses, así que necesitas un plan de rotación.
  6. Reescribe las llamadas. Pasa cada execute_kw a su endpoint JSON-2 con argumentos con nombre. La página /doc de tu propia instancia lista los modelos, campos y métodos disponibles, incluidos los de tus módulos a medida.
  7. Revisa las transacciones. Cada llamada JSON-2 se ejecuta en su propia transacción y no puedes encadenar varias en una. Si tu integración crea un pedido y luego sus líneas en llamadas separadas, piensa qué pasa si falla la segunda.
  8. Prueba en una copia de la base de datos. Lanza pedidos, devoluciones, cambios de stock y facturas reales en un entorno de pruebas y compara el resultado con la integración antigua.
  9. Monitoriza y pon alertas. Ahora los errores llegan como códigos HTTP, así que configura avisos por email o Slack cuando una sincronización falle o una clave esté a punto de caducar.

Si usas n8n o un conector comercial

n8n. El nodo de Odoo de n8n usaba los endpoints antiguos. La incidencia abierta en GitHub se cerró en julio de 2026 con la corrección en n8n 2.23.0. Si tienes una versión anterior, actualiza y revisa cada flujo que toque Odoo. Mientras tanto, también puedes llamar a JSON-2 con el nodo HTTP Request y tu clave API. Si tus automatizaciones dependen de Odoo y no tienes claro qué usan, en nuestro servicio de automatización de procesos con n8n las auditamos y las migramos.

Conectores de tienda online. Pide al proveedor tres cosas por escrito: si ya soporta JSON-2, desde qué versión y qué pasa si estás en Odoo Online. Un conector que no da fecha es un riesgo para el negocio, porque si se cae la sincronización de stock vendes lo que no tienes. Si te planteas sustituirlo, tienes las guías de integración de Odoo con Magento e integración de Odoo con Shopify.

Cuánto cuesta migrar una integración de Odoo a JSON-2

Depende sobre todo de cuántas operaciones distintas haga la integración y de lo bien documentada que esté. Como referencia orientativa:

  • Script sencillo (por ejemplo, exportar ventas a una hoja o crear contactos): suele resolverse en horas.
  • Automatizaciones en n8n: actualizar la versión y revisar los flujos. El esfuerzo crece con el número de flujos y con los que usan modelos a medida.
  • Conector propio con la tienda online (pedidos, stock, precios, clientes y facturas): es un pequeño proyecto con pruebas completas, y conviene hacerlo junto a la actualización de versión de Odoo.

Lo caro de verdad no es la migración, sino que la integración se rompa en plena campaña. Puedes ver rangos de precio en nuestra página de precios orientativos.

Aprovecha la migración para ordenar los accesos

Odoo 20 trae un servidor MCP nativo para conectar asistentes de IA como ChatGPT o Claude a tu ERP, y funcionan con los permisos del usuario que autoriza la conexión. Si ya estás creando usuarios técnicos y claves con caducidad para JSON-2, aplica el mismo criterio a la IA. Te lo contamos en qué permisos dar a los agentes de IA y cómo controlarlos.

Preguntas frecuentes

¿Mis integraciones dejan de funcionar al actualizar a Odoo 20?

Casi nunca. En Odoo 20 solo se elimina el servicio db, que sirve para gestionar bases de datos. Las lecturas y escrituras normales con execute_kw siguen funcionando hasta Odoo 22, aunque llenan el log de avisos.

Estoy en Odoo Online, ¿cuándo me afecta?

Con la versión Online 21.1, prevista para el invierno de 2027. Como Odoo actualiza las bases de datos Online de forma automática, conviene tener la migración terminada bastante antes.

¿Necesito el plan Personalizado para usar la API JSON-2?

Sí. Según la documentación oficial, el acceso a la API externa solo está disponible en el plan Personalizado. Con el plan Estándar no puedes conectar integraciones externas por API.

¿Puedo usar JSON-2 con Odoo 17 o 18?

En instalaciones propias u Odoo.sh, no: JSON-2 llega con Odoo 19. En esas versiones sigues con XML-RPC y harás el cambio al actualizar. Lo ideal es planificar ambas cosas juntas.

Si no sabes cuántas integraciones dependen hoy de XML-RPC o quieres que la migración a JSON-2 coincida con tu próxima actualización de versión, en Guznel Flow revisamos tu instalación, hacemos el inventario y dejamos tus conexiones con tiendas, automatizaciones y herramientas preparadas. Cuéntanos cómo tienes montado tu ERP en nuestra página de implantación e integración de Odoo.