Abrir y cerrar la aplicación
La aplicación no vive en internet: se ejecuta en su propio equipo y solo escucha en
127.0.0.1, así que nadie más en la red puede verla. Consta de dos partes que
se abren juntas: una ventana de consola, que es el motor, y el navegador, que es la
pantalla.
-
Doble clic en
Iniciar tablero.batEstá en la misma carpeta del CSV. La primera vez instala DuckDB (el motor de consultas); después arranca en dos segundos. -
El navegador se abre solo en
http://127.0.0.1:8765Si no lo hace, escriba esa dirección a mano. Puede abrirla en varias pestañas o navegadores a la vez. -
Para cerrar, cierre la ventana negra de la consola Cerrar solo la pestaña del navegador deja el motor corriendo en segundo plano.
Los datos ya están cargados
No hay que importar nada la primera vez. El archivo de agosto de 2026 ya está en la base y el tablero abre directamente con los 8,6 millones de registros listos para consultar.
Anatomía de la pantalla
Tres pestañas arriba, una columna de filtros a la izquierda y el área de análisis a la derecha. Los filtros son permanentes: lo que marque allí afecta a la vez a todos los indicadores, gráficos y tablas de la derecha.
Pase el cursor sobre cualquier barra o punto
Todos los gráficos muestran una ficha al pasar el ratón, con las cifras exactas del elemento: monto completo en pesos, tasa, número de créditos, ticket promedio y participación. Es la forma de leer los valores que no caben en el eje.
Los filtros
Todo lo que hay en la columna izquierda se combina con la lógica «y»: si marca Vivienda en tipo de crédito y Femenino en sexo, verá los créditos de vivienda desembolsados a mujeres. Dentro de una misma lista, en cambio, las marcas suman: marcar Consumo y Vivienda muestra los dos.
- Desde / Hasta. Las fechas de corte disponibles, que son semanales. Déjelas en blanco para usar todo el periodo cargado.
- Buscar entidad. Texto libre sobre el nombre de la entidad; no
distingue mayúsculas ni exige la palabra completa. Escribir
banco dedeja Banco de Bogotá y Banco de Occidente. - Las catorce listas desplegables. Entidad, tipo de entidad, tipo de crédito, producto, plazo, tipo de persona, sexo, tamaño de empresa, garantía, tipo de tasa, clase de deudor, rango de monto, grupo étnico y antigüedad de la empresa. Cada una viene ordenada por monto desembolsado, de mayor a menor, y muestra un contador con las opciones marcadas.
- Tasa mínima y máxima. Acota a las filas cuya tasa cae en el rango.
Útil para aislar tasas atípicas:
50a100deja a la vista únicamente lo más caro del mercado. - Monto mínimo y máximo. En pesos, sin puntos ni comas. Escribir
1000000000en el mínimo deja solo los desembolsos grandes. - Limpiar. Devuelve todos los controles a cero de una vez.
Municipio y CIIU se agrupan, pero no se filtran
El código de municipio (1.121 valores) y el CIIU de actividad económica (510) no tienen lista de selección, porque una lista de mil casillas es inmanejable. Sí puede agrupar por ellos en el ranking para ver cuáles concentran el desembolso, y desde la pestaña Detalle puede leer el código de cada registro.
Los seis indicadores
La fila superior resume la selección activa. Cada cifra se recalcula al tocar cualquier filtro.
| Indicador | Qué mide | Con todo el periodo |
|---|---|---|
| Tasa promedio ponderada | La tasa efectiva anual, ponderada por el monto de cada desembolso. | 18,11 % |
| Monto desembolsado | Suma de todo lo prestado en el periodo. B son billones,
mM miles de millones, M millones. |
$ 150,91 B |
| Créditos desembolsados | Número de operaciones, no de clientes. | 155.200.401 |
| Ticket promedio | Monto dividido entre número de créditos: el tamaño típico de la operación. | $ 972 mil |
| Margen adicional | Puntos porcentuales por encima de la tasa de referencia en créditos indexados. | 1,01 % |
| Registros analizados | Filas del reporte que cumplen los filtros. Es la medida de cuán fina es la selección, no un dato de mercado. | 8.643.069 |
La variación y sus colores
Bajo cada cifra puede aparecer una comparación contra la ventana inmediatamente anterior, de igual duración. El color no indica subida o bajada, sino si el movimiento es favorable para el deudor:
- rojo en tasa y margen cuando suben: el crédito se encareció.
- verde en monto, créditos y ticket cuando suben: hay más colocación.
Por qué a veces no aparece la variación
Para comparar hace falta historia previa en la base. Con el periodo completo seleccionado no hay nada anterior con qué comparar y la línea no se muestra. Aparece en cuanto acota el rango — por ejemplo, elegir «desde 03/07» lo compara con el mes anterior — y de forma permanente a medida que vaya cargando publicaciones sucesivas.
Leer los gráficos
Evolución semanal
Las barras son el monto desembolsado de cada corte y se leen en el eje izquierdo; la línea naranja es la tasa ponderada y se lee en el eje derecho, que no arranca en cero para que los movimientos de décimas sean visibles. Es el gráfico donde se detecta la estacionalidad: en los datos actuales, los cortes del 26 de junio y del 31 de julio sobresalen con casi 20 billones frente a los 13 o 14 habituales, el patrón de fin de mes.
Ranking
Los quince grupos principales según la dimensión y el orden que elija en los dos desplegables del encabezado. La dimensión cambia la pregunta por completo: por entidad responde «quién presta más», por producto «qué se está colocando», por municipio «dónde». El orden decide el criterio — monto, tasa o número de créditos — y conviene saber que ordenar por tasa saca a flote grupos diminutos con tasas extremas, así que suele leerse junto con la columna de participación de la tabla de resumen.
Distribución de tasas
Reparte el monto desembolsado en tramos de un punto porcentual y muestra qué porcentaje cae en cada uno. Responde a «¿el promedio del 18 % representa al mercado o esconde dos mercados distintos?». Las colas que aportan menos del 0,1 % se recortan del eje para que el gráfico no quede vacío; el pie del gráfico lo advierte cuando ocurre.
Comparativo en el tiempo
La curva de tasa semanal de los seis grupos principales del ranking, cada uno con su color en la leyenda. Sirve para ver quién está moviendo precios y quién se mantiene quieto. Cambie la dimensión del ranking y este gráfico la sigue: con la dimensión en tipo de crédito compara consumo, comercial y vivienda entre sí; con sexo, la brecha semana a semana.
Resumen por grupo y exportación
La tabla del final del tablero es el mismo corte del ranking, pero con las nueve columnas completas: tasa ponderada, tasa simple, margen, monto, participación, créditos, ticket promedio y número de registros. La barrita bajo cada nombre indica su peso relativo en el monto.
Exportar CSV descarga exactamente ese resumen agregado — con los filtros
aplicados y agrupado por la dimensión activa — como analisis_tasas.csv, listo
para Excel. No exporta los ocho millones de filas originales, sino el análisis, que es lo
que suele necesitarse para un informe.
La comparación más reveladora de la tabla
Las columnas de tasa ponderada y tasa simple, una al lado de la otra. Cuando se separan mucho, la entidad tiene muchos créditos pequeños caros y pocos grandes baratos. Banco Santander es el caso extremo: 16,20 % ponderada frente a 50,84 % simple.
Pestaña Detalle
Muestra los registros individuales del reporte, con las mismas dieciocho columnas del archivo original y respetando los filtros activos. Se pagina de cien en cien y el encabezado indica cuántos registros cumplen la selección en total.
- Ordenar: clic en cualquier encabezado. El primer clic ordena de mayor a menor; el segundo invierte.
- Navegar: los botones Anterior y Siguiente, que se desactivan al llegar a los extremos.
Es la vista para auditar: cuando un promedio del tablero sorprende, filtre hasta aislarlo, pase a Detalle, ordene por tasa y mire las filas que lo están empujando.
Actualizar con la próxima descarga
Cuando la Superintendencia publique el archivo siguiente, entre a la pestaña Datos. Hay dos formas de cargarlo y una es claramente mejor.
Desde una ruta del equipo
Pegue la ruta del CSV en la casilla, o haga clic en uno de los archivos de la lista: la aplicación busca sola en Descargas, Escritorio y la carpeta del proyecto, y marca con una estrella los que parecen ser este reporte.
No copia nada: lee el archivo donde está. Los 3 GB se procesan en unos 45 segundos.
Subir el archivo
Arrastre el CSV a la zona punteada o haga clic para elegirlo. Cómodo, pero primero copia el archivo entero al disco y solo después lo procesa, de modo que tarda bastante más y consume espacio temporal.
Si el disco no tiene sitio para la copia, la aplicación lo avisa y sugiere la otra vía.
En ambos casos verá el registro del proceso en pantalla, y al terminar el tablero se recarga solo con el periodo ampliado.
Qué pasa con los datos que ya estaban
El reporte publica siempre los últimos dos meses, así que cada descarga nueva se solapa con la anterior. La regla de la aplicación es sencilla:
- Las semanas repetidas se reemplazan. Manda el archivo nuevo, que trae las cifras corregidas.
- Las semanas anteriores se conservan. Aunque ya no vengan en la descarga, siguen en la base.
El efecto acumulado es que su base va guardando más historia que la fuente. Hoy tiene dos meses; tras varias cargas podrá comparar trimestres, y entonces la variación de los indicadores aparecerá siempre. Nada se duplica: cargar dos veces el mismo archivo deja el mismo resultado.
Vaciar la base
El botón está en la tarjeta «Archivos cargados» y borra todos los registros tras pedir confirmación. Es la salida si alguna vez carga un archivo equivocado: vacíe y vuelva a cargar los CSV correctos, que siempre se pueden reprocesar.
Cómo se calculan los indicadores
Cada fila del reporte no es un crédito: es el promedio de un grupo de créditos que comparten entidad, semana, producto, plazo, garantía y demás atributos. Por eso las tasas se agregan ponderando por el monto desembolsado.
Un promedio simple daría el mismo peso a un desembolso de un millón de pesos y a uno de mil millones, y produciría cifras que no describen el mercado. La tasa simple está igualmente en la tabla de resumen, pero como contraste, no como indicador principal.
Todo se calcula sobre la totalidad de los registros que cumplen los filtros — nunca sobre una muestra — y ninguna cifra viene precalculada: cada consulta recorre los 8,6 millones de filas en unas tres décimas de segundo.
Preguntas frecuentes, resueltas paso a paso
Las consultas más habituales y la combinación exacta de controles que las responde.
| Quiero saber… | Qué hacer | Resultado hoy |
|---|---|---|
| Qué banco cobra menos en vivienda | Filtro Tipo de crédito → Vivienda; dimensión Entidad; orden Por tasa. Lea de abajo hacia arriba y contraste con la participación. | Vivienda: 13,28 % |
| Cuánto más caro es el crédito productivo | Sin filtros; dimensión Tipo de crédito; orden Por tasa. | 36,83 % vs. 20,02 % consumo |
| Si hay brecha por sexo | Dimensión Sexo. El comparativo en el tiempo muestra si se abre o se cierra semana a semana. | 20,90 % mujeres · 20,08 % hombres |
| Cuánto pesa cada banco en el mercado | Dimensión Entidad, orden Por monto, columna Participación de la tabla. | Bancolombia: 27,7 % |
| Si las tasas subieron el último mes | Desde = 03/07/2026. La variación bajo «Tasa promedio ponderada» lo compara con el mes anterior. | — |
| Dónde se concentra el crédito | Dimensión Código de municipio, orden Por monto.
11001 es Bogotá. |
— |
| Qué microempresas pagan tasas más altas | Filtros Tamaño de empresa → Microempresa y Tasa mín. = 40; dimensión Producto. | — |
| Cómo llevar esto a Excel | Deje la selección lista y pulse Exportar CSV en «Resumen por grupo». | analisis_tasas.csv |
La versión publicada en internet
Además de la aplicación local existe una copia publicada en Cloudflare Pages, accesible desde cualquier navegador sin instalar nada y sin coste. Muestra el mismo tablero, con los mismos seis indicadores, los cuatro gráficos, las dieciséis dimensiones y todos los filtros.
Las cifras son las mismas, comprobadas una a una
El sitio no lleva servidor: publica los datos ya agregados en Apache Parquet y el navegador los consulta directamente. Se compararon 1.634 cifras — indicadores, series, rankings e histogramas — entre la versión local y la publicada, con doce combinaciones de filtros distintas: ninguna difiere. El desvío máximo en las tasas es de una millonésima de punto porcentual, es decir, ruido de redondeo.
El sitio también acepta su CSV
Arrastre el archivo del reporte a la pestaña Datos y el tablero se recalcula sobre sus datos. No hace falta instalar nada ni esperar a que nadie publique.
Su archivo no sale de su equipo
El CSV se lee y se resume en su propio navegador, con el procesador de su computador. No se sube a ningún servidor — de hecho es más privado que enviarlo — y el resumen queda guardado en ese navegador, listo para la próxima visita. El archivo completo de 2,97 GB tarda algo más de un minuto en procesarse.
Una distinción que conviene tener clara
Lo que cargue en el sitio lo verá usted, en ese navegador. Para que el
sitio muestre datos nuevos a todo el mundo, hay que cargar el CSV en
la aplicación local y ejecutar Publicar web.bat. El botón
Volver a los datos publicados descarta lo suyo y recupera la versión pública.
Qué cambia respecto a la aplicación local
- La pestaña Detalle muestra combinaciones agregadas, no los registros individuales del reporte. Cada fila reúne todos los créditos que comparten entidad, semana, producto, plazo y demás atributos, y su tasa es el promedio ponderado del grupo. Son 561.284 combinaciones en lugar de 8,6 millones de registros.
- Procesar un archivo grande necesita memoria: unos 1 GB para los 2,97 GB del reporte. En un computador de escritorio no supone problema; en un teléfono puede quedarse corto, y el sitio avisa antes de intentarlo.
- El filtro de tasa opera por tramos de un punto porcentual. Escribir 20 y 30 selecciona exactamente los créditos con tasa desde 20 % hasta menos de 31 %.
- No está el filtro de monto mínimo y máximo, porque el agregado suma los desembolsos de cada grupo y ese número ya no es comparable con el de un crédito suelto. Para acotar por tamaño use el filtro Rango de monto, que es exacto.
- Al agrupar por municipio o CIIU algunos filtros no se aplican, y el tablero lo advierte en pantalla indicando cuáles.
Cómo actualizar el sitio publicado
-
Cargue el CSV nuevo en la aplicación local Igual que siempre, desde la pestaña Datos.
-
Doble clic en
Publicar web.batRegenera los agregados y los sube. Un par de minutos después el sitio muestra los datos nuevos.
Por qué Parquet
Los 8,6 millones de registros del reporte se agrupan por todas las dimensiones a la vez, quedando en 561.284 combinaciones que conservan las sumas necesarias para recomponer cualquier consulta. Guardadas en Parquet — formato columnar, comprimido y con las dimensiones convertidas a códigos numéricos — ocupan 11,4 MB frente a los 2,97 GB del CSV original: una reducción de 260 veces. El navegador descarga ese archivo una sola vez, lo mantiene en caché y responde cada filtro en unas décimas de segundo.
Dónde viven los datos
En app\data\parquet\, un archivo por fecha de corte, en formato
Apache Parquet con compresión zstd. Los 8.643.069 registros ocupan 73 MB
frente a los 2,97 GB del CSV: cuarenta veces menos, sin perder una sola fila ni una sola
columna. Las consultas las resuelve DuckDB leyendo esos archivos, en algo menos de medio
segundo cada una.
| Formato | Tamaño | Observación |
|---|---|---|
| CSV de la Superintendencia | 2,97 GB | El archivo tal como se descarga |
| Parquet (lo que se guarda) | 73 MB | 10 archivos, uno por semana |
| Parquet agregado del sitio web | 11 MB | 561.284 combinaciones, para el navegador |
Lo que eso le permite hacer
- Cerrar la aplicación en cualquier momento. Guardar consiste en escribir archivos, así que no hay ninguna operación a medias que pueda corromperse si cierra la ventana de golpe o se va la luz.
- Publicar sin cerrar el tablero. Ya no hay base bloqueada.
- Usar los datos fuera de aquí. Parquet es un formato estándar: esos archivos se abren con Power BI, Excel, R o Python sin pasar por esta aplicación.
- Archivar o borrar los CSV de 3 GB. Una vez cargados ya no hacen falta; los datos viven en los Parquet. La aplicación nunca los borra por su cuenta.
Leerlos desde Python o Power BI
En Python basta una línea:
pandas.read_parquet('app/data/parquet/creditos-2026-06-05.parquet').
En Power BI: Obtener datos → Parquet, o apunte a la carpeta completa para
cargar todas las semanas de una vez.
Si algo falla
.bat.set PUERTO=9000 antes de
python app\servidor.py.Si necesita recargar todo desde cero sin abrir el navegador, la carga también funciona desde la consola:
:: desde la carpeta del proyecto
python app\ingesta.py "Tasas_de_interés_activas_....csv"
Referencia
Las dieciséis dimensiones
Cualquiera de ellas sirve para agrupar el ranking; las dos últimas no tienen filtro de lista.
Archivos del proyecto
| Archivo | Para qué sirve |
|---|---|
Iniciar tablero.bat | Lanzador. Es lo único que hay que ejecutar. |
app\servidor.py | Servidor web y consultas. |
app\ingesta.py | Carga de CSV; también funciona desde consola. |
app\static\ | La interfaz: HTML, CSS y JavaScript. |
app\data\parquet\ | Los datos en Apache Parquet: 73 MB con los 8,6 millones de registros. |
Publicar web.bat | Genera y sube la versión de internet. |
app\publicar.py | Convierte la base en los agregados Parquet del sitio. |
web\ | El sitio publicable. Se regenera solo; no se edita a mano. |
LEEME.md | Resumen breve de todo lo anterior. |
Por qué no es una web corriente
El CSV de la Superintendencia pesa 2,97 GB y trae 8.643.069 filas. Ningún navegador puede abrir eso en memoria, así que la aplicación convierte el archivo a una base columnar DuckDB de unos 200 MB y consulta contra ella. Ese es el motivo de que haya que arrancar un pequeño servidor local en vez de abrir un archivo HTML: es lo que permite que una pregunta sobre ocho millones de registros se responda en tres décimas de segundo.
Fuente de los datos: Superintendencia Financiera de Colombia, reporte de tasas de interés activas por tipo de crédito, últimos dos meses. Cifras de este manual tomadas de la publicación del 20 de agosto de 2026.