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:
- En el panel de Shopify, ir a Configuración > Apps, elegir “Develop apps” y luego “Build apps in Dev Dashboard”.
- Crear la app y una versión. En la sección de acceso de la versión se escriben los permisos (scopes).
- 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-Tokende 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
skudistingue mayúsculas de minúsculas.ABC-01yabc-01son 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-Idpara 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,REFUNDEDyVOIDED, entre otros. - De preparación (
displayFulfillmentStatus):UNFULFILLED,PARTIALLY_FULFILLEDyFULFILLED, 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
THROTTLEDy 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á enCONTINUEy no enDENY. - 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.
- GraphQL Admin API reference, Shopify Developer Documentation
- REST Admin API reference, Shopify Developer Documentation
- API versioning, Shopify Developer Documentation
- Shopify API limits, Shopify Developer Documentation
- Shopify API access scopes, Shopify Developer Documentation
- Authenticate an app for stores in your organization, Shopify Developer Documentation
- Installing and setting up apps, Shopify Help Center
- About apps, Shopify Help Center
- ProductVariant, Shopify Developer Documentation
- productVariantsBulkUpdate, Shopify Developer Documentation
- InventoryItem, Shopify Developer Documentation
- InventoryLevel, Shopify Developer Documentation
- Location, Shopify Developer Documentation
- Apps in inventory management, Shopify Developer Documentation
- inventorySetQuantities, Shopify Developer Documentation
- ProductVariantInventoryPolicy, Shopify Developer Documentation
- Setting up and managing locations, Shopify Help Center
- Setting sale prices for products, Shopify Help Center
- PriceList, Shopify Developer Documentation
- Build a catalog, Shopify Developer Documentation
- Shopify B2B features by plan, Shopify Help Center
- Order, Shopify Developer Documentation
- OrderDisplayFinancialStatus, Shopify Developer Documentation
- OrderDisplayFulfillmentStatus, Shopify Developer Documentation
- About webhooks, Shopify Developer Documentation
- Verify webhook deliveries, Shopify Developer Documentation
- Troubleshoot webhooks, Shopify Developer Documentation
- fulfillmentCreate, Shopify Developer Documentation
- Bulk operations, Shopify Developer Documentation
Escrito por el equipo de ERPSync, especialistas en integraciones con Softland. Quiénes somos