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>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"orderUuid": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"orderUuid": "78520f55-6394-43eb-b66d-6f40e1699ac0"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"order": {
"orderId": 2,
"orderUuid": "78520f55-6394-43eb-b66d-6f40e1699ac0",
"orderCode": "62H-T73",
"lifecycleStatus": "open",
"prepaidRequired": 0,
"openedAt": "2026-09-08T16:34:17.000Z",
"closedAt": null,
"timeOpenMinutes": 0,
"totalDurationMinutes": 0,
"notes": "test order",
"isSplit": 0,
"splitOriginOrderId": null,
"splitLabel": null,
"activeTableId": null,
"activeRoomId": 1,
"tableId": 1,
"tableName": "Mesa 01",
"roomId": 1,
"roomUuid": "9cd6f282-ab4a-11f1-b72d-f2569efa6eee",
"roomName": "Hab test 6aa0390ca9875",
"roomLocation": "Torre A - Piso 1",
"zoneId": 1,
"zoneName": "Salón Principal",
"waiterActorId": 15,
"waiterName": "App Testing",
"fulfillmentId": 10,
"fulfillmentName": "Entrega en habitación",
"callerMode": null,
"fulfillmentTypeCode": "fulfillment.room",
"fulfillmentTypeName": "En Habitación",
"channelId": 1,
"channelName": "Punto de venta",
"channelCode": "channel.staff.pos",
"cashRegisterId": null,
"cashRegisterName": null,
"showPaymentActionsOnSave": true
}
}
}