Conectar Odoo: recibir pedidos y clientes, consultar inventario
Cree una API Key en Odoo en My Profile → Account Security, complete la URL de la instancia, la base de datos, el usuario y la API Key en Integration, pruebe, mapee y active.
El conector de Odoo trae pedidos de venta y clientes de su ERP Odoo a este sistema y puede consultar las cantidades de inventario guardadas en Odoo. Lee datos de Odoo: no devuelve cambios de inventario a Odoo, no trae facturas y no envía fulfillment a Odoo. Una conexión por instancia y base de datos de Odoo.
Requisitos previos#
- Una instancia de Odoo a la que pueda acceder y el login de un usuario de Odoo para la integración.
- Para Odoo Online: el acceso a la API externa requiere el plan Custom. En cualquier otro plan de Odoo Online, ningún conjunto de valores conectará: revise el plan antes de empezar.
- Conoce la dirección de su instancia (por ejemplo https://mycompany.odoo.com; autoalojado: la dirección de su servidor) y el nombre de la base de datos, en el selector de base de datos de la página de acceso de Odoo; en Odoo Online suele ser el subdominio.
- Permiso en Odoo para abrir My Profile y crear una API Key en la pestaña Account Security.
Obtener credenciales#
- Inicie sesión en Odoo con el usuario de la integración, haga clic en el avatar de arriba a la derecha y abra My Profile.
- Abra la pestaña Account Security y haga clic en New API Key.
- Copie la API Key que crea Odoo. En esta conexión, la API Key se usa en lugar de la contraseña al iniciar sesión, así que no hay una contraseña separada que buscar: la propia clave cumple el papel de contraseña.
- Anote al mismo tiempo los otros tres valores: la dirección de la instancia, el nombre de la base de datos del selector de la página de acceso de Odoo (en Odoo Online suele ser el subdominio) y el login de ese mismo usuario.
Completar en Integration#
- Abra Integration → Marketplace → Odoo → Nueva conexión.
- base_url, obligatorio, URL de la instancia de Odoo: la dirección de su instancia, por ejemplo https://mycompany.odoo.com. En una instancia autoalojada, complete la dirección de su servidor. Debe empezar con http:// o https://.
- database, obligatorio, nombre de la base de datos: el nombre que muestra el selector de base de datos en la página de acceso de Odoo, por ejemplo mycompany. En Odoo Online suele ser el subdominio de la dirección de su instancia.
- username, obligatorio, usuario (login): el login del usuario de Odoo para la integración, por ejemplo admin. Use el login del mismo usuario que creó la API Key: la forma exacta del login depende de su instancia.
- api_key, obligatorio, API key: pegue la API Key copiada de My Profile → Account Security → New API Key. Es un campo de tipo contraseña, se usa en lugar de la contraseña y se guarda como secreto.
Probar la conexión#
Haga clic en Probar la conexión. La prueba ejecuta dos pasos reales. Primero pide la versión a la instancia, sin iniciar sesión, para confirmar que la dirección responde y leer la versión del servidor. Después inicia sesión de verdad con su database, username y api_key, con la clave en el papel de contraseña, y solo un inicio de sesión correcto cuenta como aprobado. Es decir, una dirección correcta con una clave incorrecta no aprueba: la dirección prueba que la instancia responde y el inicio de sesión prueba las credenciales. Si falta base_url o no empieza con http:// o https://, la prueba se detiene con MISSING_BASE_URL; si falta database, username o api_key, se detiene con MISSING_CREDENTIALS, porque los tres son necesarios para el inicio de sesión real.
Mapping / elegir plantilla#
Elija el mapping estándar de Odoo. Trabaja con los modelos estándar de Odoo: los pedidos de venta vienen de sale.order, los clientes de res.partner y las consultas de inventario leen product.product. Tras aprobar la prueba, ejecute una extracción y compare un pedido real lado a lado (número de pedido, cliente, líneas y cantidades) y contraste la cantidad de un producto con lo que muestra Odoo, antes de activar. Si un campo de su instancia difiere del modelo estándar, ajuste ese campo en el mapping en lugar de renombrar nada en Odoo.
Activar#
Tras activar, la conexión trae pedidos de venta y clientes de Odoo a este sistema según la frecuencia definida, y las consultas de inventario leen las cantidades actuales de Odoo. Vigile las primeras extracciones en Runs / Logs y compárelas con Odoo antes de dejar la conexión sin supervisión.
Lo que esta conexión no hace: no devuelve cambios de inventario a Odoo, no trae facturas de Odoo y no envía fulfillment ni resultados de envío a Odoo. Siga gestionando eso en el propio Odoo, o en los sistemas donde el trabajo ocurre realmente.
Preguntas frecuentes#
La dirección abre bien, pero la prueba falla con AUTH_FAILED
La instancia responde (el paso de versión contestó), pero el inicio de sesión real fue rechazado. Eso significa que database, username o api_key no coinciden: los tres valores deben ir juntos y la clave debe ser la del mismo usuario que el username. Una dirección correcta por sí sola nunca aprueba esta prueba.
Cree una API Key nueva para el usuario de la integración (avatar de arriba a la derecha → My Profile → pestaña Account Security → New API Key), cópiela tal cual en el campo api_key, vuelva a revisar database en el selector de la página de acceso de Odoo y username como el login de ese usuario, y pruebe de nuevo.
La prueba se detiene con MISSING_CREDENTIALS o MISSING_BASE_URL
Uno de los cuatro campos está vacío o la dirección no sirve. MISSING_BASE_URL significa que falta base_url o que no empieza con http:// o https://. MISSING_CREDENTIALS significa que falta database, username o api_key, y la prueba no puede iniciar sesión de verdad sin los tres.
Complete los cuatro campos según el paso de completar en Integration: base_url con la dirección completa de la instancia, incluido http:// o https://, database y username completos, y api_key pegada entera, sin recortar nada. Guarde y pruebe de nuevo.
Todos los valores parecen correctos, pero Odoo Online sigue sin conectar
Su plan de Odoo Online no incluye acceso a la API externa. Solo el plan Custom abre la API externa en Odoo Online, así que en otro plan la instancia responde en el navegador mientras las llamadas externas a la API no están disponibles: los valores no son el problema.
Revise primero el plan de la instancia de Odoo Online. Pase la instancia al plan Custom y vuelva a probar la misma conexión con los mismos cuatro valores: mientras tanto, no siga cambiando los valores.
Conectado, pero no llegan pedidos de venta
La conexión funciona (la prueba inició sesión de verdad), pero no hay nada nuevo que traer: la base de datos de Odoo no tiene pedidos de venta nuevos en el rango de extracción, o los pedidos que hay no son pedidos de venta en sale.order.
Cree o confirme un pedido de venta en Odoo, verifique que pertenece a la misma base de datos que usa la conexión, ejecute una extracción manual y confirme que el pedido aparece en la vista previa o en Runs / Logs.