Shopify

Descripción

Integración completa con la Shopify Admin API. Cubre las principales operaciones de e-commerce: productos (CRUD, variantes, imágenes), pedidos (consultar, crear, actualizar, cancelar, cerrar), reembolsos, fulfillment, clientes, colecciones, inventario, descuentos, webhooks y metafields.

La autenticación se resuelve mediante el módulo de credenciales (tipo de servicio shopify). La paginación y los filtros se construyen automáticamente.

Operaciones

Obtener pedidos Consultá pedidos con filtros y paginación.

Actualizar pedido Actualizá, cancelá o cerrá un pedido.

Obtener productos Listá productos con variantes e imágenes.

Crear producto Creá productos (borrador por defecto).

Actualizar producto Actualizá datos, precio y stock del producto.

Obtener clientes Buscá y listá clientes.

Crear cliente Creá un registro de cliente.

Actualizar cliente Actualizá los datos del cliente.

Configuración

Parámetro	Tipo	Obligatorio	Descripción
credentials_id	credentials	Sí	Credencial de Shopify
operation	text	Sí	Operación a ejecutar (más de 35 disponibles)
limit	number	No	Límite de resultados (máx. 250)
status	select	No	Estado: active, draft, archived
product_id	text	Condicional	ID del producto
order_id	text	Condicional	ID del pedido
customer_id	text	Condicional	ID del cliente
created_at_min / created_at_max	datetime	No	Rango de fecha de creación
financial_status	text	No	Estado financiero del pedido
fulfillment_status	text	No	Estado de envío del pedido

Credenciales

Tipo de servicio: shopify. Se guardan en la tabla servicecredentials.

shopDomain: Dominio de la tienda (ej.: mi-tienda.myshopify.com)
accessToken: Token de acceso de app privada o personalizada
apiVersion: Versión de la API (ej.: 2024-01)

Salida

{
  "nextModule": null,
  "data": [
    { "id": 1234567890, "title": "Camiseta Premium", "status": "active",
      "variants": [{ "id": 111, "price": "29.99", "sku": "CAM-001" }] }
  ],
  "_meta_": { "operation": "getProducts", "recordCount": 1, "executionTime": "200ms" }
}

API utilizada

Shopify Admin REST API — https://shopify.dev/docs/api/admin-rest

Notas

El límite máximo de registros por petición es 250 (impuesto por Shopify).
Los productos se crean en estado “draft” por defecto.
Las colecciones smart y custom usan endpoints distintos.
El timeout de la petición es de 30 segundos.