Listado paginado de items de la orden

Descripción

Devuelve los productos pedidos de la orden de forma paginada, junto con los productos cancelados y los modificadores asociados.

Detalles

Retorna en una sola llamada los items activos de la orden paginados, los items que fueron cancelados durante la orden y los modificadores aplicados a unos y otros. El listado permite ordenar por fecha de creación o nombre del producto. Falla si la orden no existe.

Permisos requeridos

orders.module

Request

Nombre	Tipo	Requerido	Reglas
orderUuid	string	Sí	min:36 max:36

Paginación

defaultLimit	10
maxLimit	50
allowedSorts	createdAt, productName
defaultSort	createdAt
defaultDir	asc
withTotal	true

Ejemplo de request

curl -X POST https://restofy.pro/api/pos-order/list-order-items \
  -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": "2dcf7c56-ae4d-4dc9-8212-c0f86c09b5e5",
    "page": 1,
    "limit": 10
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "orderItems": [
            {
                "itemId": 3,
                "itemUuid": "c5e846c2-914e-4ea5-9f22-9dda5ff54d60",
                "productId": 9,
                "productName": "Cazuela de Mariscos",
                "productIcon": "fa-solid fa-fish",
                "categoryId": 7,
                "categoryName": "Mariscos",
                "categoryIcon": "fa-solid fa-fish",
                "courseId": 2,
                "courseName": "Como plato fuerte",
                "isComped": 0,
                "quantity": "1.0000",
                "unitPriceCents": 2300000,
                "modifiersTotalCents": 0,
                "discountCents": 0,
                "totalBaseCents": 2300000,
                "taxCents": 0,
                "priceCents": 2300000,
                "productPriceOptionName": null,
                "preparationStatus": "pending",
                "servedStatus": "pending",
                "lifecycleStatus": "confirmed",
                "itemNotes": null,
                "consumptionMode": "eat_in",
                "servedAt": null,
                "readyAt": null,
                "createdAt": "2026-09-08T16:33:21.000Z",
                "actorId": 15,
                "actorName": "App Testing"
            },
            {
                "itemId": 4,
                "itemUuid": "740ac8f8-9225-4970-8529-87ab00ef9648",
                "productId": 9,
                "productName": "Cazuela de Mariscos",
                "productIcon": "fa-solid fa-fish",
                "categoryId": 7,
                "categoryName": "Mariscos",
                "categoryIcon": "fa-solid fa-fish",
                "courseId": 2,
                "courseName": "Como plato fuerte",
                "isComped": 0,
                "quantity": "1.0000",
                "unitPriceCents": 2300000,
                "modifiersTotalCents": 0,
                "discountCents": 0,
                "totalBaseCents": 2300000,
                "taxCents": 0,
                "priceCents": 2300000,
                "productPriceOptionName": null,
                "preparationStatus": "pending",
                "servedStatus": "pending",
                "lifecycleStatus": "confirmed",
                "itemNotes": null,
                "consumptionMode": "eat_in",
                "servedAt": null,
                "readyAt": null,
                "createdAt": "2026-09-08T16:33:23.000Z",
                "actorId": 15,
                "actorName": "App Testing"
            }
        ],
        "cancelledItems": [],
        "modifiers": [],
        "pagination": {
            "page": 1,
            "limit": 10,
            "total": 2,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}