---
title: "Reporte de mermas de inventario"
method: GET
path: "/reports/reportShrinkage"
tags: ["Reportes"]
---

# Reporte de mermas de inventario

`GET /reports/reportShrinkage`

## Request

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

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
```

## Query parameters

- `dateInitISO` string, date-time
- `dateEndISO` string, date-time
- `groupResult` boolean
- `allBusiness` boolean

## Response `200`

Reporte de mermas generado exitosamente

- object[]
  - `_id` object: Datos de la merma
    - `ingredient` object: Producto/ingrediente con merma
      - `name` string
    - `quantity` number: Cantidad perdida en la merma
    - `price` number: Precio unitario del ingrediente
    - `note` string: Nota explicativa de la merma
    - `date` string, date-time
  - `quantity` number: Total de cantidad perdida (cuando groupResult=true)
  - `total` number: Valor total de la merma (cuando groupResult=true)

## Other responses

- `401`: Token de autorización inválido o faltante
- `402`: Suscripción premium requerida
- `403`: Sin permisos para ver reportes de mermas
- `500`: Error interno del servidor

---

[API](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar.md) - [All operations](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/revisions/9d4431a3cddc?raw)