---
title: "Consultar las ventas por facturas"
method: GET
path: "/reports/reportSalesInvoices"
tags: ["Reportes"]
---

# Consultar las ventas por facturas

`GET /reports/reportSalesInvoices`

## Request

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

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
```

## Query parameters

- `pagination` boolean
- `limit` integer
- `page` integer
- `dateInit` string, date-time
- `dateEnd` string, date-time
- `status` 'Pagada'
- `paymentMethodName` string
- `clientId` string
- `tableId` string
- `cashierId` string
- `deliveryProvider` 'RAPPI' | 'UBER_EATS' | 'DIDI_FOOD' | 'INTERNAL'
- `onlyDelivery` boolean
- `cashbox` string
- `type` 'Normal' | 'FacturaElectronica'
- `typeSort` 'asc' | 'desc'

## Response `200`

Reporte de ventas generado 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
- `402`: Suscripción premium requerida
- `403`: Sin permisos para ver reportes de 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)