Reportes

Reporte de traslados de inventario entre ubicaciones

Genera un reporte de los movimientos de traslado de inventario (tipo 8) entre ubicaciones de stock 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 traslados entre ubicaciones de stock (type: 8)
  • Detalle de ingrediente trasladado, cantidad, ubicación origen y destino
  • Información del usuario que realizó el traslado
  • Agrupación opcional por ingrediente y usuario (vista consolidada)
  • Soporte para usuarios con múltiples negocios

Casos de uso:

  • Control de movimientos entre sedes o puntos de venta
  • Auditoría de traslados de inventario
  • Análisis de flujo de insumos entre ubicaciones

Ejemplos de uso:

1. Traslados del mes

GET /reports/reportTransfers?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z
Authorization: Bearer tu_token_aqui

2. Traslados agrupados por ingrediente

GET /reports/reportTransfers?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z&groupResult=true
Authorization: Bearer tu_token_aqui
get/reports/reportTransfers

Request

  • Base URL
    https://api.pirpos.com
  • URL
    https://api.pirpos.com/reports/reportTransfers
  • 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 y usuario (totales consolidados)

allBusinessboolean

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

Response

Reporte de traslados generado exitosamente

quantitynumber

Total trasladado (cuando groupResult=true)

Example response

[
  {
    "_id": {
      "ingredient": {
        "name": "Queso Mozzarella"
      },
      "quantity": 5
    },
    "quantity": 20
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.