Saltar al contenido principal
Si su tienda vende productos físicos, use estos endpoints para conectar su almacén o su software de envíos. Su tienda debe estar aprobada para productos físicos en Configuración › Productos físicos.

1. Encontrar pedidos por enviar

to_ship lista los pedidos pagados con artículos aún no enviados, empezando por los más antiguos. Otros filtros: in_transit, delivered, issues (entregas fallidas, devoluciones) y all. GET /orders/{invoiceId} devuelve la dirección, cada artículo con shipped_quantity, los envíos, las devoluciones y las notas.

2. Crear un envío

  • Omita items para enviar todo lo que queda pendiente. Para un envío parcial, envíe items: [{ "invoice_item_id": 55, "qty": 1 }].
  • El cliente recibe un correo con el enlace de seguimiento. Envíe notify_customer: false para omitirlo.
  • El enlace de seguimiento se genera a partir del transportista. GET /shipping lista los códigos de transportista.

3. Actualizar el estado

Estados: label_created, shipped, in_transit, out_for_delivery, delivered, failed_attempt, returned_to_sender. Cada uno se agrega a la línea de tiempo de seguimiento que ve el cliente. El fulfillment_status del pedido sigue a los envíos automáticamente.

Devoluciones

Los clientes solicitan devoluciones desde la página de su pedido dentro del plazo de devolución del producto. Gestiónelas con PATCH /orders/{invoiceId}/returns/{returnId}: GET /returns?status=requested lista las solicitudes abiertas de todos los pedidos.

Configuración de envíos

Consulte y modifique zonas, tarifas y ubicaciones de almacén con /shipping/zones y /shipping/locations. Cotice una cesta con POST /shipping/quote.