Reportes
Reporte de gastos del negocio
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
get/reports/reportExpenses
Request
- Base URLhttps://api.pirpos.com
- URLhttps://api.pirpos.com/reports/reportExpenses
- AuthHTTP bearer
Query parameters
dateInitstring date-time
Fecha inicial del período (formato ISO)
dateEndstring date-time
Fecha final del período (formato ISO)
allBusinessboolean
Incluir todos los negocios del usuario (para usuarios multi-negocio)
Response
Reporte de gastos generado exitosamente
Example response
[
{
"_id": "507f1f77bcf86cd799439500",
"business": "507f1f77bcf86cd799439012",
"typeExpense": "507f1f77bcf86cd799439600",
"paidTo": "507f1f77bcf86cd799439700",
"paymentMethod": "Efectivo",
"cashBox": "507f1f77bcf86cd799439800",
"provider": "507f1f77bcf86cd799439200",
"description": "Compra insumos",
"invoiceNumber": "G-001",
"subTotal": 10000,
"taxes": 1900,
"subtractCashRegister": true,
"date": "2025-08-05T10:30:00.000Z"
}
]Changes
No recorded changes to this operation across all 1 revision of this API.