Consultar todas las facturas

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
boolean
Defaults to true

Activar paginación de resultados

integer
1 to 5000
Defaults to 10

Número máximo de facturas por página (máximo 5000)

integer
≥ 0
Defaults to 0

Número de página (inicia en 0)

string

Buscar por número específico de factura

string
enum

Filtrar por estado de la factura

Allowed:
string
enum

Filtrar por tipo de factura

Allowed:
string

Filtrar por ID del cliente

string

Filtrar por método de pago

string

Filtrar por ID de mesa

string

Filtrar por ID del cajero

string
enum

Filtrar por proveedor de entrega

Allowed:
boolean

Mostrar solo facturas con entrega a domicilio

string

Filtrar por ID del repartidor

date-time

Fecha inicial para filtrar facturas

date-time

Fecha final para filtrar facturas

string

Filtrar por ID de caja registradora

string
enum

Estado de facturación electrónica DIAN (00=Aceptada, 99=Con errores)

Allowed:
string
enum

Estado de integración con Siigo (200=Exitosa, 400=Con errores)

Allowed:
string
enum

Estado de integración con Loggro (200=Exitosa, 400=Con errores)

Allowed:
string
enum
Defaults to asc

Orden de clasificación por fecha de creación

Allowed:
string

Filtrar por registrador de caja específico o 'withoutCashbox' para facturas sin caja

boolean

Mostrar solo facturas con crédito (que tienen fecha de vencimiento)

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json