IF.DATA — Cadastro da instituição
Stable ID: bacen.instituicoes.ifdata_cadastro/cadastro
Contexto semântico
Nome: IF.DATA — Cadastro da instituição
O que contém: Código, tipo, nome e atributos cadastrais da instituição no período.
Por que consultar: Use para resolver a instituição e enriquecer os fatos financeiros.
Escopo e limitações: A chave é temporal e inclui período e tipo de instituição.
Aliases e nomes oficiais: cadastro, ifdata_cadastro
Evidências:
catalogo/bacen.yml — ifdata_cadastro/cadastrodocs/catalog/deep_docs.yml — ifdata_cadastro
Comece aqui: guia de acesso aos dados
Readiness (label, not a promise): declared:verificada · materialized:none · queryable:unknown
Declared (catalog YAML)
| field | value |
|---|---|
dataset |
ifdata_cadastro |
| parte legacy layout | rest_json_ifdata |
parte legacy vigencia |
ate=202412, de=(unknown — not declared anywhere) |
chave (parte legacy) |
periodo, tipo_inst, cod_inst |
chave_status (parte legacy, declared) |
verificada |
source URL (parte legacy) |
https://www3.bcb.gov.br/ifdata/rest/arquivos |
| parte current layout | rest_json_ifdata |
parte current vigencia |
ate=(unknown — not declared anywhere), de=202501 |
chave (parte current) |
periodo, tipo_inst, cod_inst |
chave_status (parte current, declared) |
verificada |
source URL (parte current) |
https://www3.bcb.gov.br/ifdata/rest/arquivos |
Operator notes
(no operator note in the catalog for this table — semantics beyond the structured fields above are unknown)
Observed runs (from meta/runs manifests)
Last good run:
| field | value |
|---|---|
timestamp |
20260824T215921 |
outcome |
ok |
exit_code |
0 |
rows_written |
0 |
source_sha256 |
|
manifest_path |
C:\Users\plini\Repos\ciano-lake\data\meta\runs\ifdata_cadastro\20260824T215921.json |
competencia (scoped) |
(unscoped — not period-specific proof) |
Observed residuals (tolerada_com_residuo evidence)
(none observed — either the table has no residual tolerance, or the coverage inventory has not run; absence is not proof of absence)
Materialized (coverage inventory, per environment)
(no coverage inventory available — run tools/coverage_inventory.py collect and pass the JSONL to the publisher; without it nothing is claimed about what physically exists)
Deep documentation (curated, grounded in the declarations above)
BACEN IF.DATA institution registry, quarterly — one row per institution per consolidation variant per quarter. Fully verified: zero duplicate keys and zero NULL key columns across the full 45-quarter series (201503–202603, 199,988 rows).
Grain: one row per (cod_inst, tipo_inst, periodo) as declared
Units: (unknown — not declared anywhere)
Safe-join guidance:
- Join facts on (cod_inst, periodo, tipo_inst) — the exact gold join keys. institution names are labels; identifiers are the join keys.
Curated, evidence-backed lineage (not Bruin ordering):
| from | to | kind | evidence |
|---|---|---|---|
bacen.instituicoes.ifdata_cadastro/cadastro |
publish.gold_bacen/v_institution_search |
curated | ciano_lake/gold/instituicoes/fcts.py (silver cadastro passthrough) |
Explore in Metabase: https://bi.cianoinvestimentos.space (internal, Tailscale-only).
Postgres-queryable
(unknown — publication state is a publisher fact, filled at publication time; it is never inferred from materialization)