---
title: "Reporte de gastos del negocio"
method: GET
path: "/reports/reportExpenses"
tags: ["Reportes"]
---

# Reporte de gastos del negocio

`GET /reports/reportExpenses`

## Request

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

Consulta todos los gastos registrados en el negocio para 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 todos los gastos no eliminados del negocio
- Incluye información del tipo de gasto, usuario pagado y proveedor
- Detalle de subtotal, impuestos y totales
- Información de caja registradora asociada
- Límite de 2000 registros por consulta
- Soporte para usuarios con múltiples negocios

**Casos de uso:**
- Control de gastos operativos del negocio
- Análisis de egresos por período
- Reportes de pagos a proveedores
- Revisión de gastos por tipo para contabilidad

## Ejemplos de uso:

### 1. Gastos del mes actual
```
GET /reports/reportExpenses?dateInit=2025-08-01T00:00:00.000Z&dateEnd=2025-08-31T23:59:59.999Z
Authorization: Bearer tu_token_aqui
```

### 2. Gastos de todos los negocios
```
GET /reports/reportExpenses?dateInit=2025-08-01T00:00:00.000Z&dateEnd=2025-08-31T23:59:59.999Z&allBusiness=true
Authorization: Bearer tu_token_aqui
```

## Query parameters

- `dateInit` string, date-time
- `dateEnd` string, date-time
- `allBusiness` boolean

## Response `200`

Reporte de gastos generado exitosamente

- Expense[]
  - `_id` string: ID del gasto
  - `business` string: ID del negocio
  - `typeExpense` string: ID del tipo de gasto
  - `paidTo` string: ID del usuario pagado
  - `paymentMethod` string: Método de pago
  - `cashBox` string: ID de caja
  - `provider` string: ID del proveedor
  - `description` string: Descripción
  - `notes` string: Notas
  - `invoiceNumber` string: Número de factura
  - `subTotal` number: Subtotal
  - `taxes` number: Impuestos
  - `subtractCashRegister` boolean: Si descuenta caja
  - `date` string, date-time: Fecha del gasto
  - `createdBy` string: ID del usuario creador
  - `deleted` boolean: Si está eliminado
  - `deletedInfo` object: Información de eliminación
    - `isDeleted` boolean
    - `deletedBy` string
    - `date` string, date-time
  - `modifiedOn` string, date-time: Fecha de última modificación
  - `createdOn` string, date-time: Fecha de creación
  - `seq` number: Consecutivo

## Other responses

- `401`: Token de autorización inválido o faltante
- `402`: Suscripción premium requerida
- `403`: Sin permisos para ver reportes de gastos
- `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)