APAC de Tratamento Dialítico (sia-atd)¶
Resumo¶
sia-atd contém as APAC de Tratamento Dialítico do SIA/SUS: cada linha é a cobrança mensal de uma APAC de terapia renal substitutiva (hemodiálise e diálise peritoneal), com indicadores laboratoriais e de qualidade da diálise. Substitui, a partir de 2014-08, a antiga APAC de Nefrologia (sia-an).
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 |
ATD |
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):ATDSP2401.dbc—ATD(APAC de Tratamento Dialítico) +SP(UF) +24+01. Prefixo de 3 letras. - No armazenamento local do
datasus-fetcher:data/sia-atd/<AAAAMM>/sia-atd_<AAAAMM>-<uf>@<AAAAMMDD>.dbc, por exemplodata/sia-atd/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 específica criada na reorganização de 2014. 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 ATD_* registram hemoglobina, fósforo, Kt/V semanal (ATD_KTVSEM), taxa de redução da ureia (ATD_TRU), albumina, paratormônio (ATD_PTH), sorologias (HIV, HCV, HBsAg), acesso vascular (ATD_ACEVAS) e intercorrências (ATD_INTERC, ATD_SEPERI).
No FTP cobre 2014-08 a 2026-07 (27 UFs, ~1,05 GB). Em 2014 foi reorganizada a Linha de Cuidado da Doença Renal Crônica, com criação de APAC específicas (diálise e fístula) em substituição à APAC de nefrologia (sia-an, até 2014-10). A base continua ativa e é a principal fonte administrativa da terapia renal substitutiva no SUS.
Aplicações: prevalência de pacientes em diálise por UF/serviço; indicadores de qualidade (Kt/V, TRU, hemoglobina, fósforo, PTH, albumina) conforme metas regulatórias; proporção de acesso vascular definitivo; cobertura de sorologias; gasto com TRS; e série histórica concatenando sia-an (2008–2014) e sia-atd (2014 em diante).
Cobertura observada¶
- Índice do FTP (2026-10): 3911 arquivos, de 2014-08 a 2026-08, 27 UF(s) com arquivos, última atualização em 2026-10-30.
- Conversão local de amostras (5 arquivo(s) Parquet, de 2014-11 a 2026-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: início da APAC de tratamento dialítico, que substitui
sia-an
Variáveis de uso mais frequente (resumo da versão anterior desta página)¶
66 colunas no arquivo de 2024-01 (ATDAC2401.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. |
ATD_CARACT |
String | Caráter do atendimento/tratamento dialítico. |
ATD_DTPDR / ATD_DTCLI |
String AAAAMMDD | Datas de referência do tratamento (início da terapia e de ingresso na clínica; ver Informe Técnico). |
ATD_ACEVAS |
String | Acesso vascular utilizado. |
ATD_HB / ATD_FOSFOR / ATD_PTH / ATD_ALBUMI |
String | Hemoglobina, fósforo, paratormônio e albumina. |
ATD_KTVSEM / ATD_TRU |
String | Kt/V semanal e taxa de redução da ureia. |
ATD_HIV / ATD_HCV / ATD_HBSAG |
String (S/N) |
Sorologias. |
ATD_SITTRA / ATD_INTERC / ATD_SEPERI |
String | Situação de transplante e intercorrências/separação do tratamento (domínios do 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 |
atd_caract |
ATD_CARACT |
texto | Característica do tratamento | — | todos |
atd_dtpdr |
ATD_DTPDR |
texto | Data (AAAAMMDD) do início da primeira dialise | — | todos |
atd_dtcli |
ATD_DTCLI |
texto | Data (AAAAMMDD) do início da dialise nesta clinica | — | todos |
atd_acevas |
ATD_ACEVAS |
texto | Acesso Vascular | — | todos |
atd_maisne |
ATD_MAISNE |
texto | Acompanhado há mais de um ano com nefrologia (S - Sim, N - Não, I - Ignorado) | — | todos |
atd_sitini |
ATD_SITINI |
texto | Situação Inicial | — | todos |
atd_sittra |
ATD_SITTRA |
texto | Situação de transplante (1 - Apto, 2 - Inapto, 3 - Recusa, 4 - N/A caso novo, com menos de 90 dias de tratamento) | — | todos |
atd_seapto |
ATD_SEAPTO |
texto | Se Apto a transplante (1 - Inscrito na CNCDO, 2 - Em processo de avaliação transplantante no centro transplantador, 3 - Sem encaminhamento, 4 - Aguardando agendamento de consulta no centro transplantador) | — | todos |
atd_hb |
ATD_HB |
texto | HB (hemoglobina) | — | todos |
atd_fosfor |
ATD_FOSFOR |
texto | Fósforo | — | todos |
atd_ktvsem |
ATD_KTVSEM |
texto | Kt/v Semanal | — | todos |
atd_tru |
ATD_TRU |
texto | TRU (taxa de redução de ureia) | — | todos |
atd_albumi |
ATD_ALBUMI |
texto | Albumina | — | todos |
atd_pth |
ATD_PTH |
texto | PTH (hormônio da paratireoide) | — | todos |
atd_hiv |
ATD_HIV |
texto | Indicativo de presença de anticorpos de HIV (P - Positivo; N - Negativo) | — | todos |
atd_hcv |
ATD_HCV |
texto | Indicativo de presença de anticorpos de HCV (P - Positivo; N - Negativo) | — | todos |
atd_hbsag |
ATD_HBSAG |
texto | Indicativo de HBsAg (P - Positivo; N - Negativo) | — | todos |
atd_interc |
ATD_INTERC |
texto | Usuário internado, com data de início no mês vigente, para tratamento de intercorrência clínica? (S – Sim, N - Não, I - Ignorado) | — | todos |
atd_seperi |
ATD_SEPERI |
texto | Se em Diálise Peritoneal, houve peritonite diagnosticada no mês vigente? (S - Sim, N - Não, I - Ignorado) | — | 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 |
ap_natjur |
AP_NATJUR |
texto | Código da Natureza Jurídica | — | 2018-02 a 2026-08 |
No lake¶
- Dataset no lake:
datasus/sia-atd, 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: 66.
- 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-atd.schema.json, gerado por conversão local de amostras. Tipos listados com mais de um valor variam entre partições.
Cuidados de uso¶
- (i) para séries anteriores a 2014-08 use
sia-an; na janela 2014-08 a 2014-10 ambos coexistem; (ii) valores laboratoriais0ou vazio significam "não informado" e devem ser tratados comonullantes de calcular médias; (iii) a descrição dos camposATD_*baseia-se nos nomes e no Informe Técnico — valide os domínios; (iv)AP_TPAPACdistingue APAC inicial de continuidade. (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/sia-atd").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-atd
# baixa um recorte, com a documentação oficial e as tabelas auxiliares (`--dry-run` só lista)
datasus-fetcher sync sia-atd -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-atd
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/