Transações Pix por município¶
Resumo¶
Estatística do BCB sobre as transações Pix liquidadas, consolidadas por município. Para cada município e mês, traz o valor e a quantidade de transações e a quantidade de pessoas, separando pagadores e recebedores e pessoas físicas e jurídicas. Serve para medir a adoção e o volume do Pix no território.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | bcb-microdados/pix_municipio_transacoes |
| Órgão | Banco Central do Brasil (BCB) |
| Página oficial | https://dadosabertos.bcb.gov.br/dataset/pix |
| Licença | Open Data Commons Open Database License (ODbL), conforme o conjunto pix no portal de dados abertos do BCB: http://www.opendefinition.org/licenses/odc-odbl |
| Periodicidade | mensal; o mês corrente também é publicado, ainda incompleto |
| Cobertura | 2020-11 a em-curso |
| Unidade (uma linha) | um município em um mês |
| Granularidade | espacial: município; temporal: mês |
| Formato bruto | JSON da API OData Olinda (Pix_DadosAbertos, função TransacoesPixPorMunicipio), um arquivo por mês |
| Estado no lake | convertido |
| Partições | ano, mes |
| Chave | ano, mes, codigo_ibge |
| Colunas | 18 |
| Unidades de medida | vl_pagador_pf: R$; vl_pagador_pj: R$; vl_recebedor_pf: R$; vl_recebedor_pj: R$; qt_pagador_pf: transações; qt_pagador_pj: transações; qt_recebedor_pf: transações; qt_recebedor_pj: transações; qt_pes_pagador_pf: pessoas; qt_pes_pagador_pj: pessoas; qt_pes_recebedor_pf: pessoas; qt_pes_recebedor_pj: pessoas |
| Dados pessoais | nenhum |
| Eras | nenhuma |
| Revisado em | 2026-11-07 |
| Versão do fetcher | 0.3.3 |
Origem e coleta¶
- O fetcher consulta a função OData
TransacoesPixPorMunicipio(DataBase=@DataBase)do serviço OlindaPix_DadosAbertosv1, um mês por vez, desde 2020-11 (2020-10 vem vazio). O conjunto de entidades sem a função devolve erro 500, por isso a consulta é sempre pela função. - Antes de baixar, o fetcher tira do fim os meses que a API ainda devolve vazios.
- No bruto, cada mês é
pix_municipio_transacoes_<AAAA-MM>.json, com a versão de cada coleta registrada à parte.
Conteúdo¶
- Uma linha por município e mês: 5.569 a 5.572 linhas por mês, incluindo uma linha
N/D(NAO INFORMADO) sem código de município. - Cobertura no lake: 73 meses, de 2020-11 a 2026-11, este último ainda incompleto (conferido em 2026-11-07).
- A descrição oficial do recurso é "Transações Pix liquidadas por município e por pessoas físicas (PF) e jurídicas (PJ), considerando a perspectiva do pagador e do recebedor".
Variáveis¶
As descrições vêm da especificação Swagger do serviço Olinda Pix_DadosAbertos.
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
codigo_ibge |
Municipio_Ibge |
texto | Código IBGE do município; nulo na linha N/D |
7 dígitos | todo |
municipio |
Municipio |
texto | Nome do município | — | todo |
uf_ibge |
Estado_Ibge |
texto | Código IBGE do estado | 2 dígitos | todo |
estado |
Estado |
texto | Nome do estado | — | todo |
sigla_regiao |
Sigla_Regiao |
texto | Sigla da região | NO, NE, SE, SU, CO |
todo |
regiao |
Regiao |
texto | Região do país | NORTE, NORDESTE, SUDESTE, SUL, CENTRO-OESTE, Nao informado |
todo |
vl_pagador_pf |
VL_PagadorPF |
decimal(20,2) | Volume financeiro das transações cujo pagador é pessoa física | R$ | todo |
qt_pagador_pf |
QT_PagadorPF |
inteiro | Quantidade de transações cujo pagador é pessoa física | transações | todo |
vl_pagador_pj |
VL_PagadorPJ |
decimal(20,2) | Volume financeiro das transações cujo pagador é pessoa jurídica | R$ | todo |
qt_pagador_pj |
QT_PagadorPJ |
inteiro | Quantidade de transações cujo pagador é pessoa jurídica | transações | todo |
vl_recebedor_pf |
VL_RecebedorPF |
decimal(20,2) | Volume financeiro das transações cujo recebedor é pessoa física | R$ | todo |
qt_recebedor_pf |
QT_RecebedorPF |
inteiro | Quantidade de transações cujo recebedor é pessoa física | transações | todo |
vl_recebedor_pj |
VL_RecebedorPJ |
decimal(20,2) | Volume financeiro das transações cujo recebedor é pessoa jurídica | R$ | todo |
qt_recebedor_pj |
QT_RecebedorPJ |
inteiro | Quantidade de transações cujo recebedor é pessoa jurídica | transações | todo |
qt_pes_pagador_pf |
QT_PES_PagadorPF |
inteiro | Quantidade de pagadores pessoas físicas | pessoas | todo |
qt_pes_pagador_pj |
QT_PES_PagadorPJ |
inteiro | Quantidade de pagadores pessoas jurídicas | pessoas | todo |
qt_pes_recebedor_pf |
QT_PES_RecebedorPF |
inteiro | Quantidade de recebedores pessoas físicas | pessoas | todo |
qt_pes_recebedor_pj |
QT_PES_RecebedorPJ |
inteiro | Quantidade de recebedores pessoas jurídicas | pessoas | todo |
ano |
AnoMes (ano) |
inteiro | Ano da data-base | — | todo |
mes |
AnoMes (mês) |
inteiro | Mês da data-base | 1 a 12 | todo |
No lake¶
- Dataset
bcb-microdados/pix_municipio_transacoes, particionado poranoemes; um Parquet por mês. AnoMesvira as partiçõesanoemese sai das colunas; o arquivo precisa ter um único mês.- Códigos de município e de estado viram texto com zeros à esquerda (7 e 2 dígitos).
- Valores (
VL_*) viram decimal com 2 casas; quantidades (QT_*), inteiro. - Nomes de coluna em minúsculas, com
PF/PJseparados por sublinhado (VL_PagadorPFviravl_pagador_pf).
Cuidados de uso¶
- O último mês é parcial. A API publica o mês corrente ainda em andamento. Para séries mensais, descarte o mês corrente ou marque-o como incompleto.
- Pagador e recebedor são duas perspectivas das mesmas transações, segundo a descrição oficial. Não some os dois lados como se fossem transações diferentes; para um total, use um lado só.
- De quem é o município. A fonte diz apenas que os dados são por município, "considerando a perspectiva do pagador e do recebedor"; ela não detalha, campo a campo, como o município é atribuído.
- Quantidade de pessoas não se soma entre municípios ou meses. A especificação não diz se
qt_pes_*conta pessoas distintas; uma mesma pessoa pode aparecer em mais de um mês. - Linha
N/D. Em cada mês há uma linha sem código de município (municipio = N/D,regiao = Nao informado). Filtrecodigo_ibgenão nulo para análises municipais, ou mantenha-a para totais.
Exemplos¶
Transações e valor por UF no último mês completo, pelo lado do pagador:
import polars as pl
from datetime import date
pix = pl.scan_parquet("lake/bcb-microdados/pix_municipio_transacoes/**/*.parquet", hive_partitioning=True)
mes = pl.col("ano") * 100 + pl.col("mes")
hoje = date.today()
ultimo = pix.select(mes.filter(mes < hoje.year * 100 + hoje.month).max()).collect().item()
por_uf = (
pix.filter((mes == ultimo) & pl.col("codigo_ibge").is_not_null())
.group_by("estado")
.agg(
(pl.col("qt_pagador_pf") + pl.col("qt_pagador_pj")).sum().alias("transacoes"),
(pl.col("vl_pagador_pf") + pl.col("vl_pagador_pj")).sum().alias("valor"),
)
.sort("transacoes", descending=True)
.collect()
)
Referências¶
- Conjunto "Estatísticas do Pix" no portal de dados abertos do BCB: https://dadosabertos.bcb.gov.br/dataset/pix
- Especificação do serviço Olinda
Pix_DadosAbertosv1 (Swagger): https://olinda.bcb.gov.br/olinda/servico/Pix_DadosAbertos/versao/v1/swagger-ui3#/ - Estatísticas do Pix (BCB): https://www.bcb.gov.br/estabilidadefinanceira/estatisticaspix