--- title: "Consultar todos los pedidos" method: GET path: "/orders" tags: ["Pedidos"] --- # Consultar todos los pedidos `GET /orders` ## Request - Base URL: `https://api.pirpos.com` - URL: `https://api.pirpos.com/orders` - Auth: HTTP bearer Consulta una lista paginada de todos los pedidos del negocio actual. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` Soporta múltiples filtros para búsqueda específica y paginación para manejo eficiente de grandes volúmenes de datos. **Limitaciones plan trial:** Las cuentas en periodo de prueba solo pueden ver pedidos de las últimas 24 horas. ## Ejemplos de Uso ### 1. Consultar todos los pedidos (primera página) ``` GET /orders?pagination=true&limit=10&page=0 Authorization: Bearer tu_token_aqui ``` Consulta los primeros 10 pedidos ordenados por fecha de creación (más recientes primero). ### 2. Buscar pedidos en espera ``` GET /orders?status=Espera&limit=20 Authorization: Bearer tu_token_aqui ``` Filtra pedidos con estado 'Espera' para procesamiento en cocina. ### 3. Pedidos de una mesa específica ``` GET /orders?tableId=507f1f77bcf86cd799439014&pagination=true Authorization: Bearer tu_token_aqui ``` Consulta todos los pedidos de una mesa específica con paginación. ### 4. Mis pedidos como vendedor ``` GET /orders?onlyMine=true&status=Entregado&limit=50 Authorization: Bearer tu_token_aqui ``` Filtra solo los pedidos del vendedor autenticado que han sido entregados. ### 5. Pedidos por rango de fechas ``` GET /orders?dateInit=2025-08-05T00:00:00.000Z&dateEnd=2025-08-05T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` Consulta pedidos creados en un rango específico de fechas. ## Query parameters - `pagination` boolean - `limit` integer - `page` integer - `status` 'Espera' | 'Cocina' | 'Listo' | 'Entregado' | 'Cancelado' - `statusKitchen` 'Espera' | 'Preparacion' | 'Listo' - `onlyMine` boolean - `group` string - `isComplementary` boolean - `tableId` string - `product` string - `dateInit` string, date-time - `dateEnd` string, date-time ## Response `200` Lista de pedidos obtenida exitosamente - union - Order[]: Array directo de pedidos (cuando pagination=false) - `_id` string: ID único del pedido - `business` string: ID del negocio al que pertenece el pedido - `product` object: Información del producto pedido - `_id` string: ID del producto - `name` string: Nombre del producto - `price` number: Precio del producto - `table` object: Información de la mesa - `_id` string: ID de la mesa - `name` string: Nombre de la mesa - `deliveryProviderOrder` string: ID del pedido del proveedor de entrega - `group` string: ID del grupo de pedidos - `groupName` string: Nombre del grupo de pedidos - `seller` object: Información del vendedor/mesero - `_id` string: ID del vendedor - `name` string: Nombre del vendedor - `lastName` string: Apellido del vendedor - `urlImage` string: URL de la imagen del vendedor - `notes` string[]: Notas especiales del pedido - `causeCancel` string: Motivo de cancelación del pedido - `quantity` number: Cantidad del producto - `unit_price` number: Precio unitario - `total` number: Total del pedido - `status` 'Espera' | 'Cocina' | 'Listo' | 'Entregado' | 'Cancelado': Estado del pedido - `statusKitchen` 'Espera' | 'Preparacion' | 'Listo': Estado en cocina - `productsExtra` object[]: Productos adicionales/complementos - `product` object - `_id` string: ID del producto extra - `name` string: Nombre del producto extra - `price` number: Precio del producto extra - `quantity` number: Cantidad del producto extra - `complementary` object: Información de cortesía - `isComplementary` boolean: Si el pedido es cortesía - `reason` string: Motivo de la cortesía - `modifiedBy` object: Usuario que modificó el pedido - `_id` string: ID del usuario - `name` string: Nombre del usuario - `deleted` boolean: Si el pedido está eliminado - `createdOn` string, date-time: Fecha de creación del pedido - `modifiedOn` string, date-time: Fecha de última modificación - object: Objeto con datos paginados (cuando pagination=true) - `data` Order[] - `_id` string: ID único del pedido - `business` string: ID del negocio al que pertenece el pedido - `product` object: Información del producto pedido - `_id` string: ID del producto - `name` string: Nombre del producto - `price` number: Precio del producto - `table` object: Información de la mesa - `_id` string: ID de la mesa - `name` string: Nombre de la mesa - `deliveryProviderOrder` string: ID del pedido del proveedor de entrega - `group` string: ID del grupo de pedidos - `groupName` string: Nombre del grupo de pedidos - `seller` object: Información del vendedor/mesero - `_id` string: ID del vendedor - `name` string: Nombre del vendedor - `lastName` string: Apellido del vendedor - `urlImage` string: URL de la imagen del vendedor - `notes` string[]: Notas especiales del pedido - `causeCancel` string: Motivo de cancelación del pedido - `quantity` number: Cantidad del producto - `unit_price` number: Precio unitario - `total` number: Total del pedido - `status` 'Espera' | 'Cocina' | 'Listo' | 'Entregado' | 'Cancelado': Estado del pedido - `statusKitchen` 'Espera' | 'Preparacion' | 'Listo': Estado en cocina - `productsExtra` object[]: Productos adicionales/complementos - `product` object - `_id` string: ID del producto extra - `name` string: Nombre del producto extra - `price` number: Precio del producto extra - `quantity` number: Cantidad del producto extra - `complementary` object: Información de cortesía - `isComplementary` boolean: Si el pedido es cortesía - `reason` string: Motivo de la cortesía - `modifiedBy` object: Usuario que modificó el pedido - `_id` string: ID del usuario - `name` string: Nombre del usuario - `deleted` boolean: Si el pedido está eliminado - `createdOn` string, date-time: Fecha de creación del pedido - `modifiedOn` string, date-time: Fecha de última modificación - `count` integer: Total de pedidos que coinciden con los filtros ## Other responses - `401`: Token de autorización inválido o faltante - `403`: Sin permisos para ver pedidos - `500`: Error interno del servidor --- [API](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar.md) - [All operations](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/revisions/9d4431a3cddc?raw)