Restofy Docs
Toma de pedidos POST

Tablero de seguimiento de órdenes

POST /api/pos-order/list-orders

Descripción

Lista las órdenes de una etapa del tablero: por preparar, en cocina, por despachar o despachada, con su estado de pago.

Detalles

Devuelve las órdenes de una etapa del seguimiento operativo, derivada del avance de sus productos: recién confirmadas sin preparar, en preparación, listas para salir o ya despachadas. Cada orden trae su canal de entrega, mesa o habitación, cliente, total y si está pagada. Solo aparecen las órdenes de las últimas horas configuradas por el negocio.

Permisos requeridos

orders.board.view

Request

Nombre Tipo Requerido Reglas
stage string Sí
enum:to_prepare,cooking,ready,dispatched
channel string No
enum:dine_in,delivery,pickup,counter,room
paymentStatus string No
enum:unpaid,paid,comped
search string No
max:50
fromIso datetime No —

Paginación

defaultLimit 30
maxLimit 60
allowedSorts openedAt, orderCode, grandTotalCents
defaultSort openedAt
defaultDir desc
withTotal true

Ejemplo de request

curl -X POST https://restofy.pro/api/pos-order/list-orders \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "stage": "string"
}'

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

Ejemplo de respuesta

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

Request

{
    "stage": "to_prepare",
    "limit": 60
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "orders": [
            {
                "orderUuid": "5b6c0ebc-200e-47c5-b8e7-38c0ea4c0dee",
                "orderCode": "44B-Q55",
                "dailyNumber": 1,
                "paymentStatus": "unpaid",
                "grandTotalCents": 2300000,
                "prepaidRequired": 0,
                "notes": "test order",
                "openedAt": "2026-09-08T16:33:02.000Z",
                "dispatchedAt": "2026-09-08T16:33:02.000Z",
                "fulfillmentTypeCode": "fulfillment.dine.in",
                "fulfillmentTypeName": "En mesa",
                "tableName": "Mesa 01",
                "customerName": null,
                "deliveryStatus": null,
                "itemsTotal": "1",
                "boardStage": "to_prepare"
            },
            {
                "orderUuid": "dddddddd-dddd-dddd-dddd-dddddddddd01",
                "orderCode": "TST-0001",
                "dailyNumber": null,
                "paymentStatus": "unpaid",
                "grandTotalCents": 1190000,
                "prepaidRequired": 0,
                "notes": null,
                "openedAt": "2026-09-08T16:30:58.000Z",
                "dispatchedAt": "2026-09-08T16:30:58.000Z",
                "fulfillmentTypeCode": "fulfillment.dine.in",
                "fulfillmentTypeName": "En mesa",
                "tableName": "Mesa 01",
                "customerName": null,
                "deliveryStatus": null,
                "itemsTotal": "2",
                "boardStage": "to_prepare"
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 60,
            "total": 2,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}
Volver a Toma de pedidos