Manual de uso · versión 1.0

Tablero de tasas de interés activas

Guía completa de la aplicación que analiza el reporte Tasas de interés activas por tipo de crédito de la Superintendencia Financiera y que se actualiza con cada nueva publicación del archivo.

Dirección
127.0.0.1:8765
Registros
8.643.069
Periodo
05/06 – 07/08/2026
Entidades
54
Dimensiones
16

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.

  1. Doble clic en Iniciar tablero.bat Está en la misma carpeta del CSV. La primera vez instala DuckDB (el motor de consultas); después arranca en dos segundos.
  2. El navegador se abre solo en http://127.0.0.1:8765 Si no lo hace, escriba esa dirección a mano. Puede abrirla en varias pestañas o navegadores a la vez.
  3. 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.

Tasas de interés activas 05/06/2026 – 07/08/2026 · 8.643.069 registros · 54 entidades Tablero Detalle Datos 1 Filtros Limpiar Desde / Hasta Buscar entidad Entidad Tipo de crédito Producto Plazo, sexo, tamaño… Tasa mín. Tasa máx. Monto mín. Monto máx. Sin filtros · 8.643.069 registros 2 Tasa ponderada 18,11 % Monto $ 150,91 B Créditos 155,2 M Ticket prom. $ 972 mil Margen 1,01 % Registros 8,6 M 3 Evolución semanal 4 Ranking por entidad Bancolombia Davivienda BBVA B. de Bogotá B. de Occidente Distribución de tasas 5 Resumen por grupo Exportar CSV 6
1Cabecera. Periodo cargado y total de registros, más las tres pestañas.
2Filtros. Se combinan entre sí y afectan a todo lo demás.
3Indicadores. El resumen de la selección actual.
4Evolución semanal. Barras de monto y línea de tasa.
5Ranking y distribución. Quién y a qué nivel de tasa.
6Resumen por grupo. La tabla que alimenta la exportación.

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 de deja 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: 50 a 100 deja a la vista únicamente lo más caro del mercado.
  • Monto mínimo y máximo. En pesos, sin puntos ni comas. Escribir 1000000000 en 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.

IndicadorQué mideCon 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.

recomendado

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.

tasa ponderada = Σ(tasa × monto) ÷ Σ(monto)

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.

Ticket promedio
Σ(monto) ÷ Σ(número de créditos)
Participación
Monto del grupo ÷ monto total de la selección
Margen adicional
Ponderado por monto, igual que la tasa
Variación
Contra la ventana previa de igual duración

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é hacerResultado 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

  1. Cargue el CSV nuevo en la aplicación local Igual que siempre, desde la pestaña Datos.
  2. Doble clic en Publicar web.bat Regenera 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.

FormatoTamañoObservación
CSV de la Superintendencia2,97 GB El archivo tal como se descarga
Parquet (lo que se guarda)73 MB 10 archivos, uno por semana
Parquet agregado del sitio web11 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

La página no carga
Compruebe que la ventana negra de la consola siga abierta. Sin ella no hay motor.
«No se encontró Python»
Instálelo desde python.org marcando Add Python to PATH, y vuelva a ejecutar el archivo .bat.
El puerto 8765 está ocupado
Abra la consola en la carpeta y ejecute set PUERTO=9000 antes de python app\servidor.py.
«El archivo tiene N columnas y se esperaban 23»
El CSV no es este reporte, o la fuente cambió el formato. Verifique que sea el de tasas activas por tipo de crédito.
«Ya hay una carga en curso»
Espere a que termine la anterior; el registro en pantalla indica en qué va.
El tablero aparece vacío
No hay datos en la base. Vaya a Datos y cargue un CSV.

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.

Entidad
54 bancos, compañías de financiamiento y cooperativas
Tipo de entidad
Banco, compañía de financiamiento, cooperativa, oficial
Tipo de crédito
Consumo, comercial, vivienda, productivo…
Producto de crédito
64 productos: libranza, tarjeta, factoring…
Plazo
28 rangos, de días a más de veinte años
Tipo de persona
Natural o jurídica
Sexo
Femenino, masculino, no binario, no aplica
Tamaño de empresa
Micro, pequeña, mediana, grande
Tipo de garantía
Idónea, FNG, sin garantía…
Tipo de tasa
Fija, DTF, IBR y otros indicadores
Clase de deudor
Nuevo en la entidad o ya vinculado
Rango de monto
42 tramos en salarios mínimos
Grupo étnico
Autorreconocimiento del deudor
Antigüedad de la empresa
Cuatro tramos
Código de municipio
1.121 códigos DANE · solo agrupación
Código CIIU
510 actividades económicas · solo agrupación

Archivos del proyecto

ArchivoPara qué sirve
Iniciar tablero.batLanzador. Es lo único que hay que ejecutar.
app\servidor.pyServidor web y consultas.
app\ingesta.pyCarga 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.batGenera y sube la versión de internet.
app\publicar.pyConvierte la base en los agregados Parquet del sitio.
web\El sitio publicable. Se regenera solo; no se edita a mano.
LEEME.mdResumen 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.