Entregar artículos
Registra envíos o recogidas, completos o parciales, con transportista y seguimiento.
Que se logra
- Resultado: el pedido muestra qué se entregó, su estado pasa a
Partially fulfilledoFulfilledy el comprador recibe un correo y ve el seguimiento en/o/{path}. - Caso de uso: una tienda envía 2 de 3 productos hoy con número de guía y despacha el tercero cuando llega el stock.
- Se combina con: el trigger
Order fulfillment updatedpara avisar al cliente por WhatsApp o correo.
Donde esta
- Ruta:
/[orgId]/finance/orders/[id] - Acceso en UI: detalle del pedido >
Fulfill items
Como funciona
- Pulsa
Fulfill items. - Indica la cantidad por artículo (hasta lo pendiente en
Remaining). - Elige
Statusy, si aplica,Carrier,Tracking numberyTracking URL. - Pulsa
Create fulfillment. Después cambia el estado desde la secciónFulfillmentsconUpdate status.
Campos y opciones
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| Quantity por artículo | número | Al menos uno | No supera la cantidad pendiente. |
| Status | lista | Sí | Pending, Ready for pickup, In transit, Delivered, Cancelled. |
| Carrier / Tracking number / Tracking URL | texto | No | Se muestran al comprador. |
| Notes | texto | No | Notas del envío. |
Reglas y validaciones
- Solo cuentan como entregados los envíos en
Ready for pickup,In transitoDelivered. - El estado de entrega se recalcula:
Unfulfilled,Partially fulfilledoFulfilled.Returnedse mantiene si se marcó. - Cada cambio de estado de entrega dispara
Order fulfillment updatedcon el estado anterior. - Cuando un envío pasa a
Ready for pickup,In transitoDelivered, el comprador recibe un correo con los artículos, transportista, número de guía, botónTrack shipment(si hay URL) y link a su pedido. Para recogida incluye el punto de recogida.
Backend
- Servicios:
order-fulfillments(create, patch),orders. - Hooks relevantes:
prepare-order-fulfillment,sync-order-after-fulfillment(recalcula el pedido y envía el correo al comprador).
Relaciones
- Requiere: un pedido
Opencon artículos pendientes. - Dispara / afecta:
fulfilled_quantitypor artículo, estado de entrega y triggerOrder fulfillment updated.