Pular para conteúdo

Procedimento × procedimento compatível

Resumo

Pares de procedimentos que podem ou não ser registrados juntos (compatibilidade, incompatibilidade, concomitância), com a quantidade permitida.

Ficha técnica

Campo Valor
Dataset sigtap/rl_procedimento_compativel
Ó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) uma relação de compatibilidade entre um procedimento principal e um procedimento compatível, cada um com o seu instrumento de registro
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_principal, co_registro_principal, co_procedimento_compativel, co_registro_compativel, tp_compatibilidade
Colunas 11
Unidades de medida qt_permitida: quantidade; versao: AAMMDDHHMM (identificador da publicação, sem unidade)
Dados pessoais nenhum
Eras nenhuma
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.zip ou, 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 rl_procedimento_compativel.txt do ZIP (dados, uma linha por registro, largura fixa) e do layout rl_procedimento_compativel_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 o LEIA_ME.TXT (histórico das mudanças da estrutura). O fetcher guarda o ZIP inteiro; o conversor lê só os membros tb_*.txt e rl_*.txt e 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), rl_procedimento_compativel.txt existe e tem conteúdo em todos.

Conteúdo

  • Unidade de análise: uma relação de compatibilidade entre um procedimento principal e um procedimento compatível, cada um com o seu instrumento de registro.
  • Linhas por competência: 8.125 em 2008-01, 12.765 em 2026-11; entre as 227 competências convertidas para esta página, de 6.195 a 12.765. Cada competência traz a tabela inteira, não só o que mudou.
  • Em 2026-11 são 12.765 relações entre 1.306 procedimentos principais e 1.561 compatíveis: 8.157 do tipo 1, 1.628 do 2, 2.435 do 3, 425 do 4 e 120 do 5.
  • Na primeira competência (2008-01) eram 8.125 relações; o menor total é 6.195.

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_principal CO_PROCEDIMENTO_PRINCIPAL texto Código do procedimento base da compatibilidade — todo
co_registro_principal CO_REGISTRO_PRINCIPAL texto Instrumento de registro do procedimento principal; liga com tb_registro — todo
co_procedimento_compativel CO_PROCEDIMENTO_COMPATIVEL texto Código do procedimento relacionado ao principal — todo
co_registro_compativel CO_REGISTRO_COMPATIVEL texto Instrumento de registro do procedimento compatível; liga com tb_registro — todo
tp_compatibilidade TP_COMPATIBILIDADE texto Tipo da relação entre os procedimentos 1 compatível; 2 incompatível/excludente; 3 concomitante; 4 e 5 aparecem nos dados e não constam da planilha oficial todo
qt_permitida QT_PERMITIDA inteiro Quantidade máxima permitida do procedimento compatível quantidade todo
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/rl_procedimento_compativel, particionado por ano (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á em competencia (AAAAMM) e em mes (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 9999 que 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 _v do ZIP), competencia (AAAAMM, igual a ano e mes juntos), mes e _origem são acrescentadas pelo conversor.
  • dt_competencia é a coluna do arquivo, mantida como texto.

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 2.203.035 linhas nas 227 competências convertidas, contra 12.765 em 2026-11). Filtre uma competência ou compare competências explicitamente.
  • A chave só é única com tp_compatibilidade: o mesmo par pode aparecer com mais de um tipo (117 pares repetidos sem o tipo, em 2025-01, 2025-02, 2025-08, 2025-09 e 2026-08 a 2026-11).
  • Os tipos 4 e 5 não têm significado na planilha oficial (que só prevê 1, 2 e 3); use-os com cautela.
  • 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

Procedimentos com mais procedimentos compatíveis (tipo 1) na competência mais recente.

import duckdb

duckdb.sql("""
    SELECT co_procedimento_principal, count(*) AS compativeis
    FROM read_parquet('lake/sigtap/rl_procedimento_compativel/**/*.parquet', hive_partitioning = true, union_by_name = true)
    WHERE competencia = '202611' AND tp_compatibilidade = '1'
    GROUP BY 1
    ORDER BY 2 DESC
    LIMIT 10
""").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/