Indicadores Financieros de Nicaragua

Este proyecto en Python descarga, procesa y almacena información de indicadores financieros relevantes de varias instituciones de Nicaragua.

El objetivo del proyecto es consolidar esta información en una base de datos centralizada para facilitar el análisis y la visualización de los datos.

Requisitos previos

• Python 3.12 o superior.
• SQL Server 2019 o superior, instalado y configurado.
• Asegúrate de tener acceso a internet para descargar los datos de los orígenes.

Orígenes procesados

• Banco Central de Nicaragua (BCN)
• Superintendencia de Bancos (SIBOIF)
• Comisión Nacional de Microfinanzas (CONAMI)

Indicadores procesados

BCN

• Ver lista en src/bcn/reportes.py

SIBOIF y CONAMI

• Estado de Situación Financiera (ESF): Activo, Pasivo, Patrimonio.

Instalar dependencias

pip install -r requirements.txt

Base de datos

El nombre de la base de datos usada es IndicadoresDW.

Crear base de datos

El script para crear la base de datos se encuentra en /database.

Puedes ejecutar el script desde SSMS o bien desde la terminal:

• Usando autenticación de Windows

sqlcmd -S [servidor] -d master -E -i ./database/create_database.sql

• Usando usuario y contraseña en Windows/Linux/MacOS

sqlcmd -S [servidor] -d master -U [username] -P [password] -i ./database/create_database.sql

Asegúrate de que tu servidor de SQL Server esté corriendo y de que tienes los permisos necesarios para crear bases de datos. El script configurará las tablas y objetos iniciales necesarios para almacenar y actualizar los datos procesados.

Conexión a base de datos

Las credenciales que se usan para conectarse a la base de datos desde Python están en .env

Estas son configuradas desde el script de creación de la base de datos.

Ejecución

El proyecto permite procesar los indicadores financieros de varias maneras. Dependiendo de los parámetros, puede procesar todos los periodos, el último periodo disponible, o un periodo específico. E incluso se puede especificar el origen.

py src/procesar.py [periodo] [origen]

Donde

• periodo: "ultimo", "todos" o "yyyymm"
• origen: "BCN", "SIBOIF" o "CONAMI"

Ejemplo

• Procesar todos los periodos

py src/procesar.py todos

• Procesar último periodo disponible

py src/procesar.py ultimo

• Procesar periodo especifico (yyyymm)

py src/procesar.py 202403

• Procesar último periodo para el BCN

py src/procesar.py ultimo BCN