Reportes y Conciliación
Koywe proporciona endpoints de reportes completos para ayudarte a rastrear, conciliar y auditar toda la actividad financiera en tus cuentas virtuales.
Por Qué Importan los Reportes
Beneficios Clave:
- Conciliación: Compara tus registros internos con el libro mayor de Koywe
- Pistas de Auditoría: Mantén el historial completo de transacciones para cumplimiento
- Integración Contable: Exporta datos para tus sistemas de contabilidad
- Soporte al Cliente: Recupera rápidamente detalles de transacciones para consultas
Reportes Disponibles
| Reporte | Descripción | Ideal Para |
|---|---|---|
| Estado de Cuenta | Estado de cuenta estilo bancario con saldos inicial/final y saldo actualizado | Conciliación mensual, verificación de saldos |
| Reporte de Órdenes | Vista a nivel de transacción de todas las órdenes con filtros | Análisis de órdenes, seguimiento de estados, reportes de volumen |
| Detalle de Movimiento | Recibo detallado de un movimiento individual del libro mayor | Documentación de auditoría, resolución de disputas |
Cuándo Usar Cada Reporte
Dibujando diagrama…
Casos de Uso Comunes
Conciliación Bancaria Mensual
Usa el Estado de Cuenta para conciliar el saldo de tu cuenta virtual con tus registros internos:
- Obtén el estado de cuenta del mes
- Compara el saldo inicial con el cierre del mes anterior
- Verifica cada movimiento contra tus registros
- Confirma que el saldo final coincida con el saldo actual de la cuenta
Análisis de Volumen de Transacciones
Usa el Reporte de Órdenes para analizar tu actividad de pagos:
- Obtén el reporte de órdenes del período
- Usa las estadísticas de resumen para ver totales por tipo (PAYIN, PAYOUT, etc.)
- Filtra por estado para identificar transacciones fallidas o pendientes
- Exporta para dashboards de inteligencia de negocios
Documentación de Auditoría
Usa Detalle de Movimiento para generar comprobantes de transacciones específicas:
- Identifica la transacción en tu estado de cuenta
- Recupera el
ledgerEntryId - Obtén el recibo detallado con saldo antes/después
- Archiva para registros de cumplimiento
Jerarquía de la API
Todos los endpoints de reportes siguen la misma jerarquía:
Texto
/api/v1/organizations/{organizationId}/merchants/{merchantId}/accounts/{accountId}/reports/...| Parámetro | Descripción | Ejemplo |
|---|---|---|
organizationId | Tu ID de organización | org3_8821b7b4-7f0c-45d9-aa5f-a9ce41ee2f1e |
merchantId | El ID del comercio | mrc_2e8f96ab-dbd5-45f9-b4b6-645945daf340 |
accountId | El ID de la cuenta virtual | acc_0031c537-2301-40ab-9153-0f7c48505350 |
Los reportes están limitados a una cuenta virtual específica. Cada cuenta tiene su propio libro mayor e historial de transacciones.
Autenticación
Todos los endpoints de reportes requieren un token Bearer válido:
Terminal
curl -X GET 'https://api.koywe.com/api/v1/organizations/.../reports/ledger-statement' \
-H 'Authorization: Bearer TU_TOKEN'