Consultar las ventas por facturas

Consulta un reporte detallado de ventas basado en las facturas generadas en un período específico.

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}

Suscripción Premium requerida: Este endpoint requiere una suscripción premium activa.

Características del reporte:

  • Lista todas las facturas en estado "Pagada"
  • Soporta filtrado por fechas, métodos de pago, clientes, etc.
  • Incluye información detallada de productos, impuestos y descuentos
  • Datos de entrega a domicilio y repartidores
  • Información de facturación electrónica (DIAN)
  • Integración con sistemas contables (Siigo, Loggro)

Uso típico para reportes:

  • Análisis de ventas diarias, semanales o mensuales
  • Seguimiento de performance por método de pago
  • Análisis de entrega a domicilio vs mesa
  • Reportes para contabilidad y auditoría
  • Control de facturación electrónica
  •   ## Ejemplos de uso:

1. Reporte de ventas del día actual

Consultar todas las ventas (facturas pagadas) del día actual:

GET /reports/reportSalesInvoices?dateInit=2025-08-06T00:00:00.000Z&dateEnd=2025-08-06T23:59:59.999Z&status=Pagada
Authorization: Bearer tu_token_aqui

2. Reporte básico con parámetros mínimos requeridos

Ejemplo mínimo funcional para Consultar facturas pagadas del último mes:

GET /reports/reportSalesInvoices?status=Pagada
Authorization: Bearer tu_token_aqui

3. Reporte con paginación limitada

Consultar las primeras 50 facturas de la semana actual con paginación:

GET /reports/reportSalesInvoices?limit=50&page=0&dateInit=2025-08-01T00:00:00.000Z&dateEnd=2025-08-07T23:59:59.999Z
Authorization: Bearer tu_token_aqui

4. Reporte de ventas por método de pago

Analizar ventas por método de pago específico en el último mes:

GET /reports/reportSalesInvoices?paymentMethodName=Efectivo&dateInit=2025-07-06T00:00:00.000Z&dateEnd=2025-08-06T23:59:59.999Z
Authorization: Bearer tu_token_aqui

5. Reporte de ventas a domicilio

Analizar performance de entrega a domicilio en la última semana:

GET /reports/reportSalesInvoices?onlyDelivery=true&dateInit=2025-07-30T00:00:00.000Z&dateEnd=2025-08-06T23:59:59.999Z&limit=200
Authorization: Bearer tu_token_aqui

6. Reporte de facturación electrónica

Revisar estado de facturas electrónicas para contabilidad:

GET /reports/reportSalesInvoices?type=FacturaElectronica&statusFE=00&dateInit=2025-08-01T00:00:00.000Z&dateEnd=2025-08-06T23:59:59.999Z
Authorization: Bearer tu_token_aqui

7. Reporte de ventas por cajero

Evaluar performance de ventas por cajero específico:

GET /reports/reportSalesInvoices?cashierId=507f1f77bcf86cd799439015&dateInit=2025-08-01T00:00:00.000Z&dateEnd=2025-08-06T23:59:59.999Z
Authorization: Bearer tu_token_aqui
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 100

Número máximo de facturas por página para reportes

integer
≥ 0
Defaults to 0

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

date-time

Fecha inicial para el reporte de ventas

date-time

Fecha final para el reporte de ventas

string
enum
Defaults to Pagada

Estado de las facturas (típicamente solo 'Pagada' para reportes)

Allowed:
string

Filtrar ventas por método de pago específico

string

Filtrar ventas por cliente específico

string

Filtrar ventas por mesa específica

string

Filtrar ventas por cajero específico

string
enum

Filtrar ventas por proveedor de entrega

Allowed:
boolean

Mostrar solo ventas con entrega a domicilio

string

Filtrar por caja registradora específica

string
enum

Tipo de factura para el reporte

Allowed:
string
enum
Defaults to desc

Orden de clasificación por fecha (desc para reportes recientes primero)

Allowed:
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