Pestaña Cumplimiento dentro de Reportes. Descarga a Excel las transacciones de un país con las 36 columnas de la planilla que se presenta a Cumplimiento: los datos del beneficiario, el monto, el pago y la agencia donde se pagó.
Tiene permiso propio, separado del de Reportes. Por defecto solo lo tiene Admin; si un administrador lo habilita para otro perfil, aparece la pestaña y nada más cambia. Tener acceso al resto de Reportes no alcanza: si ves Estado de Situación, Cajas o Cierres por día y no ves Cumplimiento, no es una falla, es un permiso que tu usuario no tiene.
Antes de descargar: el archivo tiene datos personales
Es el reporte más sensible del sistema. El Excel trae, de todas las personas del país elegido, el nombre, la fecha de nacimiento, la nacionalidad, el documento de identidad, el teléfono, el mail y la dirección. Por eso:
- No hay vista previa. La pantalla no muestra ningún dato: tiene los filtros, un resumen de lo que se va a bajar y el botón. Los datos de muchas personas juntas solo salen por este archivo.
- Cada descarga queda registrada en Auditoría como Exportación de reporte (se puede filtrar por esa acción), con tu usuario, el país, las fechas, el estado y la cantidad de filas. No se guarda el contenido: ni un nombre, ni un documento. También queda registrado el intento de bajar un país que no es el tuyo (Exportación de reporte denegada).
- El archivo es tuyo desde que lo bajás. Guardalo solo donde corresponda y no lo compartas por medios no autorizados. El sistema no puede controlar lo que pasa con una copia fuera de él.
- Sin país elegido no hay descarga, y solo se ofrecen los países donde tu usuario tiene este permiso.
Cómo descargarlo
- Entrá a Reportes → Cumplimiento.
- Elegí el País. Es obligatorio y siempre se baja un solo país por archivo, aunque tu usuario tenga acceso a varios. Si tiene uno solo, igual aparece a la vista.
- Elegí las fechas y el estado (abajo).
- Controlá el resumen Se va a descargar: dice el país, las fechas y los estados en palabras, para que no haya que adivinar qué quedó puesto en cada filtro.
- Apretá Descargar Excel. Mientras se arma el botón dice "Descargando…". Al terminar, la pantalla confirma que se descargó el archivo y que la descarga quedó registrada en Auditoría.
El archivo se llama reporte-cumplimiento-GT-20261002-1530.xlsx: el código del país, el día y la hora de la descarga. No lleva ningún dato de las personas.
Los filtros
| Filtro | Qué hace |
|---|---|
| País | Obligatorio. Solo aparecen los países donde tu usuario puede leer este reporte |
| Desde y Hasta | Acotan por el día en que se creó la transacción (cuando entró al sistema), no por el día en que se pagó. Ambos días entran enteros. Cada extremo es opcional |
| Estado | Todos los estados, Pendiente (todavía no se pagó), Pagada o Cancelada |
Sin tocar nada, baja el mes en curso —del día 1 a hoy, con la fecha de Guatemala— y todos los estados. Se empieza por un mes y no por todo el historial para que no salgan, sin que nadie lo decida, más datos personales de los que hacen falta.
Quitar fechas vacía las dos fechas y deja el rango abierto: baja todo el historial del país. El resumen lo dice ("sin límite de fechas") para que nadie crea que bajó un mes. También se puede vaciar una sola: con "Desde" vacío entra todo lo anterior a "Hasta", y al revés.
Si "Hasta" es anterior a "Desde", la pantalla avisa y el botón queda deshabilitado hasta que se corrija.
Qué trae el archivo
Una fila por transacción, de la más vieja a la más nueva, con 36 columnas con los nombres y el orden de la planilla de Cumplimiento (los encabezados están en inglés, tal como los usa esa planilla).
| Columnas | De qué se trata |
|---|---|
| 1 a 13 | El beneficiario: nombre, apellido, fecha de nacimiento, nacionalidad, teléfono, dirección, ciudad, provincia, país, tipo / país / número de documento y mail |
| 14 a 18 | El monto y la entrega: monto principal, total con comisión, tipo de entrega (Cash o Bank transfer), cuenta bancaria y notas |
| 19 a 24 | La transacción: fecha y hora, MTCN (con el prefijo C-), PIN (el mismo número que el MTCN, sin prefijo), estado y entidad pagadora |
| 25 a 27 | El pago: moneda, tipo de cambio y monto que recibió el beneficiario |
| 28 a 32 | El estado: vencimiento, estado actual, notas del estado (siempre vacía) y fecha y hora de pago |
| 33 a 36 | La agencia donde se pagó: nombre, ciudad, provincia y país |
Cómo se llenan las celdas:
- Una celda sin dato queda vacía, nunca con un guion ni un cero. Es lo que corresponde a un reporte que lee un regulador.
- Fecha de nacimiento y nacionalidad (3 y 4) las carga el cajero al pagar. La nacionalidad se elige de la lista de países y sale con su nombre (Guatemala), no con el código; en los pagos hechos antes de que fuera un desplegable sale como se escribió (Guatemalteca). En los pagos hechos antes de que el sistema las pidiera salen vacías.
- Los montos son números, no texto: se pueden sumar y ordenar en Excel. Las fechas y las horas salen como texto (
02/10/2026,15:30:00) para que ninguna se deforme al abrir el archivo. - Ciudad, provincia, tipo de documento y país del documento salen con su nombre, no con el código del catálogo. Un dato cargado a mano antes de que existiera el catálogo sale tal cual se escribió.
- El país del documento (11) sale con el nombre de la lista de países que mandó Cumplimiento, no con el de la norma ISO: Holanda, Qatar, Suazilandia, República Checa… (la lista está en Catálogos). El tipo de documento (10) del DPI sale como DPI (Documento Personal de Identificación). Un cambio de nombre en esas listas es retroactivo: un reporte que se vuelva a bajar sale con el nombre nuevo también para pagos ya hechos, y puede diferir en esa celda de uno bajado antes. El código guardado en el pago no cambia. El país del beneficiario (9) es otra cosa: es el país donde opera CIS (Guatemala) y no sale de esa lista, así que esos cambios no lo tocan.
- El número del documento (12) sale tal cual se guardó. El sistema hace respetar el formato al cargar el pago (DPI de 13 números emitido por Guatemala; Pasaporte de 7 a 13 letras o números), pero un pago hecho antes puede traer un número que hoy no pasaría —un DPI con espacios o de 12 dígitos, por ejemplo—. Una transacción pagada no se puede modificar, así que ese número sale como quedó, sin error y sin corregirse. Si hace falta saber cuántos hay, pídaselo a quien administra el sistema.
- El teléfono y el mail son el dato adicional que se cargó al pagar y, si no hay, el que mandó Soterex.
- Moneda, tipo de cambio y monto del beneficiario (25 a 27) son los del movimiento de caja del pago. Si el pago fue en dólares, el tipo de cambio es
1. Una transacción pendiente o cancelada no tiene movimiento de caja: en un país que paga en dólares sale conUSD,1y el principal; en un país que paga en moneda local sale solo la moneda, y el tipo de cambio y el monto quedan vacíos, porque el principal está en dólares y ponerlo bajo otra moneda sería un dato falso. - Fecha y hora de pago (31 y 32) están solo si la transacción está pagada.
- La agencia (33 a 36) es el punto de venta donde se pagó, así que solo las transacciones pagadas la llevan: una pendiente o una cancelada sale con esas cuatro columnas vacías, aunque ya tenga un punto de venta asignado. En un país con módulo Caja, ese punto de venta sale de la caja desde la que se pagó cuando la persona no tenía un PDV activo ni uno solo asignado; si tenía un PDV activo, es ese (ver Asignación de Roles). Los pagos viejos que habían quedado sin punto de venta lo recuperan de su movimiento de caja. Una agencia sin ciudad o sin provincia cargadas sale con esas dos vacías (se completan en Estaciones).
- El total con comisión (15) es el principal más la comisión: quien tiene este permiso ve la comisión de cada pago en este reporte, aunque no tenga acceso al Prefondeo. Hoy solo la ven los administradores.
Cuatro columnas no vienen del sistema tal cual sino de un criterio con el que se llena la planilla hoy. Dos las confirmó Cumplimiento (el 2 de octubre de 2026) y dos esperan su respuesta, por eso no se tocaron:
| Columna | Qué dice | Estado |
|---|---|---|
| Transaction Status (23) | Siempre Sent: es el estado con el que la transacción llega de Soterex | Pendiente. Cumplimiento escribió «Send» y el archivo dice «Sent». Es un archivo para un regulador y una letra de diferencia es un error: se le pregunta cuál es el literal de su planilla y hasta que conteste no se cambia |
| Payer Name (24) | La entidad pagadora del país de la transacción: para Guatemala, CIS Guatemala. Un país que todavía no tiene la suya cargada sale con la celda vacía: no se inventa una razón social | Confirmada |
| Transaction Status - Update (29) | El estado real: Pending, Paid o Cancelled | Pendiente. Hoy sale en inglés; Cumplimiento lo escribió «pendiente, pagada o cancelada» y se le pregunta si lo quiere en español |
| Transaction Status-Additional Notes (30) | Siempre vacía. El encabezado se mantiene porque la planilla tiene esas 36 columnas en ese orden. El motivo de una cancelación ya no sale en el reporte; sigue en Auditoría (solo Admin), en el evento Cambio de estado de transacción: la ficha de la transacción no lo muestra | Confirmada |
El MTCN (21) sale con el prefijo C- (por ejemplo C-5436014032), igual que en la planilla de Cumplimiento y en la carta de Soterex. El PIN (22) sale solo con el número. Cumplimiento pidió mantener el prefijo «salvo que Soterex ya no lo use», y eso todavía se está confirmando con Soterex: por eso el prefijo es configuración y no parte del reporte. Es solo de esta columna: en el resto de la app el MTCN sigue siendo de 10 dígitos. Si Soterex deja de usarlo, quien administra el sistema lo apaga con la variable CUMPLIMIENTO_MTCN_PREFIX vacía (o lo cambia por otro texto) y el MTCN sale crudo, sin tocar nada más del reporte.
Si Cumplimiento necesita que alguna de las cuatro diga otra cosa, avisale a quien administra el sistema: se ajusta sin tocar el resto del reporte. Las entidades pagadoras por país son una línea de configuración (config/cumplimiento.php, payer_names): sumar un país nuevo no requiere cambiar el reporte.
Si algo no sale
- "El resultado supera las 1000 filas…": el archivo tiene un tope de filas (hoy 1000), porque con 36 columnas es muy pesado de armar. No se descarga un archivo cortado: se rechaza. Acotá el rango de fechas o el estado y probá de nuevo; para un período largo, bajalo en tramos. Un pedido rechazado por esto no queda registrado como descarga.
- "Hiciste varias descargas seguidas. Esperá un minuto…": hay un límite de 10 descargas por minuto por usuario; lo que descargan otras personas no te cuenta.
- "No tenés acceso a ese país": el país elegido no está entre los de tu usuario. Es el mismo aviso aunque el país no exista. Elegí uno de la lista.
- "No hay un país disponible para este reporte": tu usuario tiene el permiso pero ninguna de sus asignaciones lo incluye para un país. Pedile a un administrador que lo revise.
- "No se pudo descargar el reporte": es un corte de conexión o un error del servidor. Probá de nuevo; si se repite, avisá a quien administra el sistema.
- Una persona con acceso limitado a algunos puntos de venta recibe solo las transacciones de esos puntos. Las pendientes todavía no tienen punto de venta, así que a ese usuario no le llegan.

