Pular para conteúdo

APAC de Radioterapia (sia-ar)

Resumo

sia-ar reúne as APAC de Radioterapia do SIA/SUS: cada linha é a cobrança mensal de uma APAC oncológica de radioterapia, com campos de estadiamento, finalidade do tratamento, CIDs tratados, datas de início e término e número de campos irradiados.

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 AR 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): ARSP2401.dbc — AR (APAC de Radioterapia) + SP (UF) + 24 + 01.
  • No armazenamento local do datasus-fetcher: data/sia-ar/<AAAAMM>/sia-ar_<AAAAMM>-<uf>@<AAAAMMDD>.dbc, por exemplo data/sia-ar/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 radioterápico do câncer autorizado por APAC (serviços de radioterapia habilitados em CACON/UNACON). 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 AR_* incluem AR_FINALI (finalidade do tratamento), AR_CIDTR1…3 (CIDs tratados), AR_INIAR1…3/AR_FIMAR1…3 (datas de início e fim de cada série) e AR_NUMC1…3 (número de campos).

No FTP cobre 2008-01 a 2026-07, mas com apenas 26 UFs com arquivos (≈ 0,36 GB). A radioterapia depende de equipamentos e serviços habilitados, concentrados nas capitais e polos; a expansão do Plano de Expansão da Radioterapia no SUS (a partir de 2012) aumentou o número de serviços. O marco legal de oportunidade é o mesmo da quimioterapia (Lei nº 12.732/2012).

Aplicações: oferta e demanda de radioterapia por região; tempo de espera entre diagnóstico e início da radioterapia (AR_DTIDEN → AR_INIAR1); finalidade (curativa, paliativa); distribuição por CID; necessidade de aceleradores por 1.000 casos novos; e estudos de acesso/ deslocamento (AP_MUNPCN vs. município do serviço).

Cobertura observada

  • Índice do FTP (2026-10): 5491 arquivos, de 2008-01 a 2026-08, 26 UF(s) com arquivos, última atualização em 2026-10-30.
  • Conversão local de amostras (5 arquivo(s) Parquet, de 2008-03 a 2026-02), 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.

Variáveis de uso mais frequente (resumo da versão anterior desta página)

75 colunas no arquivo de 2024-01 (ARAC2401.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.
AR_ESTADI / AR_GRAHIS String Estadiamento e grau histológico do tumor.
AR_DTIDEN String AAAAMMDD Data de identificação patológica do câncer.
AR_FINALI String Finalidade da radioterapia (códigos de domínio: curativa, paliativa, etc.).
AR_CIDTR1…3 String (CID-10) CIDs tratados com radioterapia.
AR_INIAR1…3 / AR_FIMAR1…3 String AAAAMMDD Datas de início e fim de cada série de radioterapia.
AR_NUMC1…3 String/Inteiro Número de campos irradiados em cada série.
AR_CONTTR / AR_DTINTR String / AAAAMMDD Continuidade e data de início do tratamento.

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
ar_smrd AR_SMRD texto Sem descrição na documentação oficial consultada; o nome é o do campo no arquivo de origem — todos
ar_cid10 AR_CID10 texto CID-10 - Topografia — todos
ar_linfin AR_LINFIN texto Linfonodos regionais invadidos (S = Sim; N =Não; 3= Não Avaliáveis) — todos
ar_estadi AR_ESTADI texto Estádio - UICC (0; 1; 2; 3; 4) — todos
ar_grahis AR_GRAHIS texto Grau Histopatológico — todos
ar_dtiden AR_DTIDEN texto Data da identificação patológica do caso (AAAAMMDD) — todos
ar_trante AR_TRANTE texto Tratamentos anteriores (S = Sim; N = Não) — todos
ar_cidini1 AR_CIDINI1 texto CID 1º Tratamento anterior — todos
ar_dtini1 AR_DTINI1 texto Data de INÍCIO (AAAAMMDD) 1º tratamento anterior — todos
ar_cidini2 AR_CIDINI2 texto CID 2º Tratamento anterior — todos
ar_dtini2 AR_DTINI2 texto Data de INÍCIO (AAAAMMDD) 2º tratamento anterior — todos
ar_cidini3 AR_CIDINI3 texto CID 3º Tratamento anterior — todos
ar_dtini3 AR_DTINI3 texto Data de início (AAAAMMDD) 3º tratamento anterior — todos
ar_conttr AR_CONTTR texto Continuidade do tratamento (S = Sim; N = Não) — todos
ar_dtintr AR_DTINTR texto Data de INÍCIO do tratamento solicitado (AAAAMMDD) — todos
ar_finali AR_FINALI texto Finalidade do Tratamento: (1 = RADICAL; 2 = ADJUVANTE; 3 = ANTIÁLGICA; 4 = PALIATIVA; 5 = PRÉVIA; 6 = ANTIHEMORRÁGICA) — todos
ar_cidtr1 AR_CIDTR1 texto CID Topográfico 1º — todos
ar_cidtr2 AR_CIDTR2 texto CID Topográfico 2º — todos
ar_cidtr3 AR_CIDTR3 texto CID Topográfico 3º — todos
ar_numc1 AR_NUMC1 texto Nº Campo/Inserções 1º — todos
ar_iniar1 AR_INIAR1 texto Data de INÍCIO 1º (AAAAMMDD) — todos
ar_iniar2 AR_INIAR2 texto Data de INÍCIO 2º (AAAAMMDD) — todos
ar_iniar3 AR_INIAR3 texto Data de INÍCIO 3º (AAAAMMDD) — todos
ar_fimar1 AR_FIMAR1 texto Data de Fim 1º (AAAAMMDD) — todos
ar_fimar2 AR_FIMAR2 texto Data de FIM 2º (AAAAMMDD) — todos
ar_fimar3 AR_FIMAR3 texto Data de Fim 3º (AAAAMMDD) — todos
ar_numc2 AR_NUMC2 texto Nº Campo/Inserções 2º — todos
ar_numc3 AR_NUMC3 texto Nº Campo/Inserções 3º — 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 — 2017-08 a 2026-02

No lake

  • Dataset no lake: datasus/sia-ar, 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: 75.
  • 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-ar.schema.json, gerado por conversão local de amostras. Tipos listados com mais de um valor variam entre partições.

Cuidados de uso

  • (i) as séries 1–3 (AR_*1, AR_*2, AR_*3) são colunas wide: transforme com pl.unpivot quando precisar de formato longo; (ii) campos vazios devem virar null; (iii) apenas 26 UFs têm arquivos — a ausência de uma UF provavelmente reflete a inexistência de serviço com APAC de radioterapia no período (confirme em datasus list sia-ar), não necessariamente falha de coleta; (iv) o paciente pode aparecer em várias competências: use AP_AUTORIZ/AP_CNSPCN para contar tratamentos. (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íodo do dicionário dá o intervalo amostrado); consultas sobre vários períodos devem tolerar colunas ausentes (ex.: pl.scan_parquet(..., missing_columns="insert") ou diagonal_relaxed). Evidência: conversão local de amostras em 2026-11-16, datasus-fetcher 0.19.0.
  • 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-ar").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-ar

# baixa um recorte, com a documentação oficial e as tabelas auxiliares (`--dry-run` só lista)
datasus-fetcher sync sia-ar -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-ar

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/