usebcch

Este repositorio contiene la implementación nativa para Stata del acceso a la Base de Datos Estadísticos (BDE) del Banco Central de Chile (BCCh). usebcch descarga una o varias series, busca códigos en el catálogo y ofrece transformaciones, caché y metadatos sin depender de la integración de Python.

La implementación Stata es independiente y no constituye un producto oficial del Banco Central de Chile.

El Banco Central de Chile también publica el comando Python bcchapi para utilizar su API BDE. Este repositorio no duplica ese código: usebcch es la implementación nativa equivalente para usuarios de Stata.

Para instalar la implementación Python:

pip install bcchapi

Ayuda: bcchapi en PyPI · ejemplos oficiales de la API BDE

La API Python y usebcch requieren una cuenta propia del portal BDE/SI3.

Requiere Stata 16 o superior y acceso HTTPS.

Instalación desde el repositorio:

net install usebcch, ///
    from("https://raw.githubusercontent.com/MaykolMedrano/usebcch/main/stata") replace

Para probar una copia local durante el desarrollo, sustituya la URL por la ruta de su carpeta stata/. En ambos casos, from() debe apuntar al directorio que contenga stata.toc y usebcch.pkg, no a una página HTML ni a un archivo ZIP.

Ayuda: guía de usuario · ayuda de Stata · especificación técnica · guía de distribución

Replicación: suite de pruebas Stata

Cada usuario debe crear o activar sus propias credenciales en el portal BDE/SI3. usebcch no crea cuentas, no entrega usuarios ni contraseñas y nunca distribuye credenciales.

La opción recomendada es registrar una vez un archivo .env privado:

usebcch auth set, envfile("C:/private/bcch.env")
usebcch auth status

El archivo .env es personal y nunca debe incluirse en el repositorio. También pueden utilizarse BCCH_USER y BCCH_PASSWORD como variables de entorno o la opción credentials() para archivos de dos líneas.

* Una serie diaria
usebcch get F073.TCO.PRE.Z.D, from(2024-01-01) to(2024-12-31) clear

* Varias series con nombres legibles
usebcch get F073.TCO.PRE.Z.D F022.TPM.TIN.D001.NO.Z.D, ///
    names(dolar tpm) from(2024-01-01) clear

* Conversión mensual y variación interanual
usebcch get F073.TCO.PRE.Z.D, names(dolar) from(2020-01-01) ///
    frequency(monthly) aggregate(mean) variation(12) clear

* Búsqueda del catálogo
usebcch search "IPC", frequency(monthly) language(es) clear

Desde la raíz del repositorio, con StataNow 19 configurado en C:\Program Files\StataNow19\StataSE-64.exe:

powershell -ExecutionPolicy Bypass -File stata/scripts/run-tests.ps1

Para preparar una distribución Stata:

powershell -ExecutionPolicy Bypass -File stata/scripts/build-release.ps1

usebcch/
├── stata/
│   ├── README.md                   guía del runtime Stata
│   ├── *.ado, *.mata, *.sthlp      runtime nativo instalable
│   ├── stata.toc, usebcch.pkg  sitio net install
│   ├── tests/                   pruebas y fixtures
│   ├── docs/                    documentación Stata
│   └── scripts/                 pruebas y distribución
├── CHANGELOG.md
├── LICENSE
└── README.md

La fuente y el comportamiento de referencia se basan en el código público MIT de bcchapi, mientras que el transporte HTTP, el parser JSON y la materialización de datasets son nativos de Stata/Mata.

• Banco Central de Chile
• API BDE y condiciones de uso
• Portal BDE/SI3

Maykol Medrano
Pontificia Universidad Católica de Chile
Email: [email protected]
GitHub: MaykolMedrano

MIT. Consulte LICENSE.