1. Guia para a Clínica — como o RABI decide quanto cobrar

✅ Todas as regras de preço por convênio EM PRODUÇÃO (23–24/09/2026) — zero é zero; Utiliza = o convênio cobre (sem Utiliza entra no orçamento a R$ 0,00); os itens do serviço sempre entram na conta; "Zerar valor em pacotes" é por item e não desce em cascata; linha ✅ do serviço = valor do próprio serviço; Farol consolidado; tipo de atendimento por convênio; textos e valores finais convertidos; aba Farol › Itens com a conta de cada linha.
Novidades de 01–15/10/2026:
Novidades de 24–30/09/2026:
📖 Para quem conhece o dia a dia da clínica e não precisa entender de tecnologia. Leitura: 15 minutos. Voltar para a visão geral.

Parte 1 — A ideia, sem complicação

Pense numa tabela de preços com "exceções por convênio"

Toda clínica tem o seu preço "de balcão". E quase todo convênio negocia um preço diferente. O RABI guarda as duas coisas:

  1. O preço da casa — cadastrado no próprio serviço, produto ou taxa.
  2. O preço combinado com cada convênio — cadastrado dentro do convênio.

Quando alguém agenda, orça ou fatura, o sistema pergunta sempre na mesma ordem:

"Este convênio tem um preço combinado para este item?"
✔ Tem → usa o preço combinado.
✘ Não tem → "O convênio tem uma regra geral para este tipo de produto?"
✔ Tem → usa a regra geral.
✘ Não tem → usa o preço da casa.

São os 3 níveis. O mais específico sempre ganha.

   3º  Preço combinado do ITEM neste CONVÊNIO      ← ganha de todos
   2º  Regra geral do CONVÊNIO (só para produtos)
   1º  Preço da casa (cadastro do item)             ← usado quando não há nada acima
Diagrama dos 3 níveis de conversão: preço combinado do item no convênio ganha de todos; regra geral do convênio só para produtos; preço da casa quando não há nada acima
Os 3 níveis: o mais específico sempre ganha.

Deixar em branco é diferente de digitar zero

Você fezO sistema entende
Deixou o campo em branco"Aqui não tem regra. Use o nível de baixo."
Digitou 0,00"O preço é zero mesmo." (item gratuito para este convênio)
✅ Corrigido em 23/09/2026: o erro antigo "digitei 0,00 no serviço e veio o valor do cadastro" não acontece mais — agora 0,00 é preço zero mesmo, em todas as telas (Farol, agendamento, orçamento, pré-faturamento, contas a receber e XML). Na prática: para "sem preço combinado", deixe o campo vazio (botão Limpar valor); só digite 0,00 quando o item for realmente gratuito para o convênio. Se usou R$ 0,01 como marcador de "sem valor", limpe o campo.

As três linhas que aparecem na tela do convênio

Em Configurações › Convênios, nas abas Produtos, Serviços e Taxas, cada item mostra até três linhas:

O que você vêO que é
🔒 linha cinza com cadeadoO preço da casa. Só para consulta.
🔁 linha azul (ao passar o mouse: Convertido)É aqui que você digita o preço combinado com este convênio.
✅ linha verdeO valor que vai valer de verdade. Confira sempre esta linha.

Se a linha verde está certa, a cobrança vai sair certa. (No serviço, a linha verde é só o valor do próprio serviço; o total com os itens está no Farol — veja abaixo.)

✅ Em produção desde 24/09/2026 Não é só o preço: o nome, a descrição, o código e a tabela 87 que aparecem nas telas do convênio também já são os finais — o que foi digitado para este convênio; se estiver em branco, o do cadastro do item.

Atenção no serviço: a linha ✅ do serviço mostra o valor do próprio serviço (o que sai na linha do procedimento da guia). Os produtos e taxas dele aparecem nas abas deles. Quem soma tudo é a linha Σ da coluna Valor (abaixo, em produção desde 24/09) e o Farol (passe o mouse na bolinha para ver receita e custo).

Diagrama das três linhas de cada item na tela do convênio: linha cinza com cadeado (preço da casa), linha azul Convertido (onde se digita) e linha verde (valor efetivo)
As três linhas de cada item na tela do convênio — na coluna Valor do serviço há ainda a 4ª linha Σ (✅ em produção desde 24/09).

Na coluna Valor do SERVIÇO: quatro linhas ✅ em produção desde 24/09

Na aba Serviços do convênio, a coluna Valor do serviço mostra quatro linhas. Produtos, taxas e a coluna Tipo de Atendimento continuam com três. Passe o mouse em cada linha: uma dica explica o que ela é.

O que você vêO que é
🔒 linha cinza com cadeadoO preço da casa (cadastro). Se o serviço soma itens, aparece a soma dos itens a preço de casa, com a etiqueta "(soma dos itens)".
🔁 linha azulO valor combinado com este convênio — é aqui que você digita.
✅ linha verdeO valor do próprio serviço que vai na guia. Se o serviço soma itens e não tem valor combinado, aparece "0,00 (sem preço próprio: itens cobrados à parte)" — não é erro. A explicação do 0,00 aparece ao passar o mouse na linha ✅; um texto visível na própria linha chega no próximo ajuste.
Σ linha novaO total do serviço neste convênio: o serviço + os produtos, taxas e subserviços que entram na conta. É o que o convênio paga — o mesmo número do Farol e da guia. Confira sempre esta linha.

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

💉 Caso real: "Ferinject aplicado" no convênio Particular. O serviço tem a caixinha "Definir preço do serviço pelos itens" marcada (o preço é o medicamento + a aplicação). Na aba Serviços do Particular, a linha ✅ mostrava R$ 0,00 — e parecia erro.

Parte 2 — Os três tipos de item

Serviço (Configurações › Serviços)

Em Configurações › Serviços, na aba Dados do Serviço existe o campo Valor e, logo abaixo, a caixinha:

☐ Definir preço do serviço pelos itens. Se marcado, o valor do serviço será as taxas e produtos.
⚠️ Importante (em produção desde 23/09/2026): essa caixinha decide só o valor próprio do serviço. Em qualquer serviço — marcado ou não — os produtos, taxas e subserviços cadastrados nele entram na conta, cada um com o preço do convênio, exatamente como saem na guia. Então um serviço de preço fixo com composição cobra o valor fixo + os itens. Se o seu preço fixo já inclui os materiais, é preciso marcar Pacote no convênio — veja a Receita I.

Produto (Estoque › Produtos)

Em Estoque › Produtos, o preço do produto fica na aba Estoque:

CampoPara que serve
Preço de venda tabelaO preço de venda "da casa"
Fonte de PreçoDe onde vem o preço: uma tabela de preços, o preço fixo, a última compra, o preço médio ou a última pesquisa
Fator K/inflator/deflatorUm percentual para cima ou para baixo. 20 = +20% · -10 = −10% · 0 = não mexe
Última Compra / Padrão CalcularO custo do produto. Marcado = o sistema usa a última compra do estoque. Desmarcado = você digita o custo.
💡 O custo é tão importante quanto o preço: sem custo, o Farol fica roxo ("erro de preço/resultado").

Taxa (Configurações › Taxas)

Em Configurações › Taxas, a taxa tem só a coluna Valor. Clicando na linha, abre Convênios que utilizam esta taxa, onde você pode pôr o Valor Convênio.

Parte 3 — Dentro do convênio

Em Configurações › Convênios, abra o convênio.

🔒 Alterar um convênio: Liberar para edição → alterar → Salvar (no cabeçalho) ✅ Novo — 01/10/2026

Modo consulta (em produção desde 29/09/2026, #632). Todo convênio já cadastrado abre em modo consulta: dá para ver tudo, trocar de aba, filtrar, buscar, ordenar, paginar, expandir os itens do serviço, ver o Farol, abrir o Histórico e exportar — sem risco de mudar nada. A tela avisa: "Modo consulta. Para alterar, clique em Liberar para edição."

Para alterar (desde 01/10/2026 nada é gravado antes do Salvar):

  1. Clique em Liberar para edição (o botão passa a ser Bloquear edição). A faixa avisa: "Edição liberada. As alterações só são gravadas ao clicar em Salvar."
  2. Altere o que precisa. Nas abas Planos, Especialidades, Produtos, Serviços e Taxas a célula alterada fica destacada como pendente — ainda não foi gravada (a faixa mostra quantas linhas estão com alteração não salva).
  3. Clique em Salvar, no cabeçalho do convênio. Resposta: "N alteração(ões) das abas gravada(s)." Se algo falhar: "X gravada(s); Y não gravada(s): <motivo>" — o que falhou continua destacado para você corrigir e salvar de novo. Sem mudança: "Nenhuma alteração para salvar." (a aba Dados envia só os campos alterados).
  4. Terminou? Bloquear edição. Se ainda houver pendências, abre "Alterações não salvas" com Continuar editando / Descartar alterações / Salvar e bloquear.

Gravam na hora (não esperam o Salvar): as ações em massa — Selecionar/Desmarcar todos, Copiar e Importar Excel (com alteração pendente, o sistema pede antes: "Há alterações não salvas no convênio. Clique em Salvar (ou descarte em "Bloquear edição") antes de usar esta ação.") — e as abas Colaboradores, Custos extras, Farol e Dados Fiscais (NFS-e), que não entram no rascunho.

A liberação vale só nesta visita: trocar de convênio, sair ou recarregar a página volta ao modo consulta (não há bloqueio automático por tempo). Por isso todo passo a passo que altera um convênio é Liberar para edição → alterar → Salvar.

Casos especiais: convênio recém-criado abre liberado para preencher; sem permissão: "Modo consulta. Você não tem permissão para alterar convênios."; convênio desativado: "Convênio desativado: somente visualização. Reative-o para poder editar."; se parte dos dados não carregou: "Parte dos dados não carregou: nada foi gravado. Recarregue a tela antes de alterar." — a tela fica só leitura até carregar tudo (botão Recarregar a tela; salvar antes disso: "Aguarde o carregamento dos dados do convênio antes de salvar."); se outra pessoa gravou depois que você abriu a tela: "Este registro foi alterado por outra pessoa. Recarregue a tela antes de alterar." — nada é gravado por cima (#640). A API externa não passa pelo modo consulta.

✅ Novo — 02/10/2026 Histórico de alterações (#638): botão Histórico no cabeçalho do convênio (abre o histórico da aba atual; funciona também em modo consulta) e ícone Histórico de alterações em cada linha da lista de convênios (histórico geral). Filtros Subaba, Usuário (inclui alterações feitas pela API/integração), Operação (Criação/Alteração/Remoção) e De/Até; em cada linha, Ver campos alterados (antes e depois).

🟡 Cuidados que ainda valem (#639, parcial) O Selecionar/Desmarcar todos da aba Serviços só mexe no Utiliza, qualquer que seja a coluna escolhida (Retorno, Autorização, Pacote) — e grava na hora; nessas colunas, marque linha a linha. Não use "Copiar convênio" para montar um convênio (a correção dele não foi confirmada) — se já usou, confira tudo depois. Para passar de um convênio a outro, volte à lista e abra o próximo. Corrigido em 01–02/10/2026: marcar Utiliza/Autorização/Retorno/Pacote ou editar o código de um serviço não apaga mais o valor convertido; salvar a aba Dados não troca mais o prazo de autorização pelo limite de parcelas; data de reajuste vazia não vira mais 01/01/1970.

Histórico: até 29/09 as abas Serviços, Produtos e Taxas gravavam sozinhas ao sair do campo. Se notar um valor ou uma caixa alterados "sozinhos", use o botão Histórico para ver quem alterou e quando, e corrija. Em 29/09 as políticas de preço por tipo de produto passaram a carregar com a aba Dados (antes um Salvar podia inativá-las — confira as suas).

Aba "Dados do convênio"

CampoPara que serve
Pago no ato do atendimento?Ligado = convênio do tipo particular (o paciente paga na hora). É o que libera o Orçamento e o parcelamento.
Limite de Parcelas em Convênios ParticularesMáximo de parcelas
Política de Preço por Tipo de ProdutoA regra geral do convênio (nível 2). Ex.: "Medicamentos deste convênio = tabela X + 15%". Colunas: Tipo de Produto, Fonte do Preço de Venda, Fator K/inflator/deflator %. ✅ Novo — 15/10/2026 Com as referências oficiais de produto (#662, 1ª fase), o preço segue: conversão do produto no convênio > referências oficiais (bloco logo abaixo, se preenchido) > esta política. A carga de preços pela tela ainda não está disponível — confirme com o time Rabi (veja).
Conta de recebimento ✅ Novo — 12/10/2026A conta caixa em que entra o que o convênio paga — usada no Gerar Contas a Receber do lote. Sem ela no convênio e sem a "Conta Padrão de Recebimento de Convênios" nos Parâmetros, o sistema recusa.

Aba "Especialidades" ✅ Novo — 29/09/2026

Lista as especialidades médicas, com a coluna Atende: marque as especialidades que este convênio cobre.

🩺 Aba Especialidades do convênio (coluna Atende) — #628 🟡 Trava desligada no agendamento desde 06/10/2026

O #628 entrou em produção em 02/10, mas a trava no agendamento e no orçamento está desligada temporariamente desde 06/10/2026: hoje o sistema não filtra nem bloqueia profissionais, especialidades ou serviços pela especialidade do convênio ao agendar ou orçar (na autorização não há essa validação). A consulta de disponibilidade da IA (TalkMe, #633) é a exceção: ela respeita a coluna Atende — por isso a IA pode dizer que não há horário num caso que a recepção consegue agendar. Ao agendar, confira se o convênio cobre a especialidade.

No cadastro do convênio a coluna Atende vale: na aba Serviços, o serviço de especialidade que o convênio não atende aparece com a caixa desabilitada (laranja) e o chip "Não atendida" (ou "Não agenda", se já estava marcado) — não dá para marcar Utiliza; o "Selecionar todos" pula esses serviços; Copiar e Importar Excel os trazem desmarcados. Na aba Colaboradores entram só especialidades atendidas. ⚠️ Os textos dessa tela dizem que esses serviços "não podem ser usados no agendamento" e, ao desmarcar Atende, que "não poderão ser agendados por este convênio" — hoje isso não acontece: o agendamento não barra.

Regras (valem no cadastro e voltarão a valer no agendamento quando a trava for religada): convênio sem nenhuma especialidade marcada como Atende não restringe nada; serviço sem especialidade não passa pela trava; serviço ou profissional com várias especialidades é coberto se uma delas for atendida; desmarcar Atende não altera nada em cascata.

Faça já: marque Atende em cada especialidade que o convênio cobre — na implantação, antes de configurar serviços e profissionais do convênio (senão os serviços ficam "Não atendida" e não deixam marcar Utiliza). Em convênio já salvo: Liberar para edição → marcar → Salvar.

✅ Novo — 09/10/2026 🤖 IA de atendimento e painel de disponibilidade — o que manter em dia: o painel Disponibilidade por Convênio da Agenda passou a usar o catálogo de atendimento (#659, sem tela própria), com o mesmo veredito da agenda: grade que aceita o convênio, convênio com Utiliza no serviço, profissional, especialidade, local, serviço e equipamento ativos e serviço da especialidade da grade; os convênios por unidade vêm do cadastro Unidades do convênio. A IA (TalkMe) só oferece horários em grade que aceita o convênio e o serviço, confere a duração do serviço e recusa serviço inativo. ✅ Novo — 09/10/2026 a IA usa a consulta única de disponibilidade (#633): numa consulta só, ela verifica se há profissional da especialidade, que faz o procedimento, com agenda liberada para o convênio (sem mostrar horários — eles continuam vindo da agenda). 🟠 Roadmap a IA abrir autorização e orçamento (#660 — hoje ela não abre). Mantenha em dia: Atende convênio no cadastro do profissional; serviços e convênios (Incluir/Excluir) na grade; Utiliza nos serviços e Atende nas especialidades do convênio; e o convênio nas Unidades do convênio onde é atendido. Faltando algo, a IA pode dizer que não há atendimento mesmo que a recepção consiga agendar pela tela.

🤖 A IA de atendimento (TalkMe) e o painel de disponibilidade leem este cadastro ✅ Novo — 09/10/2026

Desde 09/10/2026 o painel Disponibilidade por Convênio da Agenda usa o catálogo de atendimento (#659 — não tem tela própria): o convênio só "atende" um serviço quando a grade aceita o convênio, o convênio tem Utiliza no serviço, o profissional, a especialidade, o local, o serviço e o equipamento estão ativos e o serviço é da especialidade da grade; os convênios de cada unidade vêm do cadastro Unidades do convênio. A IA só oferece horários em grade que aceita o convênio e o serviço. A IA usa, desde 09/10/2026, a consulta única de disponibilidade (#633): profissional da especialidade, que faz o procedimento, com agenda liberada para o convênio do paciente (inclusive paciente com dois convênios) — sem mostrar horários (eles vêm da agenda). 🟠 Roadmap a IA abrir autorização e orçamento (#660). ✅ Novo — 14/10/2026 🚦 O Farol também conta (#664): a IA não oferece serviço que o Farol bloqueia ou que exige aprovação (vermelho, roxo, amarelo com aprovação de nível 2) — esses se agendam pela recepção, com aprovação; e no painel Disponibilidade por Convênio, com um convênio no filtro, somem os serviços que o Farol bloqueia para ele.

Mantenha em dia: no cadastro do profissional, Atende convênio em cada convênio que ele atende; na grade do profissional, os serviços e os convênios (Incluir/Excluir); no convênio, Utiliza nos serviços cobertos e Atende nas especialidades; e o convênio nas Unidades do convênio onde é atendido. Faltando algo, a IA pode dizer que não há atendimento, mesmo que a recepção consiga agendar pela tela.

Abas "Produtos", "Serviços" e "Taxas"

Cada linha é um item. As caixinhas mais importantes:

CaixinhaO que significaEm palavras simples
UtilizaEste convênio cobre este itemDesmarcado = "este convênio não cobre isso": o item fica sem receita (o custo continua contando no Farol). Marque em tudo que o convênio cobre.
Valor / Valor Unitário (linha azul 🔁)O preço combinadoEm branco = usa o preço da casa. No serviço, muda só o preço do serviço — os itens somam por cima (não é pacote)
Pacote (só em Serviços)Neste convênio este serviço é um pacote"Um preço que já inclui coisas" — é o único jeito de o preço incluir itens. Só existe aqui, no convênio (não no cadastro do serviço)
Zerar valor em pacotesEste item já está dentro do preço de um pacote"Não cobrar de novo quando estiver dentro do pacote"
AutorizaçãoExige autorização prévia do convênio—
RetornoTem direito a retorno✅ Novo — 05/10/2026 Com o Prazo de Retorno em (Dias) preenchido no convênio: atendimento do mesmo serviço, pelo mesmo profissional, dentro do prazo vira retorno automaticamente e não gera valor (R$ 0 no atendimento, no pré-faturamento, no XML e no repasse); com outro profissional dentro do prazo, o agendamento é bloqueado. Ainda não vale para agendamento pela IA, online e encaixe adicional — confira esses à mão. Não existe senha para desmarcar o retorno.
OrçamentoServiço exige orçamento—
💡 "Zerar valor em pacotes" não apaga o preço do item. Se o mesmo medicamento for vendido sozinho, ele continua com o preço normal. Ele só fica a zero quando está dentro de um pacote de preço fechado (Pacote marcado + valor fixo ou valor combinado). E o zerar é por item e não desce em cascata: marcado só no medicamento, zera só o medicamento — a taxa de aplicação só zera se ela mesma estiver marcada. Um subserviço zerado perde só o próprio valor; o que está dentro dele continua entrando, cada item conforme o seu próprio "Zerar". Só a falta de Utiliza no subserviço tira tudo que está dentro dele. ✅ Em produção desde 24/09/2026
Diagrama com três exemplos de pacote: item zerado (dentro do preço), item não zerado (somado por cima) e serviço que só soma itens
Pacote: item zerado × item não zerado × serviço que só soma itens (valores ilustrativos).

Parte 4 — Receitas prontas: "quero cobrar assim, como configuro?"

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.

⚠️ Se o convênio paga um valor diferente pela aplicação, ponha esse valor em um lugar só: ou no serviço "Aplicação endovenosa" dentro do convênio, ou no valor do "Ferro aplicado" (valor combinado que soma por cima dos itens — não é pacote) — nunca nos dois, senão soma duas vezes.

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.

🧾 "Digitei um valor e os itens continuaram somando" → marque Pacote ✅ Regra vigente

Digitar um valor na linha azul 🔁 do serviço muda só o preço do serviço. Os itens (medicamento, aplicação, taxas) continuam somando por cima, cada um com o seu preço. Exemplo: valor combinado 100 → total = 100 + aplicação + medicamento.

Se o convênio paga um preço fechado que já inclui itens, abra o convênio, clique em Liberar para edição e faça os três passos:

  1. Digite o valor combinado na linha 🔁 do serviço (aba Serviços do convênio).
  2. Marque Pacote na linha do serviço.
  3. Marque Zerar valor em pacotes em cada item incluso (nas abas Produtos, Taxas ou Serviços do convênio). Item sem "Zerar" continua sendo cobrado à parte. Marcar Pacote não liga o Zerar dos itens sozinho (desde 25/09/2026, nem ao criar o vínculo) — marque item a item.
  4. Clique em Salvar no cabeçalho do convênio.

Sem Pacote marcado, o "Zerar valor em pacotes" dos itens nem é consultado. E lembre: pacote é sempre uma marcação no convênio — no cadastro do serviço não existe pacote, só preço fixo ou soma dos itens.

💊 Caso real: "Noripurum aplicado EV" no Bradesco. Pacote marcado, valor combinado 0,01. Dentro dele há o subserviço "Aplicação endovenosa promocional", marcado com Zerar valor em pacotes, e dentro desse subserviço 10 materiais e 5 taxas — entre elas a Taxa de sala de R$ 73,99, sem Zerar. Moral: se a taxa de sala já estivesse incluída no pacote, o certo seria marcar Zerar valor em pacotes na própria taxa. Veja a conta completa na Árvore de decisão.

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":

  1. Configurações › Serviços › "Curativo": caixinha "Definir preço do serviço pelos itens" desmarcada; Valor = 120,00 (ou deixe o da casa e digite 120,00 na linha azul 🔁 do convênio). Composição: gaze, soro, pomada (aba Produtos) e taxa de sala (aba Taxas).
  2. Convênio Delta › clique em Liberar para edição › aba Serviços › "Curativo": marque Utiliza e Pacote.
  3. Convênio Delta › aba Produtos: gaze e soro → Utiliza ✔ + Zerar valor em pacotes ✔; pomada → Utiliza ✔ + Zerar ✘ (cobra à parte).
  4. Convênio Delta › aba Taxas: taxa de sala → Utiliza ✔ + Zerar valor em pacotes ✔.
  5. Se algum item incluso estiver dentro de um subserviço, zere o próprio item — zerar o subserviço não zera o que está dentro dele.
  6. Clique em Salvar (cabeçalho do convênio).
  7. Confira: clique na seta do "Curativo" na aba Serviços (Expandir serviço) — gaze, soro e taxa aparecem esmaecidos, com Conta no total = Não e Motivo "Zerado em pacote"; a pomada com Sim. Os números são os mesmos da aba Farol › Itens.

✅ Resultado: R$ 120,00 + pomada. No orçamento, a quantidade prevista na composição de gaze, soro e taxa entra a R$ 0,00; se usar mais do que o previsto, só o excedente é cobrado.

⚠️ Sem Pacote, nem o preço fixo nem o valor combinado "incluem" nada. Serviço de preço fixo (ou com valor combinado) sem Pacote cobra o valor fixo + todos os itens com Utiliza na quantidade inteira (até 23/09 o orçamento embutia a composição e cobrava só o excedente — isso deixou de valer). E desmarcar Utiliza não é o jeito certo de "incluir" um item: sem Utiliza o item fica sem receita em todos os serviços daquele convênio, inclusive quando vendido sozinho.

Receita J — Trocar ou excluir um produto ou uma taxa que está dentro de serviços ✅ Novo — 26/09/2026

✅ Desde 02/10/2026 o sistema protege a composição ✅ Novo — 02/10/2026 (#626): se o produto ou a taxa estiver dentro de algum serviço ativo, a exclusão (ou inativação) é recusada com a mensagem "Não é possível excluir" e a lista dos serviços (Serviço / Código / Quantidade), cada um com link. Serviço inativo não impede.
  1. Tente excluir: se o item estiver em uso, a tela mostra em quais serviços ele está (clique no link de cada um — abre em nova aba).
  2. Substitua o item nesses serviços (Configurações › Serviços › abas Produtos/Taxas) pelo novo produto ou taxa — ou retire-o.
  3. Nos convênios: Liberar para edição → marque Utiliza (e, se for pacote, Zerar) do substituto → Salvar.
  4. Exclua o item antigo (agora passa) e confira com o Expandir serviço.

Histórico: até 02/10/2026 a exclusão era livre e o item sumia da composição sem aviso. Se a clínica excluiu itens antes disso e algum serviço passou a cobrar menos, recoloque o item (ou o substituto) na composição.

Receita K — A operadora cobra um custo à parte (ex.: 5% sobre o que paga) ✅ Novo — 12/10/2026

"Uma operadora desconta 5% de taxa administrativa de tudo o que paga" — ou "neste convênio, o serviço X usa um prestador terceiro que cobra R$ 40 por sessão".

Desde 12/10/2026 (#655) esses custos entram no Farol, para a margem mostrar o que sobra de verdade. Eles não mudam o que é cobrado (guia, XML) nem o repasse pago.

  1. Configurações › Convênios › abra o convênio › clique em Liberar para edição › aba Custos extras › Novo custo extra.
  2. Descrição = "Taxa administrativa"; Tipo = Percentual da receita; Percentual (%) = 5; Incide sobre = Tudo (serviços, produtos e taxas) — ou só o que o contrato diz; Credor (fornecedor) e Grupo do DRE, se quiser; vigência (vazio = "Sempre"). Esta aba grava na hora — não precisa do Salvar do cabeçalho.
  3. Prestador terceiro? Aba Serviços › expanda a linha do serviço › painel Serviços extras: Prestador (do cadastro de Fornecedores), Descrição, Valor por execução, quantidade e vigência.
  4. Confira: passe o mouse no Farol do serviço — a composição mostra Produtos, Custo extra do convênio, Prestadores, Repasse, Custo total, Receita e Índice.

✅ Resultado: o Farol passa a considerar o custo novo. O bloqueio por esses custos vem desligado: só passa a valer se alguém marcar "Custos extras (convênio, prestadores e repasse) também bloqueiam" em Configurações › Parâmetros › Orçamento — antes, use o botão "Ver serviços que mudam de cor" na mesma tela. Detalhes na Visão Geral.

Parte 5 — O que acontece depois, em cada tela

Diagrama do caminho do valor: agendamento, orçamento e autorização calculam na hora; o atendimento congela; pré-faturamento e lote/XML usam os valores congelados
Do cadastro até a guia: onde o sistema calcula e onde congela os valores.
MomentoO que o sistema faz com os preços
AgendamentoMostra o serviço e os produtos/taxas dele já com o valor do convênio. O botão Custos do agendamento mostra custo, preço e margem.
Orçamento (convênios "Pago no ato")Lista cada item com Preço Unit. Venda e Preço Total Venda, calcula o total e o Farol. Farol vermelho pode impedir de salvar; amarelo pode pedir aprovação de um responsável.
AutorizaçãoMostra os "dados de conversão" e o Farol de cada item (só para orientar). Quem pode bloquear é o Farol consolidado da autorização (soma de tudo), não a cor de um item isolado.
AtendimentoTira uma fotografia dos valores naquele momento. Mudar o cadastro depois não mexe no que já foi atendido.
Pré FaturamentoMostra o Valor da Guia. Dá para corrigir valor por valor, Anular um item (item anulado não entra no total nem no XML) ou usar Atualizar Valores em Massa para refazer a fotografia com os preços atuais.
Administrar LotesFecha o lote e gera o XML para o convênio com a soma de serviço + taxas + produtos.

O semáforo (Farol)

O Farol compara quanto entra com quanto custa: (Receita ÷ Custo) × 100.
Exemplo: 120 significa que a receita é 20% maior que o custo.

Os limites são definidos em Configurações › Parâmetros › aba Valores:
Índice abaixo do Vermelho → bloqueado | do Vermelho (inclusive) até o Amarelo → aviso | Acima do Amarelo → aprovado. (Desde 12/10/2026, índice exatamente no limite do vermelho é amarelo.)

✅ Novo — 12/10/2026 O custo do Farol ficou mais completo: além dos produtos, entram os custos extras do convênio, os prestadores (Serviços extras) e o repasse do profissional (sem profissional escolhido, o maior repasse entre quem atende). Por isso a cor de alguns serviços pode mudar — e serviços sem produto, que ficavam sem cor, passam a ter cor. Os valores cobrados não mudam (Receita K).

✅ Desde 23/09/2026 o Farol do orçamento é do CONJUNTO — e não mais a cor mais crítica entre os serviços: ele soma o que o convênio paga por todos os itens e divide pelo custo de todos os produtos (desde 12/10, mais custos extras, prestadores e repasse). Um serviço vermelho sozinho não bloqueia se o conjunto fecha verde. Para achar o serviço que está puxando o resultado, olhe a cor de cada linha — ela continua aparecendo, só para orientar.
🟣 Roxo não é margem ruim — é cadastro incompleto (há produto com custo 0, sem custo cadastrado, ou falta preço). Corrija o cadastro. "Sem cor" (desde 12/10) só quando o custo total é 0.

Aba Farol › Itens: cada linha mostra a sua própria conta ✅ Em produção desde 24/09/2026

Em Configurações › Convênios › abra o convênio › aba Farol › sub-aba Serviços › clique no serviço › sub-aba Itens. Ali aparece a árvore do serviço — o próprio serviço, os subserviços, os produtos e as taxas — e cada linha mostra só a conta dela:

LinhaO que ela mostra
Produto ou taxaO valor que de fato entrou (zero, se ficou fora), o custo, a receita, a margem e o farol só daquele item.
SubserviçoO total do que está dentro dele (ele mesmo + seus produtos e taxas).
Serviço (a linha de cima)O total do serviço — é o número que o Farol usa.

A coluna Conta no total diz Sim (entrou na receita) ou Não (ficou fora — porque o convênio não o utiliza, ou porque está zerado dentro de um pacote de preço fechado). Um subserviço zerado aparece com "Não" só na linha dele; os itens dentro dele mostram cada um o seu.

Expandir serviço: o jeito mais rápido de conferir ✅ Novo — 26/09/2026

Concluído em 25/09/2026. Na aba Serviços do convênio — ou na aba Convênios do cadastro do serviço (Configurações › Serviços › [serviço]) — clique na seta da linha do serviço. Abre a árvore do serviço naquele convênio, como sai na guia, sem sair da tela:

Use para responder, em segundos, "o que a guia vai cobrar?" e "por que este serviço está vermelho?". Na aba Convênios do serviço você ainda vê, lado a lado, o Farol (linha colorida) e o valor ✅ que vai na guia em cada convênio.

A sub-aba Farol › Serviços, que chegou a mostrar "0 registros" para todos os convênios, foi corrigida.

Parte 6 — Conferência em 5 minutos

  1. Configurações › Convênios › abra o convênio › abas Produtos/Serviços/Taxas → no modo consulta (é assim que o convênio abre; nada é gravado — veja), olhe a linha verde ✅ dos itens mais usados. No serviço, confira também o total: na linha Σ da coluna Valor (✅ em produção desde 24/09) ou no Farol.
  2. Aba Serviços do convênio › clique na seta dos serviços mais usados (Expandir serviço) → é a forma recomendada de ver o que a guia vai cobrar: cada item com o seu farol; o que ficou fora aparece esmaecido com o Motivo. Serviço vermelho? É aqui que se descobre qual item está puxando a conta.
  3. Para varrer todos os serviços de uma vez: aba Farol do convênio › sub-aba Serviços → clique no serviço para ver Itens: cada linha mostra a própria conta e a coluna Conta no total mostra o que entrou na soma (veja acima).
  4. Relatórios › Agenda › Validação de Configuração Por Convênio → imprime tudo que está configurado (Valor, Utiliza, Pacote, Zerar Valor).
  5. Faça um orçamento ou agendamento de teste e abra Custos (desde 12/10 mostra também "Custo do convênio", "Prestador" e "Repasse").
  6. Se a operadora cobra custos à parte, confira a aba Custos extras do convênio (Receita K).

Os erros mais comuns

SintomaCausa provávelSolução
Item sumiu da conta do convênioUtiliza desmarcadoMarcar Utiliza
Valor veio o da casa, não o do convênioLinha azul 🔁 em brancoDigitar o valor combinado
Valor veio zeroDigitaram 0,00 onde deveria ficar em branco (desde 23/09/2026, 0,00 é preço zero mesmo, em todas as telas). Se for a linha ✅ de um serviço que soma itens sem valor combinado, o 0,00 é normal — os itens são cobrados à parteLimpar o campo (botão Limpar valor (vazio))
Digitei 0,00 no serviço e veio o valor do cadastroComportamento antigo — corrigido em 23/09/2026, não acontece maisNada a fazer. Se a intenção era "sem preço combinado", deixe o campo vazio
Pacote somando o medicamento por cimaFaltou Zerar valor em pacotes no medicamento ou faltou Pacote no serviçoMarcar os dois
Digitei um valor combinado no serviço e os itens continuaram somandoValor combinado não é pacote: muda só o preço do serviço. Faltou marcar PacoteMarcar Pacote no serviço + Zerar valor em pacotes nos itens inclusos (quadro)
A linha ✅ do serviço mostra 0,00Serviço que soma itens sem valor combinado: não tem preço próprio (os itens são cobrados à parte)Nada a fazer. O total está na linha Σ da coluna Valor (em produção desde 24/09) e no Farol
Serviço de preço fixo passou a cobrar materiais e taxas por cima (desde 23/09/2026)Os itens sempre entram; o preço fixo sem Pacote não inclui nadaSe o preço já os inclui: Pacote no serviço + Zerar valor em pacotes nos itens inclusos (Receita I)
Zerei o subserviço e a taxa de dentro dele continua cobradaZerar é por item e não desce em cascata (desde 24/09/2026)Zerar também a taxa, se estiver inclusa no pacote
A taxa (ou o material) deixou de ser cobrada num serviçoO item saiu da composição — por exemplo, excluído antes de 02/10/2026, quando a exclusão era livre (hoje o sistema recusa excluir item em uso)Recolocar o item (ou o substituto) na composição do serviço (Receita J)
Não consigo excluir um produto/taxa: aparece "Não é possível excluir"O item está na composição de serviço ativo (#626, desde 02/10/2026)Substituir ou retirar o item nos serviços listados e tentar de novo (Receita J)
Serviço com farol vermelho e não sei por quêAlgum item com custo alto, sem Utiliza ou zerado em pacoteClique na seta do serviço (Expandir serviço) e veja o farol e o Motivo de cada item
Não consigo alterar nada no convênio / aparece "Modo consulta. Para alterar, clique em Liberar para edição."O convênio abre em modo consulta (desde 29/09/2026)Clique em Liberar para edição (veja como funciona)
Alterei, saí da tela e a alteração não ficouDesde 01/10/2026 as abas Planos, Especialidades, Produtos, Serviços e Taxas só gravam no Salvar do cabeçalhoLiberar para edição → alterar → Salvar; confira a mensagem "N alteração(ões) das abas gravada(s)"
"Este registro foi alterado por outra pessoa. Recarregue a tela antes de alterar."Outra pessoa gravou o convênio depois que você abriu a tela (nada foi gravado por cima)Recarregue a tela, confira o que mudou (botão Histórico) e refaça a sua alteração
Usei "Selecionar todos" na coluna Retorno/Autorização/Pacote e mudou o UtilizaLimitação atual (#639): o "Selecionar/Desmarcar todos" da aba Serviços só mexe no Utiliza — e grava na horaCorrija o Utiliza e marque Retorno/Autorização/Pacote linha a linha
A cor do Farol mudou sem eu mexer no preço (desde 12/10/2026)O custo passou a incluir custos extras, prestadores e repasse do profissionalNada a corrigir no preço; confira a composição no Farol (Receita K)
Aparece "Você não tem permissão para alterar convênios"Seu usuário só pode consultar convêniosPeça a alteração a quem tem permissão, ou peça a permissão ao administrador
Um valor ou uma caixinha do convênio mudou "sozinho" (até 29/09) depois que alguém só foi consultarAté 29/09 as abas Serviços, Produtos e Taxas gravavam ao sair do campo, apertar Enter ou clicar numa caixa. Hoje o convênio abre em modo consultaVeja no botão Histórico quem alterou; Liberar para edição → corrigir → Salvar
As políticas de preço por tipo de produto do convênio ficaram inativas depois de um SalvarFalha corrigida em 29/09/2026 (o Salvar mandava a lista vazia quando as políticas demoravam a carregar)Conferir a aba Dados do convênio e recadastrar as políticas (Receita H)
Aplicação cobrada duas vezesValor posto no serviço e no subserviçoDeixar em um só
Farol roxoProduto com custo 0 (sem custo cadastrado)Informar custo (aba Estoque › Última Compra)
Mudei o preço e a guia antiga não mudouAtendimento congela valoresPré Faturamento › Atualizar Valores em Massa

Continue por aqui: Visão Geral · Guia do Implantador · Guia para IA · Árvore de decisão do cadastro