Vinculación de productos
La vinculación por SKU
Para que las sincronizaciones funcionen, cada producto de Odoo tiene que estar vinculado con su publicación de Mercado Libre. Odumbo hace esa vinculación por SKU: el código alfanumérico que identifica al producto en los dos sistemas.
Odumbo no crea publicaciones en Mercado Libre ni en Tiendanube, y tampoco crea productos automáticamente en Odoo. Las publicaciones se crean previamente en cada plataforma y los productos tienen que existir antes en tu base. Entonces, la vinculación de los productos entre sistemas exige dos cosas: que el producto exista en Odoo y que la publicación exista en el canal de venta. Cuando el identificador de los dos coincide, Odumbo reconoce el producto y empieza a sincronizar la información.
Hay dos formas de vincular, y eliges una en el campo Emparejar producto por de la integración:
- Referencia interna: el SKU de la publicación de Mercado Libre tiene que coincidir con el campo Referencia interna (código interno) del producto en Odoo. En Odoo, navega a Ventas ▸ Productos ▸ Productos y abre el producto para verlo.
- Código de barras: el SKU de la publicación tiene que coincidir con el campo Barcode (código de barras) del producto en Odoo.
Los productos se conectan entre Odoo y Mercado Libre por coincidencia de SKU entre las dos plataformas. Si no hay match de SKU, no hay trazabilidad de ventas.
Múltiples publicaciones de un mismo producto
El SKU es el elemento clave de la integración: es lo que vincula un producto de Odoo con una o varias publicaciones de Mercado Libre.
Un mismo producto puede estar asociado a varias publicaciones diferentes, siempre que todas tengan el mismo SKU configurado. Puedes tener, por ejemplo, varias publicaciones del mismo producto con distintas condiciones comerciales —tipo de publicación, cuotas, estrategia de visibilidad—, y todas comparten el mismo stock centralizado en Odoo. Cuando se vende una unidad en cualquiera de esas publicaciones, el stock se descuenta en Odoo y se actualiza automáticamente en todas las publicaciones vinculadas.
Productos con variantes
Mercado Libre tiene limitaciones al definir variantes en sus publicaciones, y esas limitaciones se trasladan a la sincronización.
| Requisito | Por qué |
|---|---|
| Todas las variantes de la publicación deben tener SKU establecido | Sin SKU no hay con qué aparear |
| Cada SKU de variante debe tener correspondencia en Odoo | Puede ser un producto o una variante de producto con ese valor en la referencia interna o en el código de barras |
| Todas las variantes de una misma publicación deben tener el mismo precio en Odoo | Mercado Libre no permite que las variantes de una publicación tengan distinto precio: si difieren, no se sincroniza el precio de ninguna variante |
En Odoo, cada variante puede tener su propia Referencia interna: la ves en la pestaña "Variantes" del producto. Con eso Odumbo sincroniza la variante específica de Odoo con la variante correspondiente de Mercado Libre, siempre que los SKU coincidan.
Productos de tipo Pack
Si tienes packs configurados en Odoo, se sincronizan con una publicación de Mercado Libre igual que cualquier otro producto, mientras cumplan con los requisitos de SKU y de precio de las secciones anteriores.
Base de productos inicial
La sincronización funciona por SKU, así que los productos necesitan ese identificador antes de empezar. Hay dos formas de armar la base inicial.
| Opción | Cómo se hace |
|---|---|
| Opción 1 (recomendada) | Cargar o importar la base de productos en Odoo —por ejemplo, con un Excel—, incluyendo SKU, nombre, stock y precio. |
| Opción 2 | Importar las publicaciones existentes desde Mercado Libre y después vincularlas con los productos en Odoo. |
La recomendación es que Odoo sea la base principal de productos y que Mercado Libre se sincronice contra esa información.
Configurar el criterio de emparejamiento
Define con qué campo de Odoo se aparea el SKU de la publicación.
Prerequisitos
- Un usuario del portal de Odumbo con acceso a la configuración de la integración.
- Los productos de Odoo con la referencia interna o el código de barras completos.
Para configurar el emparejamiento:
- En la configuración de la integración, ubica el campo "Emparejar producto por".
- Elige Referencia interna o Código de barras.
- Define en la publicación de Mercado Libre un código alfanumérico como SKU.
- Define el mismo código en el campo elegido del producto de Odoo.
- Guarda.
Desde la siguiente sincronización, Odumbo aparea las publicaciones con los productos por ese campo.
Solución de problemas
Una publicación no se sincroniza y no aparece en ningún resultado
El problema no produce un mensaje de error propio: la publicación no figura en los resultados del test ni en el historial de cambios de la sincronización.
Ocurre cuando el SKU de la publicación está vacío, o cuando no coincide con el campo de Odoo elegido en Emparejar producto por. Sin coincidencia, Odumbo no reconoce el producto y no hay trazabilidad de sus ventas.
Para resolverlo, compara el SKU de la publicación con la referencia interna (o el código de barras) del producto en Odoo y ajusta el que esté mal. Si la venta ya entró, va a haber llegado con el producto genérico: ver la venta se creó con un producto genérico.
El precio de una publicación con variantes no se actualiza
El problema no produce un mensaje de error en la publicación: ninguna variante actualiza su precio.
Ocurre cuando las variantes de una misma publicación tienen precios distintos en Odoo. Mercado Libre no admite precios distintos entre las variantes de una publicación, así que Odumbo no sincroniza el precio de ninguna.
Para resolverlo, iguala en Odoo el precio de todos los productos o variantes asociados a las variantes de esa publicación.
Antes de abrir un ticket
Adjunta:
- El nombre de la integración y el usuario con el que operas.
- El ID de la publicación de Mercado Libre y su SKU.
- La referencia interna o el código de barras del producto en Odoo.
- El valor del campo Emparejar producto por de la integración.
- Un video y las imágenes al detalle del error que observas.