⚙️ Convênios

Como cadastrar um convênio

Do manual: abrir esta parte no manual completo ›

1. Acesse Configurações → Convênios
2. Clique em "Novo Convênio"

   O convênio recém-criado já abre liberado para preencher. Para alterar um convênio que já existe (inclusive voltar outro dia para preencher as abas), abra-o e clique primeiro em Liberar para edição — ele abre em modo consulta — e, ao terminar, clique em Salvar no cabeçalho (as abas só gravam no Salvar).

3. Selecione a operadora

   A operadora deve estar cadastrada antes. Ex: "Unimed Nacional".

4. Informe o nome do convênio

   Ex: "Unimed Individual", "Bradesco Nacional Flex", "Particular".

5. Preencha os prazos comerciais

   Prazo de pagamento, prazo de retorno, prazo de entrega de guias, prazo de glosa. Esses valores vêm do contrato com a operadora.

6. Defina "Pagamento no ato?"

   Se Sim: paciente paga copagamento na recepção ao chegar. Se Não: faturamento é feito depois em lote.

7. Salve os dados e depois configure as abas de preço

   Primeiro os dados do convênio (inclusive a Conta de recebimento, usada em Gerar Contas a Receber do lote); depois as abas Serviços, Produtos e Taxas — cada alteração fica pendente até o Salvar do cabeçalho. As abas exigem que taxas, produtos e serviços já estejam cadastrados — por isso eles vêm antes dos convênios na implantação. Veja opções na seção abaixo.

8. Credenciamento de colaboradores (abas Especialidades e Colaboradores)

   Selecione quais especialidades (com o CBOS) e quais colaboradores estão credenciados neste convênio. Marque Atende nas especialidades que o convênio cobre — vale no cadastro do convênio (abas Serviços, Colaboradores e Produtos); no agendamento a trava está desligada temporariamente desde 06/10/2026 (ver Especialidades do convênio).

9. Ative o convênio e salve

   Marque "Ativo = Sim" para que o convênio apareça nos agendamentos e no cadastro de pacientes.

Lição: convênios — o cadastro mais crítico

Do manual: abrir esta parte no manual completo ›

Contratos com operadoras aceitos pela clínica. É a configuração mais complexa: define regras comerciais, prazos, credenciamento e tabelas de preço. Rota: /portal/configuracoes/convenios.

Passo a passo — cadastrar um convênio

1. Acesse Configurações → Convênios e clique em Novo Convênio.
2. Selecione a operadora (já cadastrada).
3. Informe o nome do convênio (ex.: Unimed Individual).
4. Preencha os prazos comerciais (pagamento, retorno, entrega de guias, glosa) — vêm do contrato com a operadora.
5. Defina "Pagamento no ato?": Sim = copagamento na recepção; Não = faturado depois em lote.
6. Configure a tabela de preços (ver métodos abaixo).
7. Na aba Especialidades, marque Atende nas especialidades que o convênio cobre (hoje a marcação ainda não filtra o agendamento — ver "Especialidades do convênio" abaixo). ✅ Atualização 13/10: na aba Serviços ela já sinaliza e bloqueia marcar Utiliza em serviço de especialidade não atendida; no agendamento a trava está desligada desde 06/10.
8. Marque Ativo = Sim e salve.

O convênio recém-criado abre liberado para preencher. Para alterar um convênio que já existe (dados, valores, Utiliza, Pacote, Zerar, especialidades, colaboradores, planos, taxas, produtos, serviços, dados fiscais, copiar ou importar planilha), o 1º passo é sempre clicar em Liberar para edição — veja o quadro abaixo.

✅ Atualização 13/10: e o último passo é clicar em Salvar, no cabeçalho do convênio: desde 01/10/2026 o que você altera nas abas Planos, Especialidades, Produtos, Serviços e Taxas fica como rascunho (célula destacada) e só grava no Salvar. Sequência: Liberar para edição → alterar → Salvar.

Campos do formulário

Tabela de preços do convênio (4 métodos)

Cada convênio tem tabela própria com o valor pago por procedimento. Formas de configurar (em convênio já existente, clique antes em Liberar para edição — só Exportar funciona em modo consulta):

Painel de conversão de serviço (atualizado jun/2026)

Em /portal/configuracoes/convenios/:id/servicos, o painel de Conversão de Serviço faz o "de–para" entre os serviços internos da clínica e os códigos/serviços do convênio. Em junho/2026 esse painel foi simplificado e recebeu ajustes visuais, tornando o cadastro do "de–para" mais rápido e claro.

Novidades de julho/2026 no convênio ✅ Novo — jul/2026

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

• Valor por conversão na linha (#473): o valor por conversão passa a ser informado direto na linha do serviço.
• Desativar convênio com vinculados (#455): agora é possível desativar um convênio mesmo com colaboradores vinculados.
• Sub-aba Colaboradores (#429): a sub-aba passa a listar apenas os colaboradores que têm consulta.
• Farol de resultado 🟢🟡🔴 (#390/#434/#339): farol por convênio/serviço/produto, com cores + índice, parametrizado no convênio. Bloqueia no vermelho (liberação por nível superior) — desde 23/09/2026, no orçamento, agendamento e autorização, quem bloqueia é o Farol CONSOLIDADO do conjunto (Σ receita ÷ Σ custo); a cor de cada item só orienta. A régua (Parâmetro Vermelho/Amarelo) fica em Parâmetros › aba Valores.

✅ Novo — ago/2026 Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização: a visão geral do farol (#435) — lista de cruzamentos serviço×convênio e produto×convênio — foi entregue, e o farol ganhou a cor ROXA (#545) para erro de preço (sem custo ou sem receita), com bloqueio.

✅ Novo — ago/2026 Subabas do convênio com filtro e ordenação (#583): as subabas Produtos, Serviços e Taxas do convênio ganharam filtro e ordenação por utilização — os itens mais usados aparecem primeiro, agilizando a manutenção das tabelas. Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

✅ Novo — set/2026 Novos códigos no domínio da tabela 87 (TISS): o domínio de tabela 87 do convênio ganhou os códigos 05 — Brasindice, 12 — SIMPRO e 97 — Taxa Própria, permitindo referenciar corretamente materiais/medicamentos (Brasindice/SIMPRO) e taxas próprias da clínica nas guias. Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

✅ Novo — set/2026 Correção: campo "Política de Preço" exibia "null" (#615): o campo Política de Preço do produto no convênio exibia "null" em vez do valor configurado; corrigido no fechamento da Sprint 10 (17–18/09). Também no ciclo: cadastros estruturais padronizados (#606) — campos estruturados em maiúsculas e sem acentuação, evitando duplicidades de grafia.

Continua no manual completo ›

Preços e conversão: a ideia em uma página

Do manual: abrir esta parte no manual completo ›

1. Todo item tem um valor "de casa" e pode ter um valor "por convênio"

O RABI trabalha com três tipos de item que geram cobrança:

Cada item tem o seu valor de cadastro (o valor "de casa"). Cada convênio pode converter esse valor para o que foi negociado com ele — e também o nome, a descrição, o código, a tabela 87 e (no serviço) o tipo de atendimento. O detalhe, atributo por atributo, está na Árvore de decisão do cadastro.

2. Os 3 níveis de conversão

O sistema procura o valor de um item para um convênio do mais específico para o mais geral. Achou, para. Não achou (campo vazio), desce um nível.

NÍVEL 3  →  Conversão do ITEM dentro do CONVÊNIO          (o mais específico — sempre ganha)
             Configurações › Convênios › abas Produtos / Serviços / Taxas

NÍVEL 2  →  Regra geral do CONVÊNIO (só para PRODUTOS)
             a) "Referências oficiais por tipo de produto" (desde 15/10/2026, se preenchida)
             b) "Política de Preço por Tipo de Produto"
             Configurações › Convênios › Dados do convênio

NÍVEL 1  →  Cadastro do próprio ITEM                       (o valor "de casa")
             Serviço: campo Valor · Produto: aba Estoque · Taxa: coluna Valor

🟠 Roadmap Ainda não disponível: importar o arquivo de cada editora (SIMPRO, Brasíndice etc.) para carregar os preços das referências oficiais — volta quando o sistema souber ler o formato de cada editora. Não há data.

Regra de ouro: vazio ≠ zero.

• Campo vazio = "não tenho regra aqui, use o nível de baixo".
• Campo com 0 = "o valor é zero mesmo" (não desce de nível).

As três linhas de cada item na tela do convênio

Na tela do convênio cada item aparece com três linhas, que são exatamente isso (produtos, taxas e a coluna Tipo de Atendimento seguem com 3; a coluna Valor do serviço tem uma 4ª linha, Σ — em produção desde 24/09):

Coluna Valor do SERVIÇO: 4 linhas ✅ em produção desde 24/09

Na aba Serviços do convênio, a coluna Valor do serviço tem uma quarta linha, Σ. Produtos, taxas e a coluna Tipo de Atendimento continuam com 3 linhas. Passando o mouse em cada linha, uma dica explica o que ela é.

O mesmo total também aparece no Farol do serviço (passe o mouse na bolinha) e no painel Expandir serviço.

✅ Em produção desde 24/09/2026 Textos e valores finais convertidos: em todas as telas do convênio (abas Serviços, Produtos, Taxas e Farol) o que aparece é a informação final — nome, descrição, código, tabela 87 e valores já convertidos para aquele convênio. Precedência: nível 3 (o item no convênio) → nível 2 (política do convênio — só para o preço de produto) → catálogo (cadastro do item).

✅ Em produção desde 23/09/2026 A linha ✅ do serviço mostra o valor do próprio serviço — como sai na linha de procedimento do XML (valor combinado do convênio, senão o do cadastro; zero se o serviço soma itens e não tem valor combinado). Produtos e taxas saem nas áreas deles do XML. Quem soma tudo é o Farol (e a linha Σ da coluna Valor, em produção desde 24/09). Ex.: "Noripurum aplicado EV" com valor combinado 0,01 mostrava 16,03 na linha ✅; hoje mostra 0,01.

✅ Em produção desde 23/09/2026 A coluna Tipo de Atendimento da aba Serviços também tem as três linhas (🔒 o do cadastro, 🔁 o escolhido para o convênio, ✅ o que vale): o do convênio prevalece e é o que vai para o atendimento, o pré-faturamento e o campo tipoAtendimento do XML.

Expandir serviço: a árvore do serviço como sai na guia ✅ Novo — 26/09/2026

Concluído em 25/09/2026 (#625) e em produção. Clicando na seta da linha do serviço, abre (sob demanda) a árvore do serviço naquele convênio, exatamente como sai na guia. Está em dois lugares:

• Configurações › Convênios › [convênio] › aba Serviços;
• Configurações › Serviços › [serviço] › aba Convênios — que agora também mostra, por convênio, a coluna Farol (linha inteira colorida) e a linha ✅ efetiva (descrição, tipo de código, código, Tabela 87 e valor que vai na guia), igual à aba Serviços do convênio.

Colunas do painel, nesta ordem: Farol · Item tipo (Serviço / Subserviço / Produto / Taxa) · Item nome · Tipo código · Código · Tabela 87 · Zerar valor · Somar itens · Conta no total · Utiliza · Motivo · Unidade de medida · Quantidade · Custo unitário · Receita unitária · Custo total · Receita.

• Item que não entra na cobrança aparece esmaecido e a coluna Motivo diz por quê: "Convênio não utiliza", "Zerado em pacote" ou "Subserviço pai fora do total".
• Cada linha mostra o próprio farol; a linha do subserviço mostra o total da sua subárvore.
• Os números são os mesmos da aba Farol › Itens e da bolinha do Farol (mesma fonte no banco) — nunca recalculados na tela. Alterou valor, Pacote ou Zerar na linha do serviço e salvou → a lista expandida se atualiza sozinha.
• ✅ Novo — 29/09/2026 Passando o mouse na bolinha do Farol de cada linha aparecem a margem, a receita e o custo daquela linha.
• ✅ Novo — 29/09/2026 Não há linha de total no fim da lista expandida: o total do serviço no convênio é a linha Σ da coluna Valor (e a linha do próprio serviço, no topo da árvore).
• É o jeito rápido de responder "o que a guia vai cobrar?" e "por que este serviço está vermelho?" sem filtrar milhares de linhas na aba Farol › Itens. Também ficou mais rápido (carregamento sob demanda e cache das listas).

✅ Corrigido em 23/09/2026 A cor da primeira linha das abas Serviços, Produtos, Taxas e Equipamentos do convênio agora acompanha o Farol: a linha inteira recebe a cor do Farol do item (antes ficava sempre branca, só com a bolinha colorida). Linha sem Farol calculado fica cinza claro.

Continua no manual completo ›

Receitas prontas: quero cobrar assim, como configuro?

Do manual: abrir esta parte no manual completo ›

Receita A — Preço igual para todo mundo

Consulta a R$ 300 em qualquer convênio.

🔓 Este passo a passo altera o convênio. O convênio abre em modo consulta: dentro dele é sempre Liberar para edição → alterar → Salvar no cabeçalho do convênio (desde 01/10/2026 as abas só gravam no Salvar; a célula alterada fica destacada até lá — veja como funciona). Terminou? Bloquear edição.

1. Configurações › Serviços › abra o serviço.
2. Campo Valor = 300,00. Caixinha "Definir preço do serviço pelos itens" desmarcada.
3. Em cada convênio que atende: abra o convênio › clique em Liberar para edição › aba Serviços › marque Utiliza (deixe o Valor em branco) › Salvar.

✅ Resultado: R$ 300,00 em todos.

Receita B — Preço diferente em um convênio

Consulta a R$ 300 na casa, mas o Convênio Alfa paga R$ 180.

🔓 Este passo a passo altera o convênio. O convênio abre em modo consulta: dentro dele é sempre Liberar para edição → alterar → Salvar no cabeçalho do convênio (desde 01/10/2026 as abas só gravam no Salvar; a célula alterada fica destacada até lá — veja como funciona). Terminou? Bloquear edição.

1. Faça a Receita A.
2. Configurações › Convênios › Convênio Alfa › clique em Liberar para edição › aba Serviços › encontre a consulta.
3. Na linha azul 🔁 da coluna Valor, digite 180,00. Marque Utiliza.
4. Clique em Salvar (cabeçalho do convênio).
5. Confira a linha verde ✅: deve mostrar 180,00.

✅ Resultado: Alfa = R$ 180,00 · demais = R$ 300,00.

Receita C — Medicamento aplicado: cobra o remédio + a aplicação

"Ferro aplicado na veia" = medicamento (preço varia) + aplicação (R$ 80).

🔓 Este passo a passo altera o convênio. O convênio abre em modo consulta: dentro dele é sempre Liberar para edição → alterar → Salvar no cabeçalho do convênio (desde 01/10/2026 as abas só gravam no Salvar; a célula alterada fica destacada até lá — veja como funciona). Terminou? Bloquear edição.

1. Cadastre o medicamento em Estoque › Produtos, com preço e custo (aba Estoque).
2. Cadastre o serviço "Aplicação endovenosa" com Valor = 80,00 (preço fixo).
3. Cadastre o serviço "Ferro aplicado na veia":
   • marque Definir preço do serviço pelos itens;
   • aba Produtos › adicione o medicamento, quantidade 1;
   • aba Servicos › adicione "Aplicação endovenosa", quantidade 1.
4. No convênio: clique em Liberar para edição e marque Utiliza no serviço, no medicamento e na aplicação › Salvar.

✅ Resultado: medicamento + R$ 80,00. Se o preço do medicamento mudar, o serviço muda junto.

Receita D — Preço fechado por convênio (pacote)

O Convênio Beta paga R$ 3.500,00 pela aplicação completa, já com o medicamento.

🔓 Este passo a passo altera o convênio. O convênio abre em modo consulta: dentro dele é sempre Liberar para edição → alterar → Salvar no cabeçalho do convênio (desde 01/10/2026 as abas só gravam no Salvar; a célula alterada fica destacada até lá — veja como funciona). Terminou? Bloquear edição.

1. Monte o serviço como na Receita C.
2. No Convênio Beta › clique em Liberar para edição › aba Serviços: na linha azul 🔁 do Valor digite 3.500,00; marque Utiliza e Pacote.
3. No Convênio Beta › aba Produtos: no medicamento, marque Utiliza e Zerar valor em pacotes. (O Zerar é marcado item a item, por você: desde 25/09/2026, marcar só Pacote não liga o Zerar sozinho.)
4. Faça o mesmo (Zerar valor em pacotes) para a "Aplicação endovenosa" na aba Serviços, se ela também já está dentro dos R$ 3.500.
5. Atenção: zerar a "Aplicação endovenosa" zera só o valor dela. Se dentro dela houver produtos ou taxas (ex.: taxa de sala) que também já estão nos R$ 3.500, marque Zerar valor em pacotes também nesses itens, nas abas Produtos e Taxas.
6. Clique em Salvar (cabeçalho do convênio) — as alterações das abas só são gravadas aí.
7. Confira: aba Serviços do Convênio Beta › clique na seta do serviço (Expandir serviço) — os itens inclusos aparecem esmaecidos com o motivo "Zerado em pacote".

✅ Resultado: R$ 3.500,00, sem somar o medicamento por cima. ✅ Em produção desde 23–24/09/2026
✅ Se no orçamento for lançado mais medicamento do que o previsto no serviço, só o excedente é cobrado.
⚠️ Sem o passo do Pacote, os R$ 3.500,00 seriam só o preço do serviço e o medicamento e a aplicação somariam por cima.

Receita E — Pacote de preço fixo, com alguns itens cobrados à parte

"Aplicação de medicamento X" = R$ 100,00. A seringa está incluída; o medicamento (R$ 50) é cobrado à parte.

🔓 Este passo a passo altera o convênio. O convênio abre em modo consulta: dentro dele é sempre Liberar para edição → alterar → Salvar no cabeçalho do convênio (desde 01/10/2026 as abas só gravam no Salvar; a célula alterada fica destacada até lá — veja como funciona). Terminou? Bloquear edição.

1. Serviço com Valor = 100,00 (caixinha "definir pelos itens" desmarcada). Adicione seringa e medicamento na aba Produtos.
2. No convênio › clique em Liberar para edição › aba Serviços: marque Utiliza e Pacote.
3. No convênio › aba Produtos:
   • seringa → Zerar valor em pacotes ✔ (já está nos R$ 100)
   • medicamento → Zerar valor em pacotes ✘ (cobra à parte)
4. Clique em Salvar (cabeçalho do convênio).

✅ Resultado: 100 + 50 = R$ 150,00.
Se marcar o medicamento como zerado também: R$ 100,00. ✅ Em produção desde 23/09/2026

Receita F — O convênio não cobre um item

No convênio, clique em Liberar para edição, desmarque Utiliza naquele produto, taxa ou serviço e clique em Salvar. O item fica sem receita naquele convênio (o custo continua contando no Farol). Lembre: Utiliza = o convênio cobre — marque em tudo que o convênio cobre, senão o item fica sem receita.

✅ Em produção desde 23/09/2026 No orçamento, o item sem Utiliza entra a R$ 0,00 (tem custo, não tem receita), em vez de ser cobrado pelo preço da casa como era antes. Se for um subserviço sem Utiliza, ele e tudo que está dentro dele entram a R$ 0,00.

Receita G — Item gratuito para um convênio

No convênio, clique em Liberar para edição e, na linha azul 🔁 do item, digite 0,00 (zero é zero) e clique em Salvar.

Receita H — Todos os medicamentos do convênio seguem uma tabela + percentual

"Convênio Gama: medicamentos pela tabela de referência + 15%".

🔓 Este passo a passo altera o convênio. O convênio abre em modo consulta: dentro dele é sempre Liberar para edição → alterar → Salvar no cabeçalho do convênio (desde 01/10/2026 as abas só gravam no Salvar; a célula alterada fica destacada até lá — veja como funciona). Terminou? Bloquear edição.

1. Convênio Gama › clique em Liberar para edição › aba Dados do convênio › Política de Preço por Tipo de Produto › Adicionar.
2. Tipo de Produto = Medicamento · Fonte do Preço de Venda = a tabela desejada · Fator K = 15.
3. Clique em Salvar.

✅ Todos os medicamentos do Gama passam a seguir essa regra, exceto os que tiverem preço combinado próprio (linha azul preenchida na aba Produtos).

✅ Novo — 30/09/2026 Corrigido em 29/09/2026: as políticas de preço por tipo de produto agora carregam junto com a aba Dados. Antes, se elas demorassem a carregar, o Salvar mandava a lista vazia e inativava todas as políticas do convênio. Se as políticas de algum convênio "sumiram", confira e cadastre de novo. E salvar com campo inválido em outra aba agora avisa: "Não foi possível salvar: há campos inválidos na aba Dados do convênio".

Receita I — "Meu preço fixo já inclui os materiais": como configurar ✅ Novo — set/2026

"Curativo" = R$ 120,00 fechado no Convênio Delta, já com gaze, soro e a taxa de sala. Só a pomada especial é cobrada à parte.

🔓 Este passo a passo altera o convênio. O convênio abre em modo consulta: dentro dele é sempre Liberar para edição → alterar → Salvar no cabeçalho do convênio (desde 01/10/2026 as abas só gravam no Salvar; a célula alterada fica destacada até lá — veja como funciona). Terminou? Bloquear edição.

Desde 23/09/2026 os itens de um serviço sempre entram na conta. Sem mais nada, o Delta seria cobrado R$ 120,00 + gaze + soro + taxa de sala + pomada. Para dizer ao sistema "esses itens já estão dentro dos R$ 120":

Continua no manual completo ›

Implante você mesmo: etapa 10 — convênios

Do manual: abrir esta parte no manual completo ›

Por que agora: É aqui que o Rabi aprende quanto cada convênio paga. Por isso vem depois de taxas, produtos, serviços e colaboradores.

Onde no Rabi: Configurações › Convênios

1. Crie o convênio na operadora certa, com os planos, os prazos (pagamento, retorno, entrega de guias, autorização) e a Conta de recebimento.
2. Na aba Especialidades, marque Atende no que o convênio cobre e salve.
3. Preencha as abas de preço — Serviços, Produtos e Taxas — à mão ou por Excel. Marque Utiliza em tudo que o convênio cobre (sem Utiliza, o item vira custo sem receita). Deixe vazio o que não tem regra: vazio não é zero — 0,00 é preço zero de verdade, e não use 0,01 como marcador. Preço fechado? Marque Pacote e Zerar nos itens inclusos.
4. Depois de alterar, clique em Salvar no cabeçalho do convênio. Não use Copiar convênio para montar um convênio novo (#639) nem "Selecionar todos" nas colunas Retorno, Autorização e Pacote (ele só mexe no Utiliza).
5. Na aba CBOS, vincule os profissionais credenciados; se a operadora cobra algo à parte, use a aba Custos extras.
6. Por fim, monte a grade horária no cadastro de cada colaborador (Configurações › Colaboradores) e de cada equipamento agendável: dias, horários, unidade, local e convênios aceitos. Ela vem depois dos convênios porque lista os convênios aceitos. Sem grade, a agenda não abre horários.

✅ Pronto quando: Cada convênio tem dados, preços, profissionais credenciados e a grade está montada.

Veja também: Guia do implantador (preços) · Árvore de decisão do preço

Histórico de alterações do convênio

Do manual: abrir esta parte no manual completo ›

Botão Histórico (ícone de relógio, "Histórico de alterações da aba atual") no cabeçalho do Cadastro de Convênio, ao lado de Liberar para edição/Salvar (#638). Abre o histórico da aba em que você está ("Histórico — <aba>"); funciona também em modo consulta, em convênio desativado e para quem não pode editar. Na aba Farol abre o histórico geral.

• Na lista de convênios, o ícone "Histórico de alterações" de cada linha abre o Histórico do Convênio (todas as abas).
• Filtros: Subaba (no geral), Usuário (só quem alterou, inclusive alterações feitas por integração/API), Operação (Criação/Alteração/Remoção) e De/Até ("Até" abre em hoje).
• Cada linha mostra o item alterado; "Ver campos alterados" mostra antes e depois.

Novo — out/2026 Log de auditoria só com o campo alterado (#627, em produção desde 23/10/2026): o histórico mostra só o que mudou — antes e depois, quem e quando. A inclusão não lista campos vazios, e salvar sem mudar nada não gera registro. A conversão dos registros antigos é feita clínica a clínica: na sua clínica, os registros mais antigos ainda podem aparecer no formato anterior (com todos os campos).