**Para generar informes de consumo y liquidación para los clientes de tu reventa white label usando la API de Papo (https://papo.global/), combinas los endpoints de listado de cuentas, verificación de módulos y bandejas de entrada con las exportaciones periódicas del módulo Informes y el historial de transacciones del portal de facturación —construyendo dashboards y hojas de liquidación sin depender de la revisión manual en cada cuenta.**

Aunque la API actual no tiene un endpoint dedicado que devuelva directamente la cantidad de mensajes consumidos o los valores de factura, el cruce programático de datos estructurales (quién es cliente, qué módulos están activos, cuáles son sus bandejas de entrada) con los archivos CSV de conversaciones y plantillas permite montar informes de liquidación detallados y automatizados.

## Resumen de los recursos usados para generar el informe de liquidación

| Recurso | Qué proporciona | Cómo contribuye a la liquidación |
| :--- | :--- | :--- |
| API – listar cuentas | IDs y estado de todos los clientes white label | Identifica a cada cliente que debe recibir un informe |
| API – verificar módulos | Estado de los módulos (WhatsApp, etc.) por cuenta | Filtra los clientes que realmente consumen créditos |
| API – listar bandejas de entrada | Identificador y nombre de cada bandeja de entrada por cuenta | Relaciona cada bandeja con un cliente y aísla los datos de consumo |
| Módulo Informes – exportación CSV | Volumen de conversaciones iniciadas y plantillas enviadas por bandeja en el período | Proporciona las métricas base para calcular el gasto de créditos |
| Portal de facturación (Stripe) | Historial de compras de créditos y recargas de los clientes | Complementa la liquidación con los ingresos generados y el saldo contratado |

## Cómo funciona la generación de informes con API y exportaciones

En la reventa white label, cada cliente es una cuenta separada y suele tener su propia bandeja de entrada (ej.: “WhatsApp – Consultorio X”). La API de Papo, con los endpoints de superadministrador, permite listar todas las cuentas, verificar qué módulos están activos y obtener las bandejas de entrada de cada una. Estos datos estructuran el “quién” y el “dónde” del consumo. Los números de consumo (mensajes, plantillas) provienen del módulo Informes, que puede exportarse en CSV para cada bandeja de entrada. El historial de cobros está disponible en el portal de facturación, que es white label y mantiene tu marca.

Al combinar estos tres pilares mediante scripts, hojas de cálculo o herramientas de BI, montas, de forma programática, un informe de liquidación para cada cliente, con:
- identificación de la cuenta y de la bandeja de entrada;
- total de conversaciones y plantillas del período;
- créditos consumidos (calculados a partir de la tabla de Meta);
- resumen de la suscripción y de las recargas realizadas.

## Paso a paso para automatizar el informe de liquidación

1. **Obtén el token de API de superadministrador**  
   En el panel de tu reventa white label, genera las credenciales que darán acceso a los endpoints de gestión de cuentas.

2. **Lista todas las cuentas de clientes**  
   Haz una llamada al endpoint que devuelve las cuentas bajo tu reventa. Así mantienes un catálogo actualizado con los IDs de cada cliente.

3. **Para cada cuenta, verifica los módulos activos**  
   Con el endpoint de estado de módulos, confirma si WhatsApp (u otro canal que genera consumo) está activo. Esto evita procesar clientes inactivos.

4. **Lista las bandejas de entrada de cada cuenta**  
   Usa el endpoint que devuelve las bandejas de entrada (id, nombre y canal) para mapear los orígenes de mensajes de cada cliente. Almacena la relación entre el ID de la cuenta y los IDs de las bandejas.

5. **Exporta los informes de conversaciones**  
   En el módulo Informes, para cada bandeja de entrada identificada, selecciona el período deseado y exporta el CSV de conversaciones (que incluye el volumen de conversaciones iniciadas y plantillas enviadas). Este paso puede programarse por script si es posible descargar el archivo automáticamente.

6. **Calcula el consumo de créditos**  
   Combina el CSV con la lista de clientes activos y aplica la tarificación de créditos de WhatsApp. Agrupa por cliente y período, generando una tabla de consumo por cuenta.

7. **Recupera el historial de facturas**  
   Accede al portal de facturación (Stripe, con tu marca) para obtener el historial de transacciones de cada cliente: compras de créditos, importes y fechas. Esta información completa el informe de liquidación con los ingresos reales.

8. **Consolida y distribuye**  
   Monta el informe final –indicando consumo, crédito contratado, recargas y valor a liquidar– en hoja de cálculo, PDF o dashboard. Este consolidado puede entregarse periódicamente al cliente.

## Para quién está indicada esta automatización

- **Revendedores white label** con decenas o cientos de clientes, que necesitan generar liquidaciones mensuales de consumo sin manipular la interfaz de cada cuenta.
- **Agencias y software houses** que integran Papo con un sistema de facturación propio y quieren alimentarlo con datos precisos de uso.
- **Operaciones que ya usan herramientas de BI** y desean cruzar los datos de consumo con otros indicadores de la reventa, como ticket promedio y recurrencia.

## Preguntas frecuentes

### ¿La API de Papo devuelve directamente la cantidad de mensajes de WhatsApp consumidos?
Actualmente la API no tiene un endpoint dedicado que devuelva el saldo o el número de mensajes consumidos. El volumen de conversaciones y plantillas se obtiene desde el módulo Informes, que permite exportación en CSV.

### ¿Necesito revisar manualmente cada cliente para generar el informe?
No. Con los endpoints de listado de cuentas, módulos y bandejas de entrada, obtienes toda la estructura necesaria de forma programática. El proceso de exportación de los CSV puede programarse o ejecutarse por script, reduciendo al máximo la intervención manual.

### ¿Puedo automatizar la generación periódica del informe de liquidación?
Sí. Utilizando scripts que llaman a la API y acceden a los archivos exportados, es posible montar una rutina que genere la liquidación cada mes o en el intervalo deseado. El límite está en cómo obtienes los CSV; el módulo Informes permite exportar los datos de forma recurrente.

### ¿Cómo asocio una bandeja de entrada a un cliente específico?
Usa el endpoint de listado de bandejas de entrada, que devuelve el ID, nombre y canal de cada una. Como cada bandeja pertenece a una cuenta, basta con cruzar el ID de la cuenta devuelto en el listado de cuentas con las bandejas recibidas. Puedes crear un mapeo fijo en tu script.

### ¿Y los datos de facturación, cómo accedo sin interfaz?
El portal de facturación (Stripe) muestra el historial de transacciones de cada cliente con tu marca. Para acceso programático, es posible extraer estos datos del panel o, si está disponible, utilizar informes de Stripe. La API de gestión de cuentas de Papo no devuelve facturas.

### ¿Se necesita un token especial para estos endpoints?
Sí. Los endpoints de administración de cuentas y de listado de bandejas requieren autenticación con privilegios de superadministrador, que el revendedor white label genera en el panel de configuración.

## Lea también

- [Cómo usar la API de Papo para monitorear consumo de créditos y facturas de la reventa white label](/hc/papo/articles/api-papo-monitorear-creditos-facturas-white-label)
- [Cómo crear un dashboard de ingresos de la reventa en Power BI con integración vía webhook](/hc/papo/articles/como-crear-dashboard-ingresos-reventa-power-bi-webhook)

---

**[Empieza a automatizar tus informes de liquidación ahora →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=helpcenter&utm_medium=article&utm_campaign=api-gerar-relatorios-consumo-repasse-clientes-white-label&utm_content=pt_BR)**

Crea tu cuenta gratuita, sin tarjeta de crédito, y accede a la API de Papo para integrar tus procesos de reventa white label.