Shopify

Descripcion

Este modulo proporciona una integracion completa con la Shopify Admin API. Cubre todas las operaciones principales del e-commerce: productos (CRUD completo, variantes, imagenes), pedidos (consulta, creacion, actualizacion, cancelacion, cierre), reembolsos (calcular, crear, detectar), fulfillment (crear envio, actualizar tracking), clientes (CRUD, busqueda, pedidos por cliente), colecciones (smart y custom, agregar/quitar productos), inventario (niveles, ubicaciones, ajustes), descuentos (codigos, price rules), webhooks y metafields.

El modulo utiliza funciones auxiliares HTTP (shopifyGet, shopifyPost, shopifyPut, shopifyDelete) y construye parametros de paginacion y filtros automaticamente. La autenticacion se maneja a traves del modulo de credenciales.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial Shopify
operation	text	Si	Operacion a realizar (mas de 35 operaciones disponibles)
limit	number	No	Limite de resultados (max 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
collection_id	text	No	ID de la coleccion
product_type	text	No	Tipo de producto
vendor	text	No	Proveedor
since_id	text	No	ID desde el cual paginar
created_at_min / created_at_max	datetime	No	Rango de fechas de creacion
financial_status	text	No	Estado financiero del pedido
fulfillment_status	text	No	Estado de envio del pedido

Credenciales

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

Campos de configuracion:

• shopDomain: Dominio de la tienda (ej: mi-tienda.myshopify.com)
• accessToken: Token de acceso de la app privada o custom app
• apiVersion: Version 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"
  }
}

Ejemplo de Uso

Caso basico - Obtener productos

{
  "credentials_id": 1,
  "operation": "getProducts",
  "limit": 50,
  "status": "active"
}

API Utilizada

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

Notas

• El limite maximo de registros por solicitud es 250 (impuesto por Shopify)
• Los productos se crean en estado “draft” por defecto
• La deteccion de reembolsos (detectOrderRefunds) devuelve informacion detallada: montos, lineas reembolsadas, estado financiero
• Los descuentos se crean en dos pasos: primero una price rule y luego el codigo de descuento
• Las colecciones smart y custom se manejan con endpoints diferentes
• La busqueda de clientes usa el endpoint /customers/search.json con parametro query
• Los metafields se pueden asociar a cualquier recurso (productos, pedidos, clientes, etc.)
• El timeout de solicitudes es de 30 segundos
• Los errores de Shopify se parsean automaticamente desde el formato clave:valor

Nodos relacionados

• Obtener Productos, Obtener Producto, Crear Producto, Actualizar Producto, Eliminar Producto
• Variantes: Obtener, Crear, Actualizar, Eliminar
• Inventario: Niveles, Establecer, Ajustar, Ubicaciones
• Pedidos: Obtener, Crear, Actualizar, Cancelar, Cerrar
• Reembolsos: Obtener, Calcular, Crear, Detectar
• Fulfillment: Obtener, Crear, Actualizar Tracking
• Clientes: Obtener, Crear, Actualizar, Eliminar, Pedidos de Cliente
• Colecciones, Descuentos, Webhooks, Metafields, Info Tienda