Autorização de Procedimentos (ANS)

📚 Referência completa e treinamento: este módulo tem uma lição detalhada de certificação — passo a passo de todas as telas, campos e regras.

Módulo NOVO — identificado em rabi-api/develop em 26/05/2026. Rota: /portal/agenda/autorizacao.

Visão Geral

Para procedimentos eletivos (exames, cirurgias, internações), a operadora de saúde exige autorização prévia. Este módulo gerencia todo o ciclo: solicitação → análise → aprovação → utilização.

Fluxo Completo

Solicitar: recepcionista cria autorização com paciente, convênio, procedimentos, caráter (eletivo/urgência/emergência via Tabela 23 ANS)
Enviar: gera XML TISS, envia à operadora (manual ou via web-service)
Aguardar: operadora analisa
Receber retorno: AUTORIZADA / AUTORIZADA_PARCIAL / NEGADA
Utilizar: vincular ao Atendimento, sistema baixa quantidade
Renovar: se expira sem uso integral

Status da Autorização

Status	Significado
AGUARDANDO_ENVIO	Criada, ainda não enviada
EM_ANALISE	Enviada, operadora analisando
AUTORIZADA	Aprovada — pode usar
AUTORIZADA_PARCIAL	Parte da quantidade aprovada
NEGADA	Negada (com motivo)
EXPIRADA	Validade vencida sem uso
UTILIZADA	Quantidade integralmente consumida
CANCELADA	Cancelada pela clínica

Ciclo de Estados Oficializado (#397)

O fluxo principal foi oficializado na HU HU-Manter-Autorizacao (GitLab #397), com 6 entidades novas (em autorizacao/ e protocoloAutorizacao/):

AGUARDANDO_ENVIO → EM_ANALISE → AUTORIZADA → UTILIZADA

Os demais estados (AUTORIZADA_PARCIAL, NEGADA, EXPIRADA, CANCELADA) são ramificações desse ciclo, conforme a tabela de status acima.

Tabelas TISS 4.03.00 incorporadas

Tabela TISS	Uso na autorização
Tabela 23	Caráter do atendimento (eletivo / urgência / emergência)
Tabela 87	Indicador de acidente (trabalho, trânsito, outros)

Pré-solicitação interna (#381)

Antes de enviar a autorização à operadora, o sistema permite uma pré-solicitação interna: o setor responsável valida os dados (procedimentos, carteirinha, caráter) antes do envio oficial, reduzindo glosas e retrabalho.

Tratamento continuado — repetir pedido no mesmo prazo ✅ Novo — jul/2026

Para autorizações de tratamento continuado, é possível repetir o pedido de autorização dentro do mesmo prazo, sem recomeçar o preenchimento do zero (GitLab #477, fechada em 21/07/2026). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

Lista de autorizações — painel "Original vs Convênio" ✅ novo (jun/2026)

Na lista de autorizações (/portal/agenda/autorizacao), uma coluna nova mostra lado a lado o valor original do serviço e o valor pago pelo convênio. Isso facilita identificar rapidamente autorizações com diferença grande entre os dois valores — candidatas a revisão ou cobrança. O módulo também recebeu ajustes gerais de fluxo e de interface em junho/2026.

Campo `preFaturada` 🐞 bug em aberto (#387)

A entidade Autorizacao possui o campo preFaturada (sim/não), mas hoje nenhum fluxo o preenche — por isso os relatórios de "autorizações pré-faturadas" vêm vazios. A correção planejada (marcar true ao entrar no pré-faturamento e false no estorno) está em backlog (#387).

Endpoints da API

Método	Endpoint	Função
POST	`/autorizacao`	Criar
GET	`/autorizacao`	Listar
GET	`/autorizacao/:id`	Detalhe
PUT	`/autorizacao/:id`	Atualizar
DELETE	`/autorizacao/:id`	Cancelar
GET	`/autorizacao/:id/servicos`	Serviços vinculados
GET	`/autorizacao/:id/acompanhamento`	Histórico tratativas
GET	`/autorizacao/status`	Lista de status disponíveis

Tabelas ANS aplicáveis

Tabela 23 — Caráter do atendimento (eletivo, urgência, emergência)
Tabela 87 — Indicador de acidente
Tabela 25 — Códigos de despesa (procedimentos)

Telas (Frontend)

/portal/agenda/autorizacao — lista (ListAutorizacao.tsx)
/portal/agenda/autorizacao/criar — nova (AutorizacaoForm.tsx)
/portal/agenda/autorizacao/:id/editar — editar

Componentes principais

AcompanhamentosAutorizacao — timeline de tratativas
DadosPacienteAutorizacao — bloco fixo com info paciente
ListServicoAutorizacao — adicionar/remover serviços
ModalAddConvenio — selecionar convênio + carteirinha
ModalTermoDeResponsabilidade — exigir termo conforme parametrosDoSistema

Permissões

AUTORIZACAO.VIEW — visualizar
AUTORIZACAO.CREATE — criar
AUTORIZACAO.UPDATE — editar (somente AGUARDANDO_ENVIO)
AUTORIZACAO.SEND — enviar à operadora
AUTORIZACAO.CANCEL — cancelar
AUTORIZACAO.OVERRIDE — atender SEM autorização (caso especial — exige justificativa)

Bug conhecido — UI

Tela de Autorização tem todos os campos em coluna única, gerando muita rolagem. Issue #152 — distribuir em grid 2-3 colunas responsivo.

Integrações

Atendimento — vinculação da autorização ao serviço executado, baixa quantidade
Carteirinhas — valida vínculo ativo do paciente ao convênio (HU-Carteirinhas-Soft-Delete)
Faturamento — guia TISS carrega número e senha da autorização
Convênio — define se exige autorização prévia e prazo de validade