APAC de Nefrologia (sia-an)¶
Resumo¶
sia-an guarda as APAC de Nefrologia (Terapia Renal Substitutiva) do SIA/SUS entre 2008 e 2014: cada linha é a cobrança mensal de uma APAC de diálise (hemodiálise ou diálise peritoneal), com parâmetros laboratoriais e clínicos do paciente renal crônico.
Ficha técnica¶
Origem e coleta¶
- Arquivos preliminares: Não
- Documentação oficial no FTP:
/dissemin/publicos/SIASUS/200801_/Doc - Tabelas auxiliares no FTP:
/dissemin/publicos/SIASUS/200801_/Auxiliar
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/SIASUS/200801_/Dados |
AN |
UF (2 letras minúsculas/maiúsculas, inclui br) + AA (ano, 2 dígitos) + MM (mês, 01–12) |
dbc |
Não |
Nomenclatura e Armazenamento Local¶
- No servidor FTP (
ftp.datasus.gov.br):ANSP1401.dbc—AN(APAC de Nefrologia) +SP(UF) +14(ano 2014) +01(mês). Último período publicado:1410. - No armazenamento local do
datasus-fetcher:data/sia-an/<AAAAMM>/sia-an_<AAAAMM>-<uf>@<AAAAMMDD>.dbc, por exemplodata/sia-an/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:
Doc/Informe_Tecnico_SIASUS_2019_07.pdf(~1,1 MB, julho/2019) descreve o leiaute dos arquivos do SIA;Auxiliar/TAB_SIA.zip(~73,8 MB, tabelas SIGTAP e conversores) e as versões históricasTAB_SIA_199407-199910.zip,TAB_SIA_199911-200307.zipeTAB_SIA_200308-200712.zipcobrem as fases anteriores à Tabela Unificada.
Conteúdo¶
O Sistema de Informações Ambulatoriais do SUS (SIA/SUS) é gerido pelo Ministério da Saúde — Secretaria de Atenção Especializada à Saúde (SAES) —, com processamento e disseminação a cargo do DATASUS. Sua finalidade é registrar, validar e remunerar a produção ambulatorial financiada pelo SUS (consultas, exames, terapias, procedimentos de média e alta complexidade, medicamentos do componente especializado e ações de reabilitação), permitindo ao gestor acompanhar a oferta, a cobertura e o gasto ambulatorial por estabelecimento, município e procedimento.
O evento gerador é o tratamento dialítico de pacientes com doença renal crônica, autorizado por APAC de nefrologia. A unidade de análise é a APAC por competência. A Autorização de Procedimentos de Alta Complexidade/Custo (APAC) é o instrumento de autorização e cobrança de procedimentos ambulatoriais de alta complexidade ou de uso continuado: o tratamento é autorizado por um gestor com validade de até três competências, e cada mês de cobrança gera uma linha no arquivo. A chave do registro é o número da APAC (AP_AUTORIZ, 13 dígitos) combinado com a competência (AP_CMP/AP_MVM); a APAC subsequente de um mesmo tratamento referencia a anterior em AP_APACANT. Os campos AN_* registram peso, altura, diurese residual, glicemia, hematócrito/hemoglobina (AN_HB), albumina, taxa de redução de ureia (AN_TRU), sorologias (HIV, HBsAg, HCV) e acesso vascular (AN_ACEVAS).
É um dataset descontinuado: o FTP traz arquivos de 2008-01 a 2014-10 (27 UFs, ~0,46 GB, última atualização em 2019). Em 2014 a assistência à doença renal crônica foi reorganizada e a APAC de nefrologia foi substituída pelas APAC de Tratamento Dialítico (sia-atd, desde 2014-08) e de Confecção de Fístula (sia-acf), havendo sobreposição de competências entre 2014-08 e 2014-10 no FTP — para séries longas, combine sia-an e sia-atd e evite duplicidade nessa janela.
Aplicações: prevalência de pacientes em terapia renal substitutiva por UF; qualidade da diálise (TRU, albumina, hemoglobina); proporção de acesso vascular definitivo vs. cateter; sorologias em serviços de diálise; evolução histórica do gasto com TRS; série longa de 2008–2014 antes do sia-atd.
Cobertura observada¶
- Índice do FTP (2026-10): 2145 arquivos, de 2008-01 a 2014-10, 27 UF(s) com arquivos, última atualização em 2019-06-07.
- Conversão local de amostras (5 arquivo(s) Parquet, de 2008-02 a 2014-08), 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.
Eras¶
- 2014-08: a APAC de nefrologia é substituída pela de tratamento dialítico (
sia-atd);sia-antermina em 2014-10
Variáveis de uso mais frequente (resumo da versão anterior desta página)¶
61 colunas no arquivo de 2014-01 (ANAC1401.dbc).
| Coluna (DBF) | Tipo / Formato | Descrição |
|---|---|---|
AP_MVM / AP_CMP |
String (AAAAMM) | Mês de movimentação (processamento) e mês de competência da APAC. |
AP_AUTORIZ |
String (13) | Número da APAC (chave do tratamento); AP_APACANT aponta a APAC anterior do mesmo paciente/tratamento. |
AP_CODUNI |
String (7) | Código CNES do estabelecimento executor. |
AP_GESTAO / AP_UFMUN |
String (6) | Código do gestor e município do estabelecimento (IBGE 6 dígitos). |
AP_PRIPAL |
String (10) | Procedimento principal SIGTAP da APAC. |
AP_VL_AP |
Float | Valor (R$) aprovado da APAC na competência. |
AP_CNSPCN |
String (cifrado) | CNS do paciente — gravado de forma codificada pelo DATASUS no DBF; usar apenas como chave de pareamento, não como CNS legível. |
AP_SEXO / AP_COIDADE / AP_NUIDADE |
String | Sexo (M/F); unidade da idade (4 = anos) e idade. |
AP_RACACOR / AP_ETNIA |
String | Raça/cor (01–05, 99) e etnia indígena. |
AP_MUNPCN / AP_CEPPCN |
String (6 / 8) | Município de residência e CEP do paciente. |
AP_DTINIC / AP_DTFIM |
String AAAAMMDD | Início e fim da validade da APAC no período. |
AP_DTSOLIC / AP_DTAUT |
String AAAAMMDD | Datas de solicitação e de autorização. |
AP_CIDPRI / AP_CIDSEC / AP_CIDCAS |
String (CID-10) | Diagnóstico principal, secundário e causas associadas (0000 = não informado). |
AP_MOTSAI / AP_OBITO / AP_ALTA / AP_TRANSF / AP_PERMAN / AP_ENCERR |
String | Motivo de saída/cobrança e indicadores de óbito, alta, transferência, permanência e encerramento (flags 0/1). |
AP_TPATEN / AP_TPAPAC |
String | Tipo de atendimento e tipo da APAC (1 inicial, 2 continuidade, 3 única). |
AP_NATJUR / AP_TPUPS / AP_TIPPRE |
String | Natureza jurídica, tipo de unidade e tipo de prestador do estabelecimento. |
AN_DTPDR |
String AAAAMMDD | Data de início da terapia dialítica (primeira diálise). |
AN_ALTURA / AN_PESO |
String | Altura (cm) e peso (kg) do paciente. |
AN_DIURES / AN_GLICOS |
String | Diurese residual (mL/dia) e glicemia. |
AN_HB / AN_ALBUMI / AN_TRU |
String | Hemoglobina, albumina e taxa de redução da ureia. |
AN_HCV / AN_HBSAG / AN_HIV |
String (S/N) |
Resultados de sorologias (hepatite C, hepatite B, HIV). |
AN_ACEVAS / AN_ULSOAB / AN_CNCDO / AN_INTFIS |
String | Acesso vascular e indicadores clínicos/funcionais registrados na APAC (ver Informe Técnico). |
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 |
|---|---|---|---|---|---|
ap_mvm |
AP_MVM |
texto | Data de Processamento / Movimento (AAAAMM) | — | todos |
ap_condic |
AP_CONDIC |
texto | Sigla do Tipo de Gestão no qual o Estado ou Município está habilitado | — | todos |
ap_gestao |
AP_GESTAO |
texto | Código da Unidade de Federação + Código do Município de Gestão, ou UF0000 se o estabelecimento está sob Gestão Estadual | — | todos |
ap_coduni |
AP_CODUNI |
texto | Código do Estabelecimento no CNES (Cadastro Nacional de Estabelecimentos de Saúde) | — | todos |
ap_autoriz |
AP_AUTORIZ |
texto | Número da APAC. Lei de formação: UFAATsssssssd, onde: UF – Unid. da Federação, AA – ano, T – tipo, sssssss – sequencial, d – dígito | — | todos |
ap_cmp |
AP_CMP |
texto | Data de Atendimento ao paciente / Competência (AAAAMM) | — | todos |
ap_pripal |
AP_PRIPAL |
texto | Procedimento Principal da APAC | — | todos |
ap_vl_ap |
AP_VL_AP |
decimal(20,2) | Valor Total da APAC Aprovado | — | todos |
ap_ufmun |
AP_UFMUN |
texto | Código da Unidade da Federação + Código do Município do Estabelecimento | — | todos |
ap_tpups |
AP_TPUPS |
texto | Tipo de Estabelecimento | — | todos |
ap_tippre |
AP_TIPPRE |
texto | Tipo de Prestador | — | todos |
ap_mn_ind |
AP_MN_IND |
texto | Estabelecimento Mantido / Individual | — | todos |
ap_cnpjcpf |
AP_CNPJCPF |
texto | CNPJ do Estabelecimento executante | — | todos |
ap_cnpjmnt |
AP_CNPJMNT |
texto | CNPJ da Mantenedora do estabelecimento ou zeros, caso não a tenha | — | todos |
ap_cnspcn |
AP_CNSPCN |
texto | Número do CNS (Cartão Nacional de Saúde) do paciente | — | todos |
ap_coidade |
AP_COIDADE |
texto | Código da Idade do paciente | — | todos |
ap_nuidade |
AP_NUIDADE |
texto | Número da Idade | — | todos |
ap_sexo |
AP_SEXO |
texto | Sexo do paciente | — | todos |
ap_racacor |
AP_RACACOR |
texto | Raça/Cor do paciente: 01 - Branca, 02 - Preta, 03 - Parda, 04 - Amarela, 05 - Indígena, 99 - Sem informação | — | todos |
ap_munpcn |
AP_MUNPCN |
texto | Código da Unidade de Federação + Código Município de Residência do paciente | — | todos |
ap_ufnacio |
AP_UFNACIO |
texto | Código da Nacionalidade do paciente | — | todos |
ap_ceppcn |
AP_CEPPCN |
texto | CEP do endereço do paciente | — | todos |
ap_ufdif |
AP_UFDIF |
texto | Indica se a UF de residência do paciente é diferente da UF de localização do estabelecimento: 0 = mesma UF; 1 = UF diferente | — | todos |
ap_mndif |
AP_MNDIF |
texto | Indica se o município de residência do paciente é diferente do município de localização do estabelecimento: 0 = mesmo município; 1 = município diferente | — | todos |
ap_dtinic |
AP_DTINIC |
texto | Data de INÍCIO validade (AAAAMMDD) | — | todos |
ap_dtfim |
AP_DTFIM |
texto | Data de FIM validade (AAAAMMDD) | — | todos |
ap_tpaten |
AP_TPATEN |
texto | Tipo de Atendimento de APAC | — | todos |
ap_tpapac |
AP_TPAPAC |
texto | Indica se a APAC é 1 - inicial, 2 - continuidade, 3 - única | — | todos |
ap_motsai |
AP_MOTSAI |
texto | Motivo de Saída e Permanência | — | todos |
ap_obito |
AP_OBITO |
texto | Indicador de Óbito | — | todos |
ap_encerr |
AP_ENCERR |
texto | Indicador de Encerramento | — | todos |
ap_perman |
AP_PERMAN |
texto | Indicador de Permanência | — | todos |
ap_alta |
AP_ALTA |
texto | Indicador de Alta | — | todos |
ap_transf |
AP_TRANSF |
texto | Indicador de Transferência | — | todos |
ap_dtocor |
AP_DTOCOR |
texto | Data de Ocorrência que substitui a data de FIM de validade | — | todos |
ap_codemi |
AP_CODEMI |
texto | Código do Órgão emissor | — | todos |
ap_catend |
AP_CATEND |
texto | Caráter do Atendimento | — | todos |
ap_apacant |
AP_APACANT |
texto | Número APAC Anterior | — | todos |
ap_unisol |
AP_UNISOL |
texto | Código do Estabelecimento solicitante no CNES (Cadastro Nacional de Estabelecimentos de Saúde) | — | todos |
ap_dtsolic |
AP_DTSOLIC |
texto | Data da Solicitação (AAAAMMDD) | — | todos |
ap_dtaut |
AP_DTAUT |
texto | Data da Autorização (AAAAMMDD) | — | todos |
ap_cidcas |
AP_CIDCAS |
texto | CID Causas Associadas | — | todos |
ap_cidpri |
AP_CIDPRI |
texto | CID Principal | — | todos |
ap_cidsec |
AP_CIDSEC |
texto | CID Secundário | — | todos |
ap_etnia |
AP_ETNIA |
texto | Etnia do paciente | — | todos |
an_dtpdr |
AN_DTPDR |
texto | Data (AAAAMMDD) da PRIMEIRA diálise realizada | — | todos |
an_altura |
AN_ALTURA |
texto | Altura do paciente em cm | — | todos |
an_peso |
AN_PESO |
texto | Peso do paciente em kg | — | todos |
an_diures |
AN_DIURES |
texto | Diurese em ml | — | todos |
an_glicos |
AN_GLICOS |
texto | Glicose em Mg/dl | — | todos |
an_acevas |
AN_ACEVAS |
texto | Acesso Vascular (S = Sim; N = Não) | — | todos |
an_ulsoab |
AN_ULSOAB |
texto | Ultrassonografia Abdominal (S = Sim; N = Não) | — | todos |
an_tru |
AN_TRU |
texto | TRU (taxa de redução de ureia) | — | todos |
an_intfis |
AN_INTFIS |
texto | Quantidade de intervenção de Fístula | — | todos |
an_cncdo |
AN_CNCDO |
texto | Inscrito na lista da CNCDO (S = Sim; N = Não) | — | todos |
an_albumi |
AN_ALBUMI |
texto | Albumina em g% | — | todos |
an_hcv |
AN_HCV |
texto | Indicativo de presença de Anticorpos de HCV (P = Positivo; N = Negativo) | — | todos |
an_hbsag |
AN_HBSAG |
texto | Indicativo de HBsAg (P = Positivo; N = Negativo) | — | todos |
an_hiv |
AN_HIV |
texto | Indicativo de presença de anticorpos de HIV (P = Positivo; N = Negativo) | — | todos |
an_hb |
AN_HB |
texto | Hemoglobina (HB) em g% | — | 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 |
No lake¶
- Dataset no lake:
datasus/sia-an, 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): decimal(20,2): 1, texto: 61.
- 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:
sia-an.schema.json, gerado por conversão local de amostras. Tipos listados com mais de um valor variam entre partições.
Cuidados de uso¶
- (i) série encerrada em 2014-10: não espere novos arquivos; (ii) para continuidade temporal, concatene com
sia-atdremovendo a sobreposição de 2014-08 a 2014-10 (useAP_AUTORIZ+ competência); (iii) as sorologias e exames estão emString— converta valores numéricos comcast(strict=False)e trate zeros/espaços como "não realizado"; (iv) o dataset tem arquivos nos 27 UFs, mas o volume pequeno (≈ 2.145 arquivos) permite leitura integral. (texto da versão anterior desta página; não reconferido nesta revisão.) - 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/sia-an").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 sia-an
# baixa um recorte, com a documentação oficial e as tabelas auxiliares (`--dry-run` só lista)
datasus-fetcher sync sia-an -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 sia-an
Referências¶
- Servidor FTP do DATASUS:
ftp://ftp.datasus.gov.br/dissemin/publicos/SIASUS/200801_/ - 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/
- Informe Técnico SIASUS (jul/2019):
ftp://ftp.datasus.gov.br/dissemin/publicos/SIASUS/200801_/Doc/Informe_Tecnico_SIASUS_2019_07.pdf - SIGTAP — Tabela de Procedimentos, Medicamentos e OPM do SUS: http://sigtap.datasus.gov.br/
- Manual Técnico Operacional do SIA/SUS (SAES/MS) — disponíveis na Biblioteca Virtual em Saúde do Ministério da Saúde: https://bvsms.saude.gov.br/
- PCDaS/Fiocruz (Plataforma de Ciência de Dados aplicada à Saúde), que disponibiliza o SIA/SUS para pesquisa: https://pcdas.icict.fiocruz.br/