⚙️ Cadastro do convênio (abas, preços e Farol)

Não consigo alterar o convênio (modo consulta)

Do manual: abrir esta parte no manual completo ›

O convênio abre em modo consulta. Clique em Liberar para edição, faça a alteração e clique em Salvar no cabeçalho. Se aparecer "Você não tem permissão para alterar convênios", seu perfil só consulta — peça a quem tem a permissão. Convênio desativado só abre para visualização.

Veja: Modo consulta · Consultar sem alterar

Coluna Valor do serviço: quatro linhas

Do manual: abrir esta parte no manual completo ›

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 mesmo total também aparece no Farol (bolinha) e no painel Expandir serviço.

Expandir serviço

Do manual: abrir esta parte no manual completo ›

Concluído e em produção (#625, issue fechada em 25/09/2026). Está em dois lugares:

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

Ao clicar na seta da linha, abre (sob demanda) a árvore do serviço naquele convênio. Colunas do painel, nesta ordem:

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

• Item que não entra na cobrança aparece esmaecido, e a coluna Motivo diz por quê: "Convênio não utiliza", "Zerado em pacote" ou "Subserviço pai fora do total".
• Cada linha mostra o próprio farol; a linha do Subserviço mostra o total da sua subárvore.
• Os números são os mesmos da aba Farol › Itens e da bolinha do Farol (mesma fonte no banco) — nunca recalculados na tela. Editou um valor na lista? Os painéis abertos recarregam sozinhos.
• Ficou mais rápido: carregamento sob demanda e cache das listas.
• ✅ Novo — 29/09/2026 Passe o mouse na bolinha do Farol de cada linha para ver a margem, a receita e o custo daquele item.
• ✅ Novo — 29/09/2026 Não há linha de total no fim da lista expandida: o total do serviço naquele convênio é a linha Σ da coluna Valor (o mesmo número da receita do Farol).
• ✅ Novo — 29/09/2026 Ao alterar valor, Pacote ou Zerar na linha do serviço e salvar, a lista expandida se atualiza sozinha.

Regras de preço por convênio

Do manual: abrir esta parte no manual completo ›

A série de regras de preço por convênio está inteira em produção (23/09 e 24/09/2026) — não resta nada da série 22–24/09 pendente de ativação — e a coluna Valor do serviço com 4 linhas (linha Σ) está em produção desde 24/09. Elas fecham o comportamento das abas Serviços, Produtos, Taxas, Equipamentos e Farol do convênio. Para decidir caso a caso, use a árvore de decisão.

• Zero é zero, vazio é vazio — em todas as telas — campo com 0,00 significa preço zero de verdade (não desce de nível); campo vazio significa "não tenho regra aqui" e o sistema usa as conversões dos níveis de baixo (política do convênio, depois o cadastro). Use o botão "Limpar valor" para deixar o campo vazio. Quem usava R$ 0,01 como marcador de "sem valor" deve limpar o campo.
• Utiliza = "o convênio cobre este item" — item sem Utiliza tem custo, mas não tem receita (fica fora da receita do Farol; no orçamento entra a R$ 0). Item com Utiliza é precificado pela cadeia de conversão do convênio (valor combinado → política do convênio → cadastro), nunca pelo "preço da casa".
• Taxas, produtos e subserviços sempre entram na conta do serviço ✅ 23/09/2026 — cada um com as próprias conversões, como saem na guia/XML. "Definir preço do serviço pelos itens" decide só o valor próprio do serviço (zero quando marcado) — não decide mais se os itens entram. Só ficam fora: item sem Utiliza, ou zerado em pacote de preço fechado. Para um preço fixo ou valor combinado "já incluir" itens: clique em Liberar para edição, marque Pacote na linha do serviço (aqui, na aba Serviços do convênio) e Zerar valor em pacotes nos itens inclusos.
• Valor combinado NÃO é pacote ✅ regra vigente — decisão de 25/09/2026 — 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.: combinado 100 → total = 100 + aplicação + medicamento). Pacote é sempre uma marcação por convênio: não existe pacote no cadastro do serviço (catálogo), onde o serviço só tem preço fixo ou soma dos itens. Preço fechado = (1) valor combinado na linha 🔁 + (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" dos itens nem é consultado.
• Zerar valor em pacotes é por item e não desce em cascata ✅ 24/09/2026 — só age quando o serviço é pacote de preço fechado (Pacote marcado + valor fixo ou combinado preenchido, inclusive 0). Um subserviço zerado perde só o próprio valor; os itens dentro dele seguem cada um o seu "Zerar". Só a falta de Utiliza no subserviço tira tudo que está dentro dele.
• Linha ✅ do serviço = valor do próprio serviço ✅ 23/09/2026 — na aba Serviços, a linha ✅ mostra o valor do próprio serviço como sai na linha de procedimento do XML; produtos e taxas saem nas áreas deles. Quem soma tudo é o Farol (o do serviço consolida tudo; o da taxa é só a taxa; o do produto só o produto).
• Coluna Valor do serviço com 4 linhas — nova linha Σ ✅ em produção desde 24/09: 🔒 preço da casa (em serviço que soma itens, a soma dos itens a preço de casa, com a etiqueta "(soma dos itens)"); 🔁 valor combinado com este convênio; ✅ valor do próprio serviço que vai na guia; Σ total do serviço neste convênio = serviço + produtos, taxas e subserviços que entram na conta — o que o convênio paga e o mesmo número da receita do Farol. Em serviço que soma itens sem valor combinado, a linha ✅ mostra "0,00 (sem preço próprio: itens cobrados à parte)" — não é erro (caso real: "Ferinject aplicado" no convênio Particular). 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. Passar o mouse em cada linha explica o que ela é. Produtos, taxas e a coluna Tipo de Atendimento seguem com 3 linhas.
• Coluna Tipo de Atendimento na aba Serviços — o tipo de atendimento também é convertido por convênio, com as 3 linhas: 🔒 o do cadastro do serviço, 🔁 o escolhido para o convênio e ✅ o que vale (efetivo). O efetivo vai para o atendimento, o pré-faturamento e o campo tipoAtendimento do XML.
• Textos e valores finais convertidos ✅ 24/09/2026 — todas as telas do convênio mostram o nome, a descrição, o código, a tabela 87 e os valores finais convertidos (nível do convênio → política do convênio, só para preço de produto → catálogo).
• Aba Farol › Itens: cada linha reflete só ela ✅ 24/09/2026 — valor efetivamente considerado (zero quando fora), custo, receita, margem e farol da própria linha, com a coluna "Conta no total" (Sim/Não); a linha do serviço traz o total do serviço e a do subserviço, o total do que está dentro dele. A sub-aba Farol › Serviços, que mostrava "0 registros", foi corrigida.
• Expandir serviço ✅ Novo — 26/09/2026 — seta na linha do serviço (aba Serviços do convênio e aba Convênios do serviço) que abre a árvore do serviço naquele convênio, como sai na guia, com farol por item. Concluído (#625, fechada em 25/09) — ver seção própria.
• Farol do orçamento, agendamento e autorização é consolidado — soma de tudo que o convênio paga ÷ soma de todos os custos; um item vermelho sozinho não bloqueia se o conjunto fecha; item sem custo/preço → roxo.
• Cor da 1ª linha corrigida — a primeira linha das abas Serviços, Produtos, Taxas e Equipamentos recebia sempre fundo branco mesmo com a bolinha do Farol colorida; agora a linha inteira fica na cor do Farol (cinza claro quando não há Farol calculado).

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

Do manual: abrir esta parte no manual completo ›

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.

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

Do manual: abrir esta parte no manual completo ›

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

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

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