Sincronización de inventario en Shopify: acaba con el stock desfasado
Para responsables de e-commerce y operaciones que usan Shopify junto a un ERP: las cinco causas del desfase de stock, una sincronización que se corrige sola y quién la construye.
En esta página
Tu catálogo de Shopify y tu sistema de inventario no coinciden, y alguien de tu equipo dedica parte de cada semana a volver a igualarlos. Una sincronización de inventario en Shopify fiable necesita tres cosas: un sistema que sea dueño del número de stock, reintentos cuando un mensaje falla y una comprobación nocturna que atrape lo que se escape. Casi todo el desfase nace de una pieza que falta en ese diseño, rara vez de Shopify.
Esta guía es para responsables de e-commerce y operaciones que usan Shopify junto a un ERP o un sistema de almacén. Vas a reconocer las cinco causas detrás de un stock desfasado, decidir qué sistema es dueño de los números y ver un diseño de sincronización con código que funciona. También tendrás los criterios para elegir entre una app, n8n y un servicio a medida.
werun.dev construye y mantiene estas sincronizaciones para tiendas online, así que las últimas secciones cubren coste, plazos y cómo es el trabajo semana a semana.
Puntos clave
- El desfase de stock nace de huecos en el diseño (sin dueño, sin reintentos, sin comprobaciones), así que un mejor diseño lo arregla donde más ediciones manuales nunca lo harán.
- Nombra un único sistema como dueño del número de stock antes de construir nada y envía sus cantidades a Shopify como valores absolutos.
- Combina webhooks para la velocidad, una cola con reintentos para la seguridad y un informe de conciliación nocturno para lo que se escape.
- Las alertas y un informe semanal de diferencias convierten los fallos silenciosos en una revisión breve el mismo día.
Por qué se desfasa la sincronización de inventario en Shopify
El stock se desfasa cuando dos sistemas creen tener la verdad y nada los compara. Una venta en Shopify baja un número, una recepción de mercancía en el almacén sube otro, y el mensaje entre ambos llega tarde, dos veces o nunca. Tras unas semanas la diferencia es lo bastante grande como para que un cliente compre algo que no puedes enviar.
La solución es un diseño, no un archivo de importación más grande. Decides qué sistema es dueño del número, mueves los cambios como eventos, reintentas lo que falla y comparas ambos lados cada noche. El resto de la guía recorre esas piezas una a una.
Cómo es una sincronización sana
En una configuración sana, un cambio en cualquiera de los sistemas llega al otro en segundos o minutos. Una actualización fallida se reintenta sola. Si sigue fallando, termina en una lista corta que alguien ve esa misma mañana.
Cada mañana lees un informe que dice cuántos SKU difieren. La respuesta suele ser cero o un puñado. Tu equipo deja de preguntar si un número es correcto y pasa a preguntar qué hay que reponer.
Lo que te cuestan las ventas sin stock y los arreglos manuales
Una venta sin stock significa un correo de disculpas, un reembolso y, a veces, un cliente perdido. Los arreglos manuales cuestan horas: alguien exporta un CSV, compara columnas y edita cantidades, normalmente en plena semana de mucho trabajo.
Por ejemplo (ilustrativo), una persona que dedica 3 horas semanales a correcciones invierte unas 150 horas al año en un trabajo que una sincronización hace en segundo plano. Ese tiempo rinde más en compras, promociones o atención al cliente.
Cinco causas de un stock desfasado en Shopify
Busca tu caso a continuación. Cada causa deja un síntoma que puedes describir a un desarrollador, y eso acorta mucho el diagnóstico.
Síntoma
El stock se retrasa horas
Un producto agotado sigue mostrando unidades. Sospecha de importaciones por lotes o actualizaciones limitadas.
Síntoma
Total correcto, lugar erróneo
La suma coincide pero una sede muestra cero. Sospecha de la configuración de ubicaciones.
Síntoma
Algunos productos no se actualizan
Siempre fallan los mismos SKU. Sospecha del mapeo de SKU o variantes.
Síntoma
Las actualizaciones se paran sin avisar
Todo va bien y luego los conteos se desvían durante días. Sospecha de webhooks fallidos.
El mapa siguiente muestra por dónde entra cada causa en el camino entre tu sistema de inventario y la tienda, y dónde la comprobación nocturna atrapa lo que se escapó.
Camino del desfase
- 01Sistema de inventarioFuente de verdad del stock
- 02Lote CSVConteos de hace horas llegan a la tienda
- 03Límite de la APIActualizaciones limitadas llegan tarde
- 04Reparto por ubicaciónStock en el lugar erróneo
- 05Mapeo de SKUVariantes sin emparejar no se actualizan
- 06Tienda ShopifyMuestra el stock que ve el cliente
Mapa de cinco puntos por donde entra el desfase de stock entre un sistema de inventario y Shopify, con una revisión nocturna que atrapa el resto
Importaciones CSV por lotes que llegan tarde
Si tu sistema de inventario exporta un archivo cada pocas horas, Shopify solo conoce el stock de la última carga. Un producto puede agotarse a las 10:00 y seguir mostrando 12 unidades hasta la importación de las 14:00.
Las importaciones además sobrescriben. Un archivo generado a las 09:00 y aplicado a las 09:40 borra las ventas de esos 40 minutos. Cuanto mayor es el intervalo, mayor es el error.
Límites de la API que descartan actualizaciones
Shopify limita la velocidad a la que una app puede llamar a su Admin API, y el margen depende de tu plan (consulta los límites de velocidad de la Admin API (se abre en otra pestaña) de Shopify). Un envío completo del catálogo tras cambiar una lista de precios puede superar ese límite.
Si la sincronización ignora la respuesta de limitación, las actualizaciones que pasan del límite se pierden. El síntoma es un lote donde los primeros productos están bien y los últimos desactualizados.
Varias ubicaciones que dividen el conteo
Shopify lleva el stock por ubicación. Si la sincronización escribe un total en una sola ubicación, tu tienda de recogida puede mostrar cero mientras el almacén tiene 40 unidades.
También ocurre al revés: el ERP envía números por sede y la tienda lee solo el total. Entonces los pedidos se asignan al lugar equivocado o los productos aparecen como no disponibles donde sí hay existencias.
Variantes y SKU que no coinciden
El stock en Shopify vive en un inventory item, uno por variante, y el SKU suele ser la clave que lo enlaza con tu sistema. Si el ERP dice TS-100-M y Shopify dice TS-100-Mediumo un SKU tiene un espacio al final, la sincronización no puede emparejarlos. Se salta el artículo o actualiza la variante equivocada.
Los packs y los SKU reutilizados lo empeoran. Limpiar los datos de producto desde el origen ayuda, y la guía sobre PIM y contenido de producto muestra cómo mantener SKU y atributos coherentes.
Fallos de webhook que nadie nota
Un webhook es la forma en que Shopify avisa a tu sistema de que ha ocurrido algo, como un pedido nuevo (consulta los webhooks de Shopify (se abre en otra pestaña)). Si tu endpoint está caído durante un despliegue o responde demasiado despacio, la entrega falla.
Shopify reintenta durante un periodo limitado y puede eliminar una suscripción que falla de forma continua. Sin registro de entregas ni alerta, la sincronización simplemente se detiene, y la primera señal es un conteo erróneo días después.
Decide qué sistema es dueño del número de stock
Elige un sistema como dueño del número de stock antes de que nadie escriba código. El dueño es el sistema cuyo número prevalece cuando los dos discrepan. Cada decisión posterior, desde la dirección de los datos hasta las reglas de conflicto, se deriva de esta.
Nuestra elección para la mayoría de configuraciones con ERP
El sistema de inventario es dueño del stock
- Un solo número en Shopify, marketplaces y pedidos B2B
- Recepciones, traspasos y recuentos llegan solos a la tienda
- Requiere una sincronización que diseñes, vigiles y mantengas
- Las ediciones manuales de stock en Shopify se sobrescriben
Opción B
Shopify es dueño del stock
- La configuración más simple, sin nada que sincronizar
- Funciona bien con una ubicación y Shopify POS
- Otras herramientas leen el número desde Shopify
- Se complica cuando aparece un segundo almacén o canal
Cuándo el sistema de inventario debe ser el dueño
Elige esta opción si tienes almacén, ERP, órdenes de compra o más de un canal de venta. El sistema de inventario ya conoce recepciones, traspasos, devoluciones y unidades reservadas, así que es donde se calcula el número real.
Shopify pasa a ser entonces una capa de escaparate y checkout. Los pedidos vuelven como eventos, el sistema de inventario recalcula y la nueva cantidad sale hacia la tienda.
Cuándo Shopify debe ser el dueño
Elige esta opción para un catálogo pequeño con una ubicación y sin lógica de stock en un ERP. Tu equipo edita el stock en Shopify y otras herramientas, como una impresora de etiquetas o una hoja de cálculo, leen de ahí.
Si esperas un segundo almacén o un marketplace en el plazo de un año, planifica ya la primera opción. Cambiar de dueño más tarde es posible, pero exige un traspaso cuidadoso.
Qué fluye en cada dirección
La tabla muestra el reparto habitual cuando el sistema de inventario es dueño del stock.
| Dato | Dirección | Por qué |
|---|---|---|
| Cantidad disponible | Sistema de inventario a Shopify | Un solo dueño del número |
| Pedidos nuevos y reembolsos | Shopify al sistema de inventario | El dueño recalcula el stock |
| Recepciones, traspasos, recuentos | Sistema de inventario a Shopify | Cambian lo que se puede vender |
| SKU y código de barras | Origen del producto a ambos | Mantiene estables las coincidencias |
| Precio y contenido | Origen del producto a Shopify | Flujo separado del stock |
Diseña una sincronización de inventario en Shopify que se corrige sola
El patrón que aguanta tiene tres capas. Los webhooks dan velocidad, una cola da seguridad y una conciliación nocturna pone una red bajo ambas. Cada capa cubre una debilidad de las otras.
Cambio de stock
Venta o recepción
Webhook o evento
Llega mensaje firmado
Cola con reintentos
Ordenada y sin duplicados
Actualización en Shopify
Más revisión nocturna
Webhooks y una cola para cambios en vivo
Tu endpoint debe hacer tres cosas pequeñas: verificar la firma, guardar el evento y responder rápido. Un worker aparte lee después la cola al ritmo que permite la API. Recibir y procesar quedan separados, así que una respuesta lenta de Shopify nunca te hace perder un mensaje.
Shopify envía un id de evento en la cabecera X-Shopify-Event-Id. Guárdalo, para que el worker detecte una entrega que llega dos veces.
Actualizaciones idempotentes y reintentos
Idempotente significa que aplicar dos veces el mismo mensaje deja el mismo resultado. Se consigue enviando la cantidad completa en lugar de un ajuste, y recordando qué ids de evento ya has procesado.
Los reintentos esperan más tras cada fallo. Tras un número fijo de intentos, el mensaje pasa a una dead letter list, una zona de espera para fallos que necesitan a una persona, y salta una alerta. El flujo siguiente muestra ambos caminos.
Del evento al stock
- 01Evento de venta o recepciónVenta en Shopify o recepción en almacén
- 02ColaOrdenada y sin duplicados por id de evento
- 03WorkerLee al ritmo que permite la API
- AÉxitoEl stock coincide en todas partes
- Cantidades absolutas aplicadasCantidad total, no un ajuste
- Shopify y sistema de inventarioAmbos muestran el mismo stock
- BFalloLa actualización no se completó
- Reintento con esperaEspera más y vuelve al worker
- Dead letter list y alertaTras varios intentos, se avisa al equipo
Vista paso a paso de una sincronización donde eventos de venta y recepción entran en una cola, un worker actualiza el stock y los fallos se reintentan y alertan
Un informe de conciliación nocturno
Los webhooks no están garantizados, así que compara ambos lados cada noche. Exporta el stock del dueño y de Shopify, empareja por SKU y ubicación y lista cada diferencia. Las diferencias pequeñas pueden corregirse solas al número del dueño. Las grandes pasan a una persona, porque a menudo apuntan a un problema de mapeo.
// Compare two stock lists keyed by "SKU|location" and print the differences.
function diffStock(owner, shopify) {
const diffs = [];
for (const [key, ownerQty] of owner) {
const shopifyQty = shopify.get(key);
if (shopifyQty === undefined) {
diffs.push({ key, ownerQty, shopifyQty: null, issue: "missing in Shopify" });
} else if (shopifyQty !== ownerQty) {
diffs.push({ key, ownerQty, shopifyQty, issue: "quantity differs" });
}
}
for (const key of shopify.keys()) {
if (!owner.has(key)) {
diffs.push({ key, ownerQty: null, shopifyQty: shopify.get(key), issue: "missing in inventory system" });
}
}
return diffs;
}
const owner = new Map([["TS-100-M|warehouse", 12], ["TS-100-L|warehouse", 7], ["MUG-01|warehouse", 40]]);
const shopify = new Map([["TS-100-M|warehouse", 12], ["TS-100-L|warehouse", 9], ["CAP-02|warehouse", 3]]);
console.table(diffStock(owner, shopify));
Fija el stock con la API de inventario de Shopify
El objetivo es simple: que el número en Shopify sea el que envió tu sistema de inventario, en la ubicación correcta. Shopify documenta el modelo para apps de gestión de inventario (se abre en otra pestaña), y las piezas que necesitas son pocas.
Inventory items, ubicaciones y niveles
Cada variante tiene un inventory item, que lleva el SKU. Una ubicación es un lugar que guarda stock, como un almacén o una tienda. Un nivel de inventario es la cantidad de un artículo en una ubicación.
Así, una tienda con 2.000 SKU y 3 ubicaciones tiene hasta 6.000 niveles que mantener correctos. Tu sincronización escribe a ese nivel, nunca a nivel de producto.
Código: fijar cantidades absolutas con GraphQL
La mutación inventorySetQuantities de la Admin GraphQL API fija la cantidad del estado available para cada artículo y ubicación. Este ejemplo añade protección contra duplicados por id de evento y un reintento cuando Shopify limita la petición.
// Set absolute stock quantities in Shopify with retries and duplicate protection.
const ENDPOINT = `https://${process.env.SHOPIFY_SHOP}/admin/api/2025-07/graphql.json`;
const MUTATION = `
mutation SetStock($input: InventorySetQuantitiesInput!) {
inventorySetQuantities(input: $input) {
inventoryAdjustmentGroup { id }
userErrors { field message code }
}
}
`;
type StockLine = { inventoryItemId: string; locationId: string; quantity: number };
// In production keep processed event ids in Redis or a database table.
const processed = new Set<string>();
const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
export async function setStock(eventId: string, lines: StockLine[], maxAttempts = 5) {
if (processed.has(eventId)) return "duplicate";
for (let attempt = 1; attempt <= maxAttempts; attempt++) {
const response = await fetch(ENDPOINT, {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-Shopify-Access-Token": process.env.SHOPIFY_ADMIN_TOKEN!,
},
body: JSON.stringify({
query: MUTATION,
variables: {
input: {
name: "available",
reason: "correction",
referenceDocumentUri: `logistics://inventory-sync/${eventId}`,
ignoreCompareQuantity: true,
quantities: lines,
},
},
}),
});
const body = await response.json();
const throttled =
response.status === 429 ||
body.errors?.some((e: any) => e.extensions?.code === "THROTTLED");
if (throttled) {
await sleep(2 ** attempt * 500); // wait longer after each throttled attempt
continue;
}
if (!response.ok || body.errors) {
throw new Error(JSON.stringify(body.errors ?? response.status));
}
const userErrors = body.data.inventorySetQuantities.userErrors;
if (userErrors.length > 0) throw new Error(JSON.stringify(userErrors));
processed.add(eventId);
return "updated";
}
throw new Error(`Throttled after ${maxAttempts} attempts, move to the dead letter list`);
}
Los ids son global ids de Shopify, como gid://shopify/InventoryItem/123456. Como el sistema de inventario es dueño del número, el código pone ignoreCompareQuantity en true. Revisa la referencia de la API para tu versión, ya que los argumentos cambian entre lanzamientos.
Absolutas, nunca deltas
Envía la cantidad completa, no "menos 2" ni "más 10". Un mensaje repetido o tardío repite entonces el mismo número correcto y no puede corromper el conteo.
Cómo moverte dentro de los límites de la API
Agrupa muchas cantidades en una sola llamada en lugar de una llamada por SKU. Deja que la cola marque el ritmo y lee la respuesta de limitación para que el worker espere en vez de martillear la API.
Para una primera carga grande o una actualización completa de la lista de precios, ejecuta el proceso fuera de horas punta. Los límites crecen con tu plan y las tiendas Shopify Plus tienen un margen mayor, como explica la página de límites de velocidad (se abre en otra pestaña).
Elige entre una app, n8n o un servicio a medida
La opción adecuada depende del tamaño del catálogo, del número de ubicaciones y de cuántas reglas de negocio hay entre los dos sistemas. Esta tabla te da los criterios.
| Opción | Ideal para | Ventaja | Ojo con |
|---|---|---|---|
| App de inventario | Una ubicación, un ERP estándar, pocas reglas | Rápida de empezar, bajo coste inicial | Lógica fija, cuotas mensuales, alertas limitadas |
| Workflows de n8n | Varios sistemas, reglas propias, volumen moderado | Lógica visible, cambios rápidos | Colas y reintentos requieren un diseño deliberado |
| Servicio a medida | Muchos SKU y ubicaciones, packs, volumen alto | Control total de reglas y monitorización | Mayor inversión inicial |
Cuándo basta con una app
Una app encaja cuando tu ERP tiene un conector mantenido, tienes una o dos ubicaciones y tus reglas son estándar. Empiezas en días y pagas una suscripción. La guía sobre los límites y costes ocultos de las apps de Shopify te ayuda a sopesar esa decisión con honestidad.
Fíjate en dos cosas: cómo gestiona la app las actualizaciones fallidas y si te muestra un informe de diferencias.
Cuándo encajan los workflows de n8n
n8n es una herramienta de workflows donde dibujas los pasos y puedes añadir código cuando hace falta (consulta la documentación de n8n (se abre en otra pestaña)). Va bien para tiendas que conectan Shopify con un ERP y además con una hoja de cálculo, un feed de proveedor o un canal de avisos.
Funciona mejor cuando alguien diseña a propósito los pasos de reintento, cola y conciliación. Si estás comparando herramientas, n8n vs Zapier vs Make cubre precios, control y límites.
Cuándo compensa un servicio a medida
Un servicio a medida compensa con un catálogo grande, varios almacenes, packs o kits, o reglas como stock reservado y márgenes de seguridad. Tienes control exacto de las reglas, la velocidad y las alertas.
Además elimina la dependencia de la hoja de ruta de una app de terceros. A cambio, la construcción inicial es mayor, y la recuperas con menos correcciones y menos pedidos perdidos.
Monitoriza la sincronización para ver el desfase a tiempo
Una sincronización que no puedes ver falla en silencio. La monitorización lo convierte en una revisión breve por la mañana, y es la parte que más proyectos se saltan.
Alertas que merecen una llamada
Mantén pocas alertas, para que cada una se lea. Estas son las que importan:
- La dead letter list no está vacía.
- No ha llegado ningún webhook durante varias horas en un día laborable.
- El mensaje más antiguo de la cola supera el límite que fijaste.
- La conciliación nocturna encuentra más diferencias que tu umbral.
- Los errores de API o las limitaciones suben muy por encima de lo habitual.
Envíalas por correo o a un canal de chat del equipo con el SKU, la ubicación y lo que la sincronización intentó hacer.
Un informe semanal de diferencias
Una vez por semana, envía un informe corto: cuántos SKU difirieron, qué SKU aparecen una y otra vez, cuántas ventas sin stock hubo y cuánto tardaron de media las actualizaciones. Los SKU que se repiten suelen apuntar a una regla de mapeo o de ubicación que hay que arreglar de raíz.
En unas semanas el informe muestra cómo la sincronización se vuelve más silenciosa. Esa tendencia es tu prueba de que la solución aguanta.
Coste, plazos y quién lo construye
Qué determina el coste
El precio sigue al alcance, no solo al tamaño del catálogo. Estos factores lo mueven más:
- Qué tan buena es la API del ERP o del sistema de inventario, o si solo exporta archivos.
- El número de ubicaciones y canales de venta.
- Packs, kits y variantes con patrones de SKU poco habituales.
- Cuántos datos de SKU hay que limpiar antes de que la sincronización pueda emparejarlos.
- Reglas de negocio como stock reservado o márgenes de seguridad.
- La profundidad de monitorización e informes que quieras.
Una app tiene el menor coste inicial y una cuota recurrente. n8n queda en el punto medio, y un servicio a medida cuesta más al inicio y tiene menos límites. Pide un presupuesto ajustado al alcance, ya que una sola ubicación con SKU limpios cuesta mucho menos que un ERP con varios almacenes.
Un calendario realista
Para una tienda como la del ejemplo anterior, con 2.000 SKU y 3 ubicaciones, una forma típica sería esta (ilustrativa, varía según el ERP y los datos):
- Semana 1: auditoría de SKU, ubicaciones y el flujo actual, y acuerdo sobre el dueño del número.
- Semanas 2 a 3: construcción del receptor de webhooks, la cola, el worker y el proceso de conciliación.
- Semana 4: pruebas con tu catálogo real en una tienda de desarrollo, incluidos fallos provocados a propósito.
- Semanas 5 a 6: salida a producción por fases, vigilancia del informe y ajuste de reglas.
Cómo lo construye y lo mantiene werun.dev
Tú nos cuentas el objetivo, por ejemplo cero ventas sin stock y cero ediciones a mano, y nosotros construimos el camino. Mapeamos tus SKU y ubicaciones, acordamos el dueño del número y montamos los webhooks, la cola, los reintentos y el informe nocturno. La página de integración de Shopify con ERP describe cómo se desarrolla ese proyecto.
Tras el lanzamiento seguimos a tu lado: las alertas nos llegan también a nosotros, el informe mensual muestra cómo se comporta la sincronización y respondemos en menos de 2 horas en días laborables. El trabajo en la plataforma Shopify abarca temas, operación de tienda y Shopify Plus.
Por dónde empezar esta semana
Puedes avanzar mucho en una tarde, sin escribir código. La lista siguiente reúne los datos que cualquier desarrollador te pedirá y te muestra la gravedad del desfase.
- Decide qué sistema es dueño del número de stock, aunque sea como borrador.
- Exporta 20 SKU que hoy no coinciden, con ambas cantidades.
- Lista todas las ubicaciones en Shopify y en tu sistema de inventario.
- Revisa los registros de entrega de webhooks en busca de entregas fallidas o ausentes.
- Anota cuándo se ejecutó la última importación completa y con qué frecuencia llegan los archivos.
Con esa lista en la mano, la causa suele verse en minutos. Si quieres ayuda, cuéntale a werun.dev tu objetivo y comparte la lista. Te responderemos con lo que veamos y el camino más sencillo hacia una sincronización que aguante.
Preguntas frecuentes
¿Por qué mi inventario de Shopify no coincide con mi ERP?
Las causas habituales son importaciones por lotes tardías, llamadas a la API limitadas, conteos por ubicación que no cuadran, SKU que no coinciden y webhooks que fallaron sin alerta. Nombrar un sistema como dueño del número y añadir reintentos y una comparación nocturna elimina la mayoría.
¿Cada cuánto debe sincronizarse el inventario de Shopify con mi sistema de inventario?
En tiendas que venden rápido, los cambios deben viajar como eventos en segundos o minutos, no en archivos cada hora. Añade una comparación completa nocturna como red de seguridad, porque la entrega de eventos puede fallar.
¿Cómo evito vender sin stock en Shopify?
Mantén un único dueño del número de stock, actualiza Shopify en cuanto ocurra una venta o recepción y envía cantidades absolutas. Añade un margen de seguridad para actualizaciones lentas y una alerta que salte cuando fallen.
¿Puedo sincronizar el inventario de Shopify con un ERP sin una app?
Sí. Puedes usar workflows de n8n o un servicio a medida que escuche los webhooks de Shopify y llame directamente a la Admin API. Eso te da más control sobre reglas, reintentos y monitorización que una app con lógica fija.
¿Cuáles son los límites de la API de Shopify para actualizar inventario?
Shopify limita cuántas llamadas puede hacer una app por tienda, y el margen depende del plan de la tienda, con límites mayores en Shopify Plus. Agrupar cantidades, dosificar una cola y reintentar cuando hay limitación mantienen las actualizaciones dentro del límite.
¿Cuánto cuesta una integración de inventario a medida en Shopify?
Depende del alcance: la calidad de la API del ERP, el número de ubicaciones, los packs y las reglas implicadas. Una sola ubicación con SKU limpios cuesta mucho menos que una configuración con varios almacenes, así que pide un presupuesto ajustado tras una auditoría breve.