Reportes
Reporte de compras de inventario
Genera un reporte de todas las compras de inventario (entradas de tipo 1) realizadas 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 los movimientos de inventario de tipo "Compra" (type: 1)
- Incluye información del proveedor asociado
- Detalle de ingredientes/insumos comprados con cantidad y precio
- Información del negocio y datos de factura
- Pagos de facturas de compra (ivp)
- Soporte para usuarios con múltiples negocios
Casos de uso:
- Control de compras a proveedores
- Análisis de costos de inventario
- Cuentas por pagar a proveedores
- Auditoría de movimientos de inventario entrantes
Ejemplos de uso:
1. Compras del mes actual
GET /reports/reportPurchase?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z
Authorization: Bearer tu_token_aqui
2. Compras de todos los negocios del usuario
GET /reports/reportPurchase?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z&allBusiness=true
Authorization: Bearer tu_token_aqui
get/reports/reportPurchase
Request
- Base URLhttps://api.pirpos.com
- URLhttps://api.pirpos.com/reports/reportPurchase
- AuthHTTP bearer
Query parameters
dateInitISOstring date-time required
Fecha inicial del período del reporte (formato ISO)
dateEndISOstring date-time required
Fecha final del período del reporte (formato ISO)
allBusinessboolean
Incluir todos los negocios del usuario (para usuarios multi-negocio)
Response
Reporte de compras generado exitosamente
Example response
{
"purchases": [
{
"_id": "507f1f77bcf86cd799439040",
"date": "2025-08-05T10:30:00.000Z",
"business": "Restaurante El Buen Sabor",
"provider": {
"name": "Proveedor ABC"
},
"invoice": {
"invoiceNumber": "C-001",
"total": 50000
},
"ingredient": {
"name": "Queso Mozzarella",
"quantity": 5,
"price": 10000
}
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.