Pular para conteúdo

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 exemplo data/sia-an/202401/[email protected] (o sufixo @AAAAMMDD é a data do arquivo no FTP; arquivos preliminares levam -preliminar no 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óricas TAB_SIA_199407-199910.zip, TAB_SIA_199911-200307.zip e TAB_SIA_200308-200712.zip cobrem 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-fetcher 0.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-an termina 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 por ano, mes (diretórios chave=valor). A UF do arquivo de origem vai na coluna uf (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-fetcher 0.19.0, wrangle_datasus e LakeConverter): nomes de coluna em minúsculas; textos aparados (espaços das pontas saem); valores de preenchimento (texto vazio, NA, null, None e códigos como 999999 e 00000000, conforme a lista SENTINEL_NULLS do 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 formato AAAAMMDD viram 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-atd removendo a sobreposição de 2014-08 a 2014-10 (use AP_AUTORIZ + competência); (iii) as sorologias e exames estão em String — converta valores numéricos com cast(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_pessoais no 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/