Preços e Conversão de Valores — Visão Geral

✅ Todas as regras de preço por convênio EM PRODUÇÃO (23–24/09/2026) — zero é zero; Utiliza = o convênio cobre; taxas, produtos e subserviços sempre entram na conta do serviço; "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 em todas as telas do convênio; aba Farol › Itens com a conta de cada linha. Não resta nenhuma regra de preço pendente de ativação (série 22–24/09) — e a coluna Valor do serviço com 4 linhas (linha Σ = total do serviço no convênio) está ✅ em produção desde 24/09.
✅ Atualização 13/10/2026: as regras de preço não mudaram; mudou o custo que o Farol usa — desde 12/10 ele soma também os custos extras do convênio, os prestadores e o repasse do profissional (veja).

Novidades de 01–15/10/2026:

• ✅ 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).

Novidades de 24–30/09/2026:

• ✅ 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 (veja como funciona).
• ✅ Novo — 30/09/2026 IA de atendimento (TalkMe): Utiliza nos serviços e Atende nas especialidades do convênio também alimentam a consulta de disponibilidade da IA (#633, roadmap) — mantenha em dia (veja). ✅ Atualização 13/10: em produção desde 09/10/2026.
• ✅ Regra vigente Valor combinado NÃO é pacote. Digitar um valor na linha 🔁 do serviço muda só o preço do serviço; os itens continuam somando por cima. Para um preço fechado que já inclui itens: valor combinado + Pacote + Zerar valor em pacotes nos itens inclusos (veja abaixo).
• ✅ em produção desde 24/09 A coluna Valor da aba Serviços do convênio tem 4 linhas — com a linha Σ mostrando o total do serviço no convênio (veja abaixo).
• ✅ 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.

💰 Este é o coração financeiro do sistema. Tudo o que a clínica cobra — no orçamento, na autorização, no agendamento, na guia e no XML enviado ao convênio — nasce das configurações explicadas aqui.
Atualizado em 15/10/2026. As regras de serviço composto (somar itens, pacote, zerar valor em pacotes, Utiliza) descritas aqui são as da regra única (definida em 18/09/2026 e refinada em 22–23/09/2026), em produção desde 23–24/09/2026. Onde o comportamento anterior era diferente, isso está sinalizado como histórico.

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

✅ Novo — 15/10/2026 Referências oficiais de produto — 1ª fase (#662, em produção desde 15/10/2026). O preço do produto ganhou um degrau entre a conversão do item e a política de preço — o nível 2 de referência oficial:

1. Conversão do produto no convênio (nível 3 — aba Produtos do convênio) — se preenchida, ganha.
2. Referências oficiais — se o convênio tiver, em Dados do convênio, o bloco Referências oficiais por tipo de produto (código, descrição e preço) para o tipo do produto: preço da edição vigente da publicação ÷ fator de conversão × (1 + ajuste %) — o Fator K da linha do convênio substitui o ajuste; arredondado ao centavo.
3. Política de Preço por Tipo de Produto (nível 2 de sempre).
4. Cadastro do produto (nível 1).

O mesmo vale para o código (item do convênio > código principal da publicação > cadastro) e para a descrição (item > descrição oficial, se marcado > cadastro). Vale no Farol, orçamento, autorização, atendimento, pré-faturamento, guia e XML. Convênio sem esse bloco preenchido continua exatamente como antes. Onde fica: Estoque › Referências oficiais (publicações, edições e preços), Estoque › Produtos › aba Referências oficiais (código, descrição oficial, unidade e fator de cada produto) e o bloco no convênio (com simulação de um produto; respeita o Liberar para edição).

⚠️ Cuidado (1ª fase): a importação por planilha (códigos, preços, políticas) e o "Baixar modelo" foram retirados da tela em 15/10 e o preço não se digita na aba do produto. Hoje a carga de preços do nível 2 pela tela não está disponível — confirme com o time Rabi antes de contar com ele. Até lá, use a política de preço e as tabelas de preços internas.

✅ Desde 23/09/2026 essa regra vale de verdade em todas as telas. Antes, o Farol e várias telas tratavam 0,00 no valor convertido do serviço como se fosse vazio — corrigido. Agora 0,00 é preço zero mesmo na aba Farol, na linha ✅ da aba Serviços, no agendamento, no orçamento, no pré-faturamento, nas contas a receber e no XML. Quem usou R$ 0,01 como marcador de "sem valor" deve limpar o campo (deixar vazio).

🔒 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 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. ✅ 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.

valor do serviço = VALOR PRÓPRIO + soma dos ITENS que entram

VALOR PRÓPRIO = valor convertido do serviço no convênio (nível 3), se preenchido (inclusive 0)
                senão: 0 se o serviço "soma itens" · ou o Valor do cadastro se é de preço fixo

Os ITENS (taxas, produtos, subserviços) ENTRAM SEMPRE, cada um com as suas conversões,
exatamente como saem na guia/XML. Um item só fica FORA se:
   · o convênio não o Utiliza                                   (custo sim, receita não)
   · ou o serviço é PACOTE DE PREÇO FECHADO e o item está com "Zerar valor em pacotes"

PACOTE DE PREÇO FECHADO = Pacote marcado E (preço fixo OU valor convertido preenchido — inclusive 0)

SUBSERVIÇO: zerado → perde só o PRÓPRIO valor; o que está dentro dele segue o Zerar de cada um.
            sem Utiliza → ele e TUDO que está dentro dele ficam fora.

✅ Regra vigente: valor combinado NÃO é pacote (confirmada pelo Diretor em 25/09/2026 — fica assim).

• Digitar um valor na linha 🔁 do serviço muda só o preço do serviço. Os itens continuam somando por cima, cada um com o seu preço. Ex.: valor combinado 100 → total = 100 + aplicação + medicamento.
• Preço fechado que já inclui itens = (1) valor combinado na linha 🔁 do serviço + (2) Pacote marcado na linha do serviço + (3) Zerar valor em pacotes em cada item incluso (abas Produtos, Taxas ou Serviços do convênio). Item sem Zerar continua cobrado à parte.
• Sem Pacote, o "Zerar valor em pacotes" dos itens nem é consultado.
• Pacote é sempre uma marcação por convênio. No cadastro do serviço (catálogo) só existe preço fixo ou soma dos itens. Preço fixo no catálogo ou valor combinado no convênio definem só o preço do serviço.

⚠️ Mudou em 23/09/2026 — serviço de preço fixo sem Pacote. Antes, os itens de um serviço de preço fixo sem Pacote não entravam na receita (e no orçamento só o excedente era cobrado). Agora entram: o serviço cobra o valor fixo + todos os itens com Utiliza. Se o seu preço fixo já inclui materiais ou taxas, marque Pacote no serviço (no convênio) e Zerar valor em pacotes nos itens inclusos — veja a Receita I do Guia da Clínica.

✅ "Zerar valor em pacotes" é por item e não desce em cascata (em produção desde 24/09/2026). Ele nunca zera o item vendido sozinho e não faz nada em serviço que apenas soma itens sem preço fechado. Marcado só no medicamento, zera só o medicamento. Um subserviço zerado perde só o próprio valor — a taxa de sala dentro dele continua entrando, se ela mesma não estiver zerada. O que tira tudo que está dentro de um subserviço é só a falta de Utiliza nele.

✅ Novo — 26/09/2026 Marcar só "Pacote" não liga mais "Zerar valor" sozinho (correção de 25/09/2026). Ao criar o vínculo do item no convênio marcando apenas Pacote, o Zerar valor em pacotes fica desmarcado. O Zerar é sempre marcado item a item, por você, em cada item incluso no preço fechado — confira no painel Expandir serviço (coluna Motivo "Zerado em pacote").

✅ Produto ou taxa em uso num serviço não pode mais ser excluído ✅ Novo — 02/10/2026 (#626)

Ao excluir (ou inativar) um produto em Estoque › Produtos ou uma taxa em Configurações › Taxas que está na composição de algum serviço ativo, nada é excluído: abre "Não é possível excluir" — "Este produto está em uso em N serviço(s) e não pode ser excluído. Corrija a composição dos serviços abaixo (substitua por outro item ou retire-o) e tente de novo." — com a lista Serviço / Código / Quantidade e o link de cada serviço (abre em nova aba). Corrigida a composição, a exclusão passa na hora. Serviços inativos aparecem à parte ("Também aparece em serviços inativos (não impede a exclusão)"). Na API externa a resposta é 409, com a lista em servicos.

Ao substituir o item num serviço, marque Utiliza (e, se for pacote, Zerar valor em pacotes) do substituto nos convênios — Liberar para edição → marcar → Salvar — e confira no Expandir serviço. Do mesmo jeito, o fornecedor usado em custo extra ou prestador ativo de convênio não pode ser excluído nem inativado.

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 produtos ou taxas antes disso, confira os serviços mais usados no Expandir serviço.

Farol = (Σ do que o convênio paga por TODOS os serviços, produtos e taxas)
        ÷ (Σ do custo de TODOS os produtos envolvidos
           + custos extras do convênio + prestadores + repasse — desde 12/10/2026) × 100

CUSTO = produtos (todos os da árvore do serviço)
      + custos extras do convênio      (aba Custos extras do convênio)
      + prestadores                    (painel Serviços extras do serviço no convênio)
      + repasse do profissional        (aba Vínculo e Repasse do colaborador)

⚠️ A cor do Farol de alguns serviços pode mudar (de verde para amarelo, de amarelo para vermelho), e serviços sem produto que ficavam sem cor passam a ter cor, porque agora o repasse entra no custo. A cor fica mais realista — os valores cobrados não mudam: guia, XML, repasse pago e DRE continuam iguais (custo extra é projeção; não gera lançamento).
Bloqueio desligado por padrão: em Configurações › Parâmetros › Orçamento, a opção "Custos extras (convênio, prestadores e repasse) também bloqueiam" vem desmarcada: a cor mostrada já inclui os custos novos, mas o bloqueio e a aprovação por alçada continuam usando a cor sem eles. Antes de marcar, clique em "Ver serviços que mudam de cor" (na mesma tela): o relatório "Serviços que mudam de cor com os custos extras" mostra Convênio, Serviço, Antes, Depois, Receita, Custo antes, Custo depois e Composição.