Sincronización de stock
La sincronización de stock
La sincronización de stock es el proceso que refleja en las publicaciones de Mercado Libre las existencias que tienes en Odoo. Funciona en un solo sentido: de Odoo hacia Mercado Libre y no al revés.
Odumbo realiza una sincronización cada una cierta cantidad de minutos y, en cada una, busca los niveles de stock de los productos dentro de la Ubicación de stock que hayas configurado y los actualiza en cada publicación de MercadoLibre. Solo se sincronizan los niveles de stock de las publicaciones cuyo SKU coincide con el SKU (referencia interna) de los productos de Odoo.
El valor que Odumbo publica es el stock previsto inmediato: las unidades a mano menos las unidades ya reservadas por ventas, siempre dentro de la ubicación configurada. La diferencia con el stock previsto es que el previsto inmediato no tiene en cuenta las unidades "por comprar".
El stock se descuenta aunque no factures: al confirmar la venta, Odoo reserva automáticamente las unidades vendidas.
La sincronización de stock implica que la información de inventario de Odoo es la que predominará y se enviará para actualizar las publicaciones en Mercado Libre.
Stock centralizado entre publicaciones
El stock se maneja de forma centralizada en Odoo: un mismo producto puede estar asociado a varias publicaciones de Mercado Libre y todas comparten el mismo stock.
Si el producto tiene 10 unidades en Odoo, todas las publicaciones muestran disponibilidad basada en ese mismo stock. Si se venden 5 unidades en una publicación, el sistema descuenta el stock en Odoo y actualiza automáticamente el stock disponible en las demás publicaciones. Eso evita inconsistencias entre publicaciones y da un único control de inventario.
Mercado Libre Full y Flex
Odumbo no sincroniza el stock Full: el stock real de las publicaciones Fulfillment lo define Mercado Libre. Para reflejarlo en Odoo, la práctica es crear un almacén virtual llamado "Full" que represente el stock disponible en los almacenes de Mercado Libre. Cada vez que envías mercadería a los almacenes de Mercado Libre, en Odoo haces una transferencia interna del almacén normal al Almacén FULL; cuando se vende un producto Full, Odumbo sincroniza esa venta y el stock del Almacén FULL se reduce automáticamente.
Una vez creado ese almacén, indica su ID en el campo ID almacén Fullfilment de la integración.
Las publicaciones FULL y FLEX son las que se entregan en 24 hs y pueden enviarse por Mercado Libre o por ti. Si quieres actualizar el nivel de stock de "En tu depósito", activa la opción Stock Flex en Odumbo. Si el producto o alguna de sus variantes queda sin stock disponible, Mercado Libre quita el Envío Flex de la publicación y esta opera solo por Fulfillment.
Tienes que tener activada la opción de Envío Flex dentro de tu cuenta de Mercado Libre para que Odumbo pueda sincronizarlas correctamente. Más información en el sitio de Mercado Envíos Flex.
Odumbo buscará periódicamente el stock registrado en el almacén principal de Odoo y lo actualizará en las publicaciones de Mercado Libre. El stock de ventas Fullfilment es gestionado directamente por Mercado Libre.
Parámetros de la sincronización de stock
Los dos parámetros de la sincronización de stock, una vez activada.
| Parámetro | Qué se completa |
|---|---|
| Stock Location | La ubicación de stock de tu almacén de Odoo de la que se toman las existencias. Haz clic en el ícono de la lupa para ver la lista de ubicaciones disponibles. En Odoo, navega a Inventario ▸ Configuración ▸ Almacenes y ubica la ubicación de existencias de tu almacén físico (por ejemplo, ART/Existencias): el valor a ingresar es el ID de esa ubicación. |
| Stock Flex | Actívalo si tienes publicaciones de tipo Flex además de las de tipo Full y necesitas que el stock de las primeras también se sincronice. Si todas tus publicaciones son de un solo tipo, no hace falta activarlo. |
Las existencias de almacenes de tipo Fulfillment (gestionadas por Mercado Libre) no se sincronizan desde Odoo, ya que Mercado Libre actualiza su propio stock.
Si gestionas ventas Fullfilment, conviene crear un segundo almacén en Odoo para distinguir el inventario destinado a ese tipo de ventas.
Stock de varios almacenes de Odoo
Puedes sincronizar stock de varios almacenes de Odoo, con una sola combinación soportada.
| Escenario | Qué se puede hacer |
|---|---|
| Múltiples almacenes de Odoo con 1 solo almacén de MercadoLibre | Creas en tu base de Odoo un almacén virtual "padre" que englobe varios de tus almacenes reales, y en el campo Ubicación de stock de la integración indicas la ubicación de ese almacén padre. Odumbo contabiliza como stock disponible la suma total del stock de todos los almacenes hijos, y ese es el nivel que sincroniza en la publicación de MercadoLibre. El almacén padre virtual solo puede englobar almacenes hijos que pertenezcan todos a la misma Empresa que él. |
| Múltiples almacenes de Odoo con múltiples almacenes de MercadoLibre (publicaciones tipo User Product de ML) | Por el momento, Odumbo no soporta este tipo de publicaciones. |
Cómo se configura el almacén padre virtual está en la documentación de Adhoc sobre almacenes.
Reglas de stock mínimo y de cantidad por compra
Las reglas que evitan sobreventas y limitan cuánto puede comprar un cliente en una sola orden.
| Regla | Qué hace |
|---|---|
| Stock mínimo | Puedes configurar reglas de stock mínimo para evitar sobreventas. Cuando el stock llega a ese mínimo, el sistema puede pausar publicaciones, limitar disponibilidad o actualizar automáticamente el stock publicado, según la configuración elegida. |
| Cantidad máxima por compra | En productos con restricciones logísticas por peso —por ejemplo, bolsas de 20–25 kg— la práctica habitual es limitar la cantidad máxima por compra dentro de la publicación: permitir solo 1 unidad por orden evita que un cliente compre varias bolsas en un mismo pedido que después no puedan enviarse por Mercado Envíos. Se configura directamente en la publicación de Mercado Libre. |
Los productos pesados son el caso típico de esa segunda regla.
Configurar la sincronización de stock
Activa la sincronización de stock y define de qué ubicación se toman las existencias.
Prerequisitos
- Un usuario del portal de Odumbo con acceso a la configuración de la integración.
- La integración en modo Sandbox, para probar de forma segura.
- El ID de la ubicación de stock de Odoo que vas a sincronizar.
Para configurar la sincronización de stock:
- En la configuración de tu integración de Mercado Libre, desplázate hasta la sección "Sincronización de Stock".
- Activa la opción de sincronización de stock.
- Completa Stock Location con el ID de la ubicación de existencias.
- Activa Stock Flex si tienes publicaciones de tipo Flex.
- Guarda.
La integración queda lista para testear la sincronización de stock.
Probar la sincronización de stock
Simula la sincronización para verificar que la comunicación con Mercado Libre funciona, sin modificar nada.
Prerequisitos
- La sincronización de stock configurada y guardada.
Para probar la sincronización:
- Haz clic en el botón "Testear".
- Espera unos segundos mientras el proceso se ejecuta.
- Revisa la ventana de resultados.
Si el test es exitoso, ves el listado de publicaciones que se habrían
actualizado. Cada ítem muestra el número de identificación de la publicación, el
SKU (código interno) del producto y el detalle de cómo se actualizaría el stock,
por ejemplo updated stock quantity: 10 → 39.
El proceso de testeo es seguro y no modifica datos reales en tus publicaciones de Mercado Libre. Es solo una simulación para verificar que la comunicación es correcta.
Solución de problemas
El test de stock devuelve un mensaje de error
La ventana de resultados del test muestra un mensaje de error en lugar del listado de publicaciones actualizadas.
Ocurre cuando la integración no puede comunicarse con Mercado Libre o cuando la ubicación de stock configurada no es válida.
Para resolverlo, verifica que el ID de Stock Location corresponda a una ubicación de existencias real de tu almacén y vuelve a correr el test. Si el error persiste, contacta al equipo de soporte de Adhoc.
El stock de una publicación no se actualiza
El problema no produce un mensaje de error en la venta: la publicación conserva el stock viejo y el historial de cambios de la integración muestra una advertencia.
Ocurre cuando el SKU de la publicación no coincide con la referencia interna del producto en Odoo, cuando la publicación está pausada en Mercado Libre, o cuando el producto pertenece a un almacén Fulfillment, que Odumbo no sincroniza.
Para resolverlo, revisa la vinculación de productos y consulta el historial de cambios de la integración para ver qué publicación quedó afuera y por qué.
Antes de abrir un ticket
Adjunta:
- El nombre de la integración, el usuario y el número de sincronización.
- El ID de la publicación de Mercado Libre y el SKU del producto.
- La ubicación de stock configurada y el stock previsto inmediato que muestra Odoo.
- Un video y las imágenes al detalle del error que observas.