Reportes

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
get/reports/reportShrinkage

Request

  • Base URL
    https://api.pirpos.com
  • URL
    https://api.pirpos.com/reports/reportShrinkage
  • Auth
    HTTP bearer

Query parameters

dateInitISOstring date-time

Fecha inicial del período del reporte (formato ISO)

dateEndISOstring date-time

Fecha final del período del reporte (formato ISO)

groupResultboolean

Agrupar resultados por ingrediente (totales de cantidad y valor)

allBusinessboolean

Incluir todos los negocios del usuario (para usuarios multi-negocio)

Response

Reporte de mermas generado exitosamente

quantitynumber

Total de cantidad perdida (cuando groupResult=true)

totalnumber

Valor total de la merma (cuando groupResult=true)

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.