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 URL
    https://api.pirpos.com
  • URL
    https://api.pirpos.com/reports/reportPurchase
  • Auth
    HTTP 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

ivpobject[]

Pagos de facturas de inventario asociados

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.