Toma de pedidos
POST
Contexto general de la orden
POST /api/pos-order/get-order-context
Descripción
Devuelve los datos básicos de una orden: código, estado, mesa, zona, mesero, canal de venta, canal de entrega y notas.
Detalles
Retorna la información cabecera de la orden necesaria para identificarla a alto nivel: código y estado, mesa y zona asignadas, mesero responsable, canal de venta, canal de entrega y notas. Falla si la orden no existe o no es accesible para el usuario.
Permisos requeridos
orders.module
orders.integration
El usuario solo necesita uno de los permisos listados.
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| orderUuid | string | Sí |
min:36
max:36
|
Ejemplo de request
curl -X POST https://restofy.pro/api/pos-order/get-order-context \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"orderUuid": "string"
}'
Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-13T21:05:19Z
HTTP 200
Request
{
"orderUuid": "a829f583-b888-4549-9d82-9176772cfb0f"
}
Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"order": {
"orderId": 5,
"orderUuid": "a829f583-b888-4549-9d82-9176772cfb0f",
"orderCode": "83R-R54",
"lifecycleStatus": "open",
"prepaidRequired": 0,
"openedAt": "2026-09-13T20:54:27.000Z",
"closedAt": null,
"timeOpenMinutes": 0,
"totalDurationMinutes": 0,
"notes": null,
"isSplit": 1,
"splitOriginOrderId": 4,
"splitLabel": null,
"activeTableId": null,
"activeRoomId": null,
"tableId": 2,
"tableName": "Mesa 02",
"roomId": null,
"roomUuid": null,
"roomName": null,
"roomLocation": null,
"zoneId": 1,
"zoneName": "Salón Principal",
"waiterActorId": 15,
"waiterName": "App Testing",
"fulfillmentId": 1,
"fulfillmentName": "En mesa",
"callerMode": null,
"fulfillmentTypeCode": "fulfillment.dine.in",
"fulfillmentTypeName": "En mesa",
"channelId": 1,
"channelName": "Punto de venta",
"channelCode": "channel.staff.pos",
"cashRegisterId": null,
"cashRegisterName": null,
"showPaymentActionsOnSave": true
}
}
}