Shopify - Obtener Pedidos

Descripcion

Este modulo permite consultar pedidos de tu tienda Shopify con filtros por estado financiero, estado de envio, fechas, cliente y mas.

Configuracion

Campo	Tipo	Requerido	Descripcion
`credentials_id`	string	Si	ID de las credenciales de Shopify
`order_id`	number	No	ID de pedido especifico
`customer_id`	number	No	Pedidos de un cliente especifico
`status`	string	No	open, closed, cancelled, any
`financial_status`	string	No	Estado de pago
`fulfillment_status`	string	No	Estado de envio
`created_at_min`	string	No	Creado desde (ISO 8601)
`created_at_max`	string	No	Creado hasta (ISO 8601)
`updated_at_min`	string	No	Actualizado desde (ISO 8601)
`updated_at_max`	string	No	Actualizado hasta (ISO 8601)
`processed_at_min`	string	No	Procesado desde (ISO 8601)
`processed_at_max`	string	No	Procesado hasta (ISO 8601)
`limit`	number	No	Limite de resultados (max 250)
`since_id`	number	No	Pedidos con ID mayor a este
`fields`	string	No	Campos a devolver

Credenciales

Este modulo requiere credenciales de tipo Shopify.

Campo	Descripcion
`shop_domain`	Dominio de la tienda (mi-tienda.myshopify.com)
`access_token`	Token de acceso de la Admin API

Estados Financieros (financial_status)

Valor	Descripcion
`pending`	Pago pendiente
`authorized`	Pago autorizado
`partially_paid`	Parcialmente pagado
`paid`	Pagado
`partially_refunded`	Parcialmente reembolsado
`refunded`	Reembolsado
`voided`	Anulado
`any`	Cualquier estado
`unpaid`	No pagado (pending + authorized)

Estados de Envio (fulfillment_status)

Valor	Descripcion
`shipped`	Enviado completamente
`partial`	Enviado parcialmente
`unshipped`	No enviado
`unfulfilled`	Sin preparar
`any`	Cualquier estado

Salida

{
  "success": true,
  "orders": [
    {
      "id": 123456789,
      "order_number": 1001,
      "name": "#1001",
      "email": "cliente@ejemplo.com",
      "financial_status": "paid",
      "fulfillment_status": "unfulfilled",
      "total_price": "89.99",
      "subtotal_price": "79.99",
      "total_tax": "10.00",
      "line_items": [],
      "shipping_address": {},
      "billing_address": {},
      "created_at": "2024-01-15T10:30:00-05:00"
    }
  ],
  "total": 45,
  "filters_applied": {}
}

Ejemplo de Uso

Pedidos listos para enviar

{
  "credentials_id": "shopify_tienda",
  "financial_status": "paid",
  "fulfillment_status": "unfulfilled",
  "limit": 50
}

Pedidos de hoy

{
  "credentials_id": "shopify_tienda",
  "created_at_min": "2024-01-15T00:00:00Z",
  "created_at_max": "2024-01-15T23:59:59Z"
}

Pedidos de un cliente

{
  "credentials_id": "shopify_tienda",
  "customer_id": 987654321,
  "limit": 20
}

Notas

Por defecto solo devuelve pedidos abiertos (status=open)
Para ver todos los pedidos, usa status: "any"
El limite maximo por peticion es 250 pedidos
Las fechas deben estar en formato ISO 8601
Los pedidos se devuelven ordenados por fecha de creacion descendente

Nodos relacionados

ShopifyUpdateOrder - Actualizar, cancelar o cerrar pedidos
ShopifyGetCustomers - Obtener datos del cliente de un pedido
ShopifyGetProducts - Obtener detalles de productos en el pedido