Blog

Shopify y ERP: cómo integrar stock, precios y pedidos

Cómo conectar Shopify con tu ERP por la GraphQL Admin API: app y permisos, variantes y SKU, stock por ubicación, precios, pedidos, RUT y límites.

Shopify se conecta con un ERP por la Admin API, la interfaz que usa una app para leer y escribir los datos de la tienda. El ERP envía productos, stock y precios. Shopify entrega los pedidos y los reembolsos. Esta guía explica cómo se obtiene el acceso, cómo se modela cada dato y qué errores se repiten. Los costos, los medios de pago y la boleta están en la guía de Shopify en Chile.

Qué datos van en cada sentido

Dato Sentido Objeto de la GraphQL Admin API
Productos y variantes ERP a Shopify Product y ProductVariant
Stock por ubicación ERP a Shopify InventoryItem, InventoryLevel y Location
Precios ERP a Shopify ProductVariant y PriceList
Pedidos y clientes Shopify a ERP Order
Reembolsos Shopify a ERP Refund
Despacho y seguimiento ERP a Shopify FulfillmentOrder

Fuente: GraphQL Admin API reference, Shopify Developer Documentation.

Cómo se obtiene el acceso

Una integración entra a la tienda como una app personalizada: una app hecha solo para tu tienda, que no pasa por la Shopify App Store. Hoy se crea en el Dev Dashboard:

  1. En el panel de Shopify, ir a Configuración > Apps, elegir “Develop apps” y luego “Build apps in Dev Dashboard”.
  2. Crear la app y una versión. En la sección de acceso de la versión se escriben los permisos (scopes).
  3. Publicar la versión e instalar la app en la tienda.

El token

Con una app del Dev Dashboard no hay un token para copiar desde el panel. La integración lo pide por programa, con el flujo client credentials: entrega el client ID y el client secret de la app y recibe un token.

  • El token vence a las 24 horas. La integración tiene que renovarlo sola.
  • Va en el encabezado X-Shopify-Access-Token de cada llamada.
  • El flujo solo funciona si la app y la tienda pertenecen a la misma organización de Shopify.

Las apps personalizadas creadas desde el panel antes del 1 de enero de 2026 son ahora apps heredadas (legacy custom apps) y su token se sigue obteniendo desde el panel.

Permisos mínimos

Permiso (scope) Para qué lo necesita la integración
read_products, write_products Productos, variantes y listas de precios
read_inventory, write_inventory Artículos de inventario y cantidades por ubicación
read_locations Leer las ubicaciones de la tienda
read_orders Pedidos y reembolsos de los últimos 60 días
read_all_orders Extiende el acceso a pedidos más antiguos
write_merchant_managed_fulfillment_orders Marcar despachos e informar el seguimiento

Fuente: Shopify API access scopes, Shopify Developer Documentation.

No pidas más de lo que usas. Shopify advierte que puede restringir el acceso a los pedidos a las apps que no los necesitan.

GraphQL Admin API y REST

Shopify tiene dos versiones de su Admin API. La REST Admin API es legacy desde el 1 de octubre de 2024. Desde el 1 de abril de 2025, las apps públicas nuevas deben construirse solo con la GraphQL Admin API, y Shopify indica que algunas funciones nuevas pueden estar disponibles solo en GraphQL.

Para una integración nueva con el ERP, el camino es GraphQL. Las llamadas van por POST a una sola dirección, que lleva la versión de la API:

https://{tienda}.myshopify.com/admin/api/2026-10/graphql.json

Shopify publica una versión nueva cada tres meses y soporta cada versión estable por un mínimo de 12 meses. Una integración tiene que actualizarse al menos una vez al año.

Producto, variante y SKU

Shopify separa dos niveles. El producto es lo que el comprador ve en la tienda, por ejemplo una polera. La variante es lo que se vende y se guarda en stock, por ejemplo la polera azul talla M.

El código del ERP va en el campo sku de la variante. El cruce queda así:

  • Cada código del ERP corresponde a una variante de Shopify.
  • Las variantes de un mismo modelo se agrupan bajo un producto.
  • El sku distingue mayúsculas de minúsculas. ABC-01 y abc-01 son códigos distintos.

Por defecto, una tienda admite hasta 2.048 variantes por producto. Para modificar varias variantes de un producto en una sola llamada existe la mutación productVariantsBulkUpdate.

Stock por ubicación

El stock no se guarda en la variante. Shopify usa tres objetos:

Objeto Qué es
InventoryItem El artículo de inventario de una variante. Guarda el SKU y si se controla su cantidad (tracked)
Location Un lugar físico donde guardas o despachas inventario: bodega, tienda o pop-up
InventoryLevel Las cantidades de un artículo en una ubicación

Fuente: InventoryItem, InventoryLevel y Location, Shopify Developer Documentation.

Cada nivel de inventario tiene varias cantidades con nombre. Las tres que importan para un ERP:

  • on_hand: las unidades que están físicamente en la ubicación.
  • committed: las unidades apartadas por pedidos que todavía no se despachan.
  • available: lo que se puede vender. No incluye lo comprometido.

La cantidad se escribe con la mutación inventorySetQuantities. Recibe el artículo, la ubicación, la cantidad, su nombre (available u on_hand) y un motivo, por ejemplo correction.

Dos cambios recientes rompen integraciones antiguas. Desde la versión 2026-04 de la API:

  • Cada cantidad debe traer changeFromQuantity, el último valor que la integración conocía. Si no coincide con el de Shopify, la mutación devuelve un error en lugar de pisar el dato.
  • La mutación exige una clave de idempotencia, para que un reintento no se aplique dos veces.

Cómo cruzar con las bodegas del ERP

El número de ubicaciones activas que puedes tener depende de tu plan de Shopify. Con eso en mente, hay que decidir:

  • Qué bodegas cuentan. La de tránsito, la de mermas o la del canal mayorista normalmente quedan fuera.
  • Cómo se agrupan. Una bodega del ERP por ubicación, o varias sumadas en una.
  • Qué stock se envía. El disponible del ERP, no el físico.
  • Qué pasa con los pedidos que aún no entran al ERP. Shopify ya los descontó de su available. Si el ERP envía su disponible sin haberlos recibido, vuelve a publicar unidades vendidas.

En sobreventa de stock multicanal explicamos el problema completo.

Precios

La variante tiene dos campos de precio, en la moneda de la tienda:

  • price: el precio de venta.
  • compareAtPrice: el precio de comparación. Si es mayor que el precio, la tienda muestra el producto como rebajado.

La lista principal del ERP alimenta price.

Markets, catálogos y listas de precios

Para vender con precios distintos según el mercado o el cliente, Shopify usa catálogos. Un catálogo define a quién se le muestra y lleva una lista de precios (PriceList), que reemplaza el precio base con un ajuste porcentual o con precios fijos por variante. Los precios fijos se cargan con priceListFixedPricesAdd, que acepta hasta 250 precios por llamada.

El cruce con el ERP: cada lista adicional alimenta la lista de precios de un catálogo.

Shopify B2B está disponible en los planes Basic, Grow, Advanced y Shopify Plus. En los tres primeros puedes tener hasta 3 catálogos activos asignados a mercados B2B. Asignar un catálogo directo a una empresa, para darle sus propios precios, solo está en Shopify Plus. El modelo completo está en precios por cliente en un ecommerce B2B.

Antes de cargar precios, confirma si tu tienda muestra los valores con IVA incluido y qué lista del ERP corresponde a eso. Es la causa más común de precios con un 19 % de diferencia.

Pedidos

Hay dos formas de enterarse de un pedido nuevo.

Webhook Consulta periódica
Modelo Shopify avisa a una URL tuya cuando ocurre el evento La integración pregunta cada cierto tiempo
Cómo Suscripción a orders/create, orders/paid, orders/updated, orders/cancelled o refunds/create Consulta orders filtrada por updated_at o financial_status
Si tu sistema se cae Shopify reintenta 8 veces durante 4 horas Retoma desde la última fecha leída

Fuente: About webhooks y Troubleshoot webhooks, Shopify Developer Documentation.

Shopify recomienda usar los dos: su documentación dice que una app no debe depender solo de los webhooks, porque la entrega no siempre está garantizada. Antes de programar, conviene saber que:

  • Tu servidor debe responder en menos de cinco segundos.
  • Pueden llegar avisos duplicados. Cada entrega trae el encabezado X-Shopify-Webhook-Id para detectarlos.
  • Cada aviso viene firmado en el encabezado X-Shopify-Hmac-SHA256. Hay que validar la firma.
  • Después de 8 fallos seguidos, Shopify elimina la suscripción si se creó por la Admin API.

Estados

Un pedido tiene dos estados independientes:

  • Financiero (displayFinancialStatus): PENDING, AUTHORIZED, PAID, PARTIALLY_REFUNDED, REFUNDED y VOIDED, entre otros.
  • De preparación (displayFulfillmentStatus): UNFULFILLED, PARTIALLY_FULFILLED y FULFILLED, entre otros.

Para un ERP, la señal habitual es el estado financiero PAID. Los pagos manuales quedan en PENDING, y hay que definir si esos pedidos entran al ERP de inmediato o al pagarse.

El límite de 60 días

Por defecto, una app solo puede leer los pedidos creados en los últimos 60 días. Para llegar más atrás hay que sumar el permiso read_all_orders a read_orders. Las apps creadas en el Dev Dashboard de tu propia organización, para tus propias tiendas, no necesitan la aprobación de Shopify para ese permiso.

Despacho y reembolsos

Cuando el ERP despacha, la integración crea el despacho con la mutación fulfillmentCreate, que admite los datos de seguimiento. Los reembolsos se leen del objeto Refund del pedido o llegan con el webhook refunds/create, y en el ERP corresponden a una nota de crédito.

Boleta, factura y RUT en Chile

La documentación de la Admin API que revisamos no incluye la emisión de documentos tributarios electrónicos ante el SII. Shopify registra el pedido. El DTE lo emite tu ERP o tu proveedor de facturación.

La regla habitual en Chile es boleta para personas y factura para empresas. El problema es dónde queda el RUT, porque el pedido no tiene un campo con ese nombre. Puede quedar en:

Campo del pedido Qué es
billingAddress.company El campo de empresa de la dirección de facturación
note La nota del pedido, de hasta 5.000 caracteres
customAttributes Información adicional adjunta al pedido
metafields Campos personalizados del pedido

Fuente: Order, Shopify Developer Documentation.

Cuál se usa depende de cómo esté armado tu checkout. La integración tiene que saber qué campo usas, validar el RUT y buscar al cliente en el ERP antes de crearlo. Si el checkout no pide el RUT, no hay cómo emitir una factura sin llamar al cliente. Las reglas de boleta y factura son las que describimos en facturación electrónica para tiendas online en Chile.

Límites de la API

La GraphQL Admin API no cuenta llamadas. Cuenta puntos. Cada consulta tiene un costo según los campos que pide, y cada combinación de app y tienda tiene un saldo que se recupera por segundo:

Plan Puntos por segundo
Estándar 100
Advanced 200
Shopify Plus 1.000
Shopify para grandes empresas (Commerce Components) 2.000

Fuente: Shopify API limits, Shopify Developer Documentation.

Reglas que afectan el diseño de una integración:

  • Un objeto cuesta 1 punto y una mutación cuesta 10. Las listas cuestan según cuántos elementos pides.
  • Una sola consulta no puede costar más de 1.000 puntos, sin importar el plan.
  • Si el saldo se agota, la API responde con el error THROTTLED y hay que esperar.

Para volúmenes grandes existen las operaciones masivas (bulk operations). No tienen el límite de costo ni el de velocidad de las consultas normales y entregan el resultado en un archivo JSONL.

Errores típicos

  • Variantes sin SKU o con SKU distinto. El producto existe en los dos sistemas y no se cruza.
  • Pisar el stock con pedidos sin procesar. El ERP envía su disponible antes de recibir pedidos que Shopify ya descontó.
  • Variantes que venden sin stock. La política de inventario de la variante (inventoryPolicy) está en CONTINUE y no en DENY.
  • Depender solo de los webhooks. Un aviso perdido es un pedido que nunca llega al ERP.
  • Pedidos duplicados. La integración no revisa si el pedido ya existe en el ERP.
  • Token vencido. El token dura 24 horas y la integración no lo renueva.
  • Checkout sin RUT. Los pedidos de empresas entran sin los datos para facturar.

Qué definir antes de partir

  • Que el SKU de cada variante sea el código del ERP, escrito igual.
  • Qué bodegas del ERP alimentan cada ubicación de Shopify.
  • Qué lista es el precio de la variante y cuáles van a catálogos.
  • En qué estado se lee el pedido y qué documento crea en el ERP.
  • En qué campo del pedido queda el RUT.
  • Quién crea la app y quién guarda sus credenciales.
  • Qué pasa con los reembolsos: nota de crédito automática o aviso a tu equipo.

ERPSync con Shopify

ERPSync conecta el ERP con Shopify con una app propia sobre la Admin API y los webhooks oficiales, sin instalar apps de terceros. Funciona desde el plan Basic. Nuestra especialidad es Softland: en la ficha de Softland con Shopify está el detalle de qué se sincroniza, el cruce de campos y los requisitos. El stock y los precios se actualizan cada 5 minutos, por ubicación, desde las bodegas y listas que elijas. Cada pedido entra a Softland en cuanto Shopify lo notifica, como nota de venta o factura, con el cliente identificado por RUT. Los reembolsos se registran como nota de crédito.

También trabajamos con otros ERP, previa revisión técnica de tu caso. Entre ellos están Bsale con Shopify, Defontana con Shopify y la conexión de Odoo con Shopify. La lista completa está en integraciones.

Cuesta 0,80 UF al mes por integración, sin límite de pedidos ni de productos. Puede haber un costo inicial, que cotizamos después de revisar tu caso. Hay prueba de 14 días. El detalle está en precios.

Preguntas frecuentes

¿Shopify tiene API para conectar un ERP?

Sí. Se llama Admin API y permite leer y escribir productos, inventario, precios y pedidos. La versión vigente es GraphQL. La versión REST es legacy desde octubre de 2024.

¿Necesito Shopify Plus para integrar mi ERP?

No. Nuestra integración funciona desde el plan Basic. Plus cambia los límites: más puntos por segundo en la API y catálogos asignados directo a cada empresa en B2B.

¿Conviene usar webhooks o consultar los pedidos cada cierto tiempo?

Las dos cosas. La entrega de los webhooks no está garantizada, y Shopify recomienda sumar una consulta periódica que recupere lo perdido.

¿Por qué mi integración no ve los pedidos antiguos?

Porque una app solo lee los pedidos de los últimos 60 días, salvo que tenga el permiso read_all_orders.

¿Shopify emite boleta o factura electrónica en Chile?

En la documentación de su Admin API no aparece la emisión de DTE ante el SII. El documento lo emite tu ERP o tu proveedor de facturación.

Fuentes

Consultadas el 12 de noviembre de 2026.

Escrito por el equipo de ERPSync, especialistas en integraciones con Softland. Quiénes somos

Conecta tu ERP y deja de digitar pedidos

Revisamos tu instalación gratis y te respondemos en menos de un día hábil.