Restofy Docs
Salón y mesas POST

Abrir una orden en una habitación

POST /api/pos-zone/create-room-order

Descripción

Abre un pedido nuevo sobre una habitación libre.

Detalles

Crea una orden nueva asociada a una habitación libre, dentro del canal de venta y el tipo de entrega indicados. La habitación debe estar activa y no tener otro pedido en curso. Los datos del huésped se cargan luego por separado.

Permisos requeridos

orders.module orders.integration

El usuario solo necesita uno de los permisos listados.

Request

Nombre Tipo Requerido Reglas
roomId int
min_value:1
channelId int
min_value:1
fulfillmentId int
min_value:1

Ejemplo de request

curl -X POST https://restofy.pro/api/pos-zone/create-room-order \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "roomId": 1,
    "channelId": 1,
    "fulfillmentId": 1
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z
HTTP 200

Request

{
    "roomId": 2,
    "channelId": 1,
    "fulfillmentId": 10
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "orderUuid": "620b2c12-61bb-4e95-bd40-608485a9f1dd",
        "orderCode": "24A-S62",
        "roomLabel": "Hab test 6aa0390f36b34",
        "actorName": "App Testing"
    }
}