ER - AIH Rejeitadas com código de erro (sih-er)¶
Resumo¶
sih-er registra os erros de processamento das AIH rejeitadas: cada linha associa uma AIH rejeitada (por número, estabelecimento e datas) ao código do erro (CO_ERRO) que motivou a rejeição. É o complemento diagnóstico do sih-rj, indispensável para entender por que uma internação não foi paga.
Ficha técnica¶
Origem e coleta¶
- Arquivos preliminares: Não
- Documentação oficial no FTP:
/dissemin/publicos/SIHSUS/200801_/Doc - Tabelas auxiliares no FTP:
/dissemin/publicos/SIHSUS/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/SIHSUS/200801_/Dados |
ER |
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):ERSP2401.dbc—ER(AIH Rejeitadas com código de erro) +SP(UF) +24(ano 2024) +01(mês de competência). - No armazenamento local do
datasus-fetcher:data/sih-er/<AAAAMM>/sih-er_<AAAAMM>-<uf>@<AAAAMMDD>.dbc, por exemplodata/sih-er/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/IT_SIHSUS_1603.pdf(Informe Técnico do SIHSUS, 57 KB, 2016) é o dicionário oficial de variáveis;Auxiliar/TAB_SIH.zip(~6,1 MB, tabelas e conversores.cnv/.defatuais) e as versões históricasTAB_SIH_199201-199712.zip,TAB_SIH_199801-200307.zipeTAB_SIH_200308-200712.ziptrazem as tabelas de procedimentos, CID e códigos usadas em cada fase.
Conteúdo¶
O Sistema de Informações Hospitalares do SUS (SIH/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 — e tem como finalidade operacionalizar o pagamento das internações realizadas em hospitais públicos e privados conveniados ao SUS. Por ser um sistema de faturamento, cobre apenas a assistência financiada pelo SUS (não inclui saúde suplementar nem internações particulares) e é a principal fonte nacional para estudar morbidade hospitalar, perfil assistencial e gasto hospitalar.
O evento gerador é a crítica de consistência do processamento da AIH, que grava, para cada inconsistência encontrada, o código de erro correspondente (tabela de críticas do SIHSUS). A unidade de análise é a ocorrência de erro por AIH e competência; uma AIH com múltiplas críticas pode gerar mais de uma linha, e SEQUENCIA/REMESSA identificam o lote do gestor. Cada hospital preenche a Autorização de Internação Hospitalar (AIH) e a remete mensalmente ao gestor municipal/estadual, que a valida e a envia ao DATASUS para processamento na competência (ANO_CMPT/MES_CMPT). O processamento classifica cada AIH como aprovada (arquivo RD), rejeitada (RJ/ER) e detalha os atos profissionais (SP).
O inventário do FTP inicia em 2011-01 (embora o RJ comece em 2008-01) e segue até a competência corrente. O arquivo é pequeno (~0,3 GB para 4.958 arquivos) e tem leiaute fixo de 13 campos, bem distinto do RD: traz apenas identificação da AIH, datas, municípios e o erro. A tabela de significado dos códigos CO_ERRO encontra-se nas tabelas auxiliares do SIH (TAB_SIH.zip) e no Informe Técnico do SIHSUS.
Aplicações: ranking das causas de rejeição por hospital e município; mensuração do impacto financeiro de cada tipo de erro (quando ligado ao sih-rj); apoio à qualificação do faturamento e à capacitação de equipes de faturamento hospitalar; auditoria de gestores que enviam remessas com alto índice de erros; e monitoramento da evolução da qualidade da informação hospitalar.
Cobertura observada¶
- Índice do FTP (2026-10): 4984 arquivos, de 2011-01 a 2026-09, 27 UF(s) com arquivos, última atualização em 2026-11-10.
- Conversão local de amostras (5 arquivo(s) Parquet, de 2011-06 a 2026-05), 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)¶
13 colunas no arquivo de 2024-01 (ERAC2401.dbc).
| Coluna (DBF) | Tipo / Formato | Descrição |
|---|---|---|
SEQUENCIA |
Inteiro | Número sequencial do registro dentro da remessa. |
REMESSA |
String | Nome da remessa enviada pelo gestor (padrão HE<código do gestor>…<AAAAMM>.DTS). |
CNES |
String (7) | Estabelecimento que apresentou a AIH. |
AIH |
String (13) | Número da AIH rejeitada (equivale a N_AIH do RD/RJ). |
ANO / MES |
Inteiro | Ano e mês da competência do processamento. |
DT_INTER / DT_SAIDA |
String AAAAMMDD → pl.Date |
Datas de internação e saída informadas. |
MUN_MOV |
String (6) | Município do estabelecimento (movimento). |
UF_ZI |
String (6) | Código do gestor/UF de gestão. |
MUN_RES |
String (6) | Município de residência do paciente. |
UF_RES |
String (2) | UF de residência do paciente (código IBGE de 2 dígitos). |
CO_ERRO |
String (6) | Código do erro/crítica que causou a rejeição (p.ex. 020081); consultar tabela de erros do SIH. |
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 |
|---|---|---|---|---|---|
sequencia |
SEQUENCIA |
inteiro | Sequencial da AIH na remessa. | — | todos |
remessa |
REMESSA |
texto | Número da remessa. | — | todos |
cnes |
CNES |
texto | Código CNES do hospital. | — | todos |
aih |
AIH |
texto | Número da AIH rejeitada | — | todos |
dt_inter |
DT_INTER |
data | Data de internação (AAAAMMDD, convertida para data); o informe técnico a grafa DI_INTER |
— | todos |
dt_saida |
DT_SAIDA |
data | Data de saída, no formato aaaammdd. | — | todos |
mun_mov |
MUN_MOV |
texto | Município de movimento (do estabelecimento), código IBGE de 6 dígitos | — | todos |
uf_zi |
UF_ZI |
texto | Município Gestor. | — | todos |
mun_res |
MUN_RES |
texto | Município de residência do paciente, código IBGE de 6 dígitos | — | todos |
uf_res |
UF_RES |
texto | UF de residência do paciente | — | todos |
co_erro |
CO_ERRO |
texto | Código do erro de processamento que motivou a rejeição da AIH | — | 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/sih-er, 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): data: 2, inteiro: 1, texto: 10.
- 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:
sih-er.schema.json, gerado por conversão local de amostras. Tipos listados com mais de um valor variam entre partições.
Cuidados de uso¶
- (i) o par (
AIH,CNES, competência) liga o ER aosih-rj; (ii) pode haver várias linhas por AIH — conte AIH distintas comn_uniqueao calcular taxas; (iii) o ER só existe a partir de 2011-01, então rejeições anteriores não têm código de erro neste dataset; (iv) o significado deCO_ERROmuda com o tempo, use a tabela auxiliar da data correspondente. (texto da versão anterior desta página; não reconferido nesta revisão.) - 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/sih-er").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 sih-er
# baixa um recorte, com a documentação oficial e as tabelas auxiliares (`--dry-run` só lista)
datasus-fetcher sync sih-er -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 sih-er
Referências¶
- Servidor FTP do DATASUS:
ftp://ftp.datasus.gov.br/dissemin/publicos/SIHSUS/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 SIHSUS:
ftp://ftp.datasus.gov.br/dissemin/publicos/SIHSUS/200801_/Doc/IT_SIHSUS_1603.pdf - Manual Técnico Operacional do SIH/SUS (SAES/MS) — disponíveis na Biblioteca Virtual em Saúde do Ministério da Saúde: https://bvsms.saude.gov.br/
- SIGTAP — Tabela de Procedimentos, Medicamentos e OPM do SUS: http://sigtap.datasus.gov.br/
- PCDaS/Fiocruz (SIH/SUS para pesquisa): https://pcdas.icict.fiocruz.br/