Boletim de urna: o que é, como consultar e baixar

Copiar# Boletins de urna de uma UF em CSV (arquivo "bweb" dos Dados Abertos) com pandas
import io, urllib.request, zipfile
import pandas as pd

url = "https://cdn.tse.jus.br/estatistica/sead/eleicoes/eleicoes2026/buweb/bweb_1t_AC_051020261403.zip"
z = zipfile.ZipFile(io.BytesIO(urllib.request.urlopen(url, timeout=600).read()))
csv_nome = next(n for n in z.namelist() if n.lower().endswith(".csv"))
bu = pd.read_csv(z.open(csv_nome), sep=";", encoding="latin-1",
                 usecols=["NM_MUNICIPIO", "NR_ZONA", "NR_SECAO", "DS_CARGO_PERGUNTA", "QT_APTOS",
                          "QT_COMPARECIMENTO", "NR_VOTAVEL", "NM_VOTAVEL", "QT_VOTOS", "NR_URNA_EFETIVADA",
                          "DT_ABERTURA", "DT_ENCERRAMENTO", "DS_SECOES_AGREGADAS"])

# O boletim de uma seção (a primeira do arquivo; troque por município, zona e seção que quiser)
mun, zona, sec = bu.iloc[0][["NM_MUNICIPIO", "NR_ZONA", "NR_SECAO"]]
secao = bu[(bu["NM_MUNICIPIO"] == mun) & (bu["NR_ZONA"] == zona) & (bu["NR_SECAO"] == sec)]
print(mun, "zona", zona, "seção", sec)
pres = secao[secao["DS_CARGO_PERGUNTA"] == "Presidente"].sort_values("NR_VOTAVEL")
print(pres[["NR_VOTAVEL", "NM_VOTAVEL", "QT_VOTOS"]].to_string(index=False))
print("Urna:", secao["NR_URNA_EFETIVADA"].iloc[0], "| abriu:", secao["DT_ABERTURA"].iloc[0],
      "| encerrou:", secao["DT_ENCERRAMENTO"].iloc[0])

# Conferência: em cada seção e cargo, votos = comparecimento × nº de votos por eleitor (2 para senador em 2026)
soma = bu.groupby(["NM_MUNICIPIO", "NR_ZONA", "NR_SECAO", "DS_CARGO_PERGUNTA"], as_index=False).agg(
    votos=("QT_VOTOS", "sum"), comp=("QT_COMPARECIMENTO", "first"))
soma["esperado"] = soma["comp"] * soma["DS_CARGO_PERGUNTA"].map(lambda c: 2 if c == "Senador" else 1)
print("Seções × cargos conferidos:", len(soma), "| não fecham:", (soma["votos"] != soma["esperado"]).sum())

Copiar# Boletins de urna de uma UF em CSV (arquivo "bweb" dos Dados Abertos) com data.table
library(data.table)
options(timeout = 600)

url <- "https://cdn.tse.jus.br/estatistica/sead/eleicoes/eleicoes2026/buweb/bweb_1t_AC_051020261403.zip"
zip <- tempfile(fileext = ".zip")
download.file(url, zip, mode = "wb")
csv <- unzip(zip, exdir = tempdir())
bu <- fread(grep("\\.csv$", csv, value = TRUE, ignore.case = TRUE)[1], encoding = "Latin-1")

# Conferência: votos = comparecimento × nº de votos por eleitor (2 para senador em 2026)
soma <- bu[, .(votos = sum(QT_VOTOS), comp = QT_COMPARECIMENTO[1]),
           by = .(NM_MUNICIPIO, NR_ZONA, NR_SECAO, DS_CARGO_PERGUNTA)]
soma[, esperado := comp * ifelse(DS_CARGO_PERGUNTA == "Senador", 2, 1)]
soma[votos != esperado, .N]  # 0 = todos os boletins fecham

O código em R usa os pacotes jsonlite e data.table (install.packages(c("jsonlite", "data.table"))).

Copiar# Lê o texto de um QR code do boletim de urna (o que um leitor de QR devolve) em um dicionário
# Formato: pares CHAVE:VALOR separados por espaço; um BU longo vem em vários QR codes (QRBU:1:3, QRBU:2:3...)
def ler_qr(texto):
    campos = {}
    for par in texto.split():
        chave, _, valor = par.partition(":")
        campos.setdefault(chave, []).append(valor)
    return campos

def juntar(textos):
    """Junta os QR codes de um mesmo BU na ordem de QRBU."""
    partes = sorted(textos, key=lambda t: int(ler_qr(t)["QRBU"][0].split(":")[0]))
    return " ".join(partes)

# Exemplo ILUSTRATIVO (valores inventados; leia o QR do seu BU com o app Boletim na Mão ou qualquer leitor de QR)
exemplo = "QRBU:1:1 VRQR:1.5 UNFE:AC MUNI:01120 ZONA:0004 SECA:0175 HASH:ab12"
qr = ler_qr(juntar([exemplo]))
print(qr["UNFE"], qr["MUNI"], qr["ZONA"], qr["SECA"])

Exemplo ilustrativo de leitura do texto do QR code. A lista de campos e a verificação da assinatura estão no manual oficial do TSE (QR code no boletim de urna).