O orçamento por dentro.
Leitura que vira ação
A IA lista os aprovados sem venda, cruza com a agenda e cria a tarefa, tudo com as permissões de quem pede.
Gravações do sistema numa clínica de demonstração, com dados fictícios.
Ferramentas MCP
Escritas com prévia antes de gravar.
Ler
Orçamentos com validade, pendências por urgência, o detalhe e as condições de pagamento.
- vendas_find_orcamentos
- vendas_find_orcamento_pendencias
- vendas_get_orcamento
- vendas_find_condicoes_pagamento
Simular
Parcelas de uma condição, o preço de um pacote e a venda inteira antes de criar.
- vendas_simular_parcelas
- vendas_simular_preco_pacote
- vendas_simular_venda
Agir
Montar ou editar o orçamento, converter em venda e enviar para assinatura.
- vendas_manage_orcamento
- vendas_converter_orcamento_em_venda
- vendas_enviar_para_assinatura
API REST
Para integração sem IA: token da integração e chamadas HTTP. A referência completa vem com o acesso que a clínica concede.
O ciclo do orçamento
Criar, editar, aprovar, recusar, registrar o aceite e clonar.
- POST /orcamentos
- PUT /orcamentos/{orcamento_id}
- POST /orcamentos/{orcamento_id}/aprovar
- POST /orcamentos/{orcamento_id}/recusar
- POST /orcamentos/{orcamento_id}/aceite
- POST /orcamentos/{orcamento_id}/clonar
Da simulação à venda
Simular, criar o orçamento da simulação e converter o orçamento em venda.
- POST /vendas/simular
- POST /orcamentos/from-simulacao
- POST /vendas/de-orcamento/{orcamento_id}
Pendências
O que falta em cada orçamento: aceite, condição de pagamento e dias até a validade.
- GET /orcamentos/pendencias
token = post(AUTH, {"grant_type": "client_credentials",
"client_id": CLIENT_ID, "client_secret": CLIENT_SECRET})["access_token"]
pend = get(f"{API}/orcamentos/pendencias", token)
for o in pend["items"]:
if not o["tem_aceite"] and o["dias_ate_validade"] <= 7:
print(o["numero"], o["valor_total"], o["status"],
f'vence em {o["dias_ate_validade"]} dias')Regras
O motor de alçada
Recebe papel, desconto e tabela e responde: permitido, precisa de aprovação ou negado, com o motivo em linguagem da clínica.
- vendas_avaliar_desconto
Reavaliado a cada mudança
Adicionar item, dar desconto ou cortesia reavalia a alçada com os papéis de quem mexeu.
Aceite não é aprovação
Registrar o aceite do paciente guarda nome, texto e data, sem mudar o status do orçamento.
- POST /orcamentos/{orcamento_id}/aceite
Uma permissão por ação
orcamento.create, update, approve, reject; desconto.aprovar. O papel de quem pede decide o que passa.
Peça à sua IA
Pela conexão MCP, a IA que a clínica preferir age com as permissões de quem pediu: só faz o que essa pessoa pode fazer na Central.
Segurança para médicos builders- "Simula a venda do orçamento da Sabrina no PIX e em 10 vezes."vendas_get_orcamento · vendas_simular_parcelas
- "Um desconto de 25% na blefaroplastia precisa de aprovação para a recepção?"vendas_avaliar_desconto
- "Cria um orçamento de PRK para o Vinícius com validade de 30 dias. Me mostra antes."vendas_manage_orcamento
