Orçamento de Procedimentos

📚 Referência completa e treinamento: este módulo tem uma lição detalhada de certificação — passo a passo de todas as telas, campos e regras.

Módulo grande — 13 arquivos backend, 8 models no schema. Em produção. Substitui processo manual em planilha. (GitLab #398 — HU completa, concluída em 24/07/2026.)

✅ Novo — jul/2026 Novidades de julho/2026: HU do Orçamento concluída (#398 — 24/07); vínculo do orçamento a partir do agendamento (#359 — 24/07); e Farol de Margem Receita/Custo entregue (ver seção abaixo). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

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. Aprovação automaticamente vira agendamento + autoriza 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

Status do Orçamento

Status	Significado
RASCUNHO	Em criação
AGUARDANDO_APROVACAO	Enviado ao paciente
APROVADO_CLIENTE	Paciente aprovou
REJEITADO_CLIENTE	Paciente rejeitou (com motivo)
CONFIRMADO	Agendamento gerado, fluxo iniciado
AGENDADO	Data marcada
REALIZADO	Procedimento executado
CANCELADO	Cancelado (com descricaoCancelamento)
EXPIRADO	Validade vencida (ParametrosOrcamento.diasValidos)

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

Entregue! O Farol de Margem saiu do roadmap: a HU de Farol de Margem Receita/Custo com Níveis (#390) foi concluída em 22/07/2026, junto com o farol em cores nos serviços (#434), o farol por parâmetros com exibição em cor e bloqueio no vermelho para convênios e serviços (#505/#506/#507) e o farol de % de gastos dos convênios (#339). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

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

Cor	Significado	Consequência
🟢 Verde	Margem dentro da meta da clínica	Segue sem aprovação extra
🟡 Amarelo	Margem em alerta	Exige aprovação por nível hierárquico
🔴 Vermelho	Margem ruim ou negativa	Bloqueia — exige liberação por nível hierárquico

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

Em breve: a visão geral com a lista de cruzamentos do farol (#435) ainda está em desenvolvimento (Sprint 3).

Expiração Automática

Todo orçamento tem validade definida em ParametrosOrcamento.diasValidos (padrão 30 dias). Um cron diário marca automaticamente como EXPIRADO os orçamentos que ultrapassaram a validade — sem ação manual.

Aprovação Vira Agendamento (automático)

Ao aprovar (POST /orcamento/:id/aprovar), o sistema cria o agendamento automaticamente e abre o fluxo de atendimento — não é preciso recriar os dados manualmente. 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).

Bugs corrigidos ✅ Novo — jul/2026: os bugs #386 e #387 (servicosPedemAutorizacao) foram corrigidos entre 20 e 22/07/2026. Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

Endpoints da API

Método	Endpoint	Função
POST	`/orcamento`	Criar
GET	`/orcamento`	Listar
GET	`/orcamento/:id`	Detalhe
PUT	`/orcamento/:id`	Atualizar
GET	`/orcamento/status`	Lista status

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

Fluxo Conversão para Atendimento

Orçamento APROVADO_CLIENTE → botão "Agendar"
Sistema abre tela de agendamento pré-preenchida
Salvar agendamento → orçamento vira CONFIRMADO
Execução do atendimento → vincula MovimentacaoFinanceira ao OrcamentoServicoMovimentacao
Orçamento vira REALIZADO ao fechar atendimento

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

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

ORCAMENTO.VIEW, .CREATE, .UPDATE
ORCAMENTO.APROVAR — confirmar aprovação do paciente
ORCAMENTO.CANCELAR
ORCAMENTO.REABRIR — reabrir cancelado
ORCAMENTO.OVERRIDE_VALOR — valor manual acima da tabela

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 expirados (potencial perdido)