Squarespace - Crear Fulfillment

Descripción

Este módulo permite marcar un pedido como enviado y agregar información de seguimiento (tracking). Opcionalmente envía una notificación al cliente.

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	Sí	ID del pedido
tracking_number	string	No	Número de seguimiento
tracking_url	string	No	URL de seguimiento personalizada
carrier_name	string	No	Nombre del transportista (UPS, FedEx, etc.)
service	string	No	Servicio de envío (Ground, Express, etc.)
send_notification	boolean	No	Enviar notificación al cliente (default: true)

Salida

{
  "success": true,
  "fulfillment": {...},
  "order_id": "5f3e...",
  "message": "Fulfillment creado para pedido 5f3e..."
}

Ejemplo de Uso

Marcar como enviado (sin tracking)

{
  "order_id": "5f3e...",
  "send_notification": true
}

Con información de tracking

{
  "order_id": "5f3e...",
  "tracking_number": "1Z999AA10123456784",
  "carrier_name": "UPS",
  "service": "Ground",
  "send_notification": true
}

Con URL de tracking personalizada

{
  "order_id": "5f3e...",
  "tracking_number": "ABC123",
  "tracking_url": "https://mi-transportista.com/track/ABC123",
  "carrier_name": "Mi Transportista Local"
}

Sin notificación al cliente

{
  "order_id": "5f3e...",
  "tracking_number": "1Z999AA10123456784",
  "carrier_name": "FedEx",
  "send_notification": false
}

API Utilizada

• Endpoint: POST /1.0/commerce/orders/{id}/fulfillments
• Documentación: Squarespace Fulfillments API

Notas

• Un pedido solo puede tener un fulfillment
• Una vez creado el fulfillment, el estado cambia a FULFILLED
• El carrier_name es texto libre, no hay lista predefinida
• Si send_notification es true, el cliente recibe email con tracking
• Los fulfillments no pueden ser eliminados o modificados

Nodos Relacionados

• SquarespaceGetOrders - Obtener pedidos pendientes de envío
• SquarespaceGetProducts - Obtener productos del pedido
• SquarespaceGetProfiles - Obtener datos del cliente del pedido