La API de Shopify permite integrar la tienda online con ERP, CRM, herramientas de BI, plataformas logísticas y cualquier otra aplicación mediante un amplio conjunto de recursos y campos que se pueden consultar, crear o actualizar.
PRODUCTS
Gestión completa de los productos del catálogo.
- id – Identificador único del producto.
- title – Nombre del producto.
- body_html – Descripción en HTML.
- vendor – Marca o proveedor.
- product_type – Tipo o familia de producto.
- status – Estado (active, draft, archived).
- created_at / updated_at / published_at – Fechas clave del ciclo de vida.
- handle – Identificador SEO usado en la URL.
- tags – Etiquetas para búsqueda y segmentación.
- template_suffix – Plantilla de theme asociada.
- variants[] – Variantes del producto.
- options[] – Opciones de variante (talla, color, etc.).
- images[] / image – Imágenes asociadas y principal.
VARIANTS
Variantes de un producto (tallas, colores, formatos, etc.).
- id – Identificador de la variante.
- product_id – ID del producto padre.
- title – Nombre de la variante.
- sku – Referencia interna (SKU).
- price / compare_at_price – Precio de venta y precio “tachado”.
- position – Orden dentro del producto.
- option1 / option2 / option3 – Valores de opciones (p.ej. “Rojo”, “XL”).
- inventory_management – Sistema que gestiona el stock (shopify, external…).
- inventory_policy – Política de stock (permitir/no vender sin stock).
- taxable – Indica si aplica impuestos.
- barcode – Código de barras (EAN/UPC, etc.).
- grams / weight / weight_unit – Peso y unidad.
- image_id – Imagen específica de la variante.
- requires_shipping – Si necesita envío físico.
INVENTORY ITEMS
Artículos de inventario usados para controlar stock, coste y datos logísticos.
- id – Identificador del ítem de inventario.
- sku – SKU asociado.
- cost – Coste unitario.
- tracked – Indica si el stock se controla.
- requires_shipping – Si requiere envío.
- country_code_of_origin / province_code_of_origin – Origen de mercancía.
- harmonized_system_code – Código arancelario HS.
INVENTORY LEVELS
Niveles de stock por ubicación.
- inventory_item_id – Ítem de inventario.
- location_id – Almacén/ubicación.
- available – Unidades disponibles.
- updated_at – Última actualización.
LOCATIONS
Almacenes y ubicaciones físicas donde se gestiona stock y preparación de pedidos.
- id – Identificador de la ubicación.
- name – Nombre del almacén o punto de venta.
- address1 / address2 / city / zip / province / country – Dirección completa.
- phone – Teléfono.
- active – Si la ubicación está activa.
- legacy – Marca ubicaciones antiguas/heredadas.
CUSTOMERS
Ficha de clientes de la tienda Shopify.
- id – Identificador de cliente.
- email / phone – Datos de contacto.
- first_name / last_name – Nombre y apellidos.
- state – Estado del cliente (enabled, disabled).
- note – Nota interna.
- verified_email – Email verificado.
- tax_exempt – Exento de impuestos.
- tags – Etiquetas para segmentación.
- last_order_id / last_order_name – Último pedido asociado.
- orders_count / total_spent – Nº de pedidos y total gastado.
- created_at / updated_at – Fechas de alta y actualización.
- default_address – Dirección por defecto.
- addresses[] – Otras direcciones del cliente.
ORDERS
Gestión de pedidos realizados en la tienda Shopify.
- id – Identificador del pedido.
- name / order_number – Número y referencia visible.
- customer – Datos del cliente asociado.
- currency / presentment_currency – Moneda del pedido y de presentación.
- subtotal_price / total_price / total_tax / total_discounts – Resumen económico.
- total_line_items_price / total_weight – Total líneas de producto y peso.
- financial_status / fulfillment_status – Estado de cobro y de logística.
- cancel_reason / cancelled_at – Información de cancelación.
- billing_address / shipping_address – Facturación y envío.
- discount_codes[] / discount_applications[] – Descuentos aplicados.
- line_items[] / shipping_lines[] / tax_lines[] – Detalle de productos, envío e impuestos.
- fulfillments[] / refunds[] – Envíos y devoluciones asociadas.
- tags / source_name / referring_site – Origen y clasificación del pedido.
LINE ITEMS
Líneas de producto dentro de un pedido.
- id – ID de la línea.
- product_id / variant_id – Producto y variante.
- title / variant_title – Nombre de producto y variante.
- quantity – Cantidad pedida.
- sku – SKU asociado.
- price – Precio unitario.
- total_discount – Descuento total de la línea.
- discount_allocations[] – Detalle de descuentos.
- fulfillable_quantity – Cantidad pendiente de enviar.
- tax_lines[] / duties[] – Impuestos y aranceles.
SHIPPING LINES
Conceptos de envío aplicados al pedido.
- id – ID de la línea de envío.
- title – Nombre del método de envío.
- code – Código interno/transportista.
- price / discounted_price – Coste del envío.
- carrier_identifier – Identificador del transportista.
- tax_lines[] / discount_allocations[] – Impuestos y descuentos del envío.
FULFILLMENTS
Envíos realizados sobre un pedido.
- id – ID del fulfillment.
- order_id – Pedido asociado.
- status – Estado del envío.
- location_id – Ubicación desde la que se envía.
- tracking_company – Transportista.
- tracking_number / tracking_url – Datos de seguimiento.
- line_items[] – Líneas incluidas en este envío.
TRANSACTIONS
Transacciones de pago asociadas a un pedido.
- id – ID de la transacción.
- order_id – Pedido.
- amount – Importe.
- currency – Moneda.
- gateway – Pasarela de pago.
- kind – Tipo (sale, refund, etc.).
- status – Estado (success, failure…).
- test – Si es transacción de prueba.
- authorization / receipt – Datos de autorización y recibo.
REFUNDS
Devoluciones generadas sobre pedidos.
- id – ID de la devolución.
- order_id – Pedido asociado.
- created_at / processed_at – Fechas clave.
- note – Comentario interno.
- refund_line_items[] – Líneas devueltas.
- transactions[] – Transacciones de reembolso.
DRAFT ORDERS
Pedidos borrador para presupuestos, ventas asistidas o pedidos creados desde backoffice.
- id – ID de borrador.
- name / status – Nombre y estado del borrador.
- email – Email del cliente.
- note – Nota interna.
- currency – Moneda.
- invoice_sent / invoice_url – Estado y enlace de factura enviada.
- completed_at – Cuándo se convirtió en pedido.
- line_items[] – Productos incluidos.
- billing_address / shipping_address – Direcciones.
- applied_discount – Descuento aplicado.
- shipping_line – Propuesta de envío.
- subtotal_price / total_price / total_tax – Totales.
- tags – Etiquetas.
PRICE RULES
Reglas de precio y condiciones avanzadas de descuento.
- id – ID de la regla.
- title – Nombre de la promoción.
- target_type / target_selection – Tipo de objetivo y selección (líneas, envío, etc.).
- allocation_method – Cómo se reparte el descuento.
- value_type / value – Tipo (porcentaje, importe fijo) y valor.
- once_per_customer – Límite de uso por cliente.
- usage_limit – Nº máximo de usos.
- starts_at / ends_at – Vigencia de la regla.
- entitled_product_ids[] / entitled_collection_ids[] – Productos/colecciones incluidas.
- customer_selection – Clientes objetivo (todos o segmentos).
DISCOUNT CODES
Códigos de descuento asociados a las price rules.
- id – ID del código.
- price_rule_id – Regla de precio asociada.
- code – Código que introduce el cliente.
- usage_count – Número de usos realizados.
- created_at / updated_at – Fechas.
CARRIER SERVICES (LEGACY / CUSTOM APPS)
Servicios de transportista personalizados usados para calcular gastos de envío vía API.
- id – Identificador del servicio.
- name – Nombre mostrado.
- active – Si está activo.
- carrier_service_type – Tipo (api, legacy, etc.).
- callback_url – URL a la que Shopify llama para obtener tarifas.
- format – Formato de respuesta esperado.
- service_discovery – Descubrimiento automático de servicios.
Si quieres ver cómo aprovechamos estos recursos para integrar Shopify con ERP, CRM, plataformas logísticas o cualquier otra herramienta, ponte en contacto con nuestro equipo y te ayudamos a diseñar la integración que necesitas.
