Stock y sincronización¶
El conector mantiene el stock de tus productos sincronizado entre Odoo y MercadoLibre. Esta página explica el modelo: quién manda sobre qué, cuándo se actualiza y cómo se reparte el stock entre depósito propio y Fulfillment.
Para activar la sincronización paso a paso, ver Configurar la sincronización de stock.
La regla de oro: Odoo es la fuente de verdad¶
El stock se gestiona en Odoo. MercadoLibre es un destino, no un origen. El flujo es unidireccional para cambios de stock:
- Odoo → MercadoLibre: cada vez que el stock de un SKU cambia en Odoo (entrega, recepción, ajuste de inventario, devolución), el conector empuja la nueva cantidad a todas las publicaciones MercadoLibre que tengan ese SKU.
- MercadoLibre → Odoo: los caminos de vuelta son las ventas (descuentan stock al validar la transferencia de salida), las cancelaciones de ventas ya despachadas (ver Cancelaciones) y las devoluciones físicas post-entrega (ver Devoluciones). En todos los casos generan una transferencia de devolución que reincorpora el stock al validar la recepción física.
Cambios manuales en MercadoLibre se sobrescriben. Si alguien modifica el stock de un producto desde el panel MercadoLibre o desde otra integración externa, ese cambio queda inválido al próximo movimiento de stock en Odoo. Si necesitás cambiar el stock, hacelo en Odoo o pausá temporalmente la sincronización del producto.
Cuándo se actualiza el stock en MercadoLibre¶
Cada movimiento de stock en Odoo dispara la actualización al instante:
- Validación de una transferencia de salida (venta).
- Validación de una recepción (compra, transferencia interna).
- Ajuste manual de inventario.
El cambio aparece en MercadoLibre en segundos. La sincronización es reactiva — no depende de un cron periódico para llegar a MeLi.
Conciliación de respaldo (cada 30 minutos)¶
Como red de seguridad, cada 30 minutos corre una conciliación automática que compara el stock real de Odoo contra lo que MercadoLibre tiene publicado y reenvía cualquier diferencia. Es invisible para el usuario y no requiere configuración. Solo entra en juego cuando un cambio reactivo no llegó a MeLi por un fallo puntual (red, sidecar reiniciándose, etc.) — en operación normal no detecta nada que corregir.
Los tres niveles de control¶
El conector tiene tres niveles para activar/desactivar la sincronización, de más general a más específico:
Interruptor general (sí/no)
↓
Producto activo (sí/no) — todas las variantes del producto
↓
Variante activa (sí/no) — variante específica
Los tres niveles deben estar activos para que un SKU sincronice. Por defecto todo está desactivado — solo los productos que vos activás llegan a MercadoLibre.
Esto permite operar incrementalmente: empezar con pocos productos, validar que todo anda y después ir activando el resto.
Para los pasos concretos, ver Configurar la sincronización de stock.
El caso Fulfillment (Full)¶
En productos vendidos por Fulfillment, el stock no vive en el depósito del vendedor — vive en los depósitos de MercadoLibre. El conector lo modela así:
- Las ventas Fulfillment descuentan stock de un depósito virtual configurado en MercadoLibre → Configuración → Depósitos.
- El depósito propio del vendedor no se toca para esas ventas.
- Eso da trazabilidad contable de lo vendido por Full sin mezclar con el stock físico.
Para configurar el depósito Fulfillment, ver Configurar depósitos.
Requisitos del producto¶
Para que un SKU pueda sincronizar, además de las activaciones, el producto debe cumplir:
- Tener referencia interna (SKU) cargada en Odoo.
- Ser de tipo Consumible (los servicios no manejan stock).
Conceptos relacionados¶
- Configurar la sincronización de stock — pasos para activar.
- Tipos de logística — qué tipos de venta tocan qué depósito.