Fulfillment
El dominio de Fulfillment gestiona el ciclo de vida completo de envíos y devoluciones.
Shipments
Crear envío
POST /api/v1/fulfillment/shipments
Crea un envío asociado a una orden.
Obtener envío
GET /api/v1/fulfillment/shipments/:id
Marcar como enviado
POST /api/v1/fulfillment/shipments/:id/ship
Marcar como entregado
POST /api/v1/fulfillment/shipments/:id/deliver
Marcar como fallido
POST /api/v1/fulfillment/shipments/:id/fail
Cancelar envío
POST /api/v1/fulfillment/shipments/:id/cancel
Split Shipments
Permite dividir una orden en múltiples envíos (por ejemplo, items de diferentes bodegas).
Crear envío parcial
POST /api/v1/fulfillment/fulfillments/:id/shipments
Listar envíos por fulfillment
GET /api/v1/fulfillment/fulfillments/:id/shipments
Listar envíos por orden
GET /api/v1/fulfillment/orders/:order_id/shipments
Cotizaciones de envío
Solicita tarifas de envío de múltiples transportistas.
POST /api/v1/fulfillment/shipping/quotes
Returns (Devoluciones)
Solicitar devolución
POST /api/v1/fulfillment/returns
Crea una solicitud de RMA (Return Merchandise Authorization).
Obtener devolución
GET /api/v1/fulfillment/returns/:id
Aprobar devolución
POST /api/v1/fulfillment/returns/:id/approve
Completar devolución
Marca la devolución como completada (item recibido y procesado).
POST /api/v1/fulfillment/returns/:id/complete
Rechazar devolución
POST /api/v1/fulfillment/returns/:id/reject
Estados de envío
| Estado | Descripción |
|---|---|
pending | Envío creado, pendiente de procesamiento |
shipped | Enviado al cliente |
delivered | Entregado exitosamente |
failed | Falló la entrega |
cancelled | Cancelado |
Estados de devolución
| Estado | Descripción |
|---|---|
requested | Solicitud creada por el cliente |
approved | Aprobada por el merchant |
rejected | Rechazada |
completed | Devolución procesada |