Autorização de Procedimentos (ANS)

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

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

Status da Autorização

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

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.

Autorização com PRODUTOS e TAXAS ✅ Novo — ago/2026

Com a conclusão do épico #570 (13/08/2026), a autorização deixa de tratar só serviços: passa a incluir produtos e taxas, com quantidades e a conversão do convênio (#547–#549). Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

• Farol consolidado da autorização — o farol da autorização (e o do agendamento) passa a ser calculado sobre serviço + produto + taxa (#551/#552).
• Crítica de quantidades no agendamento — o agendamento critica as quantidades de produtos a partir do orçamento/autorização (#553), com totais previstos × agendados nas telas (#554) e board "faltam X de Y" de produtos controlados (#556) — ver Agendamento.

Novidades do ciclo de agosto/2026 ✅ Novo — ago/2026

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

• Tela de autorização reorganizada — a tela foi reorganizada em um grid responsivo de 2–3 linhas, deixando o preenchimento mais claro (#306 — 28/08).
• Produtos e taxas na autorização + farol consolidado — épico #570 concluído em 13/08 (ver seção acima).
• Botão agendar direto da autorização — botão para agendar diretamente a partir da autorização, com os dados já preenchidos (#226 — 18/08).
• Edição de "Atendido" aprovada reflete na autorização — no novo fluxo de edição de agendamento Atendido, a edição aprovada reflete na Autorização vinculada (#565 — ver Agendamento).
• Cancelado/não comparecido não consome a autorização — agendamento cancelado ou com não comparecimento deixa de contar como uso da autorização (#522).
• Acompanhamento das autorizações pelo paciente — página de acompanhamento das autorizações pelo próprio paciente no serviço de agendamento online (#515).

Ainda no roadmap (não disponível)

• Pré-solicitação de autorização — #380.

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 corrigido (#387)

A entidade Autorizacao possui o campo preFaturada (sim/não). O bug que deixava o campo sempre vazio (relatórios de "autorizações pré-faturadas" em branco) foi corrigido em 20/07/2026 (#387): o campo é marcado true ao entrar no pré-faturamento e false no estorno.

Endpoints da API

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

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

Ver também

• Mapa de Módulos Novos
• Faturamento Avançado (Guia, Lote, Glosas)
• Orçamento