Saltar al contenido
Cuéntanos tu proyecto

Plataforma · · 10 min de lectura

Cómo integrar Shopify con un ERP: stock, precios y pedidos

Integrar Shopify con un ERP consiste en decidir qué sistema manda en cada dato y en construir una sincronización que aguante fallos de red, avisos duplicados y cambios de versión de la API. Esta guía explica cómo se comporta Shopify según su documentación oficial: el modelo de cantidades de inventario, los webhooks, las operaciones masivas y el versionado. Sirve para evaluar con criterio un conector o una propuesta a medida.

Qué sistema manda en cada dato

La primera decisión es de organización y se toma antes de hablar de conectores. Para cada dato hay que fijar qué sistema lo origina y cuál lo recibe: catálogo, precios y tarifas, stock por almacén, pedidos, clientes y empresas B2B, facturas. Si dos sistemas escriben el mismo dato, el último que escribe pisa al otro, y el descuadre suele aparecer días después, cuando alguien compara el stock de la tienda con el del almacén.

Un reparto habitual en tiendas que ya tienen ERP es este. Las excepciones más frecuentes son un sistema de gestión de almacén (SGA) o un operador logístico distinto del ERP, que entonces manda en el stock, y los datos que solo existen en Shopify.

  • Catálogo base, SKU y atributos de producto: del ERP a Shopify.
  • Precios y tarifas, incluidas las de clientes B2B: del ERP a Shopify.
  • Stock por almacén: del ERP o del SGA a Shopify.
  • Pedidos, clientes, cancelaciones y reembolsos: de Shopify al ERP.
  • Textos de marketing, imágenes, metacampos de la ficha y colecciones: solo en Shopify.

La clave común: SKU por variante

Los dos sistemas tienen que reconocer el mismo producto. Lo normal es usar el SKU de cada variante o un identificador del ERP guardado en Shopify. Una variante sin SKU, o dos variantes con el mismo, dejan al conector sin saber a qué aplicar un precio o una cantidad: el dato se queda sin sincronizar o, peor, cae en el producto equivocado.

Por eso la limpieza del catálogo va antes de la carga inicial. Un listado de SKU vacíos y repetidos en los dos lados, cruzado con una hoja de equivalencias, evita muchas de las incidencias del arranque. La guía de importar productos en Shopify explica cómo revisar variantes y SKU antes de una carga masiva.

Las vías de integración y qué decide entre ellas

Hay cuatro formas de conectar los dos sistemas, y casi todas acaban usando las mismas piezas de Shopify: la GraphQL Admin API para leer y escribir datos y los webhooks para enterarse de los cambios.

Lo que decide entre ellas es cómo encajan con tu mapa de datos. A cualquier conector o proveedor conviene preguntarle qué datos sincroniza y en qué sentido, cada cuánto, qué hace con un SKU que no existe en el otro lado, dónde registra los errores, qué versión de la API usa y quién la actualiza.

Si se desarrolla a medida, Shopify permite crear una app personalizada, exclusiva para tu tienda, que accede a sus datos con las API. Cada petición a la GraphQL Admin API lleva un token de acceso, y la documentación pide solicitar solo el acceso a datos que la app necesita: una integración de stock y pedidos no tiene por qué leer, por ejemplo, los temas de la tienda.

  • Conector del App Store: una app ya construida para un ERP concreto. Se pone en marcha rápido; su límite es lo que sepa mapear.
  • Plataforma intermedia (iPaaS o middleware): un servicio que traduce entre los dos sistemas, con flujos y transformaciones configurables.
  • Shopify Flow: útil para avisos y envíos puntuales a otro sistema. Se queda corto para una sincronización completa en los dos sentidos, como explicamos en la guía de Shopify Flow.
  • Desarrollo propio: una app a medida que usa la Admin API y los webhooks con la lógica exacta del negocio.

Stock: el modelo de cantidades de Shopify

Shopify no guarda una sola cifra de stock por variante. Cada artículo tiene cantidades en varios estados y en cada ubicación. on_hand es lo que hay físicamente en una ubicación y equivale a la suma de available, committed, reserved, damaged, safety_stock y quality_control. incoming es mercancía en camino, que Shopify no cuenta como on_hand.

committed lo gestiona Shopify con acciones como crear y preparar pedidos, reservar inventario en pedidos preliminares o marcar transferencias y envíos como listos para enviar. La GraphQL Admin API no puede ajustarlo ni moverlo. Lo que sí puede escribir una integración es esto: con inventorySetQuantities fija la cantidad de available o de on_hand; con inventoryAdjustQuantities suma o resta en available, damaged, incoming, quality_control, reserved o safety_stock; con inventoryMoveQuantities mueve unidades entre esos estados.

Aquí se rompen muchas sincronizaciones. Si el ERP manda su stock disponible y la integración lo escribe en available, puede pisar unidades que en Shopify ya están en committed por pedidos que el ERP aún no ha recibido, y la tienda vuelve a ofrecer unidades vendidas. Hay que acordar qué cifra del ERP corresponde a qué estado de Shopify: si el ERP envía las unidades físicas, encaja con on_hand y Shopify sigue descontando lo comprometido; si envía un disponible que ya resta pedidos pendientes, hay que comprobar que esos pedidos no se descuentan dos veces.

Para no escribir sobre una cifra que ha cambiado entre la lectura y la escritura, las mutaciones aceptan changeFromQuantity, la última cantidad conocida en esa ubicación. Si no coincide con la actual, la mutación falla con el error CHANGE_FROM_QUANTITY_STALE y la integración tiene que volver a leer. Shopify recomienda usar esta comprobación; solo propone desactivarla, pasando null, cuando tu sistema es la fuente de verdad y la cantidad actual de Shopify no importa.

Además, estas mutaciones llevan una clave de idempotencia con la directiva @idempotent, disponible desde la versión 2026-01 de la API y obligatoria desde la 2026-04. Protege de ajustes duplicados por condiciones de carrera o fallos de red: si una petición se reintenta, el ajuste no se aplica dos veces.

Con varios almacenes, el stock se sincroniza por ubicación y no como un total: las cantidades de Shopify son siempre de un artículo en una ubicación concreta. La guía de inventario en varias ubicaciones explica cómo se organizan en la tienda.

  • on_hand: unidades físicas en la ubicación.
  • available: lo que queda para vender.
  • committed: comprometido por pedidos y reservas; solo lo cambia Shopify.
  • reserved: apartado para un cliente.
  • damaged: no se puede vender por daños.
  • safety_stock: reserva para cubrir oscilaciones de la demanda.
  • quality_control: en revisión de calidad.
  • incoming: en camino; no cuenta como on_hand.

Pedidos: webhooks y lo que Shopify no garantiza

Los webhooks son avisos que Shopify envía a tu sistema cuando pasa algo en la tienda, como un pedido nuevo, una cancelación o un reembolso, para no tener que preguntar a la API cada poco tiempo. Son la vía normal para pasar pedidos al ERP, pero la documentación de Shopify marca tres límites que hay que tener en cuenta desde el diseño: no garantiza el orden dentro de un tema ni entre temas del mismo recurso, la entrega no está siempre garantizada y el mismo webhook puede llegar más de una vez.

Los plazos también están publicados. Shopify espera un 200 OK, con un tiempo de conexión de un segundo y de cinco segundos para toda la petición; si no llega, la entrega falla. Reintenta hasta ocho veces en un periodo de cuatro horas y, si los fallos persisten, retira la suscripción, que no vuelve a recibir nada hasta que se crea de nuevo.

Cuándo pasar el pedido al ERP es una decisión de negocio: al crearse, al pagarse o al prepararse. Sea cual sea, las cancelaciones y los reembolsos parciales tienen que llegar como movimientos propios, y no como una edición silenciosa del pedido, para que facturación y almacén cuadren con lo que ve el cliente.

En Weblineo trabajamos solo con Shopify desde 2016 y somos Shopify Plus Partner; desarrollamos estas integraciones dentro de nuestro servicio de desarrollo Shopify; si la tienda vende a empresas, el servicio de Shopify B2B incluye también catálogos y precios por cliente.

  • Responder enseguida y procesar después: la documentación propone una cola para cumplir los cinco segundos.
  • Verificar la firma: la cabecera X-Shopify-Hmac-SHA256 lleva un HMAC-SHA256 en base64 del cuerpo sin procesar, calculado con el secreto de la app.
  • Descartar duplicados con X-Shopify-Webhook-Id. X-Shopify-Event-Id agrupa entregas que vienen de la misma acción en la tienda.
  • No fiarse del orden de llegada: antes de sobrescribir, comparar la fecha de actualización del recurso con la que ya tiene el ERP, o volver a leer el pedido de la API.
  • Hacer idempotente la escritura en el ERP: el mismo pedido no puede crearse dos veces aunque el aviso llegue repetido.

Carga inicial y conciliación periódica

Como la entrega de webhooks no está garantizada, la propia documentación recomienda trabajos de conciliación que lean de Shopify cada cierto tiempo lo que haya cambiado. Muchas consultas GraphQL aceptan filtros por updated_at, así que basta con pedir lo modificado desde la última ejecución.

Para volúmenes grandes, como la carga inicial del catálogo o una conciliación completa, están las operaciones masivas. Shopify ejecuta la consulta por su cuenta y devuelve un archivo JSONL, con un objeto JSON por línea y los elementos hijos en líneas aparte enlazados con __parentId. A partir de la versión 2026-01, una app puede tener en marcha hasta cinco consultas masivas al mismo tiempo en la misma tienda. La ejecución de la consulta masiva no cuenta para el límite de peticiones; sí cuentan las peticiones que haces para lanzarla y consultar su estado. La URL del resultado caduca a la semana.

Fuera de las operaciones masivas, la GraphQL Admin API pone un tope según lo que cuesta cada consulta, contado en puntos, y Shopify indica que ese límite depende del plan. En vez de suponer una cifra, la integración debe leer en cada respuesta extensions.cost, con requestedQueryCost, actualQueryCost y throttleStatus (maximumAvailable, currentlyAvailable y restoreRate), y frenar antes de recibir el error THROTTLED.

  • Stock por SKU y ubicación en los dos sistemas.
  • Pedidos de Shopify que no están en el ERP, y al revés.
  • Precios o tarifas distintos entre ERP y tienda.
  • Productos del ERP sin variante en Shopify, y variantes de Shopify sin correspondencia en el ERP.

Errores, avisos y versiones de la API

Cada error tiene que quedar a la vista. Conviene una cola donde caigan los fallos de la sincronización (referencias que solo existen en un lado, pedidos que el ERP no acepta, el middleware sin responder), con una regla de reintento para cada tipo y alguien del equipo que reciba el aviso. Si el único síntoma es que alguien detecta el descuadre a fin de mes, la integración no está terminada.

La API también cambia. Shopify publica una versión nueva cada tres meses, el primer día de cada trimestre, con nombres por fecha como 2026-04, y cada versión estable tiene soporte durante al menos 12 meses. Si una integración pide una versión que ya no está accesible, Shopify atiende la petición con la versión estable más antigua que siga disponible, y la cabecera X-Shopify-API-Version indica cuál se ha usado. Ese salto puede cambiar el comportamiento sin que nadie toque el código, así que conviene fijar la versión y revisarla cada trimestre.

Antes de conectar la tienda que vende, prueba en una tienda de desarrollo: pedidos de prueba, cancelaciones, reembolsos parciales, un SKU inexistente y una caída simulada del ERP.

Lista de comprobación antes de elegir conector o desarrollo

Sirve igual para una app del App Store, una plataforma intermedia o una propuesta a medida. Si alguna respuesta es vaga, es justo ahí donde fallará la integración. Para tiendas B2B, revisa también empresas, catálogos y precios por cliente con la guía de Shopify B2B.

Si necesitas que alguien lo construya o lo audite, en Weblineo lo hacemos desde nuestros servicios de desarrollo Shopify y Shopify B2B, siempre sobre la documentación oficial de la plataforma.

  • Mapa de datos con qué sistema manda y en qué sentido va cada dato, validado por operaciones y por quien lleva el ERP.
  • SKU únicos y completos en los dos sistemas antes de la carga inicial.
  • Qué estado de inventario escribe (available u on_hand) y si usa changeFromQuantity.
  • Clave de idempotencia en los ajustes de inventario y en la creación de pedidos en el ERP.
  • Verificación HMAC, deduplicación por X-Shopify-Webhook-Id y tratamiento del orden de llegada.
  • Conciliación periódica y operaciones masivas para volúmenes grandes.
  • Registro de errores, reintentos y aviso a una persona.
  • Versión de la API que usa, quién la actualiza y cada cuánto.

Preguntas frecuentes

¿La sincronización de stock entre Shopify y el ERP es instantánea?

Depende de cómo esté construida. Los webhooks avisan de los cambios en Shopify sin tener que consultar la API, pero no garantizan orden ni entrega, y el stock que viene del ERP llega con la frecuencia que tenga el conector. Por eso se combina con una conciliación periódica.

¿Qué pasa si el ERP no recibe un webhook?

Shopify da cinco segundos para responder y reintenta hasta ocho veces en cuatro horas. Si los fallos persisten, retira la suscripción. Un trabajo de conciliación que lea lo modificado desde la última ejecución recupera lo que se haya perdido.

¿Es mejor una app del App Store o un desarrollo propio?

Si un conector cubre tu mapa de datos, gestiona errores y mantiene la versión de la API al día, suele ser la vía más directa. El desarrollo propio tiene sentido cuando la lógica del negocio no encaja en lo que el conector sabe mapear.

¿Se sincroniza el stock por almacén o como un total?

Por almacén. En Shopify las cantidades de inventario son de un artículo en una ubicación concreta, así que cada almacén del ERP tiene que corresponder a una ubicación de la tienda.

Cuéntanos qué necesita tu tienda

Cuéntanos tu proyecto en unos minutos. Si encaja, reservas una llamada de 30 minutos con un desarrollador y te enviamos una propuesta con precio cerrado.

Cuéntanos tu proyectoTe respondemos en menos de 24 horas