Métodos de integración con la API de Odoo

¿Qué métodos hay para integrar Odoo por API?

Odoo admite tres tecnologías clave para la integración:

1. RPC (Remote Procedure Call): API nativa para acceso directo a funciones
2. REST API: Una interfaz web estándar para casos de uso habituales
3. Queued Middleware: Un enfoque basado en mensajes para el intercambio de datos asíncrono y escalable

Cada enfoque tiene puntos fuertes y contrapartidas concretas, según los sistemas implicados, la naturaleza del flujo de datos y las necesidades de tiempo real de tu aplicación. 

Estos métodos también se pueden combinar, por ejemplo, REST para APIs públicas y RPC para tareas internas. Para asistentes de IA como Claude o ChatGPT, Odoo 20 añade otra vía: un servidor MCP nativo.

¿Qué es la API externa de Odoo (JSON-2 y RPC)?

Odoo admite de forma nativa una interfaz RPC (Remote Procedure Call) que permite llamadas directas a métodos usando JSON o XML. 

Desde Odoo 19, el estándar es la API JSON-2: envías por POST un cuerpo JSON con una clave de API como token de portador, por ejemplo para llamar al método search_read de Odoo en /json/2/res.partner/search_read. Los puntos finales antiguos de XML-RPC y JSON-RPC (/xmlrpc, /xmlrpc/2, /jsonrpc) están obsoletos y está previsto eliminarlos en Odoo 22 (otoño de 2028) y en Odoo Online 21.1 (invierno de 2027). 

El enfoque de la API RPC permite un acceso profundo a las funcionalidades centrales de Odoo y es el método más integrado en la plataforma.

Ventajas:

• Perfecta para interacciones rápidas con una sobrecarga mínima, porque es ligera y eficiente.
• Admite todos los métodos internos de Odoo sin configuración adicional, lo que permite acceso completo al sistema.

Desventajas:

• Opera a nivel de función y no con recursos estructurados, es decir, llamas directamente a métodos de backend como create, write o search_read en lugar de trabajar con recursos REST estándar como /products o /customers
• No está tan extendida y carece de la estandarización universal de REST o GraphQL.
• Cada llamada JSON-2 se ejecuta en su propia transacción de base de datos, así que no puedes encadenar varias llamadas en una sola operación atómica.

Ideal para: Integraciones internas, tareas críticas para el rendimiento o cuando hace falta acceso completo a los métodos sin restricciones. 

¿Tiene Odoo una API REST?

La API RESTful de Odoo sigue los estándares web convencionales y permite interactuar con los datos de Odoo mediante métodos HTTP habituales como GET, POST, PUT y DELETE. 

Es una interfaz ampliamente compatible e ideal para integrarse con plataformas o servicios externos.

Aunque Odoo no incluye una API REST nativa por defecto, muchas implementaciones usan módulos de la comunidad o controladores a medida para exponer puntos finales RESTful.

Ventajas:

• Estandarizada, muy extendida y compatible con casi todos los lenguajes de programación modernos.
• Organiza los datos en tipos claros (como productos o pedidos), lo que hace que tu sistema sea más fácil de gestionar y de escalar más adelante.
• Hay bibliotecas de cliente REST en la mayoría de infraestructuras, porque es un ecosistema muy soportado.
• Es más fácil documentar y probar las APIs REST con herramientas como Postman o Swagger.

Desventajas:

• Las llamadas REST llevan metadatos adicionales que pueden ralentizarlo todo.
• Menos eficiente para casos de uso complejos, y el rendimiento puede resentirse si hacen falta muchas llamadas encadenadas a la API.
• Solo funciona sobre HTTP y no ofrece soporte nativo para transportes alternativos como WebSockets.
• La ausencia de estado es una restricción habitual de REST, lo que a veces provoca llamadas repetitivas, por ejemplo, volver a pedir los datos de autenticación o de usuario.

Ideal para: Portales web, apps móviles e integraciones con servicios de terceros donde la compatibilidad universal es clave.

¿Cuándo conviene usar middleware con colas con Odoo?

Para proyectos con grandes volúmenes de datos o necesidades de comunicación asíncrona, Odoo se puede integrar con herramientas de queued middleware como Kafka o RabbitMQ, aunque no incluye soporte nativo para ellas.

Este patrón desacopla los sistemas y garantiza una comunicación tolerante a fallos incluso cuando una de las partes no está disponible temporalmente.

Ventajas:

• Permite la comunicación sin depender de los tiempos de respuesta.
• Maneja grandes conjuntos de datos y permite almacenar los mensajes en búfer y procesarlos cuando haya recursos disponibles.
• Muy escalable y resiliente: los mensajes no se pierden ni siquiera durante caídas del sistema.

Desventajas:

• Configuración más compleja y requiere una infraestructura de colas aparte.
• No es a tiempo real: puede haber retrasos porque el procesamiento es asíncrono.
• Requiere una configuración cuidadosa y una gestión continua de los message brokers por las dependencias del middleware

Ideal para: Procesos con mucha carga de datos, como informes, sincronización entre sistemas u operaciones masivas de lectura/escritura a lo largo del tiempo.

¿Cómo eliges el método de integración de la API de Odoo adecuado?  

Al seleccionar la estrategia de API adecuada para tu proyecto de Odoo, ten en cuenta:

• Socio de integración: ¿Vas a trabajar con un sistema de terceros o con herramientas internas?
• Necesidades de tiempo real: ¿Necesitas transferencia de datos instantánea o es aceptable un procesamiento diferido?
• Volumen de datos: ¿Vas a sincronizar un puñado de registros o a transmitir miles por hora?
• Complejidad del sistema: ¿Quieres algo estandarizado y listo para usar o algo muy optimizado y a medida?

Esta es una regla rápida:

Al elegir un método de conexión por API en Odoo, no tienes que limitarte estrictamente a uno.

Es habitual usar un enfoque híbrido, por ejemplo, REST para sistemas de cara al público, RPC para la orquestación del backend y colas para el procesamiento pesado en segundo plano.

Ten en cuenta: La API externa de Odoo solo está disponible en el plan de precios Custom, no en One App Free ni en Standard. Las opciones de REST y middleware dependen de tu versión de Odoo o de implementaciones a medida.

¿Qué debes comprobar antes de lanzar una integración de la API de Odoo?

Antes de lanzarte al desarrollo, aclara estos puntos con tu equipo o con el socio de integración:

• Estrategia de autenticación: ¿Vas a usar tokens, autenticación por sesión u OAuth?
• Gestión de errores y reintentos: Especialmente importante en operaciones en cola o por lotes
• Propiedad y mapeo de los datos: ¿Quién es el dueño de la fuente de verdad de cada campo?
• Consideraciones de seguridad: Asegúrate de que los puntos finales están protegidos y los datos cifrados
• Monitorización y registro: Ten visibilidad sobre el tráfico de tu API y las tasas de fallo

Una integración bien preparada ahorra tiempo, reduce errores y hace que tus sistemas conectados sigan siendo fiables y preparados para el futuro.

Preguntas frecuentes sobre la API de Odoo

¿Qué métodos usa Odoo para la integración por API? 

Odoo se integra mediante su API externa (JSON-2 desde Odoo 19; XML-RPC y JSON-RPC están obsoletos), puntos finales REST añadidos con módulos a medida o de la comunidad, y middleware con colas como RabbitMQ o Kafka para grandes volúmenes de datos. Los asistentes de IA se conectan a través del servidor MCP de Odoo 20.

¿Es fácil conectar Odoo con otro software por API? 

Sí, si tu plan lo incluye. La API externa de Odoo solo está disponible en el plan de precios Custom, no en One App Free ni en Standard. Con ella puedes conectar Odoo con herramientas como Shopify o CRMs de terceros para automatizar flujos de trabajo y sincronizar datos sin introducción manual.

¿Cómo mantengo segura mi conexión a la API de Odoo? 

Usa una clave de API de Odoo propia para cada integración, enviada como token de portador en la cabecera Authorization, nunca la contraseña de un usuario. Ejecuta las integraciones con un usuario bot que solo tenga los permisos de acceso necesarios, cifra todo el tráfico con HTTPS y revoca una clave al instante si detectas un riesgo de seguridad.

¿XML-RPC está obsoleto en Odoo?

Sí. XML-RPC y JSON-RPC (/xmlrpc, /xmlrpc/2, /jsonrpc) están obsoletos desde Odoo 19. La documentación de Odoo prevé eliminarlos en Odoo 22 (otoño de 2028) y en Odoo Online 21.1 (invierno de 2027). Migra tus integraciones a la API JSON-2 antes de esa fecha, idealmente como parte de tu actualización de Odoo.

¿Qué es la API JSON-2 de Odoo?

JSON-2 es la API externa de Odoo desde Odoo 19. Envías por POST un cuerpo JSON a /json/2/model/method, por ejemplo /json/2/res.partner/search_read, con una clave de API como token de portador en la cabecera Authorization. Cada llamada se ejecuta en su propia transacción de base de datos, así que no puedes encadenar varias de forma atómica.

¿Qué plan de Odoo necesito para acceder a la API?

Necesitas el plan Custom. La documentación de Odoo indica que el acceso a los datos mediante la API externa solo está disponible en los planes de precios Custom, no en One App Free ni en Standard. Si estás en Standard y planeas integraciones, presupuesta el cambio a Custom antes de empezar el desarrollo.

¿Cómo se conectan a Odoo herramientas de IA como Claude o ChatGPT?

A través del Protocolo de Contexto de Modelo (MCP). Odoo 20 incluye un servidor MCP nativo en un punto final /mcp con cinco herramientas de solo lectura por defecto; un administrador debe habilitar las acciones de escritura. El servidor usa claves de API exclusivas para MCP y aplica los permisos de acceso del usuario. Más información sobre el servidor MCP de Odoo.