Órdenes
POST
Cambiar el estado de la entrega
POST /api/pos-order/set-delivery-status
Descripción
Avanza la entrega a domicilio a su siguiente estado: en camino, entregada, fallida o cancelada.
Detalles
Cambia el estado de seguimiento de la entrega a domicilio y registra la fecha y hora del cambio. Solo permite transiciones válidas desde el estado actual y exige un repartidor asignado para poner la entrega en camino o marcarla entregada. Al marcarla fallida se guarda el motivo.
Permisos requeridos
orders.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| orderUuid | string | Sí |
min:36
max:36
|
| status | string | Sí |
enum:in_transit,delivered,failed,cancelled
|
| failureReason | string | No |
max:300
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/pos-order/set-delivery-status \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"orderUuid": "string",
"status": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"orderUuid": "4c33e2f6-e08f-49b2-a542-c1da178dcb71",
"status": "in_transit"
}Response
{
"success": true,
"message": "Entrega actualizada",
"data": {
"orderUuid": "4c33e2f6-e08f-49b2-a542-c1da178dcb71"
}
}