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 URL
    https://api.pirpos.com
  • URL
    https://api.pirpos.com/reports/reportExpenses
  • Auth
    HTTP 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

_idstring

ID del gasto

businessstring

ID del negocio

typeExpensestring

ID del tipo de gasto

paidTostring

ID del usuario pagado

paymentMethodstring

Método de pago

cashBoxstring

ID de caja

providerstring

ID del proveedor

descriptionstring

Descripción

notesstring

Notas

invoiceNumberstring

Número de factura

subTotalnumber

Subtotal

taxesnumber

Impuestos

subtractCashRegisterboolean

Si descuenta caja

datestring date-time

Fecha del gasto

createdBystring

ID del usuario creador

deletedboolean

Si está eliminado

modifiedOnstring date-time

Fecha de última modificación

createdOnstring date-time

Fecha de creación

seqnumber

Consecutivo

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.