Bens de candidatos (bem_candidato)¶
Resumo¶
Declaração de bens que acompanha o registro de candidatura (arquivo bem_candidato): cada linha é um bem de uma candidatura, ligado ao cadastro de candidatos por sq_candidato. Serve para somar o patrimônio declarado por pessoa, cargo ou partido.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | tse/bens-candidatos |
| Órgão | Tribunal Superior Eleitoral (TSE) |
| Página oficial | https://dadosabertos.tse.jus.br/dataset/candidatos-2024 |
| Licença | Creative Commons Attribution (CC BY), conforme os conjuntos no portal de dados abertos do TSE: http://www.opendefinition.org/licenses/cc-by. Nenhuma restrição de coleta ou de redistribuição foi encontrada nas páginas dos conjuntos; o LEIAME dos arquivos avisa que CPF, e-mail e outros dados pessoais de candidatos podem vir ocultos (veja os cuidados de uso). |
| Periodicidade | diária segundo o portal de dados abertos (extração com data de geração em cada arquivo) |
| Cobertura | 2018 a 2026 |
| Unidade (uma linha) | um bem declarado por uma candidatura |
| Granularidade | espacial: unidade eleitoral (município, UF ou nacional), com UF; temporal: eleição (ano) |
| Formato bruto | ZIP por ano com um CSV por UF, mais os consolidados BR e BRASIL; CSV em Latin-1 (ISO-8859-1), separador ponto e vírgula, todos os campos entre aspas duplas (inclusive os numéricos), uma linha de cabeçalho |
| Estado no lake | convertido |
| Partições | ano, uf |
| Chave | ano, sq_candidato, nr_ordem_bem_candidato |
| Colunas | 19 |
| Unidades de medida | vr_bem_candidato: R$ (texto com vírgula decimal) |
| Dados pessoais | sq_candidato (identificador da pessoa candidata); ds_bem_candidato (texto livre sobre o patrimônio da pessoa (pode conter endereços, matrículas e nomes)); vr_bem_candidato (patrimônio declarado) |
| Eras | nenhuma |
| Revisado em | 2026-11-10 |
| Versão do fetcher | 0.3.3 |
Origem e coleta¶
- O fetcher baixa
bem_candidato_<ano>.zipdo CDN (https://cdn.tse.jus.br/estatistica/sead/odsele/bem_candidato/). No bruto o nome é o da fonte, com manifesto ao lado. - Dentro do ZIP:
leiame.pdf(descartado), um CSV por UF (bem_candidato_<ano>_<UF>.csv), o consolidadobem_candidato_<ano>_BRASIL.csve, em 2018, 2022 e 2026, oBRdas candidaturas nacionais. - Conferido em 2026-11-10 pela listagem do bruto: ZIPs de 2018, 2020, 2022, 2024 e 2026. O fetcher aceita desde 2006.
Conteúdo¶
- Unidade de análise: um bem; a chave
ano,sq_candidatoenr_ordem_bem_candidatoé única nos arquivos por UF conferidos (2.189.264 linhas distintas em 2.189.264). - Cobertura conferida (arquivo
BRASIL, linhas): 2018: 93.527; 2020: 1.015.279; 2022: 92.559; 2024: 911.317; 2026: 77.446. - Cabeçalho de 19 colunas igual em todos os anos conferidos; nenhuma quebra de layout.
- Nulos: nenhum campo nulo nas 4.380.256 linhas conferidas (com a duplicação descrita nos cuidados).
Variáveis¶
Descrições do LEIAME oficial do TSE (bem_candidato); onde o texto não define a variável, a célula diz "não informado pela fonte". Todos os valores chegam ao lake como texto.
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
dt_geracao |
DT_GERACAO |
texto | Data da extração dos dados para geração do arquivo. | — | todo |
hh_geracao |
HH_GERACAO |
texto | Hora da extração dos dados para geração do arquivo com base no horário de Brasília. | — | todo |
ano_eleicao |
ANO_ELEICAO |
texto | Ano de referência da eleição para geração do arquivo. | — | todo |
cd_tipo_eleicao |
CD_TIPO_ELEICAO |
texto | Código do tipo de eleição. | . 1: Eleição Suplementar; . 2: Eleição Ordinária; e . 3: Consulta Popular. | todo |
nm_tipo_eleicao |
NM_TIPO_ELEICAO |
texto | Nome do tipo de eleição. | — | todo |
cd_eleicao |
CD_ELEICAO |
texto | Código único da eleição no âmbito da Justiça Eleitoral. | — | todo |
ds_eleicao |
DS_ELEICAO |
texto | Descrição da eleição. | — | todo |
dt_eleicao |
DT_ELEICAO |
texto | Data da ocorrência da eleição. | — | todo |
sg_uf |
SG_UF |
texto | Sigla da unidade da federação na qual a candidata ou candidato concorre na eleição. | — | todo |
sg_ue |
SG_UE |
texto | Sigla da unidade eleitoral na qual a candidata ou candidato concorre na eleição. A unidade eleitoral representa a unidade da federação ou o município em que a candidata ou o candidato concorre na eleição e é relacionada à abrangência territorial desta (...) | — | todo |
nm_ue |
NM_UE |
texto | Nome da unidade eleitoral da candidata ou candidato. Em caso de abrangência nacional, é igual a "Brasil". Em caso de abrangência estadual, é o nome da UF em que a candidata ou candidato concorre. Em caso de abrangência municipal, é o nome do município em que (...) | — | todo |
sq_candidato |
SQ_CANDIDATO |
texto | Número sequencial da candidata ou candidato, gerado internamente pelos sistemas eleitorais para cada eleição. | — | todo |
nr_ordem_bem_candidato |
NR_ORDEM_BEM_CANDIDATO |
texto | Número de ordenação do bem patrimonial material da candidata ou candidato de acordo com a sequência de bens declarados pela(o) mesma(o). | — | todo |
cd_tipo_bem_candidato |
CD_TIPO_BEM_CANDIDATO |
texto | Código do tipo do bem patrimonial material declarado pela candidata ou candidato. | — | todo |
ds_tipo_bem_candidato |
DS_TIPO_BEM_CANDIDATO |
texto | Tipo do bem patrimonial material declarado pela candidata ou candidato. | — | todo |
ds_bem_candidato |
DS_BEM_CANDIDATO |
texto | Descrição detalhada do bem material patrimonial da candidata ou candidato. | — | todo |
vr_bem_candidato |
VR_BEM_CANDIDATO |
texto | Valor, em reais, do bem declarado. Texto com vírgula decimal e sem separador de milhar, como 20000,00 |
R$ | todo |
dt_ult_atual_bem_candidato |
DT_ULT_ATUAL_BEM_CANDIDATO |
texto | Data da última atualização, no sistema, do bem material patrimonial declarado pela candidata ou candidato. | — | todo |
hh_ult_atual_bem_candidato |
HH_ULT_ATUAL_BEM_CANDIDATO |
texto | Hora da última atualização, no sistema, do bem material patrimonial declarado pela candidata ou candidato. | — | todo |
No lake¶
- Dataset
tse/bens-candidatos, particionado poranoeuf, um Parquet por CSV de origem. anoeufvêm do nome do membro; oBRvai parauf=bre oBRASILsó é lido se o ZIP não tiver os arquivos por UF (então vai parauf=__HIVE_DEFAULT_PARTITION__).- Todas as colunas são texto (inclusive
vr_bem_candidato, com vírgula decimal). Leitura em Latin-1; os campos de descrição com quebra de linha entre aspas são lidos corretamente: obem_candidato_2024_BRASIL.csvtem 936.515 linhas físicas e 911.317 registros, e o lake tem 911.317. - O esquema de referência (
bens-candidatos.schema.json) tem 19 colunas.
Cuidados de uso¶
- Dupla contagem (corrigida; lake gerado até a versão 0.3.3 ainda tem). O ZIP traz um CSV por UF, o
BR(registros de âmbito nacional, quando existe) e oBRASIL(consolidado que repete as UFs e oBR). O conversor atual não lê oBRASILquando o ZIP tem os arquivos por UF: lê as UFs (uf=<sigla>) e oBR(uf=br, comsg_uf=BR); se o ZIP só tiver oBRASIL, ele é lido e vai parauf=__HIVE_DEFAULT_PARTITION__. Ao descartar oBRASIL, o conversor confere o número de linhas dele com a soma das UFs e doBR; se divergir, registra um aviso com as três contagens e mantém só as UFs e oBR. Assim somar o lake inteiro conta cada linha uma vez. Um lake gerado antes da correção tem os Parquets doBRASILemuf=__HIVE_DEFAULT_PARTITION__e as linhas em dobro: apaguetse/bens-candidatos/e reconverta (veja oCHANGELOG.md). Evidência (conferida em 2026-11-10 com o conversor atual): em 2018 oBRASILtem 93.527 linhas, as UFs somam 93.212 e oBR315, e o lake passa a ter 93.527; em 2020 e 2024 oBRASILiguala a soma das UFs. - Valor em texto.
vr_bem_candidatoé texto com vírgula (20000,00); troque a vírgula por ponto antes de converter. Todas as linhas de 2022 seguem o padrãodígitos,dd. - Soma por pessoa. Um bem pode ser declarado em mais de uma eleição pela mesma pessoa; some por
sq_candidatodentro de umano, nunca entre anos. Osq_candidatomuda a cada eleição. - Descrição livre.
ds_bem_candidatoé texto digitado pela pessoa candidata e traz, por exemplo, percentuais de participação ("1/3 do imóvel") e aplicações financeiras; o valor não é padronizado. - **Marcadores da fonte ficam como texto, não viram nulo.
Exemplos¶
Patrimônio declarado mediano das candidaturas ordinárias de 2022 (soma dos bens por candidatura):
import polars as pl
bens = pl.scan_parquet(
"lake/tse/bens-candidatos/ano=2022/*/*.parquet", hive_partitioning=True
)
patrimonio = (
bens.filter(pl.col("cd_tipo_eleicao") == "2")
.with_columns(valor=pl.col("vr_bem_candidato").str.replace(",", ".").cast(pl.Float64))
.group_by("sq_candidato")
.agg(pl.col("valor").sum().alias("patrimonio"))
.select(pl.col("patrimonio").median())
.collect()
)
Na conversão local de 2026-11-10 o resultado foi R$ 275.900,00 para 18.244 candidaturas.
Referências¶
- Conjunto de 2024: https://dadosabertos.tse.jus.br/dataset/candidatos-2024
- Repositório de dados eleitorais (CDN): https://cdn.tse.jus.br/estatistica/sead/odsele/bem_candidato/
- Layout:
leiame.pdfdentro de cada ZIP