Procedimentos¶
Resumo¶
A tabela central do SIGTAP: um registro por procedimento, medicamento ou órtese, prótese e material especial vigente na competência, com nome, complexidade, sexo e idade permitidos, limites de execução, valores pagos (hospitalar, ambulatorial e profissional) e financiamento.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | sigtap/tb_procedimento |
| Órgão | Departamento de Informática do Sistema Único de Saúde (DATASUS), Ministério da Saúde |
| Página oficial | http://sigtap.datasus.gov.br/ |
| Licença | Sem licença declarada pela fonte; dados públicos pela Lei 12.527/2011 (LAI) e Decreto 8.777/2016 (política de dados abertos). |
| Periodicidade | mensal (uma tabela por competência; o DATASUS pode regerar uma competência depois de publicada) |
| Cobertura | 2008-01 a em-curso |
| Unidade (uma linha) | um procedimento vigente na competência |
| Granularidade | espacial: nacional (sem recorte geográfico); temporal: competência mensal |
| Formato bruto | ZIP mensal com arquivos TXT de largura fixa, ISO-8859-1, sem separador, um arquivo por tabela; o layout vem em arquivos de texto no próprio ZIP |
| Estado no lake | convertido |
| Partições | ano |
| Chave | competencia, co_procedimento |
| Colunas | 20 |
| Unidades de medida | qt_maxima_execucao: execuções (9999 = não se aplica); qt_dias_permanencia: dias (9999 = não se aplica); qt_pontos: pontos; vl_idade_minima: meses (9999 = não se aplica); vl_idade_maxima: meses (9999 = não se aplica); vl_sh: R$; vl_sa: R$; vl_sp: R$; qt_tempo_permanencia: unidade não informada pela fonte (9999 = não se aplica); versao: AAMMDDHHMM (identificador da publicação, sem unidade) |
| Dados pessoais | nenhum |
| Eras | 2012-09: a tabela ganha a coluna QT_TEMPO_PERMANENCIA; 2025-06: larguras do arquivo mudam: VL_SH 10→12; VL_SA 10→12; VL_SP 10→12 |
| Revisado em | 2026-11-15 |
| Versão do fetcher | 0.4.0 |
Origem e coleta¶
- O fetcher baixa, por FTP, o ZIP de cada competência do SIGTAP em
ftp2.datasus.gov.br, pasta/pub/sistemas/tup/downloads. O nome na fonte éTabelaUnificada_AAAAMM.zipou, quando o DATASUS regera a tabela,TabelaUnificada_AAAAMM_vAAMMDDHHMM.zip; o sufixo é a data e a hora da geração. - No bruto, o arquivo fica em
tabelas/com o carimbo de data da versão baixada ([email protected]). - Este dataset vem do membro
tb_procedimento.txtdo ZIP (dados, uma linha por registro, largura fixa) e do layouttb_procedimento_layout.txt, que dá nome, tamanho e posição de cada coluna. O ZIP traz ainda o layout reunido de todas as tabelas (layout.txt), a planilha 'DATASUS - Tabela de Procedimentos - Lay-out.xls' (dicionário oficial) e oLEIA_ME.TXT(histórico das mudanças da estrutura). O fetcher guarda o ZIP inteiro; o conversor lê só os membrostb_*.txterl_*.txte os layouts. - Conferido em 2026-11-15 pelo tamanho dos membros dos 227 ZIPs publicados (2008-01 a 2026-11, uma competência por mês, sem lacunas),
tb_procedimento.txtexiste e tem conteúdo em todos.
Conteúdo¶
- Unidade de análise: um procedimento vigente na competência.
- Linhas por competência: 4.190 em 2008-01, 5.068 em 2026-11; entre as 227 competências convertidas para esta página, de 4.190 a 5.068. Cada competência traz a tabela inteira, não só o que mudou.
- Cobre procedimentos de todos os nove grupos da classificação, inclusive medicamentos (grupo
06) e órteses, próteses e materiais especiais (grupo07). co_rubricasó vem preenchido nos procedimentos de financiamento04(FAEC): nas 227 competências, nenhuma linha de outro financiamento tem rubrica, e os dois primeiros dígitos da rubrica repetem o financiamento. Em 34 linhas de FAEC (somadas as competências) a rubrica vem nula.- Os valores
vl_sh,vl_saevl_spsão os valores que o SUS paga naquela competência, por componente (hospitalar, ambulatorial, profissional); a fonte não define a soma dos três como valor único. - Mudanças de estrutura (conferidas nos layouts dos ZIPs):
- 2012-09: a tabela ganha a coluna QT_TEMPO_PERMANENCIA.
- 2025-06: larguras do arquivo mudam: VL_SH 10→12; VL_SA 10→12; VL_SP 10→12.
Variáveis¶
As descrições seguem a planilha oficial de layout do ZIP ('DATASUS - Tabela de Procedimentos - Lay-out.xls'), conferidas contra os valores observados em 2026-11. Onde os dados diferem da planilha, isso está dito na coluna 'Unidade / códigos'.
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
co_procedimento |
CO_PROCEDIMENTO |
texto | Código do procedimento, 10 dígitos: os seis primeiros dão grupo (2), subgrupo (2) e forma de organização (2); os quatro últimos identificam o procedimento dentro da forma de organização | — | todo |
no_procedimento |
NO_PROCEDIMENTO |
texto | Nome descritivo do procedimento (até 250 caracteres) | — | todo |
tp_complexidade |
TP_COMPLEXIDADE |
texto | Complexidade do procedimento | 0 não se aplica; 1 atenção básica; 2 média complexidade; 3 alta complexidade |
todo |
tp_sexo |
TP_SEXO |
texto | Sexo a que o procedimento se aplica | M masculino; F feminino; I indiferente (ambos); N não se aplica |
todo |
qt_maxima_execucao |
QT_MAXIMA_EXECUCAO |
inteiro | Número máximo de execuções permitidas do procedimento | 9999 = não se aplica | todo |
qt_dias_permanencia |
QT_DIAS_PERMANENCIA |
inteiro | Número máximo de dias de internação possíveis | 9999 = não se aplica | todo |
qt_pontos |
QT_PONTOS |
inteiro | Quantidade de pontos do procedimento | 0 = sem pontos | todo |
vl_idade_minima |
VL_IDADE_MINIMA |
inteiro | Idade mínima para usar o procedimento, em meses | 9999 = não se aplica | todo |
vl_idade_maxima |
VL_IDADE_MAXIMA |
inteiro | Idade máxima para usar o procedimento, em meses | 9999 = não se aplica; o valor 1571 (130 anos e 11 meses) aparece como teto de idade | todo |
vl_sh |
VL_SH |
decimal | Valor do serviço hospitalar (SH) do procedimento, em reais; a fonte grava centavos sem separador e o conversor divide por 100 | R$ | todo |
vl_sa |
VL_SA |
decimal | Valor do serviço ambulatorial (SA) do procedimento, em reais (mesma escala de vl_sh) |
R$ | todo |
vl_sp |
VL_SP |
decimal | Valor do serviço profissional (SP) do procedimento, em reais (mesma escala de vl_sh) |
R$ | todo |
co_financiamento |
CO_FINANCIAMENTO |
texto | Tipo de financiamento do procedimento; liga com tb_financiamento |
01, 02, 04 a 08 (ver tb_financiamento) |
todo |
co_rubrica |
CO_RUBRICA |
texto | Rubrica do procedimento (financiamento + subtipo); nula quando o procedimento não tem rubrica. Liga com tb_rubrica |
6 dígitos; os dois primeiros repetem co_financiamento |
todo |
qt_tempo_permanencia |
QT_TEMPO_PERMANENCIA |
inteiro | Tempo de permanência do procedimento; a fonte não descreve a coluna (ausente da planilha oficial) | 9999 = não se aplica | desde 2012-09 |
dt_competencia |
DT_COMPETENCIA |
texto | Competência de validade do registro (AAAAMM). Igual à coluna competencia em todas as linhas conferidas |
AAAAMM | todo |
versao |
— (nome do ZIP) | inteiro | Versão da publicação: sufixo _v do nome do ZIP, no formato AAMMDDHHMM (data e hora em que o DATASUS gerou o arquivo); 0 quando o nome do ZIP não traz sufixo (competências de 2008-01 a 2009-04) |
AAMMDDHHMM; 0 = sem sufixo | todo |
competencia |
— (conversor) | texto | Competência (AAAAMM) do ZIP de que a linha veio; igual a ano e mes juntos |
AAAAMM | todo |
mes |
— (conversor) | texto | Mês da competência (MM, texto de 2 dígitos), gravado pelo conversor; com ano (a partição) dá a competência |
01 a 12 | todo |
_origem |
— (conversor) | texto | Chave do ZIP de origem da linha: o nome do ZIP sem a extensão e sem o carimbo @AAAAMMDD (por exemplo TabelaUnificada_202610_v2610271043), gravada pelo conversor |
texto | todo |
No lake¶
- Dataset
sigtap/tb_procedimento, particionado porano(inteiro); um arquivo Parquet por ano,ano=AAAA/<tabela>.parquet, com as linhas de todas as competências do ano. A competência de cada linha está emcompetencia(AAAAMM) e emmes(texto de 2 dígitos,05). - O conversor lê cada linha de largura fixa com o layout do próprio ZIP, aparando espaços nas pontas; campo em branco vira nulo e texto é decodificado de ISO-8859-1 para UTF-8.
- Colunas numéricas viram inteiros ou decimais conforme o layout; valor que não converte vira nulo. Os valores
9999que a fonte usa como 'não se aplica' ficam como estão. - Linhas totalmente em branco são ignoradas. Se um ZIP traz mais de uma versão da mesma competência, só a de maior sufixo
_vé convertida. - As colunas
versao(sufixo_vdo ZIP),competencia(AAAAMM, igual aanoemesjuntos),mese_origemsão acrescentadas pelo conversor. dt_competenciaé a coluna do arquivo, mantida como texto.- Os valores
vl_sh,vl_saevl_spsão lidos como centavos e divididos por 100. - As colunas
vl_idade_minima,vl_idade_maximaeqt_*são inteiros; o conversor os lê como inteiros mesmo quando o layout automático as trataria como decimais.
Cuidados de uso¶
- Cada competência é uma fotografia completa, não um incremento. Sem filtrar
competencia, o mesmo registro aparece uma vez por competência (esta tabela soma 1.035.134 linhas nas 227 competências convertidas, contra 5.068 em 2026-11). Filtre uma competência ou compare competências explicitamente. - A fonte usa 9999 como 'não se aplica' em
qt_maxima_execucao,qt_dias_permanencia,vl_idade_minima,vl_idade_maximaeqt_tempo_permanencia; o conversor preserva o 9999. Em 2026-11, 1.444 procedimentos têmqt_maxima_execucao9999, 3.351 têmqt_dias_permanencia9999 e 5.065 de 5.068 têmqt_tempo_permanencia9999. Trate 9999 como ausência antes de calcular médias ou limites. - Idade em meses. Desde 2007 a fonte grava a idade em meses, não em anos (LEIA_ME do ZIP). Em 2026-11,
vl_idade_maximaé 1571 em 4.092 procedimentos e 9999 em 595; a planilha oficial só prevê valores de 0 a 1331 e 9999. - Valores zerados são comuns. Em 2026-11, 2.569 procedimentos têm
vl_shigual a zero, 2.961 têmvl_sazero, 3.235 têmvl_spzero e 902 têm os três zerados (por exemplo, procedimentos de registro sem pagamento direto). - Valor e nome são da competência. O mesmo código muda de valor e de nome ao longo do tempo; para séries de preço, junte sempre por
competencia. O nome mais antigo pode estar em caixa alta sem acento, o recente em caixa mista. - Sexo.
tp_sexotrazAem uma linha de 2008-01 (procedimento0702050369), valor que a planilha oficial não prevê. Em 2026-11 só háF,I,MeN. - Junte sempre pela mesma competência. Códigos, nomes e valores mudam de uma competência para outra; unir tabelas de competências diferentes dá resultados que nunca existiram no SIGTAP.
Exemplos¶
Valor ambulatorial médio (SA) dos procedimentos de média e alta complexidade com valor, por grupo, na competência mais recente.
import duckdb
duckdb.sql("""
SELECT substr(co_procedimento, 1, 2) AS grupo, count(*) AS procedimentos,
round(avg(vl_sa), 2) AS vl_sa_medio
FROM read_parquet('lake/sigtap/tb_procedimento/**/*.parquet', hive_partitioning = true, union_by_name = true)
WHERE competencia = '202611' AND tp_complexidade IN ('2', '3') AND vl_sa > 0
GROUP BY 1
ORDER BY 1
""").show()
Referências¶
- SIGTAP (Sistema de Gerenciamento da Tabela de Procedimentos, Medicamentos e OPM do SUS): http://sigtap.datasus.gov.br/
- Arquivos de exportação do SIGTAP (FTP do DATASUS): ftp://ftp2.datasus.gov.br/pub/sistemas/tup/downloads/
- Dentro de cada ZIP: a planilha 'DATASUS - Tabela de Procedimentos - Lay-out.xls' e o
LEIA_ME.TXT. - Notas técnicas da CGSI/DATASUS sobre cada competência: ftp://ftp2.datasus.gov.br/pub/sistemas/tup/downloads/notastecnicas/