Sincronización de stock
Sincronización de stock de Odoo a Tienda Nube
La sincronización de stock replica en Tienda Nube las cantidades que Odoo calcula, con dos límites:
- Un solo sentido: el stock viaja siempre de Odoo hacia Tienda Nube, nunca al revés.
- Uno a uno (1:1): un almacén de Odoo contra un almacén (o centro de distribución) de Tienda Nube. No hay sincronizaciones multi-almacén cruzadas.
Cualquier transacción cotidiana en Odoo (compras de reabastecimiento, órdenes de fabricación o ventas concretadas por otros canales) impacta de inmediato en las cantidades disponibles en Odoo, y Odumbo replica automáticamente ese nuevo balance en Tienda Nube.
Stock de seguridad
El stock de seguridad es una cantidad por producto que Odumbo reserva y no publica en Tienda Nube. Sirve para resguardar unidades de forma preventiva ante despasajes o imprevistos.
Ejemplo práctico: si cuentas con un stock real de 125 unidades en Odoo y configuras un stock de seguridad de 25 unidades, Odumbo solo envía y muestra un stock disponible de 100 unidades en Tienda Nube.
Cálculo del stock que se sincroniza
Odoo calcula la cantidad final que se envía a Tienda Nube a partir de tres métricas del reporte pronosticado del producto.
| Métrica | Qué representa | Entra en el cálculo |
|---|---|---|
| A la mano | Stock físico real que está en el almacén en ese momento. | Sí, suma |
| Saliente | Unidades comprometidas en pedidos de venta pendientes de entregar. Se restan para evitar sobreventas. | Sí, resta |
| Entrante | Unidades de órdenes de compra pendientes de recibir, todavía en tránsito. | No |
La fórmula que aplica el sistema es:
Stock Sincronizado = Cantidad "A la mano" - Cantidad "Saliente"
Ejemplo práctico: si un producto tiene 17 unidades A la mano y 2 unidades Salientes, el cálculo da 15 unidades, y ese es el stock final que Odumbo sincroniza en los canales de venta.
Para la sincronización de stock NO se tiene en cuenta la cantidad Entrante. Como esos productos están en tránsito y no hay previsibilidad exacta de su recepción, no pueden considerarse cantidades vendibles aún.
Requisitos de la sincronización de stock
Sin estas cuatro condiciones la sincronización no llega a impactar cantidades en Tienda Nube.
| Requisito | Dónde | Detalle |
|---|---|---|
| Un solo almacén por integración | Odoo y Tienda Nube | La relación es 1:1. Con varios depósitos físicos, consolida el stock en un almacén virtual de Odoo. |
| Criterio de lectura del stock | Odoo | La ubicación principal ("Existencias") toma la sumatoria total del stock disponible en la ubicación raíz y en todas sus sub-ubicaciones hijas. Una sub-ubicación específica restringe la sincronización a lo disponible en ese sector (por ejemplo, una estantería exclusiva para ventas online). |
| Seguimiento de stock numérico | Tienda Nube | Los productos deben tener habilitada la contabilidad de inventario, no el modo de stock infinito. |
| Al menos un centro de distribución | Tienda Nube | Es el destino donde Odumbo impacta los niveles de stock. |
Verificar los almacenes en Odoo y en Tienda Nube
Constata qué almacenes existen en cada plataforma antes de elegir el par que se va a integrar.
Prerequisitos
- Acceso a la base de datos de Odoo y al panel de administración de Tienda Nube.
Para verificar los almacenes:
- En Odoo, ve al menú "Inventario > Configuración > Almacenes". La pantalla lista todos los almacenes creados en la base de datos (por ejemplo, "Mueblería ARG"). Recuerda que solo vas a poder seleccionar uno para la integración.
- En el panel de Tienda Nube, donde los almacenes se llaman Centros de distribución, ve a "Configuración > Centros de distribución".
Al terminar tienes identificado el almacén de Odoo y el centro de distribución de Tienda Nube que vas a vincular.
Si no ves ningún centro de distribución creado, da de alta al menos uno con el botón "Agregar nuevo". Sin eso, Odumbo no tiene destino donde impactar el stock.
Configurar la sincronización de stock
Define desde dónde toma Odumbo el stock en Odoo y hacia dónde lo envía en Tienda Nube, sin tocar la tienda real.
Prerequisitos
- Acceso al panel de Odumbo, con la cuenta de Tienda Nube ya conectada. Ver Conectar Odumbo a Tienda Nube.
- El almacén de Odoo y el centro de distribución de Tienda Nube ya identificados.
Para configurar la sincronización de stock:
- En la parte superior de la interfaz de la integración, ubica el botón "Producción" y haz clic para cambiar al modo "Sandbox". La integración se detiene momentáneamente y pasa al modo de pruebas de forma segura.
- En la sección Sincronización de Stock, en el campo Ubicación de Stock (Odoo), haz clic en el ícono de la lupa para desplegar las ubicaciones disponibles en tu Odoo. Identifica el número de ID de la ubicación de tu almacén principal (por ejemplo, la ubicación Existencias del depósito central), cópialo y pégalo en el campo de texto.
- En el campo Tiendanube Location (Destino), haz clic en la lupa para ver los centros de distribución creados en Tienda Nube. Identifica el almacén de destino (por ejemplo, "Centro"), copia su código alfanumérico identificador (ID) y pégalo en el campo.
- Haz clic en el botón de guardar de la sección.
La integración queda configurada en modo de pruebas, lista para el test.
Mientras estés en modo Sandbox, todas las acciones de sincronización son simulaciones y no afectan a tu tienda real en Tienda Nube.
Probar la sincronización de stock
Valida el comportamiento del conector sobre productos concretos antes de activarlo.
Prerequisitos
- La configuración de ubicaciones guardada y la integración en modo Sandbox.
- El código SKU de al menos un producto vinculado.
Para probar la sincronización de stock:
- En el panel de Sincronización de Stock, haz clic en el botón "Test". Se abre una ventana flotante llamada Stock Synchronization.
- En el campo de texto, escribe el código SKU del producto que quieres
verificar (por ejemplo:
FURN_0002). Para probar varios artículos a la vez, ingrésalos separados por comas. - Haz clic en el botón "Test Stock".
El sistema devuelve un mensaje con la cantidad de existencias detectadas en Odoo y cómo se actualizarían en Tienda Nube:
updated stock quantity: 0 -> 15
Puedes modificar el stock directamente en tu Odoo ingresando al producto en "Inventario > Productos > Productos", actualizando la cantidad en la ubicación configurada y volviendo a ejecutar el test en Odumbo para comprobar que los cambios impacten correctamente en la simulación.
Verificar el nivel de stock que sincroniza Odumbo
Comprueba en la ficha del producto de Odoo qué cantidad va a tomar Odumbo, cuando el valor sincronizado no coincide con tus estimaciones.
Prerequisitos
- Acceso a la ficha del producto en la base de datos de Odoo.
Para verificar el nivel de stock:
- En Odoo, entra al producto en cuestión.
- Haz clic en el botón inteligente "Pronosticado", en la parte superior del formulario del producto.
- Selecciona el almacén específico que quieres consultar (por ejemplo, Mueblería ARG).
- Lee las tres métricas del margen derecho y aplica la fórmula de cálculo.
El resultado de la fórmula es la cantidad que Odumbo publica en Tienda Nube. Si coincide con lo que muestra la tienda, la sincronización está funcionando.
Activar la sincronización en Producción
Pasa la sincronización de stock a tiempo real, sobre datos reales.
Prerequisitos
- Pruebas de simulación con resultados de stock esperados.
- La integración en modo Sandbox.
Para activar la sincronización de stock:
- Cierra la ventana de pruebas (Test).
- Haz clic en el botón superior "Sandbox" para devolver la integración al modo "Producción".
- Haz clic en el botón "Activar sincronización".
Desde ese momento, el 100% de los productos vinculados empieza a actualizar su stock de forma automática. Puedes monitorear cada movimiento y ejecución en la sección de "Historial", en el menú superior de Odumbo.
Solución de problemas
Odumbo no actualiza las cantidades de un producto en Tienda Nube
Este problema no produce un mensaje de error: el producto conserva su cantidad anterior en la tienda.
Ocurre cuando el producto está configurado en modo de "stock infinito", que es como Tienda Nube suele configurar los productos por defecto. Mientras permanece en esa modalidad, Odumbo no puede actualizar sus cantidades.
Para resolverlo, edita el producto en Tienda Nube y ponle un stock inicial (por ejemplo, 0), que es lo que activa la contabilidad de inventario.
Antes de abrir un ticket
Adjunta:
- El SKU del producto y la cantidad que esperabas ver.
- La ventana de resultados del botón "Test Stock", completa.
- La captura del reporte "Pronosticado" del producto en Odoo, con el almacén seleccionado.
- El almacén de Odoo y el centro de distribución de Tienda Nube configurados en la integración.