CDA PL — Patrimônio líquido do fundo
Stable ID: cvm.fundos.cda_fi/pl
Contexto semântico
Nome: CDA PL — Patrimônio líquido do fundo
O que contém: Patrimônio líquido reportado por fundo/classe e competência.
Por que consultar: Use como referência de tamanho da carteira e para validar somas/ratios de exposição por fundo.
Escopo e limitações: Uma linha por fundo/classe e competência na semântica declarada, com exceções de republicação documentadas.
Aliases e nomes oficiais: PL, pl, Patrimônio líquido
Evidências:
catalogo/cvm.yml — cda_fi/pldocs/catalog/deep_docs.yml — cda_fi/plhttps://dados.cvm.gov.br/dataset/fi-doc-cda
Comece aqui: guia de acesso aos dados
Readiness (label, not a promise): declared:tolerada/verificada · materialized:none · queryable:unknown
Declared (catalog YAML)
| field | value |
|---|---|
dataset |
cda_fi |
| parte historico_0506 layout | zip_multi_tabela |
parte historico_0506 vigencia |
ate=200612, de=200501 |
chave (parte historico_0506) |
tp_fundo, cnpj_fundo, dt_comptc |
| chave_status (parte historico_0506) | not declared in YAML — effective gate status verificada (registry default; treat as unverified) |
source URL (parte historico_0506) |
https://dados.cvm.gov.br/dados/FI/DOC/CDA/DADOS/HIST/cda_fi_{aaaa}.zip |
| parte historico_0717 layout | zip_multi_tabela |
parte historico_0717 vigencia |
ate=201712, de=200701 |
chave (parte historico_0717) |
tp_fundo, cnpj_fundo, dt_comptc |
chave_status (parte historico_0717, declared) |
tolerada |
max_linhas_excedentes (parte historico_0717) |
5 |
politica_dedup_silver (parte historico_0717) |
keep_first |
source URL (parte historico_0717) |
https://dados.cvm.gov.br/dados/FI/DOC/CDA/DADOS/HIST/cda_fi_{aaaa}.zip |
| parte historico_1822 layout | zip_multi_tabela |
parte historico_1822 vigencia |
ate=202212, de=201801 |
chave (parte historico_1822) |
tp_fundo, cnpj_fundo, dt_comptc |
| chave_status (parte historico_1822) | not declared in YAML — effective gate status verificada (registry default; treat as unverified) |
source URL (parte historico_1822) |
https://dados.cvm.gov.br/dados/FI/DOC/CDA/DADOS/HIST/cda_fi_{aaaa}.zip |
| parte corrente_2023 layout | zip_multi_tabela |
parte corrente_2023 vigencia |
ate=202311, de=202301 |
chave (parte corrente_2023) |
tp_fundo, cnpj_fundo, dt_comptc |
| chave_status (parte corrente_2023) | not declared in YAML — effective gate status verificada (registry default; treat as unverified) |
source URL (parte corrente_2023) |
https://dados.cvm.gov.br/dados/FI/DOC/CDA/DADOS/cda_fi_{aaaamm}.zip |
| parte corrente_2024 layout | zip_multi_tabela |
parte corrente_2024 vigencia |
ate=202401, de=202312 |
chave (parte corrente_2024) |
tp_fundo_classe, cnpj_fundo_classe, dt_comptc |
| chave_status (parte corrente_2024) | not declared in YAML — effective gate status verificada (registry default; treat as unverified) |
source URL (parte corrente_2024) |
https://dados.cvm.gov.br/dados/FI/DOC/CDA/DADOS/cda_fi_{aaaamm}.zip |
| parte corrente_202402 layout | zip_multi_tabela |
parte corrente_202402 vigencia |
ate=202604, de=202402 |
chave (parte corrente_202402) |
tp_fundo_classe, cnpj_fundo_classe, dt_comptc |
| chave_status (parte corrente_202402) | not declared in YAML — effective gate status verificada (registry default; treat as unverified) |
source URL (parte corrente_202402) |
https://dados.cvm.gov.br/dados/FI/DOC/CDA/DADOS/cda_fi_{aaaamm}.zip |
| parte corrente_202605 layout | zip_multi_tabela |
parte corrente_202605 vigencia |
ate=(unknown — not declared anywhere), de=202605 |
chave (parte corrente_202605) |
tp_fundo_classe, cnpj_fundo_classe, dt_comptc |
| chave_status (parte corrente_202605) | not declared in YAML — effective gate status verificada (registry default; treat as unverified) |
source URL (parte corrente_202605) |
https://dados.cvm.gov.br/dados/FI/DOC/CDA/DADOS/cda_fi_{aaaamm}.zip |
Divergent declarations: this table name is declared in more than one parte with differing chave/status — inspect each parte above.
Operator notes (verbatim from the catalog comments)
parte historico_0506
# VERIFICADA (probe com filtro_linha, split por DT_COMPTC contra o
# zip anual): excess=0 em 200812 (8,354) e 202212 (25,397) — um PL
# por fundo por data, como construcao.
parte historico_0717
# TOLERADA (2026-09-04): era VERIFICADA; o re-run revelou em 201104
# excess=1, byte-identico (mesma republicacao do blc_8).
# VERIFICADA (probe com filtro_linha, split por DT_COMPTC contra o
# zip anual): excess=0 em 200812 (8,354) e 202212 (25,397) - um PL
# por fundo por data, como construcao.
parte historico_1822
# VERIFICADA (probe com filtro_linha, split por DT_COMPTC contra o
# zip anual): excess=0 em 200812 (8,354) e 202212 (25,397) — um PL
# por fundo por data, como construcao.
parte corrente_2023
# VERIFICADA: excess=0 em 202301 (24,937) e 202311 — um PL por fundo
# por data, como construcao.
parte corrente_2024
# VERIFICADA: probe excess=0 em 202312 e 202401 — um valor de PL por
# fundo por data, confirmado por construcao.
parte corrente_202402
# VERIFICADA: excess=0 em 202603/202604/202605.
parte corrente_202605
# VERIFICADA: excess=0.
Observed runs (from meta/runs manifests)
Last good run:
| field | value |
|---|---|
timestamp |
20260825T150535 |
outcome |
ok |
exit_code |
0 |
rows_written |
73490 |
source_sha256 |
|
manifest_path |
C:\Users\plini\Repos\ciano-lake\data\meta\runs\cda_fi\20260825T150535.json |
competencia (scoped) |
(unscoped — not period-specific proof) |
Latest failed attempt (kept distinct from the last good run):
| field | value |
|---|---|
timestamp |
20260825T173137 |
outcome |
error |
exit_code |
1 |
error |
blc_1: Quality check failed: [PASS] row_count: 18,344 rows (validates > 0) |
| [FAIL] chave_status: chave_status 'pendente' — tabela nao promove. Bloqueada por decisao de catalogo (chave incompleta ou nao verificada), nao por regressao de dados. Ver catalogo/cvm.yml para a chave declarada e a nota. Gate nao executou a query de unicidade.; blc_2: Quality check failed: [PASS] row_count: 29,010 rows (validates > 0) | |
| [FAIL] chave_status: chave_status 'pendente' — tabela nao promove. Bloqueada por decisao de catalogo (chave incompleta ou nao verificada), nao por regressao de dados. Ver catalogo/cvm.yml para a chave declarada e a nota. Gate nao executou a query de unicidade.; blc_3: Quality check failed: [PASS] row_count: 432 rows (validates > 0) | |
| [FAIL] chave_status: chave_status 'pendente' — tabela nao promove. Bloqueada por decisao de catalogo (chave incompleta ou nao verificada), nao por regressao de dados. Ver catalogo/cvm.yml para a chave declarada e a nota. Gate nao executou a query de unicidade.; blc_4: Quality check failed: [PASS] row_count: 49,734 rows (validates > 0) | |
| [FAIL] chave_status: chave_status 'pendente' — tabela nao promove. Bloqueada por decisao de catalogo (chave incompleta ou nao verificada), nao por regressao de dados. Ver catalogo/cvm.yml para a chave declarada e a nota. Gate nao executou a query de unicidade.; blc_5: Quality check failed: [PASS] row_count: 11,030 rows (validates > 0) | |
| [FAIL] chave_status: chave_status 'pendente' — tabela nao promove. Bloqueada por decisao de catalogo (chave incompleta ou nao verificada), nao por regressao de dados. Ver catalogo/cvm.yml para a chave declarada e a nota. Gate nao executou a query de unicidade.; blc_6: Quality check failed: [PASS] row_count: 5,818 rows (validates > 0) | |
| [FAIL] chave_status: chave_status 'pendente' — tabela nao promove. Bloqueada por decisao de catalogo (chave incompleta ou nao verificada), nao por regressao de dados. Ver catalogo/cvm.yml para a chave declarada e a nota. Gate nao executou a query de unicidade.; blc_7: Quality check failed: [PASS] row_count: 58 rows (validates > 0) | |
| [FAIL] chave_status: chave_status 'pendente' — tabela nao promove. Bloqueada por decisao de catalogo (chave incompleta ou nao verificada), nao por regressao de dados. Ver catalogo/cvm.yml para a chave declarada e a nota. Gate nao executou a query de unicidade.; blc_8: Quality check failed: [PASS] row_count: 43,997 rows (validates > 0) | |
| [FAIL] chave_status: chave_status 'pendente' — tabela nao promove. Bloqueada por decisao de catalogo (chave incompleta ou nao verificada), nao por regressao de dados. Ver catalogo/cvm.yml para a chave declarada e a nota. Gate nao executou a query de unicidade. | |
manifest_path |
C:\Users\plini\Repos\ciano-lake\data\meta\runs\cda_fi\20260825T173137.json |
competencia (scoped) |
(unscoped) |
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)
Fund net equity (PL) — one row per fund per competência by construction. Re-measured 2026-09-04: status is tolerada with a small measured, capped exception (201104: excess=1, byte-identical — a CVM republication, the same pattern as blc_8); the historical probes closed at 0 excess (200812, 202212 through the DT_COMPTC row split). Silver collapses the byte-identical repeat with keep_first. Still the cleanest CVM fund-level table: safe to join on (tp_fundo, cnpj_fundo, dt_comptc) knowing the capped, documented exception.
Grain: one row per fund per competência (measured capped exception: one byte-identical republication in 201104, cap 5)
Units: values in BRL (VL_* columns)
Safe-join guidance:
- Safe to join/aggregate on (tp_fundo, cnpj_fundo, dt_comptc) — the key closes with a single measured byte-identical republication in 201104 (tolerada, cap 5); silver keep_first collapses the repeat.
Evidence references:
catalogo/cvm.yml — pl entry historico_0717 (re-measured 2026-09-04, tolerada cap 5)catalogo/cvm.yml — pl entries (historico_0506 and historico_1822, probes with filtro_linha split)
Postgres-queryable
(unknown — publication state is a publisher fact, filled at publication time; it is never inferred from materialization)