Lição: Autorização (ANS/TISS)

Esta lição treina você, do zero, para operar o módulo de Autorização de Procedimentos do Sistema Rabi. Para procedimentos eletivos (exames, cirurgias, internações), a operadora de saúde exige autorização prévia. O módulo gerencia todo o ciclo: solicitação → análise → aprovação → utilização, seguindo o padrão TISS/ANS.

🟢 Em produção: o ciclo completo da autorização (#397), as Tabelas TISS 23 e 87, a pré-solicitação interna (#381), o acompanhamento e o painel "Original vs Convênio" estão disponíveis e são uso real.

1. Objetivo e onde fica o módulo

Lista de autorizações: /portal/agenda/autorizacao
Nova autorização: /portal/agenda/autorizacao/criar
Editar: /portal/agenda/autorizacao/:id/editar

Objetivo: garantir que procedimentos que dependem de aprovação da operadora sejam solicitados, acompanhados e utilizados corretamente, reduzindo glosas e evitando atendimento sem cobertura.

2. Fluxo completo

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

✅ Novo — jul/2026 Tratamento continuado (#477): é possível repetir o pedido de autorização dentro do mesmo prazo, para tratamentos continuados — sem recriar tudo do zero. Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

3. Status da autorização

O ciclo principal foi oficializado na HU HU-Manter-Autorizacao (#397):

AGUARDANDO_ENVIO → EM_ANÁLISE → AUTORIZADA → UTILIZADA

Os demais estados são ramificações desse ciclo:

Status	Significado
AGUARDANDO_ENVIO	Criada, ainda não enviada
EM_ANÁLISE	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
FATURADA	✅ Novo — jul/2026 A autorização passa a "faturada" quando a guia dela é faturada (#450)

✅ Novo — jul/2026 Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

4. Passo a passo: criar uma autorização

Acesse /portal/agenda/autorizacao e clique em Nova (ou vá direto a /portal/agenda/autorizacao/criar).
Selecione o paciente e, no modal de convênio, escolha o convênio + carteirinha (o sistema valida se o vínculo do paciente ao convênio está ativo).
Adicione os serviços/procedimentos a autorizar (bloco de serviços) e a quantidade.
Informe o caráter do atendimento (Tabela 23: eletivo, urgência ou emergência) e, se houver, o indicador de acidente (Tabela 87).
Se a clínica exigir, aceite o Termo de Responsabilidade (controlado pelos parâmetros do sistema).
Salve. A autorização nasce em AGUARDANDO_ENVIO.
Envie à operadora (ação Enviar): gera o XML TISS e o status vai para EM_ANÁLISE.

Pré-solicitação interna (#381): antes do envio à operadora, o setor responsável pode validar internamente procedimentos, carteirinha e caráter. Isso reduz glosas e retrabalho.

5. Tabelas TISS/ANS aplicáveis

Tabela	Uso na autorização
Tabela 23	Caráter do atendimento: eletivo / urgência / emergência
Tabela 87	Indicador de acidente: trabalho / trânsito / outros
Tabela 25	Códigos de despesa (procedimentos)

6. Lista e painel "Original vs Convênio"

Na lista (/portal/agenda/autorizacao), uma coluna mostra lado a lado o valor original do serviço e o valor pago pelo convênio. Serve para identificar rapidamente autorizações com diferença grande entre os dois valores — candidatas a revisão ou cobrança.

7. Telas e componentes

ListAutorizacao — lista de autorizações.
AutorizacaoForm — criação/edição.
AcompanhamentosAutorizacao — timeline de tratativas (histórico com a operadora).
DadosPacienteAutorizacao — bloco fixo com dados do paciente.
ListServicoAutorizacao — adicionar/remover serviços.
ModalAddConvenio — selecionar convênio + carteirinha.
ModalTermoDeResponsabilidade — exige o termo conforme parâmetros do sistema.

8. Permissões

Modelo atual: papel (Role) + ações por módulo. A Autorização usa as ações padrão VIEW/CREATE/UPDATE/DELETE e ações específicas de fluxo:

Permissão	Permite
`AUTORIZACAO.VIEW`	Visualizar
`AUTORIZACAO.CREATE`	Criar
`AUTORIZACAO.UPDATE`	Editar — somente em AGUARDANDO_ENVIO
`AUTORIZACAO.SEND`	Enviar à operadora
`AUTORIZACAO.CANCEL`	Cancelar
`AUTORIZACAO.OVERRIDE`	Atender SEM autorização (caso especial — exige justificativa)

9. Integrações

Atendimento: a autorização é vinculada ao serviço executado; o sistema baixa a quantidade autorizada.
Carteirinhas: valida o vínculo ativo do paciente ao convênio.
Faturamento: a guia TISS carrega o número e a senha da autorização.
Convênio: define se exige autorização prévia e o prazo de validade.

10. Erros comuns e como resolver

Situação	Causa / Solução
Não consigo editar a autorização	Ela já saiu de AGUARDANDO_ENVIO. Só se edita antes do envio (UPDATE só em AGUARDANDO_ENVIO).
Convênio recusou a carteirinha	Vínculo do paciente ao convênio inativo/vencido. Atualize a carteirinha antes de solicitar.
Autorização voltou AUTORIZADA_PARCIAL	Só parte da quantidade foi aprovada; ajuste a utilização à quantidade liberada e, se necessário, renove.
Preciso atender sem autorização	Requer permissão `AUTORIZACAO.OVERRIDE` e justificativa; usar apenas em casos especiais.
Relatório de "autorizações pré-faturadas" vem vazio	✅ Novo — jul/2026 Bug do campo `preFaturada` corrigido (#387). Entregue no ciclo de julho/2026; se ainda ocorrer no seu ambiente, a correção chega na próxima atualização.
Muita rolagem na tela de autorização	Bug de UI conhecido (Issue #152): campos em coluna única. Melhoria para grid 2-3 colunas está planejada.

11. Planejado / em homologação

✅ Novo — jul/2026 Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização:

Autorização obrigatória (#374): exigir autorização no agendamento — parametrizável.
Tratamento continuado (#477): repetir o pedido no mesmo prazo.
Status "faturada" (#450): a autorização vira "faturada" quando a guia dela é faturada.
Bugs #386 e #387 corrigidos (validação de sessões e campo preFaturada).

🟠 Ainda não em produção:

Pré-solicitação de autorização (#380): segue no roadmap (Sprint 5).
Filtros + autocomplete na autorização: em homologação.
Relatórios de produtividade de autorização e acompanhamento sem protocolo: em homologação.

Pontos-chave

Ciclo oficial (#397): AGUARDANDO_ENVIO → EM_ANÁLISE → AUTORIZADA → UTILIZADA; demais status são ramificações.
Só se edita a autorização em AGUARDANDO_ENVIO.
Tabela 23 = caráter (eletivo/urgência/emergência); Tabela 87 = indicador de acidente.
A pré-solicitação interna (#381) valida os dados antes do envio, reduzindo glosas.
Na utilização, a autorização é vinculada ao Atendimento e a guia TISS carrega número e senha.
Atender sem autorização exige AUTORIZACAO.OVERRIDE + justificativa.
Novidades de jul/2026: tratamento continuado (#477), status "faturada" quando a guia é faturada (#450), autorização obrigatória parametrizável (#374) e bugs #386/#387 corrigidos.

O que a prova vai cobrar

A ordem correta do ciclo de status oficial (#397).
Em qual status a autorização pode ser editada (só AGUARDANDO_ENVIO).
Para que servem as Tabelas TISS 23 e 87.
O papel da pré-solicitação interna (#381) e do painel "Original vs Convênio".
Permissão necessária para atender sem autorização (OVERRIDE) e distinção produção × roadmap: a obrigatoriedade (#374) e a correção do preFaturada (#387) foram entregues em jul/2026; a pré-solicitação de autorização (#380) segue roadmap.