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.
Em produção (identificado 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 → acompanhamento da resposta do convênio → Autorizado ou Negado → uso pelos agendamentos.

Fluxo Completo

✅ Novo — 30/09/2026 Correção 30/09: os nomes de status usados antes nesta página (AGUARDANDO_ENVIO, EM_ANÁLISE, AUTORIZADA, AUTORIZADA_PARCIAL, NEGADA, EXPIRADA, UTILIZADA, FATURADA) e a ação "Enviar à operadora" vinham do planejamento (HU #397) e não existem no sistema. Abaixo, os status e o fluxo reais, conferidos no código de produção.
  1. Solicitar: a recepção cria a autorização com paciente, convênio, serviços (e, desde ago/2026, produtos e taxas), caráter do atendimento (eletivo/urgência/emergência — Tabela 23). A autorização fica como pendência (Aguardando autorização, Pendentes de autorização ou Pré-solicitação).
  2. Pedir ao convênio: a clínica envia a solicitação pelo portal/canal da própria operadora e registra no Rabi o protocolo e o acompanhamento (a pré-solicitação dá o farol pelo prazo de resposta). Não existe botão que envie à operadora e mude o status sozinho. O envio automático por webservice TISS (autorização online: solicitação, status e lote) está no roadmap — 🟠 Sprint 14, 09–16/out, #622 do épico #618. (✅ Atualização 15/10: da integração TISS, só a fase 1 — consulta de elegibilidade — está em produção.)
  3. Aguardar: enquanto o convênio não responde, a autorização segue como pendência; se o Prazo de autorização (dias) do convênio passar, ela aparece como Prazo vencido.
  4. Registrar o resultado: Autorizado ou Negado. Ao registrar Autorizado, os agendamentos vinculados são liberados (se todos os serviços que pedem autorização estiverem autorizados, o agendamento vai para o status normal da agenda) e os documentos exigidos do protocolo são copiados para eles.
  5. Utilizar: os agendamentos consomem a quantidade autorizada (depois que a guia mãe é pré-faturada ou faturada, a autorização não recebe mais sessões — ver abaixo); quando o saldo é totalmente consumido, a autorização passa a Agendado. Agendamento cancelado ou não comparecido não consome, e cancelar um agendamento devolve a sessão à autorização.
  6. Tratamento continuado: é possível repetir o pedido no mesmo prazo (#477).

Status da Autorização

StatusO que significaNo board da agenda (coluna Autorização)
Aguardando autorizaçãoSolicitação registrada, aguardando a resposta do convênioPendência
Pendentes de autorizaçãoAguardando decisãoPendência
Pré-solicitaçãoAinda precisa formalizar a solicitação; tem acompanhamento com farol pelo prazo (#380)Pendência
Prazo vencidoVirtual (não é gravado): é uma "Aguardando autorização" cujo Prazo de autorização (dias) do convênio já passouPendência
AutorizadoO convênio aprovou. Libera os agendamentos vinculados e copia para eles os documentos exigidos do protocoloResolvido
AgendadoAutorizado cujo saldo (quantidade autorizada) já foi totalmente consumido por agendamentos que contam como uso (desde 01/10/2026, decidido só pela quantidade do serviço)Resolvido
NegadoO convênio negou (final)Fora do board
CanceladoAutorização cancelada (final)Fora do board

Nota sobre o "ciclo oficializado" da HU #397

✅ Correção — 30/09/2026 Versões anteriores deste manual apresentavam como "ciclo oficializado" a sequência AGUARDANDO_ENVIO → EM_ANALISE → AUTORIZADA → UTILIZADA, tirada da HU HU-Manter-Autorizacao (GitLab #397). Esses nomes eram de planejamento e não existem no sistema. Valem os status da tabela acima.

Tabelas TISS 4.03.00 incorporadas

Tabela TISSUso na autorização
Tabela 23Caráter do atendimento (eletivo / urgência / emergência)
Tabela 36Indicador de acidente (trabalho, trânsito, outros)
Tabela 87"Tabela de tabelas": de qual referência vem o código do item (tabela própria, Brasíndice, SIMPRO…) — no Rabi, domínio 87

Pré-solicitação de autorização — acompanhamento com farol de prazo (#380) ✅ completa em produção desde 28/09/2026

✅ Novo — 29/09/2026 Pré-solicitação completa em produção — a regra e a notificação estão no servidor de produção desde 25/09/2026 (issue #380 fechada em 25/09) e a tela (ícone Acompanhamento + coluna Pré-solicitação na lista) está em produção desde 28/09/2026. ✅ Novo — 26/09/2026 Correção: versões anteriores deste manual descreviam a pré-solicitação como uma "conferência interna antes do envio à operadora" e a colocavam no roadmap sem data — as duas coisas estavam erradas.

O que é: a pré-solicitação é um acompanhamento registrado na própria autorização — ela não cria uma autorização nova. Serve para a clínica anotar quando pediu a autorização à operadora e cobrar a resposta dentro do prazo.

  1. Na lista de autorizações, clique no ícone Acompanhamento da autorização — abre o modal de acompanhamento.
  2. Registre a data da pré-solicitação e uma observação. Pode haver várias (fica o histórico completo); o sistema usa a mais recente.
  3. O sistema calcula um farol pelo prazo de resposta do convênio — campo Prazo de autorização (em dias) no cadastro do convênio:
Tempo decorrido do prazoFarolO que acontece
Menos de 50%🟢 VerdeDentro do prazo
De 50% a 90%🟡 AmareloMostra "faltam N dias"
90% ou mais, ou prazo vencido🔴 VermelhoNotificação automática ao responsável (evento PRE_SOLICITACAO_VENCENDO) — ver Notificações
Convênio sem Prazo de autorização configurado— (sem farol)Não é "verde": configure o prazo no convênio para ter o farol

Na lista de autorizações, uma nova coluna Pré-solicitação mostra o farol e os dias. O status "Pré-solicitação" da autorização já existia antes e continua valendo.

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.

✅ Novo — 23/09/2026 Farol consolidado da autorização: desde 23/09/2026, o Farol da autorização (assim como o do orçamento e o do agendamento) é um só para o conjunto inteiro — soma do que o convênio paga por todos os itens ÷ soma do custo dos produtos × 100. Substitui a regra antiga do farol por serviço (em que valia a cor mais crítica): um serviço vermelho sozinho não bloqueia se o conjunto fecha verde; item sem custo ou sem preço deixa o consolidado 🟣 roxo e bloqueia; o pedido de aprovação por alçada refere-se ao consolidado. Cada linha continua com a própria cor, só para orientar. Detalhes em Orçamento › Farol consolidado e Preços e Conversão de Valores.
✅ Atualização 24/09 A série de regras de preço está toda em produção: produtos, taxas e subserviços sempre entram na conta com as conversões do convênio (só ficam fora sem Utiliza ou zerados em pacote de preço fechado) e Zerar valor em pacotes é por item, sem cascata. Passo a passo na Árvore de decisão de preços.
💰 Como o Rabi chega ao preço? Os valores de serviços, produtos e taxas da autorização vêm da conversão do convênio — os 3 níveis de conversão, as 3 linhas de cada item (4 na coluna Valor do serviço, com a Σ — ✅ em produção desde 24/09) e o modo pacote estão explicados de ponta a ponta na nova área Preços e Conversão de Valores.

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.

Novidades do ciclo de setembro/2026 ✅ Novo — set/2026

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

Novidades de outubro/2026 ✅ Novo — 13/10/2026

Lista de autorizações com mais colunas ✅ Novo — 05/10/2026

Em Agenda › Autorizações (#657) entraram as colunas Telefone (texto), CPF, Validade (com dias para vencer), Plano, Solicitante, Executante (com filtro) e Orçamento (clicável), além das existentes (inclusive "Pré-solicitação"). "Qtd. Solicitada" deixou de vir vazia e os avisos de vencidas/vencendo contam a lista inteira, não só a página. Colunas escondíveis e reordenáveis, salvas por usuário neste navegador até sair do sistema; botão "Colunas padrão"; "Exportar Excel" com todas as linhas do filtro e as colunas visíveis. Filtros, ordem e página ficam no endereço da tela. ✅ Atualização 15/10: desde 13/10, ao sair do sistema as colunas escolhidas voltam ao padrão (o logout apaga as preferências do navegador).

Subserviços na autorização ✅ Novo — 02/10/2026

Na linha do serviço aparece o quadro "Subserviços" (#641), com chips "Convênio não cobre", "Não pede autorização", autorização existente com protocolo, "Pede autorização" e "Autorização incluída nesta tela". Dá para criar a autorização do subserviço na própria tela ou separada ("+ Autorização"). Hoje a autorização do subserviço não é obrigatória: subserviço sem autorização não deixa o agendamento em Pendente de Autorização nem bloqueia o acolhimento (regra desativada desde 03/10, vai ser revista). Confira no faturamento se a guia precisa listar os subserviços.

Guia pré-faturada ou faturada: peça nova autorização ✅ Novo — 08/10/2026

Quando a guia mãe da autorização está pré-faturada, faturada ou em lote (#649), a autorização sai da aba "Autorizadas" do painel de pendências da Agenda, não é oferecida no seletor do agendamento, e criar/repetir/editar agendamento com ela mostra "A guia desta autorização já foi pré-faturada/faturada; peça nova autorização." Guia filha fechada com a mãe aberta não tira a autorização da lista; "Atendido com pendência" conta como guia aberta; guia reaberta volta a aparecer sozinha.

Outras mudanças

Correções de 13 a 15/10/2026 ✅ Novo — 15/10/2026

Novidades de 15 a 23/10/2026 Novo — out/2026

Não encontro o profissional ou o serviço

Hoje (produção): a autorização não valida a especialidade do convênio, e a trava de especialidade (#628) está desligada temporariamente desde 06/10/2026 também no agendamento e no orçamento — profissionais, especialidades e serviços aparecem sem filtro pelo que o convênio atende. Confira a cobertura do convênio. No cadastro do convênio a regra vale (serviço de especialidade não atendida aparece como "Não atendida" e não pode ser marcado como Utiliza) — ver Configurações › Convênios › aba Especialidades.

Ainda no roadmap (não disponível)

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

MétodoEndpointFunção
POST/autorizacaoCriar
GET/autorizacaoListar
GET/autorizacao/:idDetalhe
PUT/autorizacao/:idAtualizar
DELETE/autorizacao/:idCancelar
GET/autorizacao/:id/servicosServiços vinculados
GET/autorizacao/:id/acompanhamentoHistórico tratativas (inclui as pré-solicitações)
GET/autorizacao/statusLista de status disponíveis

Tabelas ANS aplicáveis

Telas (Frontend)

Componentes principais

Permissões

A autorização é controlada pela permissão AUTORIZACAO, do grupo de Agendamento, com os níveis de ação do modelo:

Desde 15/09/2026 as permissões granulares (#395) permitem refinar isso por funcionalidade e por ação, em perfis e grupos.

✅ Correção — 30/09/2026 Não existem as permissões AUTORIZACAO.SEND, AUTORIZACAO.CANCEL nem AUTORIZACAO.OVERRIDE, nem a regra "só edita em AGUARDANDO_ENVIO" — vinham do planejamento (HU #397). Agendar sem autorização não é liberado por permissão: depende do cadastro do convênio/serviço (se o serviço pede autorização) e da parametrização da autorização obrigatória no agendamento (#374).

Nota histórica — layout da tela

✅ Resolvido: a tela de Autorização, que tinha todos os campos em coluna única, foi reorganizada em grid (#306, 28/08/2026).

Integrações

Ver também