Squarespace - Obtener Pedidos

Descripción

Este módulo permite consultar los pedidos de una tienda Squarespace. Puede obtener un pedido específico por ID o listar pedidos filtrados por estado de fulfillment y fechas.

Configuración

Credenciales Requeridas

• API Key: Clave API de Squarespace

Parámetros

Parámetro	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Squarespace
order_id	string	No	ID del pedido específico
fulfillmentStatus	select	No	Estado: PENDING, FULFILLED, CANCELED
modifiedAfter	string	No	Pedidos modificados después de (ISO 8601)
modifiedBefore	string	No	Pedidos modificados antes de (ISO 8601)
cursor	string	No	Cursor de paginación

Estados de Fulfillment

• PENDING: Pedido pendiente de envío
• FULFILLED: Pedido completamente enviado
• CANCELED: Pedido cancelado

Salida

{
  "success": true,
  "orders": [...],
  "count": 25,
  "hasNextPage": true,
  "nextCursor": "abc123...",
  "message": "25 pedidos obtenidos"
}

Campos de Pedido

• id: ID del pedido
• orderNumber: Número de pedido visible
• createdOn: Fecha de creación
• modifiedOn: Fecha de modificación
• fulfillmentStatus: Estado de fulfillment
• customerEmail: Email del cliente
• lineItems: Productos del pedido
• shippingAddress: Dirección de envío
• billingAddress: Dirección de facturación
• grandTotal: Total del pedido
• subtotal: Subtotal
• shippingTotal: Total de envío
• taxTotal: Total de impuestos

Ejemplo de Uso

Obtener pedido por ID

{
  "order_id": "5f3e..."
}

Pedidos pendientes

{
  "fulfillmentStatus": "PENDING"
}

Pedidos del último mes

{
  "modifiedAfter": "2024-01-01T00:00:00Z",
  "modifiedBefore": "2024-01-31T23:59:59Z"
}

API Utilizada

• Endpoint: GET /1.0/commerce/orders
• Documentación: Squarespace Orders API

Notas

• Los pedidos no pueden ser modificados directamente via API
• Para marcar como enviado, usar el módulo CreateFulfillment
• Los precios se devuelven en la moneda configurada en la tienda
• La API incluye información completa de direcciones y productos

Nodos Relacionados

• SquarespaceCreateFulfillment - Marcar pedido como enviado con tracking
• SquarespaceGetProducts - Obtener datos de productos del pedido
• SquarespaceGetProfiles - Obtener perfil del cliente del pedido
• SquarespaceGetTransactions - Obtener transacciones de pago del pedido