Cocina

Obtener pedidos para la pantalla de cocina

Retorna los pedidos que deben mostrarse en la pantalla de cocina. Incluye pedidos con estado "Espera" (que no estén terminados en cocina) y pedidos "Cancelada" que estén en estado "Preparando" en cocina. Solo retorna pedidos del último mes. Opcionalmente filtra por área de despacho (waiterOrderArea).

Autenticación requerida: Bearer Token en header Authorization: Bearer {tokenCurrent}

Permiso requerido: OR_PUT_KITCHEN - "Pedidos RT" (sin validación explícita de permiso en este endpoint)

get/orders/kitchen/ordersForKitchen

Request

  • Base URL
    https://api.pirpos.com
  • URL
    https://api.pirpos.com/orders/kitchen/ordersForKitchen
  • Auth
    HTTP bearer

Query parameters

waiterOrderAreastring

ID del área de despacho/zona de cocina para filtrar pedidos

includeDefaultsboolean

Si es true junto con waiterOrderArea, también incluye pedidos sin área asignada (waiterOrderArea = null)

Response

Lista de pedidos para cocina (máximo 500)

_idstring

ID único del pedido

businessstring

ID del negocio al que pertenece el pedido

deliveryProviderOrderstring

ID del pedido del proveedor de entrega

groupstring

ID del grupo de pedidos

groupNamestring

Nombre del grupo de pedidos

notesstring[]

Notas especiales del pedido

causeCancelstring

Motivo de cancelación del pedido

quantitynumber

Cantidad del producto

unit_pricenumber

Precio unitario

totalnumber

Total del pedido

status'Espera' | 'Cocina' | 'Listo' | 'Entregado' | 'Cancelado'

Estado del pedido

statusKitchen'Espera' | 'Preparacion' | 'Listo'

Estado en cocina

deletedboolean

Si el pedido está eliminado

createdOnstring date-time

Fecha de creación del pedido

modifiedOnstring date-time

Fecha de última modificación

Example response

[
  {
    "_id": "507f1f77bcf86cd799439011",
    "business": "507f1f77bcf86cd799439012",
    "product": {
      "name": "Hamburguesa Clásica",
      "price": 15000
    },
    "table": {
      "name": "Mesa 5"
    },
    "deliveryProviderOrder": "507f1f77bcf86cd799439014",
    "group": "507f1f77bcf86cd799439015",
    "groupName": "Grupo Mesa 5",
    "seller": {
      "name": "Carlos",
      "lastName": "Pérez",
      "urlImage": "https://ejemplo.com/vendedor.jpg"
    },
    "notes": [
      "Sin cebolla",
      "Extra queso"
    ],
    "causeCancel": "Cliente canceló",
    "quantity": 2,
    "unit_price": 15000,
    "total": 30000,
    "status": "Espera",
    "statusKitchen": "Espera",
    "productsExtra": [
      {
        "product": {
          "name": "Papas fritas",
          "price": 5000
        },
        "quantity": 1
      }
    ],
    "modifiedBy": {
      "name": "Admin"
    },
    "createdOn": "2025-08-05T10:30:00.000Z",
    "modifiedOn": "2025-08-05T10:30:00.000Z"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.