Toma de pedidos
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. En el modo lite no exige repartidor: el pedido aprobado pasa de pendiente a en camino y luego a entregado.
Permisos requeridos
orders.module
lite.module
El usuario solo necesita uno de los permisos listados.
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://restofy.pro/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-10-09T02:12:12Z
HTTP 200
Request
{
"orderUuid": "c8719696-4898-4c61-acae-38fe8c34ae76",
"status": "in_transit",
"failureReason": null
}Response
{
"success": true,
"message": "Entrega actualizada",
"data": {
"orderUuid": "c8719696-4898-4c61-acae-38fe8c34ae76"
}
}