El stock de WooCommerce y Odoo no coincide: cómo encontrar la causa
Compara la misma variante, almacén y momento. Reconstruye reservas, ventas y actualizaciones antes de sobrescribir existencias o reimportar el catálogo.
Cuando el stock de WooCommerce y Odoo no coincide, comprueba que ambos valores se refieren a la misma variante, al mismo almacén y a una definición equivalente de disponibilidad. Una diferencia puede representar reservas o una venta reciente; también puede revelar un fallo de correspondencia o una actualización que no llegó.
Esta guía aborda la investigación de una discrepancia. Para definir la conexión desde el principio, consulta qué preparar antes de sincronizar WooCommerce con Odoo.
1. Elegir una referencia y fijar el momento de comparación
Anota SKU, identificadores de ambos sistemas, variante y cantidades observadas con su hora. No compares una captura del ERP de ayer con el catálogo actual. Si hay operaciones simultáneas, registra también la última actualización aplicada por el conector.
Un ejemplo hipotético: el almacén tiene diez unidades físicas, tres están reservadas y la tienda muestra siete vendibles. Esa diferencia puede ser correcta si esa es la regla acordada. El problema aparece cuando no puedes explicar cómo se calculó cada valor.
2. Verificar producto, variante y unidad
Comprueba que el identificador de origen apunta al registro de destino previsto. Una referencia repetida, una variante sin SKU o una correspondencia antigua puede actualizar el artículo equivocado.
Revisa packs y unidades de medida. Un sistema puede representar cajas y otro unidades; copiar la cantidad sin transformar su significado produce un error aunque la petición termine correctamente. Los casos ambiguos deben quedar pendientes de revisión.
3. Separar stock físico, reservado y vendible
Odoo documenta distintos métodos de reserva. La configuración de tu operación determina cuándo se reserva mercancía; no conviene asumir que un único campo representa todo lo disponible para la web.
Identifica qué almacenes abastecen WooCommerce y si otras tiendas comparten existencias. Define cómo afectan ventas, devoluciones y ajustes manuales al valor publicado. Revisa la fórmula con la persona responsable de inventario antes de cambiarla.
4. Reconstruir movimientos y actualizaciones
Ordena los eventos de la referencia: venta web, reserva, preparación, cancelación, reposición y actualización del conector. Registra qué sistema originó cada movimiento y cuál lo aplicó después.
Si ambos sistemas descuentan una venta y además reciben una actualización absoluta, comprueba si el flujo produce un doble descuento. Si llegan eventos fuera de orden, una cantidad antigua puede reemplazar una nueva. El diseño debe diferenciar movimientos incrementales de cantidades completas.
5. Revisar ejecución y recuperación
Consulta errores, tareas pendientes y última operación completada. Si el flujo utiliza webhooks, los registros de WooCommerce ayudan a investigar su entrega; también hace falta comprobar el resultado en el consumidor y en el ERP.
Un reintento debe conservar la identidad de la operación. Repetir un movimiento de inventario como si fuera nuevo puede alterar la cantidad; reenviar un valor completo tampoco es inocuo si pertenece a un momento anterior.
6. Reconciliar antes de corregir en bloque
Prepara una lista de diferencias con referencia, valor de origen, valor de destino, hora y motivo conocido. Separa problemas de correspondencia de diferencias temporales o reglas de disponibilidad.
Corrige primero una muestra y comprueba venta, cancelación y actualización posterior. Una reimportación de todo el catálogo puede ocultar la causa durante unas horas y afectar campos que no necesitaban cambios. Guarda valores anteriores y limita el alcance de la corrección.
Cómo comprobar que la solución se mantiene
Repite la comparación tras varias operaciones normales y una interrupción controlada. Mide discrepancias, antigüedad de tareas pendientes y casos que requieren intervención. La prueba debe mostrar recuperación, no solo igualdad en una captura.
Para revisar el recorrido, consulta la integración de WooCommerce con ERP, la automatización de pedidos y las integraciones mediante API. Nuestro artículo sobre criterios de sincronización WooCommerce–ERP explica cómo repartir responsabilidades.