Elbuz intercambia datos con Odoo directamente mediante la API de Odoo, sin archivos: catálogo, stock de almacenes y pedidos llegan a Elbuz; precios, productos nuevos y vínculos con proveedores de las listas de precios vuelven a Odoo.
Cuándo sirve:
- Almacén y contabilidad en Odoo: productos con variantes, fotos, atributos y stock por almacén pasan al catálogo.
- Precios según listas de proveedores: Elbuz envía a Odoo solo los precios cambiados.
- Compras en Odoo: la pestaña “Compra” muestra los proveedores de las listas con sus códigos, precios y plazos.
- Pedidos de Odoo en la cola común: cada uno, como “Pedido de cliente”.
Por dónde empezar: cree una clave API en Odoo.
Qué hace la conexión con Odoo
- Pasa los productos al catálogo: nombre, referencia, código de barras, precio, peso, descripciones y categoría; cada variante, como ficha aparte.
- Agrupa las variantes en una familia y convierte colores, tallas y demás ejes de variante en atributos de opción.
- Descarga las fotos junto con la galería del sitio web de Odoo, aunque en Odoo las imágenes requieran iniciar sesión.
- Replica los almacenes: el stock de cada producto en cada almacén de Odoo.
- Recibe los pedidos de venta y da de alta a los proveedores de Odoo como contactos.
- Exporta a Odoo precios, productos nuevos con foto y categoría, opcionalmente descripciones, SEO y datos principales, y vínculos con proveedores.
Qué va en cada sentido:
- Запит або дія
- Примітка
Qué necesita de Odoo: dirección y clave API
Elbuz se conecta a Odoo en nombre de un usuario de Odoo con su clave API. Hacen falta tres datos:
- Dirección de Odoo: la del navegador, por ejemplo
https://company.odoo.com. Si el servidor aloja varias bases de datos, añada su nombre a la dirección:https://erp.company.com/?db=main. En Odoo Online la base se toma de la dirección. - Clave API: se crea en Odoo y se pega en el campo “Clave API de Odoo”.
- Usuario: solo para Odoo 18 y anteriores. Odoo 19 y posteriores funcionan solo con la clave; deje el campo vacío.
No hace falta indicar la versión de Odoo: Elbuz detecta si el servidor admite el nuevo protocolo de Odoo 19+ y, si no, pasa al antiguo para Odoo 14–18.
Dónde obtener la clave API, paso a paso
| Dónde | Qué hacer |
|---|---|
| Odoo | Avatar en la esquina superior derecha → Mis preferencias → pestaña Seguridad → bloque “Claves API” → Create API Key |
| Ahí mismo | Confirmar la contraseña, escribir una descripción (por ejemplo, “Elbuz”) y la caducidad |
| Ahí mismo | Copiar la clave: Odoo la muestra una sola vez |
| Elbuz | Plantilla “Odoo” → tarjeta “Conexión” → dirección, clave (y usuario para Odoo 18 y anteriores) → “Guardar” → “Comprobar conexión” |
1
Pestaña «Seguridad»2
Botón «Create API Key»- Pestaña «Seguridad» de la ventana «Cambiar mis preferencias» (avatar → «Mis preferencias»).
- Create API Key crea una clave; Odoo la muestra una sola vez. Arriba — una clave existente «elbuz» con alcance RPC y fecha de caducidad.
En Odoo 20 una clave dura como máximo tres meses. Al caducar, la importación y la exportación se detienen con el error “Invalid apikey”. Póngase un recordatorio: antes de que venza, cree una clave nueva e introdúzcala en ambas plantillas.
Cree en Odoo un usuario aparte, por ejemplo “Elbuz”, con permisos de ventas, inventario y compras. Así se ve qué cambios hizo la integración, y el acceso se revoca fácilmente sin tocar a ninguna persona.
En Odoo Online, en la nube, la API externa solo está disponible en el plan Custom. En los planes One App Free y Standard, Odoo no aceptará las solicitudes. Odoo en servidor propio o en Odoo.sh no tiene esta limitación.
Odoo debe ser accesible desde internet. Elbuz funciona en la nube y no entra en redes internas: un servidor de Odoo visible solo en la red de la oficina no se conectará.
Cómo conectar
- Cree una plantilla de tipo “Odoo” y, en la tarjeta “Conexión”, introduzca la dirección, la clave API y, para Odoo 18 y anteriores, el usuario.
- Guarde la plantilla y pulse “Comprobar conexión”: se comprueban la dirección y la clave guardadas. Si Odoo responde con el nombre de su empresa, la clave se ha aceptado.
- En la tarjeta “Selección de datos para importar”, deje marcadas solo las casillas necesarias (qué activan), guarde y ejecute.
Qué importar de Odoo: casillas de la plantilla
Usted decide qué traer: la plantilla de Odoo muestra solo las casillas que la conexión realmente ejecuta. Si desmarca una, la ejecución omite esa parte.
| Casilla | Qué llega |
|---|---|
| Productos | fichas de productos y variantes (campos) |
| Categorías | categoría del producto: la del sitio web de Odoo o, si no hay sitio, la categoría interna de Odoo; funciona junto con “Productos” |
| Atributos | ejes de variante como atributos de opción y los demás atributos; junto con “Productos” (variantes) |
| Fotos | foto principal y galería del sitio web de Odoo; junto con “Productos” (fotos) |
| Almacenes | almacenes de Odoo y el stock del producto en cada uno; sin “Productos”, actualiza el stock de las fichas ya importadas (almacenes) |
| Pedidos | pedidos de venta como documentos “Pedido de cliente” (pedidos) |
| Importar proveedores de Odoo como contactos | proveedores en el grupo “Proveedor” (proveedores) |
1
Productos2
Almacenes3
Proveedores de Odoo como contactos- Productos — importa los productos de Odoo con sus variantes.
- Almacenes — trae los almacenes de Odoo y el stock de cada producto por almacén.
- Importar proveedores de Odoo como contactos — los crea en el grupo «Proveedor».
Orden de la ejecución: proveedores → productos → almacenes → pedidos. Los almacenes van después de los productos porque el stock se escribe en fichas ya existentes.
Velocidad y volúmenes
La conexión lee y escribe por lotes: páginas de 500 productos, fotos en varias solicitudes paralelas y precios en paquetes de 500 por solicitud. Mediciones del 11.11.2026, con Odoo 20 en el mismo ordenador que Elbuz (sin latencia de red):
| Operación | Volumen | Tiempo |
|---|---|---|
| importación del catálogo con fotos | 3049 productos, 3039 fotos | 8 s |
| importación completa al catálogo de Elbuz | 3054 productos y 24 pedidos | 37 s; repetición: 23 s |
| exportación de todos los precios | 3000 productos | 22 s |
| exportación diaria de precios | 3000 productos, 100 cambiados | 0,8 s |
En su Odoo el tiempo depende del servidor y del plan, pero la proporción es la misma: no hace falta exportar cada vez toda la lista, Elbuz descarta solo los precios sin cambios. El botón “Detener” del registro corta la importación del catálogo y de los pedidos tras la página en curso.
Qué pasa a la ficha de producto
Cada variante de un producto de Odoo se convierte en una ficha aparte en Elbuz. Un producto de Odoo sin variantes es una sola ficha.
| Datos de Odoo | Campo de la ficha en Elbuz |
|---|---|
| nombre (en la variante, con los atributos, por ejemplo “Mesa (Blanco, Acero)”) | Nombre |
| referencia interna (Internal Reference) | Referencia |
| código de barras | Código de barras (solo dígitos) |
| precio de venta de la variante | Precio |
| cantidad disponible (con la aplicación Inventario) | Stock; el negativo pasa a cero |
| peso | Peso |
| descripción de venta | Descripción corta |
| descripción para el sitio web de Odoo, título y descripción SEO | Descripción completa, metatítulo, metadescripción |
| activo y casilla “Ventas” | Activo: desactivado si el producto no se puede vender |
Cada ficha recibe una clave fija: el ID del producto en Odoo. Con ella Elbuz reconoce el producto en cada ejecución, aunque en Odoo se cambien el nombre o la referencia. Por eso dos productos distintos de Odoo con el mismo nombre siguen siendo dos fichas y no se fusionan.
Un producto creado en Odoo por la exportación de Elbuz se reconoce al importar como su ficha existente: no habrá una segunda ficha.
Qué hace una nueva ejecución con sus cambios
La ejecución devuelve a la ficha lo actual de Odoo: nombre, referencia, código de barras, precio, stock, activo y descripciones. Un campo vacío en Odoo no borra su valor. Se omiten los creados en Odoo por la exportación de Elbuz: su precio y stock los gestiona Elbuz. Para fijar el precio: “Precio fijo” en la ficha (resumen de la importación).
Las fotos y los atributos se cargan solo al crear la ficha. En una ficha ya existente la ejecución no los actualiza: si cambia la foto en Odoo, en Elbuz no cambiará.
Un producto eliminado o archivado en Odoo sigue igual en Elbuz: la ejecución solo trae los productos existentes y no desactiva nada. Las fichas de Odoo se encuentran en la ventana “Productos” por la columna “Fuente: código” (odoo).
Variantes, atributos y fotos
Las variantes de un mismo producto de Odoo se agrupan en una familia de productos: todas tienen el mismo “Nombre de la familia (variantes)”, el nombre del producto en Odoo. En el sitio web se cambia entre ellas con botones de color y talla, y cada una tiene su precio, foto y stock.
- Los ejes de variante (color, talla, material de las patas…) llegan como atributos de opción, que son los que cambian de variante.
- Los atributos de Odoo que no crean variantes llegan como atributos normales; varios valores, separados por punto y coma.
- Dos productos distintos de Odoo con variantes y el mismo nombre reciben una familia con el ID de la plantilla de producto de Odoo al final, por ejemplo “Camiseta #101”, para que sus variantes no se mezclen.
1
Color2
Legs- Color — la opción de la variante, aquí con el valor White.
- Legs — la segunda opción de la variante, aquí con el valor Steel.
Sin la casilla “Atributos”, las variantes también pasan a ser fichas aparte de una misma familia, pero sin atributos de opción. En ese caso el selector no aparecerá en el sitio web hasta que marque los atributos de variante a mano.
Fotos de productos
Las imágenes de Odoo solo se abren tras iniciar sesión en Odoo, así que un enlace a ellas no le sirve a Elbuz. Por eso la conexión descarga el propio archivo a través de la API, lo guarda en su almacenamiento de Elbuz y escribe en la ficha un enlace propio.
- Foto principal: la de la variante o, si no tiene, la del producto.
- Galería: fotos adicionales del sitio web de Odoo (aplicación Comercio electrónico); primero las de la variante y después las del producto.
- Una foto, un archivo. Una foto común a cinco variantes se sube una sola vez; repetir la ejecución sin cambios no descarga nada.
Stock por almacén
La casilla “Almacenes” crea en Elbuz un espejo de los almacenes de Odoo: cada almacén de Odoo pasa a ser un almacén de Elbuz con el mismo nombre y el mismo stock que en Odoo. El sistema principal para el stock es Odoo.
- Un almacén nuevo de Odoo aparecerá en Elbuz solo en la siguiente ejecución.
- Cada cambio de stock queda en el historial de movimientos del almacén como sincronización, sin documentos. Repetir la ejecución sin cambios en Odoo no escribe nada.
- El stock total de la ficha es la suma de todos los almacenes de Odoo.
1
YourCompany2
Kyiv WH- YourCompany — un almacén de Odoo, copiado como almacén propio.
- Kyiv WH — otro almacén de Odoo; el tercero es My Company (Chicago).
Sin la aplicación Inventario, Odoo no tiene almacenes ni cantidades: el registro de la ejecución mostrará un error para los almacenes y los productos se importarán sin stock.
No conviene registrar movimientos con documentos de Elbuz en los almacenes espejo: la siguiente ejecución restablecerá el stock de Odoo. La conexión no toca sus propios almacenes de Elbuz ni sus documentos.
Pedidos de venta y proveedores
Cada pedido de venta de Odoo entra en Elbuz como documento “Pedido de cliente” con su número de Odoo, p. ej., S00042. Otra ejecución no lo duplica: actualiza estado (si no lo cambió a mano), pago y envío, y rellena contactos y dirección vacíos. Líneas e importe no se sobrescriben: si cambia el contenido en Odoo, Elbuz conserva el anterior.
| En Odoo | En el documento de Elbuz |
|---|---|
| línea de producto | línea del documento vinculada a la ficha; precio con el impuesto y el descuento de la línea |
| línea de envío | importe del envío (no es una línea de producto) |
| secciones y notas del pedido | no se transfieren |
| cliente | nombre, email, teléfono |
| dirección de entrega | ciudad, país, código postal, dirección; si no hay una aparte, se toma la del cliente |
| nota y referencia del cliente | comentario del documento |
| estado del pedido y de la factura | estado del pedido y del pago, para la correspondencia de estados |
El importe del documento coincide con el total del pedido en Odoo, impuestos incluidos. La primera ejecución trae todos los pedidos de venta, también presupuestos (borradores) y cancelados, con su situación en el estado; las siguientes, solo los modificados desde la anterior. Los modificados en el último segundo de la ejecución anterior vuelven a llegar y solo se actualizan.
Proveedores de Odoo como contactos
La casilla “Importar proveedores de Odoo como contactos” da de alta a los proveedores de Odoo en Elbuz, en el grupo “Proveedor”: nombre, email, teléfonos, sitio web, número fiscal, país, ciudad, dirección, código postal y comentario.
- Se considera proveedor el contacto de Odoo marcado como proveedor (la marca aparece con las aplicaciones Compra o Contabilidad). Sin ella, los que figuran en los precios de compra de los productos.
- Las personas de contacto dentro de una empresa no se convierten en proveedores aparte.
- El contacto se busca por nombre. Si ya existe, la ejecución no lo cambia: sus modificaciones en la ficha del contacto se conservan.
Qué exportar a Odoo
La exportación es una plantilla “Odoo” aparte en la ventana “Exportación de datos”, con la misma dirección y clave. Qué enviar lo deciden las casillas de la tarjeta “Qué exportar”:
| Casilla | Qué hace en Odoo |
|---|---|
| Productos | actualiza el precio de los productos vinculados, solo de los que ha cambiado (precios de variantes) |
| Publicar productos nuevos | crea los productos que aún no están en Odoo: nombre, precio, referencia, código de barras, peso, descripción corta |
| Categorías | asigna categoría al producto nuevo y la crea en Odoo según su ruta |
| Fotos | envía la foto principal del producto nuevo |
| Vínculos con proveedores | rellena la pestaña “Compra” (detalles); activada por defecto |
| Descripciones y SEO | a los productos vinculados les envía la descripción corta a la descripción de venta y la completa a la descripción del producto en el sitio web de Odoo, además del título SEO y la meta descripción; desactivada por defecto |
| Datos principales (nombre, SKU, código de barras, peso) | actualiza estos campos de los productos vinculados; el nombre solo en productos sin variantes, porque las variantes lo comparten con la plantilla; desactivada por defecto |
Un campo vacío en Elbuz no borra el valor en Odoo y solo se envían los campos que cambiaron. Sin la aplicación “Sitio web”, Odoo no tiene dónde guardar la descripción completa: entonces solo va la corta.
1
Productos2
Publicar productos nuevos3
Vínculos con proveedores4
Descripciones y SEO- Productos — envía a Odoo los precios de los productos ya vinculados.
- Publicar productos nuevos — crea en Odoo los productos que aún no existen allí.
- Vínculos con proveedores — transfiere a la pestaña «Compra» del producto los proveedores de las listas de precios.
- Descripciones y SEO — envía las descripciones y los textos SEO del producto.
Se considera vinculado un producto importado de la misma base de Odoo o ya creado por esta exportación. Ese producto no se vuelve a crear, y uno de otra base de Odoo no cuenta como vinculado. Odoo no tiene casilla aparte “solo lo modificado”: Elbuz compara los precios con Odoo y envía solo los cambiados.
Precios de variantes
En Odoo 20 cada variante tiene precio propio y Elbuz escribe el de cada una. En Odoo 18 y anteriores el precio es de la plantilla de producto; la variante solo añade el recargo del atributo. Ahí Elbuz escribe el precio base si las variantes sin recargo cuestan igual; si no, omite esa plantilla y el registro indica cuántas hay.
- El stock no se escribe en Odoo. Odoo gestiona el almacén y Elbuz toma el stock de él.
- La foto y la categoría se envían solo a los productos nuevos; en los ya existentes en Odoo no se cambian.
- Un código de barras duplicado en uno de los productos nuevos no detiene el resto: Odoo rechaza solo ese producto y el motivo queda en el registro.
Vínculos con proveedores en la pestaña “Compra”
Elbuz sabe qué proveedores tienen cada producto del catálogo gracias a las listas de precios vinculadas. La casilla “Vínculos con proveedores” lleva esto a Odoo, a la pestaña estándar “Compra” de la ficha de producto: cada producto tiene tantas líneas como proveedores.
| Línea de “Compra” en Odoo | Origen |
|---|---|
| Proveedor | proveedor de la lista de precios; si no está en Odoo, se crea como empresa proveedora |
| Código y nombre del producto del proveedor | referencia y nombre del producto en la lista de precios |
| Precio y moneda | precio de la lista en la moneda del proveedor, si esa moneda está activa en Odoo; si no, en su moneda base, si está activa; si no, convertido al tipo de cambio de Elbuz a la moneda de la empresa en Odoo. Si no hay ninguna, la línea no se escribe y el error queda en el registro |
| Plazo de entrega | número de días del plazo de entrega de la lista de precios |
1
Pestaña «Compra»2
Líneas de proveedores- Pestaña «Compra» de la ficha de producto de Odoo.
- Proveedores de las listas de precios de Elbuz: precio en su moneda o convertido, plazo de entrega.
- Sin cambios, sin escritura. Una línea que ya coincide no se reescribe; las modificadas se actualizan en paquetes de 500.
- Un vínculo eliminado en Elbuz desaparece también en Odoo, pero solo en sus proveedores, es decir, los que tienen lista de precios en Elbuz, y solo para los productos incluidos en esta exportación.
- Las líneas de proveedores dados de alta solo en Odoo no se tocan. Sus compradores pueden llevar allí sus propios proveedores en paralelo.
El nombre del contacto en Elbuz y el del contacto en Odoo deben coincidir. Si no, en Odoo aparecerá una segunda empresa con el nombre de Elbuz y los vínculos irán a ella.
Escenarios
Almacén y contabilidad en Odoo, ventas y listas de precios en Elbuz
Importación programada: “Productos”, “Atributos”, “Almacenes”. Exportación: “Productos” (precios) y “Vínculos con proveedores”. El stock llega de Odoo y los precios van a Odoo desde las listas de precios.
Los compradores trabajan en Odoo
Exportación solo con la casilla “Vínculos con proveedores”. En la pestaña “Compra” de cada producto, los proveedores al día, con sus precios y plazos.
Migración de Odoo a Elbuz
Una sola importación con todas las casillas, incluidos proveedores y pedidos. Las fotos, las familias de variantes, las categorías y el historial de ventas se trasladan junto con los productos.
Pedidos de Odoo en la cola común
Una plantilla de importación aparte, solo con la casilla “Pedidos” y programada: los pedidos de Odoo aparecen junto a los del sitio web y los marketplaces.
Novedades de las listas de precios directamente en Odoo
Exportación con “Publicar productos nuevos”, “Categorías” y “Fotos”: un producto que aparece en el catálogo de Elbuz se creará en Odoo con foto y su lugar en el árbol de categorías.
Qué hacer cuando Odoo no se conecta
| Qué se ve | Causa | Qué hacer |
|---|---|---|
| “Invalid apikey” | la clave ha caducado, se ha revocado o no se copió entera | cree una clave nueva en Odoo (cómo) e introdúzcala en ambas plantillas |
| “Odoo < 19: login is required” | Odoo 18 o anterior funciona con usuario y clave | rellene el campo “Usuario” |
| “login or API key rejected” | el usuario no es el dueño de la clave o la base de datos no es la correcta | compruebe el usuario; indique la base en la dirección con ?db= |
| “blocked: private or reserved address” | Odoo está en una red local, no en internet | abra el acceso a Odoo desde internet con un dominio |
| “Odoo: error de API — stock.warehouse” | Odoo no tiene la aplicación Inventario | instale la aplicación o desmarque la casilla “Almacenes” |
| “Odoo: error de exportación product.supplierinfo” | el usuario de Odoo dueño de la clave no tiene permisos sobre los precios de compra | dele permisos de compras o desmarque la casilla “Vínculos con proveedores”; la pestaña “Compra” de la ficha aparece con la aplicación Compra |
| productos sin fotos | la casilla “Fotos” se activó después de la primera ejecución | las fotos solo llegan a fichas nuevas; añada fotos a las existentes en Elbuz o elimine las fichas y repita |
Preguntas frecuentes
¿Se pueden exportar pedidos de Elbuz a Odoo?
No. Los pedidos solo van de Odoo a Elbuz (pedidos de venta).
¿Elbuz actualiza el stock en Odoo?
No. El sistema principal para el almacén es Odoo; Elbuz solo replica su stock (stock por almacén).
¿Qué versiones de Odoo se admiten?
Odoo 14–20: Community, Enterprise, Odoo.sh y Odoo Online en el plan Custom; probado en Odoo 18 y 20. Para Odoo 18 y anteriores también hace falta el usuario (qué se necesita).
He eliminado un producto en Odoo: ¿por qué sigue en Elbuz?
La ejecución solo trae los productos existentes y no desactiva nada. Desactive o elimine la ficha sobrante en la ventana “Productos” (nueva ejecución).
¿Se pueden conectar varias bases de datos de Odoo?
Sí, con una plantilla para cada una. Las fichas de bases distintas no se confunden: la clave del producto incluye la marca de la base.
¿Se envían a Odoo los atributos del producto?
No. La exportación envía el precio y, para los productos nuevos, nombre, referencia, código de barras, peso, descripción, categoría y foto (qué exportar).
Un producto en varias categorías del sitio web de Odoo: ¿a cuál irá?
A la más profunda. Las demás categorías del sitio web no se transfieren (casillas).
Dónde está y quién tiene acceso
- Menú
- Datos maestros → Operaciones → Importación de datos (desde Odoo) y Exportación de datos (hacia Odoo)
- Plantilla
- plantilla nueva → tipo “Odoo”; una plantilla, una base de datos de Odoo
- Permiso de acceso
- ventanas “Importación de datos” y “Exportación de datos” en “Permisos de grupos”
- Qué preparar
- dirección de Odoo y clave API; para Odoo 18 y anteriores, también el usuario
1
Dirección de Odoo2
Usuario3
Clave API de Odoo4
Comprobar conexión- Dirección de Odoo — la dirección de su Odoo; para una base propia se añade ?db=nombre.
- Usuario — solo hace falta para Odoo 18 y versiones anteriores.
- Clave API de Odoo — la clave creada en las preferencias del usuario de Odoo.
- Comprobar conexión — verifica los datos introducidos sin lanzar la importación.
Cómo funcionan en general las plantillas de importación: resumen de la importación de datos.
Temas relacionados
- Si necesita entender cómo trata una plantilla de importación cualquier origen de datos: Importación de datos al catálogo.
- Si las variantes de Odoo deben cambiarse en el sitio web por colores y tallas: Familias de productos.
- Si los precios de Elbuz deben llegar a Odoo de forma programada: Plantillas de exportación.
- Si aún no hay vínculos con proveedores: Conectar y cargar una lista de precios.
