---
title: "Reporte de utilidad agrupado por proveedor de entrega"
method: GET
path: "/reports/reportUtilityDeliveryProvider"
tags: ["Reportes"]
---

# Reporte de utilidad agrupado por proveedor de entrega

`GET /reports/reportUtilityDeliveryProvider`

## Request

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

Genera un reporte de ventas a domicilio agrupadas y totalizadas por proveedor de entrega (RAPPI, Uber Eats, Didi Food, Interno, etc.).

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

**Características del reporte:**
- Solo incluye facturas con entrega a domicilio (`delivery.isDelivery: true`)
- Solo facturas en estado "Pagada"
- Agrupa y totaliza por proveedor de entrega
- Útil para comparar performance entre canales de delivery
- Soporte para usuarios con múltiples negocios

**Casos de uso:**
- Análisis de rentabilidad por canal de delivery
- Comparación de comisiones vs ingresos por proveedor
- Decisiones sobre alianzas con plataformas de entrega
- Reporte de ventas por canal para gerencia

## Ejemplos de uso:

### 1. Utilidad por proveedor de entrega del mes
```
GET /reports/reportUtilityDeliveryProvider?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z
Authorization: Bearer tu_token_aqui
```

### 2. Utilidad multi-negocio por proveedor de entrega
```
GET /reports/reportUtilityDeliveryProvider?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
- `dateEndISO` string, date-time
- `allBusiness` boolean

## Response `200`

Reporte de utilidad por proveedor de entrega generado exitosamente

- object[]
  - `_id` object: Agrupación por proveedor de entrega
    - `deliveryProvider` 'RAPPI' | 'UBER_EATS' | 'DIDI_FOOD' | 'INTERNAL': Nombre del proveedor de entrega
  - `total` number: Total de ventas del proveedor en el período
  - `count` number: Cantidad de órdenes del proveedor
  - `deliveryCost` number: Total de costo de envío cobrado

## Other responses

- `401`: Token de autorización inválido o faltante
- `403`: Sin permisos para ver este reporte
- `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)