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

# Reporte de compras de inventario

`GET /reports/reportPurchase`

## Request

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

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

## Query parameters

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

## Response `200`

Reporte de compras generado exitosamente

- object
  - `purchases` object[]: Lista de compras realizadas
    - `_id` string: ID del movimiento de inventario
    - `date` string, date-time: Fecha de la compra
    - `business` string: Nombre del negocio
    - `provider` object: Información del proveedor
      - `name` string
    - `invoice` object: Información de factura de compra
      - `invoiceNumber` string
      - `total` number
    - `ingredient` object: Detalle del ingrediente/insumo comprado
      - `name` string
      - `quantity` number
      - `price` number
  - `ivp` object[]: Pagos de facturas de inventario asociados

## Other responses

- `401`: Token de autorización inválido o faltante
- `402`: Suscripción premium requerida
- `403`: Sin permisos para ver reportes de compras
- `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)