↑↓ seleccionarEnter abrirEsc cerrar

    1. Elbuz

    Cómo conectar Odoo a Elbuz

    13 min de lecturaActualizado

    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

    Qué va en cada sentido:

    Dos plantillas con una misma clave API: la importación trae de Odoo todo lo que Odoo gestiona como sistema principal y la exportación envía a Odoo lo que calcula Elbuz
    ElbuzOdooPlantilla “Odoo” en “Importación de datos”Plantilla “Odoo” en “Exportación de datos”Productos y variantes: fichas de una misma familiaCategorías, atributos, fotos y galeríaAlmacenes y stock en cada almacénProveedores, como contactosPedidos de venta, como “Pedido de cliente”Precios que han cambiadoProductos nuevos con categoría y fotoVínculos con proveedores, pestaña “Compra”Descripciones, SEO y datos principales, por casilla
    • Запит або дія
    • Примітка

    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óndeQué hacer
    OdooAvatar en la esquina superior derecha → Mis preferencias → pestaña Seguridad → bloque “Claves API” → Create API Key
    Ahí mismoConfirmar la contraseña, escribir una descripción (por ejemplo, “Elbuz”) y la caducidad
    Ahí mismoCopiar la clave: Odoo la muestra una sola vez
    ElbuzPlantilla “Odoo” → tarjeta “Conexión” → dirección, clave (y usuario para Odoo 18 y anteriores) → “Guardar” → “Comprobar conexión”
    Pestaña «Seguridad» en las preferencias de usuario de Odoo: claves API con el botón Create API Key
    1Pestaña «Seguridad»
    2Botón «Create API Key»
    1. Pestaña «Seguridad» de la ventana «Cambiar mis preferencias» (avatar → «Mis preferencias»).
    2. 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

    1. 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.
    2. 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.
    3. 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.

    CasillaQué llega
    Productosfichas de productos y variantes (campos)
    Categoríascategoría del producto: la del sitio web de Odoo o, si no hay sitio, la categoría interna de Odoo; funciona junto con “Productos”
    Atributosejes de variante como atributos de opción y los demás atributos; junto con “Productos” (variantes)
    Fotosfoto principal y galería del sitio web de Odoo; junto con “Productos” (fotos)
    Almacenesalmacenes de Odoo y el stock del producto en cada uno; sin “Productos”, actualiza el stock de las fichas ya importadas (almacenes)
    Pedidospedidos de venta como documentos “Pedido de cliente” (pedidos)
    Importar proveedores de Odoo como contactosproveedores en el grupo “Proveedor” (proveedores)
    Tarjeta «Selección de datos para importar» de la plantilla de Odoo con las casillas de datos
    1Productos
    2Almacenes
    3Proveedores de Odoo como contactos
    1. Productos — importa los productos de Odoo con sus variantes.
    2. Almacenes — trae los almacenes de Odoo y el stock de cada producto por almacén.
    3. 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ónVolumenTiempo
    importación del catálogo con fotos3049 productos, 3039 fotos8 s
    importación completa al catálogo de Elbuz3054 productos y 24 pedidos37 s; repetición: 23 s
    exportación de todos los precios3000 productos22 s
    exportación diaria de precios3000 productos, 100 cambiados0,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 OdooCampo 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 barrasCódigo de barras (solo dígitos)
    precio de venta de la variantePrecio
    cantidad disponible (con la aplicación Inventario)Stock; el negativo pasa a cero
    pesoPeso
    descripción de ventaDescripción corta
    descripción para el sitio web de Odoo, título y descripción SEODescripció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.
    Ficha del producto con las características de la variante: color y patas
    1Color
    2Legs
    1. Color — la opción de la variante, aquí con el valor White.
    2. 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.
    Lista de almacenes con los tres almacenes reflejados desde Odoo
    1YourCompany
    2Kyiv WH
    1. YourCompany — un almacén de Odoo, copiado como almacén propio.
    2. 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 OdooEn el documento de Elbuz
    línea de productolínea del documento vinculada a la ficha; precio con el impuesto y el descuento de la línea
    línea de envíoimporte del envío (no es una línea de producto)
    secciones y notas del pedidono se transfieren
    clientenombre, email, teléfono
    dirección de entregaciudad, país, código postal, dirección; si no hay una aparte, se toma la del cliente
    nota y referencia del clientecomentario del documento
    estado del pedido y de la facturaestado 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”:

    CasillaQué hace en Odoo
    Productosactualiza el precio de los productos vinculados, solo de los que ha cambiado (precios de variantes)
    Publicar productos nuevoscrea los productos que aún no están en Odoo: nombre, precio, referencia, código de barras, peso, descripción corta
    Categoríasasigna categoría al producto nuevo y la crea en Odoo según su ruta
    Fotosenvía la foto principal del producto nuevo
    Vínculos con proveedoresrellena la pestaña “Compra” (detalles); activada por defecto
    Descripciones y SEOa 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.

    Tarjeta «Qué exportar» de la plantilla de exportación de Odoo con las casillas de datos que se envían
    1Productos
    2Publicar productos nuevos
    3Vínculos con proveedores
    4Descripciones y SEO
    1. Productos — envía a Odoo los precios de los productos ya vinculados.
    2. Publicar productos nuevos — crea en Odoo los productos que aún no existen allí.
    3. Vínculos con proveedores — transfiere a la pestaña «Compra» del producto los proveedores de las listas de precios.
    4. 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 OdooOrigen
    Proveedorproveedor de la lista de precios; si no está en Odoo, se crea como empresa proveedora
    Código y nombre del producto del proveedorreferencia y nombre del producto en la lista de precios
    Precio y monedaprecio 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 entreganúmero de días del plazo de entrega de la lista de precios
    Pestaña «Compra» de un producto de Odoo con los proveedores que exportó Elbuz
    1Pestaña «Compra»
    2Líneas de proveedores
    1. Pestaña «Compra» de la ficha de producto de Odoo.
    2. 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 veCausaQué hacer
    “Invalid apikey”la clave ha caducado, se ha revocado o no se copió enteracree 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 claverellene 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 correctacompruebe el usuario; indique la base en la dirección con ?db=
    “blocked: private or reserved address”Odoo está en una red local, no en internetabra el acceso a Odoo desde internet con un dominio
    “Odoo: error de API — stock.warehouse”Odoo no tiene la aplicación Inventarioinstale 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 compradele 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 fotosla casilla “Fotos” se activó después de la primera ejecuciónlas 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
    Tarjeta «Conexión» de la plantilla de importación de Odoo con los tres campos y el botón de comprobación
    1Dirección de Odoo
    2Usuario
    3Clave API de Odoo
    4Comprobar conexión
    1. Dirección de Odoo — la dirección de su Odoo; para una base propia se añade ?db=nombre.
    2. Usuario — solo hace falta para Odoo 18 y versiones anteriores.
    3. Clave API de Odoo — la clave creada en las preferencias del usuario de Odoo.
    4. 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

    ¿Le resultó útil este artículo?

    ¿Falta una función? Escríbenos.

    La añadimos gratis si también les sirve a otros.

    Si solo la necesitas tú, lo acordamos aparte.

    Contenido del artículo

    Proponer una mejora

    Prueba Elbuz gratis