Profissional (cnes-pf)¶
Resumo¶
O cnes-pf contém os microdados do arquivo de Profissionais do Cadastro Nacional de Estabelecimentos de Saúde (CNES), que registra os vínculos dos profissionais de saúde com os estabelecimentos cadastrados. Cada registro (linha) representa um vínculo profissional–estabelecimento–ocupação (CBO) em uma competência mensal, descrevendo a ocupação exercida, o vínculo empregatício com o SUS, a carga horária e o conselho de classe. É a maior base do CNES em volume e a principal fonte para dimensionar a força de trabalho em saúde no Brasil.
Ficha técnica¶
Origem e coleta¶
- Arquivos preliminares: Não
- Documentação oficial no FTP:
/dissemin/publicos/CNES/200508_/doc(IT_CNES_1706.pdf) - Tabelas auxiliares no FTP:
/dissemin/publicos/CNES/200508_/Auxiliar(TAB_CNES.zip)
Diretórios e Padrões de Arquivos (meta.py)¶
Diretório FTP (dir) |
Prefixo (filename_prefix) |
Padrão (filename_pattern) |
Extensão | Preliminar |
|---|---|---|---|---|
/dissemin/publicos/CNES/200508_/Dados/PF |
PF |
UF + AA + MM (ex.: SP2401) |
dbc |
Não |
Nomenclatura e Armazenamento Local¶
- No servidor FTP (
ftp.datasus.gov.br): exemplo realPFSP2401.dbc—PF(Profissionais),SP(UF),24(ano),01(mês). Há tambémPFBR<AA><MM>.dbc. - No armazenamento local do
datasus-fetcher:data/cnes-pf/<AAAAMM>/cnes-pf_<AAAAMM>-<uf>@<AAAAMMDD>.dbc, por exemplodata/cnes-pf/202401/[email protected](o sufixo@AAAAMMDDé a data do arquivo no FTP; arquivos preliminares levam-preliminarno nome do dataset). - Documentação e Tabelas Auxiliares associadas:
IT_CNES_1706.pdf(seção "Layout dos arquivos de Profissionais — PF*.dbf") e o pacote de domíniosTAB_CNES.zip(que inclui a tabela de CBO e de conselhos).
Conteúdo¶
O arquivo PF integra o CNES, sistema oficial mantido pelo Ministério da Saúde (Secretaria Executiva/DATASUS) e alimentado continuamente pelos estabelecimentos de saúde por meio do SCNES, sob responsabilidade dos gestores estaduais e municipais (Portarias SAS/MS nº 403/2000 e nº 511/2000; Portaria GM/MS nº 1.646/2015). Ele materializa a dimensão "trabalhadores" do cadastro e é a base para políticas de gestão do trabalho e da educação na saúde, para a vinculação de produção assistencial (SIH/SIA) e para a identificação de profissionais habilitados.
O evento gerador é a declaração mensal dos profissionais vinculados ao estabelecimento na FCES/SCNES. A unidade de análise é o vínculo identificado pela terna CNES + CPF_PROF (ou CNS_PROF) + CBO + VINCULAC, em cada competência. Um mesmo profissional pode ter vários vínculos (em um ou vários estabelecimentos), com diferentes ocupações (CBO) e cargas horárias. O arquivo traz o nome (NOMEPROF), o CBO, o CNS, o conselho de classe (CONSELHO/REGISTRO), os indicadores de vínculo com o SUS (VINCUL_C, VINCUL_A, VINCUL_N) e a carga horária decomposta (hospitalar, ambulatorial e outras).
A nomenclatura histórica reflete sucessivas ampliações: a padronização de CNS e CPF, a introdução de CPF_UNICO/CBO_UNICO (contadores de unicidade) e o campo UFMUNRES (município de residência do profissional). Não há diretório preliminar. O volume é muito alto porque inclui todas as ocupações de nível superior, técnico e médio vinculadas a cada estabelecimento, mês a mês.
Aplicações analíticas típicas: número de médicos, enfermeiros, técnicos e demais profissionais por município/UF, razão profissional por habitante, carga horária média, identificação de profissionais SUS vs. não SUS, planejamento de recursos humanos, estudos de fixação/rotatividade e vinculação de registros de produção (por exemplo, CBO do executante em SIA/SIH).
Cobertura observada¶
- Índice do FTP (2026-10): 6858 arquivos, de 2005-08 a 2026-09, 27 UF(s) com arquivos, última atualização em 2026-10-15.
- Conversão local de amostras (5 arquivo(s) Parquet, de 2005-08 a 2026-02), feita em 2026-11-16 com o
datasus-fetcher0.19.0: serve de base ao esquema de referência. Períodos fora das amostras podem ter colunas que não aparecem aqui.
Variáveis de uso mais frequente (resumo da versão anterior desta página)¶
| Coluna (DBF) | Tipo / Formato | Descrição |
|---|---|---|
CNES |
String (7) | Número nacional do estabelecimento de saúde |
CODUFMUN |
String (6) | Código do município do estabelecimento (UF + MUNIC, sem dígito) |
COMPETEN |
String (AAAAMM) |
Ano e mês de competência da informação |
CPF_PROF |
String (11) | CPF do profissional (ou 99999999999 se não informado) |
CNS_PROF |
String (15) | Cartão Nacional de Saúde do profissional |
NOMEPROF |
String (60) | Nome do profissional |
CBO |
String (6) | Código da ocupação/especialidade (CBO) |
CONSELHO |
String (2) | Código do conselho de classe |
REGISTRO |
String (13) | Número do registro no conselho de classe |
VINCULAC |
String (6) | Vínculo empregatício (código composto) |
VINCUL_C / VINCUL_A / VINCUL_N |
String (1) | Vínculo: contratado SUS / autônomo SUS / não identificado |
PROF_SUS / PROFNSUS |
String (1) | Caracterização do profissional que realiza atendimento SUS / não SUS |
HORA_AMB / HORAHOSP / HORAOUTR |
String (3) | Carga horária ambulatorial / hospitalar / outras |
UFMUNRES |
String (8) | UF + município de residência do profissional |
NAT_JUR |
String (4) | Natureza jurídica do estabelecimento |
Variáveis¶
Descrições tiradas do informe técnico ou do dicionário de dados do DATASUS quando o campo consta do documento; textos marcados "inferido do nome do campo" não têm definição oficial; "Sem descrição na documentação oficial consultada" é lacuna a preencher. Tipo e Período vêm do esquema de referência (conversão local de amostras): Período é o intervalo de partições amostradas em que a coluna existe, e todos significa todas as amostras. Na fonte é o nome do campo no DBF.
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
cnes |
CNES |
texto | Número nacional do estabelecimento de saúde | — | todos |
codufmun |
CODUFMUN |
texto | Código do município do estabelecimento UF+ MUNIC (sem dígito) | — | todos |
regsaude |
REGSAUDE |
texto | Código da região de saúde | — | todos |
micr_reg |
MICR_REG |
texto | Código da micro-região de saúde | — | todos |
distrsan |
DISTRSAN |
texto | Código do distrito sanitário | — | todos |
distradm |
DISTRADM |
texto | Código do distrito administrativo | — | todos |
tpgestao |
TPGESTAO |
texto | Gestão de saúde | — | todos |
pf_pj |
PF_PJ |
texto | Indicador de pessoa: 1-Física 3-Jurídica | — | todos |
cpf_cnpj |
CPF_CNPJ |
texto | CPF do Estabelecimento, caso pessoa física ou CNPJ, caso pessoa jurídica | — | todos |
niv_dep |
NIV_DEP |
texto | Grau de dependência, onde: 1-Individual 3-Mantida | — | todos |
cnpj_man |
CNPJ_MAN |
texto | CNPJ da mantenedora do estabelecimento | — | todos |
esfera_a |
ESFERA_A |
texto | Código da esfera administrativa | — | todos |
atividad |
ATIVIDAD |
texto | Código da atividade de ensino | — | todos |
retencao |
RETENCAO |
texto | Código de retenção de tributos | — | todos |
natureza |
NATUREZA |
texto | Código da natureza da organização | — | todos |
clientel |
CLIENTEL |
texto | Código de fluxo da clientela | — | todos |
tp_unid |
TP_UNID |
texto | Tipo de unidade (estabelecimento) | — | todos |
turno_at |
TURNO_AT |
texto | Código de turno de atendimento | — | todos |
niv_hier |
NIV_HIER |
texto | Código do nível de hierarquia | — | todos |
terceiro |
TERCEIRO |
texto | O estabelecimento é terceiro: 1-Sim 0-Não 2-não | — | todos |
cpf_prof |
CPF_PROF |
texto | CPF do Profissional ou caso “99999999999” caso não seja preenchido. Contador de CPF ÚNICO do Profissional | — | todos |
cbo |
CBO |
texto | deve ser “1”. Código da especialidade do profissional | — | todos |
cbounico |
CBOUNICO |
texto | Sem descrição na documentação oficial consultada; o nome é o do campo no arquivo de origem | — | todos |
nomeprof |
NOMEPROF |
texto | Nome do profissional | — | todos |
cns_prof |
CNS_PROF |
texto | CNS do profissional ou “999999999999999” caso não seja preenchido. | — | todos |
conselho |
CONSELHO |
texto | Código do conselho de classe | — | todos |
registro |
REGISTRO |
texto | Número do registro no conselho de classe | — | todos |
vinculac |
VINCULAC |
texto | Vínculo empregatício com o estabelecimento: | — | todos |
vincul_c |
VINCUL_C |
texto | Vínculo empregatício com o estabelecimento: Contratado SUS | — | todos |
vincul_a |
VINCUL_A |
texto | Vínculo empregatício com o estabelecimento: Autônomo SUS | — | todos |
vincul_n |
VINCUL_N |
texto | Vínculo empregatício com o estabelecimento: Vínculo não identificado (registros de profissionais não SUS e outras situações anômalas) | — | todos |
horaoutr |
HORAOUTR |
inteiro | Carga horária não ambulatorial, nem hospitalar | — | todos |
horahosp |
HORAHOSP |
inteiro | Carga horária HOSPITALAR | — | todos |
hora_amb |
HORA_AMB |
inteiro | Carga horária AMBULATORIAL | — | todos |
competen |
COMPETEN |
texto | Ano e Mês de competência da informação (AAAAMM) | — | todos |
prof_sus |
PROF_SUS |
texto | Caracterização do PROFISSIONAL que realiza ATENDIMENTO SUS | — | todos |
profnsus |
PROFNSUS |
texto | Caracterização do PROFISSIONAL que realiza ATENDIMENTO NÃO SUS | — | todos |
cpfunico |
CPFUNICO |
texto | Sem descrição na documentação oficial consultada; o nome é o do campo no arquivo de origem | — | todos |
ufmunres |
UFMUNRES |
texto | Código da UF + município de residência do profissional (sem dígito) | — | todos |
uf |
— | texto | UF do arquivo de origem (sigla em minúsculas, br para arquivos nacionais), gravada pelo conversor; as linhas do período saem ordenadas por ela |
sigla da UF | todos |
_origem |
— | texto | Chave do arquivo bruto que originou a linha (nome do arquivo no FTP, sem o carimbo de data), gravada pelo conversor | texto | todos |
nat_jur |
NAT_JUR |
texto | Natureza Jurídica de Leitos - Nomenclatura (LT*.dbf) | — | 2016-01 a 2026-02 |
No lake¶
- Dataset no lake:
datasus/cnes-pf, particionado porano,mes(diretórioschave=valor). A UF do arquivo de origem vai na colunauf(as linhas do período saem ordenadas por ela) e o nome do arquivo bruto, na coluna_origem; os arquivos de uma mesma partição compartilham um Parquet. - Chave: sem chave natural declarada. Nenhuma combinação de colunas foi conferida como única nas amostras; para tirar duplicatas, defina a chave por consulta (ver Cuidados de uso).
- Tipos nas amostras (número de colunas): inteiro: 3, texto: 39.
- Transformações do conversor (
datasus-fetcher0.19.0,wrangle_datasuseLakeConverter): nomes de coluna em minúsculas; textos aparados (espaços das pontas saem); valores de preenchimento (texto vazio,NA,null,Nonee códigos como999999e00000000, conforme a listaSENTINEL_NULLSdo pacote) viram nulo; colunas de código (CID, CNES, município, procedimento, CEP, número de AIH e semelhantes) ficam como texto, preservando zeros à esquerda; colunas de data no formatoAAAAMMDDviram data (valores inválidos interrompem a conversão em vez de virarem nulo); valores monetários com casas decimais ficam como decimal exato; registros marcados como excluídos no DBF são descartados; arquivos DBC sem nenhuma linha não passam pela limpeza (ver Cuidados de uso). - Esquema de referência:
cnes-pf.schema.json, gerado por conversão local de amostras. Tipos listados com mais de um valor variam entre partições.
Cuidados de uso¶
- como um profissional pode ter múltiplos vínculos e CBOs, contagens de "profissionais" exigem deduplicação por
CPF_PROF/CNS_PROF; cargas horárias são texto e podem ultrapassar limites plausíveis (validação recomendada); os camposCPF_UNICO/CBO_UNICOajudam a detectar duplicidades; e por ser a maior tabela do CNES (~43,5 GB), o processamento deve ser particionado por UF/competência e convertido a Parquet para análises. (texto da versão anterior desta página; não reconferido nesta revisão.) - Colunas que não existem em todo o período: 1 colunas aparecem só em parte das amostras (a coluna
Períododo dicionário dá o intervalo amostrado); consultas sobre vários períodos devem tolerar colunas ausentes (ex.:pl.scan_parquet(..., missing_columns="insert")oudiagonal_relaxed). Evidência: conversão local de amostras em 2026-11-16,datasus-fetcher0.19.0. - Dado pessoal: as colunas listadas em
dados_pessoaisno cabeçalho são o inventário por nome de coluna; atributos demográficos e territoriais (sexo, raça/cor, idade, município de residência) não entram na lista, mas combinados podem identificar uma pessoa.
Exemplos¶
Consulta sobre o lake (polars)¶
Quantas linhas há por período e por UF do arquivo de origem? (confere a cobertura do lake antes de qualquer análise)
from pathlib import Path
import polars as pl
arquivos = sorted(Path("lake/datasus/cnes-pf").glob("**/*.parquet"))
dados = pl.concat( # períodos diferentes têm colunas e tipos diferentes
[pl.scan_parquet(a, hive_partitioning=True) for a in arquivos],
how="diagonal_relaxed",
)
(
dados.group_by("ano", "mes", "uf")
.agg(pl.len().alias("linhas"))
.sort("ano", "mes", "uf")
.collect()
)
O caminho lake/ é a raiz do lake (a pasta que contém datasus/). A consulta foi executada sobre a conversão local de amostras de 2026-11-16.
Pela linha de comando (datasus-fetcher)¶
# o que o FTP publica para o dataset (arquivos e tamanho)
datasus-fetcher list cnes-pf
# baixa um recorte, com a documentação oficial e as tabelas auxiliares (`--dry-run` só lista)
datasus-fetcher sync cnes-pf -o ./data --start 2024-01 --end 2024-12 --regions sp rj --docs --aux
# converte o que foi baixado para o lake (Parquet particionado)
datasus-fetcher convert -i ./data -o ./lake --dataset cnes-pf
Referências¶
- Servidor FTP do DATASUS:
ftp://ftp.datasus.gov.br/dissemin/publicos/CNES/200508_/Dados/PF - Portal de Transferência de Arquivos do DATASUS: https://datasus.saude.gov.br/transferencia-de-arquivos/
- TabNet DATASUS: https://datasus.saude.gov.br/informacoes-de-saude-tabnet/
- CNES — site oficial e Wiki CNES: https://cnes.datasus.gov.br/ e https://wiki.saude.gov.br/cnes/
- Nota Técnica
IT_CNES_1706.pdf(layout PF) eTAB_CNES.zip(tabela CBO e conselhos) - Portaria GM/MS nº 1.646/2015 (institui o CNES)
- PCDaS/Fiocruz — CNES: https://pcdas.icict.fiocruz.br/conteudo/tecnico/cnes