Orçamento de Procedimentos

Visão Geral

Para procedimentos eletivos (cirurgias, planos de tratamento, particulares), gera orçamento detalhado com serviços, equipamentos, produtos e taxas. Paciente recebe PDF, aprova/rejeita. Orçamento aprovado → botão "Agendar" gera o agendamento pré-preenchido com os dados do orçamento (ver Fluxo de conversão) e segue para o fluxo financeiro.

Estrutura do Orçamento

Um orçamento contém múltiplos Serviços. Cada serviço pode ter:

• Produtos consumidos (ex: ampolas, gases, materiais)
• Taxas (ex: taxa de sala cirúrgica, taxa de equipamento)
• Equipamentos utilizados (com grade de tempo de uso)
• Profissional responsável

Não encontro o profissional ou o serviço

Status do Orçamento

✅ Novo — 26/09/2026 Os status abaixo são os nomes que aparecem no sistema (código de produção). Correção 26/09/2026: esta tabela listava nomes técnicos que não existem na tela (RASCUNHO, APROVADO_CLIENTE, EXPIRADO etc.).

✅ Novo — 08/10/2026 Rótulos únicos: a lista, o modal, o relatório, o seletor da agenda, a aba Orçamentos do paciente e os dashboards passaram a usar os mesmos nomes; o seletor de status do modal mostra só as trocas permitidas.

✅ Novo — 08/10/2026 Botão "Agendar" liberado para Aprovado pelo Paciente, Aprovado pelo Convênio, Aprovado pela Assistência, Pago, Agendado e Concluído — Em Negociação não libera. Copiar e Reabrir passaram a guardar o orçamento de origem.

Resumo: travam a edição só Recusado e Aprovado pela Assistência; Vencido e Aprovado pela Assistência também aparecem como pendência no board. Detalhes em Edição depois de aprovado.

Farol de Margem Receita/Custo ✅ Novo — jul/2026

Ao cruzar receita × custo, o sistema exibe um farol colorido indicando a saúde da margem:

Os limites de cada cor são configuráveis nos Parâmetros da clínica, e o índice do parâmetro aparece junto ao farol nos serviços (#434). Quando a margem fica amarela ou vermelha, o sistema exige aprovação por nível (1 a 4 — orçamentista, coordenador, gerente, diretor); no vermelho há bloqueio até a liberação (#505/#506/#507). ✅ Novo — ago/2026 Essa aprovação passou a funcionar por nível de alçada (renomeado de "nível de desconto" — #557), com notificação a todos os usuários do nível; quando um responde, resolve para todos (#558, épico #571 concluído em 13/08/2026). ✅ Novo — 26/09/2026 Desde 24/09/2026 os pedidos de aprovação (farol, desconto e edição/cancelamento de Atendido) chegam em tempo real a todos os aprovadores do nível exigido ou superior (ex.: um pedido de Nível 2 chega ao Nível 2 e ao Nível 3) e somem da tela dos demais assim que alguém responde.

Farol consolidado do orçamento ✅ Novo — 23/09/2026

Em linguagem simples: Farol consolidado = tudo o que o convênio vai pagar por todos os serviços, produtos e taxas do orçamento (já com todas as regras de conversão) ÷ o custo de todos os produtos envolvidos × 100. ✅ Atualização 13/10: desde 12/10 o custo também inclui custo extra do convênio, prestadores e repasse — ver acima. Como funciona na prática:

• Um serviço vermelho sozinho não bloqueia se o conjunto fecha verde — e o conjunto pode ficar vermelho mesmo com todos os serviços verdes.
• Cada linha continua mostrando a própria cor, só para orientar: é por ela que você acha o serviço que está puxando o resultado para baixo.
• Qualquer item sem custo ou sem preço → Farol consolidado 🟣 roxo (cadastro incompleto) e o orçamento fica bloqueado até a correção.
• A aprovação por nível de alçada (2 ou 3) refere-se ao Farol consolidado — a mensagem de aprovação fala do orçamento inteiro, não de um serviço isolado.

Taxas, produtos e subserviços sempre entram na conta ✅ em produção desde 23/09

Desde 23/09/2026, os itens da composição do serviço (taxas, produtos e subserviços) entram sempre no orçamento, cada um com as conversões do convênio — exatamente como saem na guia/XML. A opção "Definir preço do serviço pelos itens" (somar itens) decide só o valor próprio do serviço (zero quando marcada); ela não decide mais se os itens entram. Um item só fica fora em dois casos: o convênio não o Utiliza, ou o serviço é pacote de preço fechado e o item está com Zerar valor em pacotes.

• Serviço de preço fixo SEM Pacote — cobra os produtos e taxas na quantidade inteira, com as conversões do convênio. (Antes embutia a quantidade da composição e cobrava só o excedente.)
• Quer que o preço fixo ou o valor combinado "já inclua" os itens? No convênio (Configurações › Convênios), clique em Liberar para edição — ele abre em modo consulta desde 29/09/2026 — e marque Pacote na linha do serviço (aba Serviços do convênio) e Zerar valor em pacotes nos itens inclusos — só nesse caso a quantidade da composição entra a R$ 0,00 e apenas o excedente é cobrado.
• ✅ regra vigente Valor combinado NÃO é pacote (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 (ex.: combinado 100 → total = 100 + aplicação + medicamento). Pacote é sempre marcação por convênio — não existe pacote no cadastro do serviço. Sem Pacote, o "Zerar" dos itens nem é consultado. Sintoma "digitei um valor e os itens continuaram somando" → marque Pacote (Guia da clínica).
• ✅ em produção desde 24/09 Onde conferir o total antes de orçar: na aba Serviços do convênio, a coluna Valor do serviço tem a 4ª linha Σ = total do serviço no convênio (serviço + produtos, taxas e subserviços que entram) — o mesmo número da receita do Farol e do orçamento. Em serviço que soma itens sem valor combinado, a linha ✅ "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.
• ✅ em produção desde 24/09 Zerar é por item e não desce em cascata: dentro de um pacote de preço fechado, um subserviço zerado sai a R$ 0,00, mas os produtos e taxas dentro dele que não estão zerados continuam sendo cobrados. Só a falta de Utiliza no subserviço tira tudo que está dentro dele.

Na dúvida sobre quando um item entra, fica fora ou vira R$ 0,00, siga a Árvore de decisão de preços.

As regras completas de conversão (zero é zero, vazio desce de nível, Utiliza, pacotes) estão na área Preços e Conversão de Valores.

Novidades do ciclo de agosto/2026 ✅ Novo — ago/2026

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

• Farol — visão geral entregue: lista de cruzamentos serviço×convênio e produto×convênio (#435 — 02/08).
• Farol considera taxas: o farol do orçamento passa a considerar as taxas (#550 — 07/08).
• Farol roxo para erro de preço: itens sem custo ou sem receita ganham farol roxo, com bloqueio (#545 — 01/08).
• Notificação de orçamento com link para aprovar: notificação de orçamentos solicitados com link para ver/aprovar e prazos (#446 — 30/07).
• Crítica de quantidades no agendamento a partir do orçamento: o agendamento passa a criticar as quantidades de produtos a partir do orçamento/autorização (#553 — épico #570, 13/08). Ver Agendamento.
• Nível de alçada na aprovação do farol: aprovações do farol por nível de alçada (renomeado de "nível de desconto" — #557), com notificação por grupo (#558 — épico #571, 13/08).

Novidades do ciclo de setembro/2026 ✅ Novo — set/2026

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

• Trava de edição pós-aprovação ✅ Novo — 26/09/2026 (regra revista em 25/09): travam a edição só os status Recusado e Aprovado pela Assistência. Aprovado pelo Paciente, Aprovado pelo Convênio e Vencido (para renovar) continuam editáveis — ver Edição depois de aprovado.
• Documentos copiados também na edição: os documentos anexados ao orçamento passam a ser copiados para o agendamento também na edição do orçamento — antes isso só acontecia na criação.
• Status do orçamento destravado em vários cenários (#607): melhoria na transição de status — o orçamento não fica mais preso em situações em que deveria seguir o fluxo normalmente.
• Impressão com aviso RASCUNHO e data de validade (#611): a impressão do orçamento voltou a exibir o aviso de RASCUNHO (quando aplicável) e a data de validade.
• ✅ Corrigido 24/09 Impressão igual à proposta e gravação sempre confirmada (#614): o valor impresso do orçamento divergia da proposta (mesmo com o orçamento aprovado) e, em alguns casos, a gravação falhava sem aviso. Corrigido: a impressão sai com os mesmos valores da proposta e toda gravação agora mostra confirmação — não há mais falha silenciosa ao salvar.
• ✅ Novo — 23–24/09 Regras de preço — série completa em produção: itens sem Utiliza a R$ 0,00; taxas/produtos/subserviços sempre entram; Zerar por item, sem cascata — ver seção acima e a Árvore de decisão de preços.
• Emissão de NFS-e direto do Orçamento (#594): no pagamento feito a partir do orçamento, já é possível emitir a NFS-e — ver Notas Fiscais. ✅ Novo — 26/09/2026 Em orçamento 100% particular com financeiro próprio, a nota das sessões sai por parcela paga do orçamento.
• ✅ Novo — 26/09/2026 Várias sessões, um financeiro só (24–25/09): cobrança única com o total do orçamento, pagamento no orçamento ou no acolhimento, "agendar sem pagar sim, acolher sem pagar não", valor travado depois de pago, sessão devolvida ao cancelar o agendamento — ver seção própria.
• Farol consolidado do orçamento (23/09): o Farol e a aprovação por alçada passam a olhar o orçamento inteiro (Σ receita ÷ Σ custo), não mais a cor mais crítica entre os serviços — ver seção do Farol consolidado.
• Zero é zero, vazio é vazio (23/09): valor 0,00 agora vale como preço zero de verdade em todas as telas (inclusive no orçamento); campo vazio é o que faz o sistema descer de nível na conversão — ver Preços e Conversão de Valores.

Novidades de outubro/2026 ✅ Novo — 13/10/2026

• ✅ Novo — 05/10/2026 Lista de Orçamentos com mais colunas (#657): Nº Proposta, Abertura, Validade (dias para vencer), Farol, Status, Nome do Paciente, CPF, Telefone (texto), Serviço(s) ("primeiro e mais N"), Convênio, Sessões (usadas × previstas), Valor total, Pagamento (Pago / Parcial / Pendente, considerando o pago na agenda), Responsável e Local (escondido por padrão). Filtros por telefone, serviço, convênio e responsável; ordenação por data, paciente, status e valor; o filtro Vencido foi corrigido. Colunas escondíveis e reordenáveis, salvas por usuário neste navegador até sair do sistema; botão "Colunas padrão"; "Exportar Excel" com todas as linhas do filtro. Não há coluna Profissional. ✅ Atualização 15/10: desde 13/10, ao sair do sistema as colunas escolhidas voltam ao padrão (o logout apaga as preferências do navegador).
• ✅ Novo — 12/10/2026 Farol com repasse e custos extras — ver Farol.
• 🟡 Chegando Status automáticos Pago / Agendado / Concluído / Renegociado — ainda não ativos; ver Status.
• ✅ Novo — 02/10/2026 Subserviços visíveis: o quadro "Subserviços" aparece abaixo do serviço, com a árvore (código, Qtd, Valor) e os chips "Convênio não cobre" / "Pede autorização"; a autorização do subserviço é opcional hoje (#641).
• ✅ Novo — 06/10/2026 O pedido de desconto do orçamento mostra paciente e serviço(s) na notificação do aprovador (#637).
• ✅ Novo — 02/10/2026 Proteção de versão (#640): se outra pessoa alterou o orçamento depois que você abriu a tela, aparece "Este registro foi alterado por outra pessoa. Recarregue a tela antes de alterar."
• Trava de especialidade do convênio desligada no orçamento desde 06/10 — ver acima.
• 🟠 Roadmap A IA (TalkMe) abrir orçamento (#660) ainda não está em produção.

Novidades de 15 a 23/10/2026 Novo — out/2026

• Novo — out/2026 Marca d'água de rascunho: o orçamento em Pendente de Aprovação Interna ou Em negociação sai impresso/no PDF com a marca d'água de rascunho — assim ninguém entrega ao paciente uma proposta que ainda não foi aprovada.
• Novo — out/2026 Recusado não vira Vencido: orçamento Recusado não aparece mais como Vencido; o "Vencido" aparece só pelo prazo de validade (ver Expiração).
• Novo — out/2026 Cancelar encerra a cobrança (22/10): cancelar o orçamento encerra os títulos em aberto e os links de pagamento ligados a ele. O que já foi pago não some: para devolver, use o estorno no financeiro.
• Novo — out/2026 Pagamento parcial (22/10): pagar parte de uma parcela gera uma parcela paga e deixa o saldo em aberto.
• Novo — out/2026 Quem aprova: desde 21/10/2026, o colaborador com conselho profissional que tem a ação Ver Valores (excepcional) pode aprovar orçamento — ver Permissões.
• Novo — out/2026 Os textos do formulário seguem o tipo da tela (Orçamento, Acolhimento ou Agendamento); o Log de erros passou a ter a origem Orçamento.
• Novo — out/2026 Médico aprova sem acesso a Colaboradores (23/10): o médico que não tem permissão na tela de Colaboradores agora consegue aprovar — opções como "Aprovado pela Assistência" deixam de ficar desabilitadas por falta dessa permissão (vale também no agendamento).

Expiração Automática

Todo orçamento tem validade definida em ParametrosOrcamento.diasValidos (padrão 30 dias). Passada a validade, o orçamento aparece como Vencido — sem ação manual. ✅ Novo — 26/09/2026 Correção 26/09/2026: Vencido é um status virtual, calculado pela validade: ele nunca é gravado no orçamento (não há rotina que troque o status). O orçamento vencido continua editável para ser renovado e aparece como pendência no board.

✅ Atualização 13/10: segue assim enquanto a troca automática (#656) não for ativada. 🟡 Chegando Com a ativação, a validade passa a ser gravada na criação e o Vencido passa a travar o orçamento até Cancelar ou Renegociar — ver Status automáticos.

✅ Novo — 15/10/2026 Orçamento Recusado depois da validade não aparece mais como "Vencido" na lista nem no filtro Vencido. Também em 15/10: o card de aprovação do Farol mostra quem pediu, o serviço e o paciente já ao abrir a página; e, desde 13/10, o desconto por sessão do orçamento aparece no financeiro do agendamento.

Aprovação → botão "Agendar"

Com o orçamento aprovado, o botão "Agendar" gera o agendamento pré-preenchido com os dados do orçamento — não é preciso recriar os dados manualmente; basta conferir e salvar (ver Fluxo de conversão). Na API interna do sistema, a aprovação é POST /orcamento/:id/aprovar. Orçamentos cancelados podem ser reabertos em /orcamento/:idOrcamentoCancelado/reabrir.

✅ Novo — jul/2026 O caminho inverso também foi entregue: agora é possível fazer o vínculo do orçamento a partir do agendamento (#359 — 24/07/2026).

✅ Novo — 26/09/2026 Nem toda aprovação trava o orçamento: só Recusado e Aprovado pela Assistência impedem a edição (ver a seção abaixo).

Edição depois de aprovado — quem trava e quem não trava ✅ Novo — 26/09/2026

Em produção desde 25/09/2026. A regra antiga ("orçamento aprovado não pode ser editado", de forma genérica) foi substituída por esta:

Continua valendo o #614: a impressão e a proposta mostram o valor congelado do orçamento, e uma tentativa de edição num orçamento travado é ignorada com aviso (nunca falha em silêncio).

Orçamento com várias sessões — financeiro único ✅ Novo — 26/09/2026

• Uma cobrança só: todas as sessões de um orçamento compartilham uma única movimentação financeira, com o valor total do orçamento — nunca "valor × nº de sessões". Cada nova sessão reaproveita a mesma cobrança em vez de gerar outra.
• Onde pagar: na tela do orçamento (opcional) ou no acolhimento. Pagou de um lado, aparece pago nos dois.
• Agendar sem pagar: sim. Acolher sem pagar: não. Orçamento particular com financeiro pode ser agendado sem estar pago, mas não pode ser acolhido sem estar pago — o pagamento é feito ali mesmo, no acolhimento. Mensagem: "Não é possível acolher: o orçamento (id N) ainda não foi pago." Orçamento só de convênio (sem parcelas) não entra nesta regra.
• Trocar o status pelo menu do check-in para um status que só se alcança pelo acolhimento também exige o orçamento pago: "Não é possível mudar o status: o orçamento ainda não foi pago. Faça o acolhimento com o pagamento."
• Depois de pago, o valor TRAVA: não se altera valor nem se dá desconto — "O orçamento desta sessão já foi pago — não é possível alterar o valor nem dar desconto." Antes de pago, desconto ou ajuste feito no acolhimento vale para o orçamento e para todas as sessões (é o mesmo financeiro).
• NFS-e: em orçamento 100% particular com financeiro próprio, a nota das sessões sai pelo lado do orçamento, por parcela paga (sem duplicar). Orçamento misto (particular + convênio) ou sem financeiro próprio segue emitindo pela movimentação, como antes — ver Notas Fiscais.
• Contagem de sessões pelo uso real (corrigida em 25/09): o saldo do orçamento conta o uso real pelos agendamentos, e cancelar um agendamento devolve a sessão ao orçamento/autorização — pela tela de cancelar, pelo cancelamento da autorização e pelo portal do paciente. A aba de orçamentos "com saldo" deixou de listar orçamentos já 100% consumidos.

O que o acolhimento bloqueia (orçamentos novos)

Para proteger contra cobrança errada ou em dobro, o acolhimento recusa a operação (o sistema mostra a mensagem e não acolhe) quando:

Ver também Agendamento › Acolhimento de orçamento pago.

✅ Novo — 29/09/2026 Pagamento parcial antecipado (#604, em produção desde 28/09/2026): quando o serviço exige sinal, o percentual mínimo incide sobre a sessão agendada, não sobre o orçamento/pacote inteiro; a confirmação do pagamento é manual nesta versão — ver Agendamento › Pagamento parcial antecipado.

Endpoints da API interna do sistema

Atenção: estes são os endpoints da API interna usada pelas telas do Rabi — não é a API externa de integração. Para integrar sistemas externos (criar orçamento, atualizar, mudar status, anexos), use a API externa — referência de operação (Orçamentos).

Models do schema (8)

• Orcamento — header (paciente, local, responsável, status, observação)
• OrcamentoServico — serviços do orçamento
• OrcamentoServicoProdutos — produtos consumidos por serviço
• OrcamentoServicoTaxa — taxas do serviço
• OrcamentoServicoEquipamentos — equipamentos utilizados
• OrcamentoServicoMovimentacao — vincula a MovimentacaoFinanceira
• StatusOrcamento — status configuráveis
• ParametrosOrcamento — validade (diasValidos)

Telas (Frontend)

• /portal/agenda/orcamento — lista (OrcamentoList.tsx)
• /portal/agenda/orcamento/criar — novo (OrcamentoForm.tsx)
• /portal/agenda/orcamento/:id — editar/detalhar
• /portal/agenda/orcamento/:idOrcamentoCancelado/reabrir — reabrir cancelado (cria um novo orçamento em Pendente de aprovação interna)

Fluxo Conversão para Atendimento

1. Orçamento aprovado → botão "Agendar"
2. Sistema abre tela de agendamento pré-preenchida
3. Salvar agendamento → a sessão passa a contar como usada no orçamento (cancelar o agendamento devolve a sessão)
4. Execução do atendimento → vincula MovimentacaoFinanceira ao OrcamentoServicoMovimentacao (orçamentos criados desde 25/09/2026: todas as sessões usam a mesma movimentação, com o total do orçamento — ver Financeiro único)

Descontos

Aplicação de desconto chama validacaoDescontoController que valida nível de permissão do colaborador via ParametrosDeDesconto:

• Nivel 1 (até 5%) — Recepcionista
• Nivel 2 (até 10%) — Coordenador
• Nivel 3 (até 20%) — Gerente
• Sem limite — Diretor

✅ Novo — ago/2026 O "nível de desconto" foi renomeado para "nível de alçada" (#557), e as aprovações passaram a notificar todos os usuários do nível — quando um responde, resolve para todos (#558).

✅ Novo — 26/09/2026 Aprovação de desconto em tempo real (desde 24/09/2026): o pedido chega na hora a todos os aprovadores do nível exigido ou superior e some da tela dos demais quando um deles responde.

✅ Novo — 26/09/2026 Desconto em orçamento de várias sessões: antes do pagamento, o desconto dado no acolhimento vale para o orçamento e todas as sessões (é o mesmo financeiro); depois de pago, não é possível alterar o valor nem dar desconto — ver Financeiro único.

Versões do Orçamento

Cada alteração relevante (mudança valor, escopo) gera nova versão. Cliente compara versões antes de aprovar. Histórico preservado em Actions.

Permissões

O orçamento é controlado pela permissão ORCAMENTO, só com os níveis do modelo (refináveis pelas permissões granulares, #395):

• ORCAMENTO.VIEW — consultar
• ORCAMENTO.CREATE — criar orçamento
• ORCAMENTO.UPDATE — alterar o orçamento, mudar o status (inclusive aprovar e cancelar) e os parâmetros
• ORCAMENTO.DELETE — excluir
• Reabrir orçamento cancelado (/portal/agenda/orcamento/:idOrcamentoCancelado/reabrir): exige CREATE na permissão AGENDAMENTO/ACOLHIMENTO/CONFIRMACAO e cria um novo orçamento, que começa em Pendente de aprovação interna.
• Aprovar desconto pela alçada: permissão DESCONTO (UPDATE).
• Novo — out/2026 Ver Valores (excepcional) (21/10/2026): colaborador com conselho profissional que recebe essa ação pode aprovar orçamento. Na tela de permissões, os níveis aparecem como Sem Permissão / Visualizar / Criar / Editar / Total — ver Permissões Granulares.
• Novo — out/2026 Desde 23/10/2026 aprovar não depende de acesso à tela de Colaboradores.

✅ Correção — 30/09/2026 Versões anteriores listavam ORCAMENTO.APROVAR, ORCAMENTO.CANCELAR, ORCAMENTO.REABRIR e ORCAMENTO.OVERRIDE_VALOR: essas permissões não existem no sistema.

Relatórios

• Taxa de conversão (orçamento → realizado) por colaborador/especialidade
• Valor médio por tipo de procedimento
• Top motivos de rejeição
• Orçamentos vencidos (potencial perdido)