Forma Nodo

Sincronizar inventario de noche o por eventos: qué conviene a tu tienda

La pregunta no es técnica. Es cuánto tiempo puede estar mal el inventario de tu tienda sin que te cueste una venta. De ahí sale la arquitectura.

La pregunta real

Cuando alguien pide “sincronizar el inventario en tiempo real”, casi siempre quiere decir otra cosa: no quiere vender una pieza que ya no tiene. Esa es la pregunta útil. ¿Cuánto tiempo puede estar mal el número que ve tu clienta antes de que te cueste una venta o una disculpa?

Para una tienda que vende pocas unidades de cada SKU al día y tiene varias piezas de cada talla, unas horas de diferencia casi nunca importan. Para una tienda de piezas únicas, o con una venta física fuerte que comparte el mismo inventario, unos minutos pueden importar. La respuesta decide la arquitectura.

Tres formas de hacerlo

Nocturna Programada cada pocos minutos Por eventos, con conciliación
Cuánto puede estar mal Hasta un día Lo que dure el intervalo Segundos o minutos, casi siempre
Qué tan simple es La más simple Simple La más compleja
Qué se rompe Ventas entre corridas Límites de la API si el catálogo es grande Eventos perdidos, duplicados o fuera de orden
Reporte Uno por corrida, fácil de leer Muchos, hay que resumirlos Requiere su propio tablero

Sincronización nocturna

Un proceso corre una vez al día, normalmente de madrugada. Lee el inventario completo del sistema que manda, lo compara con Shopify y corrige las diferencias. Al terminar deja un reporte: qué cambió, qué no se pudo actualizar y por qué.

Tiene ventajas que no se ven a primera vista. Cada corrida revisa todo el catálogo, así que un error de ayer se corrige solo hoy. Es fácil de explicar, fácil de auditar y barata de operar. Y el reporte diario se vuelve la forma en que el equipo detecta problemas de datos en el origen.

El costo es el que ya imaginas: entre una corrida y otra, una venta en mostrador no se refleja en la tienda en línea.

Si la corrida vive en GitHub Actions, hay dos detalles de su documentación que conviene conocer. Las tareas programadas pueden retrasarse en momentos de mucha carga, sobre todo al inicio de cada hora, y si la carga es muy alta algunas pueden descartarse. Por eso conviene programarlas en un minuto poco común, no a las 00:00 en punto, y revisar que el reporte llegue. Además, en un repositorio público los workflows programados se desactivan solos después de 60 días sin actividad. GitHub ya acepta una zona horaria en la programación, así que la corrida puede expresarse en hora de la Ciudad de México en lugar de UTC.

Programada cada pocos minutos

Es la misma idea con un intervalo corto. Funciona bien con catálogos medianos, pero hay que respetar los límites de la API de Shopify. La API GraphQL Admin mide el uso en puntos por segundo según el plan: 100 en Standard, 200 en Advanced y 1,000 en Plus. Una mutación cuesta 10 puntos de base y los arreglos de entrada aceptan hasta 250 elementos por llamada. Un catálogo de miles de variantes actualizado completo cada cinco minutos puede chocar con esos límites. Lo razonable es enviar solo las diferencias.

Para cargas grandes existen las operaciones masivas, que no tienen los mismos límites de costo. Una importación masiva debe terminar en 24 horas y su archivo JSONL no puede pasar de 100 MB. Sirven para una corrida nocturna de un catálogo grande, no para un intervalo de minutos.

Por eventos

Aquí cada cambio dispara un aviso. En Odoo, una regla de automatización puede enviar una notificación por webhook cuando cambia un registro; su documentación la describe desde la versión 17. En Shopify, temas como inventory_levels/update u orders/create avisan cuando cambia un nivel de inventario o entra un pedido.

Suena ideal, y para algunos negocios lo es. Pero la documentación de Shopify es clara sobre sus límites:

  • La entrega de webhooks no está garantizada, y Shopify recomienda no depender solo de ellos y correr tareas de conciliación periódicas.
  • No garantiza el orden dentro de un mismo tema ni entre temas.
  • Un mismo webhook puede llegar más de una vez; hay que detectar duplicados con el encabezado X-Shopify-Webhook-Id.
  • Si tu servidor no responde a tiempo, Shopify reintenta 8 veces en 4 horas, y después de 8 fallas seguidas borra la suscripción si se creó por la API.

En la práctica, una sincronización por eventos bien hecha incluye también una sincronización completa programada que corrige lo que los eventos no alcanzaron. Por eso cuesta más construirla y mantenerla.

Lo que cambió en 2026 en la API de inventario de Shopify

Si alguien te muestra un ejemplo de código de hace un año, probablemente ya no funciona tal cual:

  • inventorySetQuantities es la mutación para cuando tu sistema es la fuente de verdad del inventario. Shopify recomienda inventoryAdjustQuantities en los demás casos.
  • Desde la versión 2026-04 de la API, las dos mutaciones exigen una llave de idempotencia, para que un reintento no aplique el mismo cambio dos veces.
  • En la versión 2026-10, el campo changeFromQuantity reemplazó a la comparación anterior y es obligatorio: hay que enviarlo aunque sea null. Si el valor ya no coincide con lo que tiene Shopify, la mutación falla en lugar de sobrescribir.

Esto no cambia la decisión entre nocturna y por eventos, pero sí el presupuesto de cualquier integración que se escribió con la API anterior.

Cómo lo decidimos

Estas preguntas nos dan la respuesta en casi todos los casos:

  1. ¿Cuántas unidades hay de cada variante? Con piezas únicas o tallas de una sola unidad, el riesgo de vender algo que ya no está es alto, y conviene un intervalo corto o eventos.
  2. ¿Hay venta física con el mismo inventario? Si sí, cada hora de retraso es una oportunidad de vender dos veces la misma pieza.
  3. ¿Cuántas ventas por día tiene el SKU que más se vende? Si son pocas, una corrida nocturna rara vez falla.
  4. ¿Quién va a leer el reporte? Una corrida nocturna con un reporte que alguien lee vale más que una sincronización en tiempo real que nadie vigila.

Muchas tiendas empiezan bien con una corrida nocturna y un reporte claro. Es lo que construimos en un proyecto de ropa: el proceso corre a medianoche, hora de la Ciudad de México, actualiza existencias por SKU y crea como borrador lo que falta en Shopify. Si el negocio crece hacia piezas únicas o venta en mostrador con el mismo inventario, el siguiente paso es acortar el intervalo, y después agregar eventos, siempre con la corrida completa como respaldo.

Si todavía no sabes si te conviene un conector o algo a la medida, empieza por la guía sobre conectores de Odoo y Shopify. Y si ya lo sabes, cuéntanos tu caso en integraciones.

Fuentes

¿Tienes un proyecto en mente?

Desde cero o sobre lo que ya existe. Primero una llamada, luego un alcance por escrito, y solo entonces un número.