Reportes y Conciliación

Reportes financieros y conciliación de cuentas

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

ReporteDescripciónIdeal Para
Estado de CuentaEstado de cuenta estilo bancario con saldos inicial/final y saldo actualizadoConciliación mensual, verificación de saldos
Reporte de ÓrdenesVista a nivel de transacción de todas las órdenes con filtrosAnálisis de órdenes, seguimiento de estados, reportes de volumen
Detalle de MovimientoRecibo detallado de un movimiento individual del libro mayorDocumentación de auditoría, resolución de disputas

Cuándo Usar Cada Reporte


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:

  1. Obtén el estado de cuenta del mes
  2. Compara el saldo inicial con el cierre del mes anterior
  3. Verifica cada movimiento contra tus registros
  4. 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:

  1. Obtén el reporte de órdenes del período
  2. Usa las estadísticas de resumen para ver totales por tipo (PAYIN, PAYOUT, etc.)
  3. Filtra por estado para identificar transacciones fallidas o pendientes
  4. Exporta para dashboards de inteligencia de negocios

Documentación de Auditoría

Usa Detalle de Movimiento para generar comprobantes de transacciones específicas:

  1. Identifica la transacción en tu estado de cuenta
  2. Recupera el ledgerEntryId
  3. Obtén el recibo detallado con saldo antes/después
  4. Archiva para registros de cumplimiento

Jerarquía de la API

Todos los endpoints de reportes siguen la misma jerarquía:

/api/v1/organizations/{organizationId}/merchants/{merchantId}/accounts/{accountId}/reports/...
ParámetroDescripciónEjemplo
organizationIdTu ID de organizaciónorg3_8821b7b4-7f0c-45d9-aa5f-a9ce41ee2f1e
merchantIdEl ID del comerciomrc_2e8f96ab-dbd5-45f9-b4b6-645945daf340
accountIdEl ID de la cuenta virtualacc_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:

$curl -X GET 'https://api.koywe.com/api/v1/organizations/.../reports/ledger-statement' \
> -H 'Authorization: Bearer TU_TOKEN'

Próximos Pasos