Módulos de reportería – Centro de Soporte Kushki

Tabla de Contenido

Guía para visualizar, descargar y conciliar los informes de transacciones y liquidaciones disponibles en la consola de Kushki, con la nueva jerarquía de Customer Group.

1. Contexto: la jerarquía y su impacto en la reportería

Con la incorporación del Customer Group como nuevo nivel de la jerarquía (Owner → Customer Group → Customer → Branch), Kushki habilita reportería consolidada en dos nuevos niveles: Customer y Customer Group. Antes de Kushki One, los informes solo se podían generar a nivel de Branch.

Esto significa que un Customer con 10 branches puede ahora generar un solo informe consolidado de todos ellos. Y si esos Customers están agrupados en un Customer Group, el informe puede abarcar toda la estructura en un único archivo.

Nivel	Acceso	Tipo de informe	Medios de pago
Branch	Credenciales del Branch (Merchant ID)	A demanda. Rango de fechas libre. Generación inmediata.	Tarjeta, transferencia y efectivo.
Customer	Credenciales del Customer	Programado automáticamente. Diario (día vencido). Se ejecuta a las 3:00 a.m. hora Ecuador.	Solo tarjeta (Card Present y Card Not Present).
Customer Group	Credenciales del Customer Group	Programado automáticamente. Diario (día vencido). Se ejecuta a las 3:00 a.m. hora Ecuador.	Solo tarjeta (Card Present y Card Not Present).

⚠️ Importante: Los informes de Customer y Customer Group son exclusivamente de tarjeta. Las transacciones de transferencia y efectivo siguen siendo reportables únicamente a nivel de Branch. En el futuro podría habilitarse transferencia en estos niveles, pero no hay fecha definida.

2. Módulo de Informes en la consola

2.1 Cómo acceder

Para acceder al módulo de informes:

Se inicia sesión con las credenciales del nivel desde el que se desea configurar o descargar el informe (Branch, Customer o Customer Group).
En el menú lateral, se selecciona Informes.
Se visualizarán las pestañas Mis informes y Descarga de pendientes.

2.2 Novedades: botones de búsqueda en el módulo de informes

En el módulo de informes (vista Admin de Kushki) se agregaron dos nuevos botones de búsqueda:

Botón	Función
Customer / Branch	Permite buscar un Customer o un Branch por nombre o por ID. Si ya tiene un informe configurado, lo precarga para poder editarlo. Si no tiene informe, habilita el botón Crear informe.
Customer Group	Permite buscar un Customer Group por nombre o por ID. Si ya tiene un informe configurado, lo precarga. Si no, habilita el botón Crear informe.

ℹ️ Nota: Cuando se ejecuta la búsqueda, el resultado muestra el nombre del comercio para confirmación antes de crear o editar el informe. Se puede buscar por nombre o por Merchant ID / Customer Group ID indistintamente.

3. Informes de Branch (sin cambios)

Los informes de Branch mantienen exactamente el mismo flujo que el equipo ya conoce. No hay cambios en la estructura del formulario.

3.1 Características

Tipo: a demanda (el usuario genera el informe cuando lo necesita).
Rango de fechas: libre, el usuario define el período.
Generación: inmediata.
Medios de pago: tarjeta, transferencia y efectivo.
Acceso: con credenciales del Branch (Merchant ID).

3.2 Nuevos campos en los informes de tarjeta de Branch

Para facilitar la identificación de transacciones de Card Present frente a Card Not Present en un mismo informe, se están incorporando dos campos adicionales en los reportes de tarjeta:

Campo	Descripción	¿Cuándo viene vacío?
Serial de la terminal	Número de serie del dispositivo físico (SmartPOS) en el que se procesó la transacción.	Transacciones de Card Not Present (sin terminal física).
Marca de la terminal	Fabricante/modelo del dispositivo. Actualmente: Sunmi. En el futuro podrá incluir otras marcas.	Transacciones de Card Not Present, o cuando el comercio usa terminal propia sin integración.

Si una transacción de tarjeta tiene estos campos vacíos, corresponde a una operación de Card Not Present. El comercio puede usar esta lógica para filtrar y diferenciar ambos tipos en su propia herramienta de conciliación.

ℹ️ Nota: Cuando el comercio usa terminales propias de terceros con integración, los campos de serial y marca pueden venir poblados o vacíos según lo que el proveedor envíe. Cuando son terminales Kushki One (Sunmi), el proveedor Payrillium siempre envía esta información.

4. Informes de Customer y Customer Group

4.1 Características principales

Estos reportes son fundamentalmente distintos al de Branch. Son programados, no generables a demanda, y siempre cubren todos los Branches o Customers del nivel correspondiente.

Programación fija: el reporte se ejecuta automáticamente a las 3:00 a.m. hora Ecuador, todos los días.
Período cubierto: el día anterior completo (desde las 00:00 hasta las 23:59 del día de corte).
Alcance: incluye todos los Branches del Customer o todos los Customers del Customer Group. No es posible generar reportes de un subconjunto.
Solo tarjeta: Card Present y Card Not Present. Transferencia y efectivo no están incluidos.
Solo transacciones: el formulario no ofrece la opción de reporte de suscripciones (no aplica para este nivel).

⚠️ Importante: Si se configura el informe hoy, el primer reporte disponible será mañana a las 3:00 a.m. con las transacciones de hoy. No hay generación retroactiva. Por esto, es clave crear el informe desde el primer día de operación del comercio.

4.2 Formulario de creación del informe

Al crear un informe de Customer o Customer Group, el formulario tiene los siguientes campos:

Campo	Opciones / Comportamiento
Nombre del informe	Identificador interno para reconocerlo en la consola.
Formato	CSV u otros formatos disponibles, igual que en Branch.
Tipo de información	Solo transacciones (las suscripciones no aplican en este nivel).
Nivel de detalle	Detalle o resumen, bajo la misma estructura que Branch.
Medio de pago	Solo tarjeta (Pay ins → Tarjeta). Card Present y Card Not Present se incluyen automáticamente si el Customer los opera.
Estado de transacciones	Aprobadas, declinadas o todas. Igual que en Branch.
Hora de ejecución	Fija: 3:00 a.m. hora Ecuador. No es configurable.
SFTP (opcional)	Si el comercio desea recibir el archivo en su servidor SFTP, puede configurar los datos de conexión aquí. Es opcional.

4.3 Dónde quedan disponibles los informes generados

Una vez ejecutado el proceso de las 3:00 a.m., el informe queda disponible en dos lugares simultáneamente:

Siempre en la consola: en la pestaña Descarga de pendientes del módulo de Informes. Esto aplica tanto si se configuró SFTP como si no.
En el SFTP del comercio (si está configurado): el archivo también llega automáticamente al servidor del comercio.

ℹ️ Nota: A diferencia de los reportes de Branch, los informes de Customer y Customer Group no tienen opción de envío por correo electrónico. La distribución es por consola o por SFTP (SFTP configurado directamente en el módulo de informes, no el SFTP del proceso de onboarding).

4.4 Recomendación operativa: crear el informe desde el primer día

Dado que los reportes no generan datos retroactivos, es fundamental que el equipo de onboarding cree el informe de Customer (o de Customer Group) desde el momento en que se activa el comercio. Si el comercio empieza a transaccionar el 1 de mayo y el informe se crea el 16 de mayo, el primer reporte disponible será el 17 de mayo con datos del 16 de mayo. El histórico previo no se recupera de forma automática.

ℹ️ Nota: Aunque el Customer Group es un campo opcional, es recomendable asignarlo desde el inicio para que el comercio pueda acceder a reportes consolidados desde el primer día. Para comercios ya existentes que quieran este tipo de reportería, el Customer Group puede asignarse en cualquier momento, pero solo generará datos hacia adelante.

5. Módulo de Liquidaciones

5.1 ¿Qué es el módulo de liquidaciones?

El módulo de liquidaciones es una nueva sección de la consola que permite a los comercios visualizar y descargar los reportes de liquidación (pagos realizados a su cuenta bancaria) directamente desde la consola, sin necesidad de acceder a un servidor SFTP externo.

ℹ️ Nota: Este módulo no es exclusivo de Kushki One. Está disponible para todos los comercios de Kushki, independientemente de si operan con terminales físicas o no. Ya se encuentra desarrollado y en producción (pendiente de activación oficial).

5.2 ¿Qué reportes muestra?

Característica	Detalle
Reportes disponibles	Los mismos que se generan actualmente.
Periodicidad	Diarios y mensuales, según el tipo de reporte configurado con FinOps.
Acceso	Exclusivo para usuarios con el rol Visor de reportes a nivel de Customer.
Relación con SFTP existente	Los comercios que ya reciben reportes en su SFTP siguen recibiéndolos ahí. La consola es un canal adicional, no un reemplazo.
Comercios nuevos	Si el comercio no quiere configurar SFTP, FinOps genera los reportes de todas formas y la consola los muestra automáticamente.

5.3 Rol necesario: Visor de reportes

Para acceder al módulo de liquidaciones e informes consolidados, el usuario del comercio debe tener asignado el rol Visor de reportes. Este es un rol nuevo que se configura a nivel de Customer.

Rol	Acceso a informes	Acceso a liquidaciones	Acceso a transacciones
Visor de reportes (nuevo)	Sí — puede configurar y descargar informes.	Sí — puede ver y descargar reportes de liquidación.	No (por ahora no está habilitado para este rol).
Visor maestro (existente)	Sí	No (no aplica para el visor maestro de Branch)	Sí, con descarga.

⚠️ Importante: El módulo de transacciones no estará habilitado para el rol Visor de reportes en esta primera fase. Si en el futuro se habilita, la descarga de información desde ese módulo quedará desactivada para este rol, de modo que la descarga de datos se realice únicamente desde el módulo de informes.

5.4 Agrupación de reportes de liquidación

Para comercios que reciben múltiples reportes de liquidación (por ejemplo, porque operan Card Present y Card Not Present con cuentas bancarias diferentes), el módulo muestra los reportes agrupados. L El comercio puede seleccionar y descargar reportes de forma individual o por período.

ℹ️ Nota: La agrupación de clientes que aparece en el módulo de liquidaciones corresponde a la lógica de agrupación que se aplica hoy en la generación de sus reportes. No está relacionada con el Customer Group de la jerarquía de la consola.

6. Capacidad y limitantes conocidas

Durante la fase de pruebas y primeros meses de producción, hay algunas limitantes a tener en cuenta:

Limitante	Estado actual	Acción recomendada
Tamaño máximo de descarga (Branch)	Aprox. 25 MB / 400,000 registros en la consola actual. Se está revisando la capacidad para la nueva consola.	Para comercios con alto volumen, usar SFTP para evitar problemas de descarga.
Reportes retroactivos (Customer / Customer Group)	No disponibles. Los informes programados solo generan datos desde la fecha de configuración.	Crear el informe desde el primer día de operación del comercio.
Volumen máximo de reportes simultáneos	En evaluación. Se están haciendo pruebas con comercios de alto volumen transaccional.	Monitorear durante el Small Test y escalar si hay incidentes.
Reportes de terminales en consola	No disponible. La consola solo maneja transacciones, no terminales.	Para reportes de terminales, consultar el DMS o Mongo.

Preguntas frecuentes (FAQ)

¿Es posible generar un informe de Customer con solo algunos Branches?

No. El informe de Customer consolida automáticamente todos los Branches que tenga ese Customer. No es posible seleccionar un subconjunto. Si se necesita separar grupos de Branches, la alternativa es descentralizar esos Branches y manejar credenciales independientes.

Si se configura un SFTP para el informe de Customer Group, ¿el informe deja de aparecer en la consola?

No. El informe siempre queda disponible en la consola en la pestaña Descarga de pendientes, independientemente de si se configuró SFTP o no. El SFTP es un canal adicional, no reemplaza la disponibilidad en consola.

¿El módulo de liquidaciones reemplaza el SFTP que ya tiene configurado el comercio con FinOps?

No. Los comercios que ya reciben reportes de liquidación en su SFTP seguirán recibiéndolos ahí sin cambios. El módulo de liquidaciones en consola es un canal adicional de acceso. La estructura, periodicidad y formato de los reportes los sigue definiendo FinOps directamente con el comercio.

¿Cómo se puede saber si una transacción en el informe es de Card Present o Card Not Present?

En los informes de tarjeta hay dos campos nuevos: serial de la terminal y marca de la terminal. Si esos campos vienen vacíos, la transacción es de Card Not Present (no hubo terminal física). Si vienen con datos (número de serie y Sunmi, por ejemplo), la transacción es de Card Present procesada con una terminal Kushki One.

¿Qué pasa con el histórico de un comercio que se incorporó a Kushki One pero solo configuró el informe meses después?

El histórico previo a la configuración del informe no se genera de forma automática. Si se necesita ese histórico, debe solicitarse como proceso interno al equipo correspondiente. Por eso es fundamental crear el informe de Customer o Customer Group desde el primer día de activación del comercio.