1. Guia para a Clínica — como o RABI decide quanto cobrar
- ✅ Novo — 12/10/2026 Custos extras do convênio, Serviços extras (prestadores) e repasse no custo do Farol (#655): a cor do Farol de alguns serviços pode mudar — fica mais realista; os valores cobrados não mudam (guia, XML, repasse pago); o bloqueio pelos custos novos vem desligado (veja).
- ✅ Novo — 01/10/2026 Nas abas do convênio, nada é gravado antes do Salvar no cabeçalho: Liberar para edição → alterar → Salvar; ações em massa gravam na hora. E o botão Histórico mostra quem alterou o quê (#638) (veja).
- ✅ Novo — 02/10/2026 Produto ou taxa em uso num serviço não pode mais ser excluído (#626) (veja).
- 🟡 Parcial Especialidades do convênio (#628): a coluna Atende vale no cadastro do convênio, mas a trava no agendamento está desligada desde 06/10 (veja). #639: não use "Copiar convênio"; "Selecionar todos" só mexe no Utiliza.
- ✅ Novo — 15/10/2026 Referências oficiais de produto — 1ª fase (#662): SIMPRO, Brasíndice, CMED, TUSS e outras no produto (aba Referências oficiais) e no convênio (bloco Referências oficiais por tipo de produto). Nasce o nível 2 de referência oficial: a ordem do preço do produto passa a ser conversão do produto no convênio > referências oficiais > política de preço > cadastro. Cuidado: a importação por planilha foi retirada da tela em 15/10 — a carga de preços pela tela ainda não está disponível; confirme com o time Rabi. Convênio sem o bloco preenchido não muda (veja).
- ✅ Novo — 30/09/2026 O convênio abre em modo consulta (#632, em produção desde 29/09): consultar ficou seguro — nada é gravado. Para alterar, clique em Liberar para edição; por isso todas as receitas abaixo começam por esse clique (veja como funciona). Junto veio uma correção: as políticas de preço por tipo de produto passam a carregar com a aba Dados — antes, se demorassem, o Salvar podia inativar todas as políticas do convênio (Receita H).
- ✅ Novo — 30/09/2026 IA de atendimento (TalkMe): a clínica já deve manter em dia Utiliza nos serviços e Atende nas especialidades do convênio — a IA usa esse cadastro para dizer se há atendimento (veja o que conferir).
- ✅ Novo — 29/09/2026 Revise a aba Especialidades de todos os convênios: com o #628 (roadmap) a marcação Atende vai passar a valer (veja por quê). No Expandir serviço, a bolinha do Farol de cada linha mostra margem, receita e custo ao passar o mouse.
- ✅ Regra vigente Valor combinado não é pacote: digitar um valor no serviço muda só o preço do serviço — os itens continuam somando. Para o valor já incluir itens, marque Pacote (veja o quadro).
- ✅ em produção desde 24/09 A coluna Valor do serviço tem 4 linhas, com o total do serviço no convênio (veja a tabela).
- ✅ Novo — 26/09/2026 Expandir serviço concluído: clique na seta do serviço e veja o que a guia vai cobrar, item por item, com o motivo de cada item que ficou fora (veja como). Marcar só Pacote não liga mais o Zerar sozinho. E cuidado ao excluir produto ou taxa que está dentro de serviços (Receita J).
- ✅ Atualização 13/10/2026: o bloqueio de exclusão de produto/taxa em uso (#626) entrou em produção em 02/10; a coluna Atende das especialidades (#628) passou a valer no cadastro do convênio em 02/10, mas a trava no agendamento está desligada desde 06/10; a consulta única de disponibilidade da IA (#633) está em produção desde 09/10 — veja as novidades de outubro, acima.
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:
- O preço da casa — cadastrado no próprio serviço, produto ou taxa.
- 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
Deixar em branco é diferente de digitar zero
| Você fez | O 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) |
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 cadeado | O 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 verde | O 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).
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 cadeado | O 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 azul | O valor combinado com este convênio — é aqui que você digita. |
| ✅ linha verde | O 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 nova | O 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.
- Não é erro: um serviço que soma itens não tem preço próprio. Quem tem preço são os itens dentro dele. Na guia, a linha do procedimento sai 0 e o medicamento e a aplicação saem nas áreas deles.
- Com as 4 linhas (em produção desde 24/09): 🔒 mostra a soma dos itens a preço de casa "(soma dos itens)"; 🔁 fica vazia; ✅ mostra 0,00 — a explicação "0,00 (sem preço próprio: itens cobrados à parte)" aparece hoje ao passar o mouse na linha ✅ (um texto visível na própria linha chega no próximo ajuste); e Σ mostra o total que o Particular paga (medicamento + aplicação) — o mesmo número do Farol.
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.
- Desmarcada → o serviço tem preço fixo (valor próprio): vale o que está no campo Valor.
Exemplo: Consulta = R$ 300,00. - Marcada → o serviço não tem preço próprio (valor próprio = zero): vale a soma do que tem dentro (abas Produtos, Taxas e Servicos). O campo Valor fica bloqueado.
Exemplo: "Ferro aplicado na veia" = o medicamento + a aplicação.
Produto (Estoque › Produtos)
Em Estoque › Produtos, o preço do produto fica na aba Estoque:
| Campo | Para que serve |
|---|---|
| Preço de venda tabela | O preço de venda "da casa" |
| Fonte de Preço | De 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/deflator | Um percentual para cima ou para baixo. 20 = +20% · -10 = −10% · 0 = não mexe |
| Última Compra / Padrão Calcular | O custo do produto. Marcado = o sistema usa a última compra do estoque. Desmarcado = você digita o custo. |
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.
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):
- 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."
- 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).
- 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).
- 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"
| Campo | Para 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 Particulares | Máximo de parcelas |
| Política de Preço por Tipo de Produto | A 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/2026 | A 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.
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.
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:
| Caixinha | O que significa | Em palavras simples |
|---|---|---|
| Utiliza | Este convênio cobre este item | Desmarcado = "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 combinado | Em 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 pacotes | Este item já está dentro do preço de um pacote | "Não cobrar de novo quando estiver dentro do pacote" |
| Autorização | Exige autorização prévia do convênio | — |
| Retorno | Tem 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çamento | Serviço exige orçamento | — |
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.
- Configurações › Serviços › abra o serviço.
- Campo Valor =
300,00. Caixinha "Definir preço do serviço pelos itens" desmarcada. - 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.
- Faça a Receita A.
- Configurações › Convênios › Convênio Alfa › clique em Liberar para edição › aba Serviços › encontre a consulta.
- Na linha azul 🔁 da coluna Valor, digite
180,00. Marque Utiliza. - Clique em Salvar (cabeçalho do convênio).
- 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.
- Cadastre o medicamento em Estoque › Produtos, com preço e custo (aba Estoque).
- Cadastre o serviço "Aplicação endovenosa" com Valor =
80,00(preço fixo). - 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.
- 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.
- Monte o serviço como na Receita C.
- 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. - 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.)
- 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.
- 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.
- Clique em Salvar (cabeçalho do convênio) — as alterações das abas só são gravadas aí.
- 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.
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:
- Digite o valor combinado na linha 🔁 do serviço (aba Serviços do convênio).
- Marque Pacote na linha do serviço.
- 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.
- 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.
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.
- Antes (até 23/09): zerar o subserviço levava junto tudo que estava dentro dele. A taxa de sala sumia da receita: o Farol mostrava R$ 16,03 de receita × R$ 24,74 de custo → vermelho, mesmo a guia cobrando a taxa.
- Agora (desde 24/09): o subserviço perde só o próprio valor; a taxa de sala (sem Zerar) entra. A receita sobe para pelo menos R$ 90,02 (16,03 + 73,99) contra os mesmos R$ 24,74 de custo → verde. E a linha ✅ do serviço mostra
0,01(o valor do próprio serviço), não mais 16,03.
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.
- Serviço com Valor =
100,00(caixinha "definir pelos itens" desmarcada). Adicione seringa e medicamento na aba Produtos. - No convênio › clique em Liberar para edição › aba Serviços: marque Utiliza e Pacote.
- No convênio › aba Produtos:
- seringa → Zerar valor em pacotes ✔ (já está nos R$ 100)
- medicamento → Zerar valor em pacotes ✘ (cobra à parte)
- 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.
- Convênio Gama › clique em Liberar para edição › aba Dados do convênio › Política de Preço por Tipo de Produto › Adicionar.
- Tipo de Produto = Medicamento · Fonte do Preço de Venda = a tabela desejada · Fator K =
15. - 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":
- Configurações › Serviços › "Curativo": caixinha "Definir preço do serviço pelos itens" desmarcada; Valor =
120,00(ou deixe o da casa e digite120,00na linha azul 🔁 do convênio). Composição: gaze, soro, pomada (aba Produtos) e taxa de sala (aba Taxas). - Convênio Delta › clique em Liberar para edição › aba Serviços › "Curativo": marque Utiliza e Pacote.
- Convênio Delta › aba Produtos: gaze e soro → Utiliza ✔ + Zerar valor em pacotes ✔; pomada → Utiliza ✔ + Zerar ✘ (cobra à parte).
- Convênio Delta › aba Taxas: taxa de sala → Utiliza ✔ + Zerar valor em pacotes ✔.
- 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.
- Clique em Salvar (cabeçalho do convênio).
- 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.
Receita J — Trocar ou excluir um produto ou uma taxa que está dentro de serviços ✅ Novo — 26/09/2026
- 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).
- Substitua o item nesses serviços (Configurações › Serviços › abas Produtos/Taxas) pelo novo produto ou taxa — ou retire-o.
- Nos convênios: Liberar para edição → marque Utiliza (e, se for pacote, Zerar) do substituto → Salvar.
- 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.
- Configurações › Convênios › abra o convênio › clique em Liberar para edição › aba Custos extras › Novo custo extra.
- 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. - 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.
- 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
| Momento | O que o sistema faz com os preços |
|---|---|
| Agendamento | Mostra 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ção | Mostra 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. |
| Atendimento | Tira uma fotografia dos valores naquele momento. Mudar o cadastro depois não mexe no que já foi atendido. |
| Pré Faturamento | Mostra 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 Lotes | Fecha 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).
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:
| Linha | O que ela mostra |
|---|---|
| Produto ou taxa | O valor que de fato entrou (zero, se ficou fora), o custo, a receita, a margem e o farol só daquele item. |
| Subserviço | O 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:
- Uma linha por item (serviço, subserviço, produto, taxa), com código, Tabela 87, quantidade, custo, receita e o farol de cada linha. A linha do subserviço mostra o total do que está dentro dele.
- O 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".
- Os números são os mesmos da aba Farol › Itens e da bolinha do Farol. Alterou valor, Pacote ou Zerar na linha do serviço e salvou? A lista expandida se atualiza sozinha.
- ✅ Novo — 29/09/2026 Passe o mouse na bolinha do Farol de qualquer 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: o total do serviço no convênio é a linha Σ da coluna Valor (veja a tabela).
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
- 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.
- 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.
- 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).
- Relatórios › Agenda › Validação de Configuração Por Convênio → imprime tudo que está configurado (Valor, Utiliza, Pacote, Zerar Valor).
- 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").
- Se a operadora cobra custos à parte, confira a aba Custos extras do convênio (Receita K).
Os erros mais comuns
| Sintoma | Causa provável | Solução |
|---|---|---|
| Item sumiu da conta do convênio | Utiliza desmarcado | Marcar Utiliza |
| Valor veio o da casa, não o do convênio | Linha azul 🔁 em branco | Digitar o valor combinado |
| Valor veio zero | Digitaram 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 à parte | Limpar o campo (botão Limpar valor (vazio)) |
Digitei 0,00 no serviço e veio o valor do cadastro | Comportamento antigo — corrigido em 23/09/2026, não acontece mais | Nada a fazer. Se a intenção era "sem preço combinado", deixe o campo vazio |
| Pacote somando o medicamento por cima | Faltou Zerar valor em pacotes no medicamento ou faltou Pacote no serviço | Marcar os dois |
| Digitei um valor combinado no serviço e os itens continuaram somando | Valor combinado não é pacote: muda só o preço do serviço. Faltou marcar Pacote | Marcar Pacote no serviço + Zerar valor em pacotes nos itens inclusos (quadro) |
| A linha ✅ do serviço mostra 0,00 | Serviç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 nada | Se 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 cobrada | Zerar é 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ço | O 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 pacote | Clique 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 ficou | Desde 01/10/2026 as abas Planos, Especialidades, Produtos, Serviços e Taxas só gravam no Salvar do cabeçalho | Liberar 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 Utiliza | Limitação atual (#639): o "Selecionar/Desmarcar todos" da aba Serviços só mexe no Utiliza — e grava na hora | Corrija 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 profissional | Nada 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ênios | Peç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 consultar | Até 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 consulta | Veja 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 Salvar | Falha 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 vezes | Valor posto no serviço e no subserviço | Deixar em um só |
| Farol roxo | Produto com custo 0 (sem custo cadastrado) | Informar custo (aba Estoque › Última Compra) |
| Mudei o preço e a guia antiga não mudou | Atendimento congela valores | Pré Faturamento › Atualizar Valores em Massa |
Continue por aqui: Visão Geral · Guia do Implantador · Guia para IA · Árvore de decisão do cadastro