---
title: "Consultar todas las facturas"
method: GET
path: "/invoices"
tags: ["Facturas"]
---

# Consultar todas las facturas

`GET /invoices`

## Request

- Base URL: `https://api.pirpos.com`
- URL: `https://api.pirpos.com/invoices`
- Auth: HTTP bearer

Consulta una lista paginada de todas las facturas 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 facturas de las últimas 24 horas.

## Ejemplos de Uso

### 1. Consultar todas las facturas (primera página)
```
GET /invoices?pagination=true&limit=10&page=0
Authorization: Bearer tu_token_aqui
```
Consulta las primeras 10 facturas ordenadas por fecha de creación.

### 2. Buscar facturas pagadas de hoy
```
GET /invoices?status=Pagada&dateInit=2025-08-05T00:00:00.000Z&dateEnd=2025-08-05T23:59:59.999Z
Authorization: Bearer tu_token_aqui
```
Filtra facturas con estado 'Pagada' creadas en el día actual.

### 3. Facturas de entrega a domicilio
```
GET /invoices?onlyDelivery=true&deliveryProvider=RAPPI
Authorization: Bearer tu_token_aqui
```
Consulta solo facturas que incluyen entrega a domicilio con Rappi.

### 4. Facturas por método de pago
```
GET /invoices?paymentMethodName=Efectivo&pagination=true&limit=20&page=1
Authorization: Bearer tu_token_aqui
```
Filtra facturas pagadas con efectivo, página 2 (20 elementos por página).

### 5. Facturas electrónicas exitosas
```
GET /invoices?type=FacturaElectronica&statusFE=00&statusSiigo=200
Authorization: Bearer tu_token_aqui
```
Consulta facturas electrónicas aceptadas por DIAN e integradas exitosamente con Siigo.

## Query parameters

- `pagination` boolean
- `limit` integer
- `page` integer
- `number` string
- `status` 'Pendiente' | 'Pagada' | 'Anulada' | 'Todos'
- `type` 'Normal' | 'FacturaElectronica'
- `clientId` string
- `paymentMethodName` string
- `tableId` string
- `cashierId` string
- `deliveryProvider` 'RAPPI' | 'UBER_EATS' | 'DIDI_FOOD' | 'INTERNAL'
- `onlyDelivery` boolean
- `deliveryGuyId` string
- `dateInit` string, date-time
- `dateEnd` string, date-time
- `cashbox` string
- `statusFE` '00' | '99'
- `statusSiigo` '200' | '400'
- `statusLoggro` '200' | '400'
- `typeSort` 'asc' | 'desc'
- `cashBoxRegister` string
- `paidInvoices` boolean

## Response `200`

Lista de facturas obtenida exitosamente

- Invoice[]
  - `_id` string: ID único de la factura
  - `businessId` string: ID del negocio al que pertenece la factura
  - `business` object: Información del negocio
    - `name` string: Nombre del negocio
    - `nit` string: NIT del negocio
    - `address` string: Dirección del negocio
  - `number` string: Número de la factura
  - `invoicePrefix` string: Prefijo de la factura
  - `seq` number: Número secuencial de la factura
  - `products` object[]: Lista de productos en la factura
    - `idInternal` string: ID del producto
    - `name` string: Nombre del producto
    - `quantity` number: Cantidad
    - `price` number: Precio unitario
  - `total` number: Total de la factura
  - `totalPaid` number: Total pagado
  - `status` 'Pendiente' | 'Pagada' | 'Anulada': Estado de la factura
  - `type` 'Normal' | 'FacturaElectronica': Tipo de factura
  - `table` object: Información de la mesa
    - `idInternal` string: ID de la mesa
    - `name` string: Nombre de la mesa
  - `client` object: Información del cliente
    - `idInternal` string: ID del cliente
    - `name` string: Nombre del cliente
    - `phone` string: Teléfono del cliente
  - `cashier` object: Información del cajero
    - `idInternal` string: ID del cajero
    - `name` string: Nombre del cajero
  - `paid` object: Información de pago
    - `paymentMethodValue` object
      - `paymentMethod` string: Método de pago utilizado
  - `delivery` object: Información de entrega
    - `isDelivery` boolean: Si es una entrega a domicilio
    - `deliveryProvider` string: Proveedor de entrega
    - `deliveryGuy` object
      - `internalId` string: ID del repartidor
      - `name` string: Nombre del repartidor
  - `deliveryCost` number: Costo de entrega
  - `eInvoice` object: Información de facturación electrónica
    - `DIAN` object
      - `dianState` string: Estado en DIAN
  - `externalIntegration` object: Integraciones externas
    - `siigo` object
      - `statusCode` number: Código de estado en Siigo
    - `loggro` object
      - `statusCode` number: Código de estado en Loggro
  - `credit` object: Información de crédito
    - `dueDate` string, date-time: Fecha de vencimiento del crédito
  - `createdOn` string, date-time: Fecha de creación
  - `modifiedOn` string, date-time: Fecha de última modificación
  - `deletedInfo` object: Información de eliminación
    - `isDeleted` boolean: Si la factura está eliminada

## Other responses

- `401`: Token de autorización inválido o faltante
- `403`: Sin permisos para ver facturas
- `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)