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 exemplodata/sia-ar/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 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-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)¶
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 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: 75.
- 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-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 compl.unpivotquando precisar de formato longo; (ii) campos vazios devem virarnull; (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 emdatasus list sia-ar), não necessariamente falha de coleta; (iv) o paciente pode aparecer em várias competências: useAP_AUTORIZ/AP_CNSPCNpara 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í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-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/