Reporte de mermas de inventario
Genera un reporte de las mermas (pérdidas o desperdicios) registradas en el inventario durante 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 clasificados como merma
- Detalle de ingrediente/insumo, cantidad perdida y precio
- Notas explicativas de la merma
- Agrupación opcional por ingrediente con totales de cantidad y valor
- Soporte para usuarios con múltiples negocios
Casos de uso:
- Control de pérdidas de inventario
- Análisis de desperdicios por ingrediente
- Auditoría de mermas para ajuste de costos
- Identificación de insumos con mayor desperdicio
Ejemplos de uso:
1. Mermas del mes actual
GET /reports/reportShrinkage?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z
Authorization: Bearer tu_token_aqui
2. Mermas agrupadas por ingrediente
GET /reports/reportShrinkage?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z&groupResult=true
Authorization: Bearer tu_token_aqui
Request
- Base URLhttps://api.pirpos.com
- URLhttps://api.pirpos.com/reports/reportShrinkage
- AuthHTTP bearer
Query parameters
Fecha inicial del período del reporte (formato ISO)
Fecha final del período del reporte (formato ISO)
Agrupar resultados por ingrediente (totales de cantidad y valor)
Incluir todos los negocios del usuario (para usuarios multi-negocio)
Response
Reporte de mermas generado exitosamente
Example response
[
{
"_id": {
"ingredient": {
"name": "Tomate"
},
"quantity": 2,
"price": 1500,
"note": "Producto vencido"
},
"quantity": 10,
"total": 15000
}
]Changes
No recorded changes to this operation across all 1 revision of this API.