Conector de Odoo para tu tienda online
Bentian usa la API JSON-RPC de Odoo para leer productos y stock libre y para crear pedidos de venta. No toca la base de datos PostgreSQL de Odoo: todo pasa por los métodos oficiales del servidor.
Estado: Beta, en validación con clientes piloto
El flujo JSON-RPC está implementado y probado con el Modo Evaluación y con revisión de código, pero todavía no se ha validado en una instancia real de Odoo. No hemos contrastado el tratamiento de impuestos, unidades de medida ni multiempresa, así que no lo recomendamos aún para producción sin supervisión.
No ofrecemos garantías de sincronización en producción para este conector hasta completar la validación. Los conectores de Factusol y Sage 50 tienen su propia página de estado.
Cómo se conecta Bentian a Odoo
A diferencia de los conectores SQL, aquí la conexión es por HTTP o HTTPS contra tu servidor Odoo, con los datos de acceso de un usuario.
- Indicas la URL de tu Odoo (por ejemplo http://127.0.0.1:8069 o la de tu servidor), el nombre de la base de datos, el usuario y la contraseña.
- El agente se autentica con el método common.authenticate del endpoint /jsonrpc.
- El catálogo y el stock se leen con object.execute_kw y search_read; el pedido se crea con sale.order y sus líneas en una sola llamada.
- Si tu Odoo está en tu red local, el agente trabaja desde dentro; si está en la nube, basta con salida HTTPS.
Qué sincroniza el conector de Odoo
Productos
Variantes de producto con referencia interna (default_code), nombre, categoría, precio de venta, coste y código de barras.
Stock libre
Cantidad libre (free_qty) del producto, no la cantidad física total.
Clientes
Búsqueda del contacto por correo electrónico y alta de un nuevo res.partner si no existe.
Pedidos de venta
Pedido sale.order con líneas sale.order.line y referencia del pedido web en client_order_ref.
Modelos de Odoo que usa el conector
Modelos y campos consultados por JSON-RPC:
| Recurso | Campos | Uso en Bentian |
|---|---|---|
| product.product | default_code, barcode, standard_price, product_tmpl_id | Lectura del catálogo y resolución del SKU de cada línea. |
| product.template | name, list_price, categ_id | Nombre, categoría y precio de venta. |
| res.partner | name, email | Búsqueda por correo y alta de cliente. |
| sale.order / sale.order.line | partner_id, client_order_ref, note, product_id, product_uom_qty, price_unit | Alta del pedido de venta con sus líneas. |
Requisitos para Odoo
- • Odoo accesible por HTTP o HTTPS desde el equipo del agente (el adaptador está diseñado para las versiones 14 a 18, sin validar todavía en ninguna).
- • Usuario de Odoo con permisos de lectura de productos y de creación de pedidos de venta; si tu versión lo admite, puede usarse una clave de API como contraseña.
- • Módulos de Ventas e Inventario instalados.
- • Los SKU de la tienda deben existir como referencia interna en Odoo.
Requisitos generales del agente en Requisitos del sistema.
Puntos que seguimos validando en Odoo
- • Un pedido con un SKU que no existe en Odoo no se crea; el cliente puede haberse dado de alta antes.
- • Impuestos, descuentos y unidad de medida de la línea no están mapeados todavía; revisa el precio con IVA.
- • Las lecturas no están paginadas para catálogos muy grandes y el tiempo de espera es corto.
- • El número que se devuelve al crear el pedido es el identificador interno, no el nombre tipo S00012.
Participa en el piloto de Odoo
Buscamos empresas dispuestas a probar el conector sobre una copia de sus datos y a compartir el esquema real de sus tablas o recursos. Puedes probar el flujo completo en Modo Evaluación sin conectar a tu ERP. Los planes de licencia están en la sección de precios.
Solicitar acceso al piloto de OdooOtros conectores de Bentian que pueden interesarte
FacturaScripts
Otro ERP abierto conectado por API REST en lugar de SQL.
Business Central
Comparte el enfoque de API con autenticación y empresa, aunque con OData.
Sage 200
Alternativa SQL para quienes comparan ERP de empresa mediana.
Preguntas frecuentes sobre Odoo y comercio electrónico
¿Necesito instalar algún módulo en Odoo? ▼
No hay módulo de Bentian que instalar. El conector usa la API JSON-RPC que Odoo ya incluye en el servidor. Lo único necesario es que los productos tengan referencia interna y que el usuario tenga permisos suficientes.
¿Funciona con Odoo Online (SaaS) y Odoo.sh? ▼
Está pensado para cualquier URL que exponga /jsonrpc, así que en principio sí con HTTPS y credenciales válidas. Las instancias SaaS pueden limitar el acceso JSON-RPC según el plan; no lo hemos comprobado y es parte del piloto.
¿Se duplica el pedido si la tienda reintenta el envío? ▼
El conector busca primero un pedido con la misma referencia web (client_order_ref) y, si existe, lo devuelve en vez de crear otro. Esta comprobación no es atómica, así que dos envíos simultáneos podrían pasar a la vez.
¿Qué stock se envía a la web: físico, previsto o libre? ▼
Stock libre (free_qty), es decir, lo que se puede vender ahora. El perfil actual no filtra por almacén concreto ni por empresa; con varios almacenes u empresas hay que revisarlo.
¿Conecta directamente con la base de datos PostgreSQL? ▼
No. Aunque aparezca un perfil SQL en la configuración, no lo usamos para Odoo: la ruta correcta es JSON-RPC. Evitamos así escribir directamente en las tablas internas de Odoo.
Prueba el conector de Odoo en Modo Evaluación
Descarga el instalador para Windows y comprueba el flujo con un catálogo de ejemplo antes de conectar tu ERP. Este conector sigue en Beta.
Descargar Instalador Oficial Windows (v0.5.3)