Skip to main content

POST Criar Orçamento

Cria um novo orçamento. O paciente é criado (se não tiver id) ou atualizado (se tiver id), e o orçamento nasce com status PENDING.

Envia WhatsApp ao paciente e cria proposta no Feegow

Logo após criar, a rota dispara os mesmos eventos de Notificar Orçamento (budget.notify — mensagem do orçamento via BotConversa para o telefone do paciente; o status passa a SEND ou FAIL conforme o envio) e create-proposal.feegow (proposta no Feegow, quando a integração está configurada). Não há como criar um orçamento "silencioso" por esta rota — cuidado ao testar com pacientes reais.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige a permissão create_budgets.


Endpoint​

POST https://api-dev.imagemais.com.br/api/budgets

Corpo da Requisição​

CampoTipoObrigatórioDescrição
patientobject✅Dados do paciente. Com id → atualiza; sem id → cria novo
patient.idnumber❌ID do paciente existente (para atualizar)
patient.namestring✅Nome completo. Obrigatório também com patient.id — sem ele a atualização do paciente falha com 500 "Erro ao atualizar paciente"
patient.dateBirthstring❌Data de nascimento (YYYY-MM-DD, hoje ou anterior)
patient.genderobject❌Gênero. Ex.: { "name": "M" }
patient.cpfstring❌CPF do paciente (exatamente 11 dígitos)
patient.contactobject❌Dados de contato (telefone, e-mail)
patient.addressobject❌Dados de endereço
proceduresarray✅Lista de procedimentos do orçamento
procedures[].idnumber✅ID do procedimento
procedures[].discountIdnumber❌ID do desconto individual do procedimento
procedures[].discountValuenumber❌Valor de desconto customizado para o procedimento
discountIdnumber❌ID de um desconto geral aplicado a todo o orçamento
budgetRequestUuidstring❌UUID (v7) da requisição de orçamento de origem
reasonstring❌Motivo/observação do orçamento (máx. 500 caracteres)
customDiscountobject❌Desconto avulso no total do orçamento: kind (PERCENT ou FIXED), value (percentual de 0,01 a 100, ou valor fixo maior que 0, com até 2 casas) e reason (3 a 200 caracteres). O servidor calcula o valor em reais
Descontos

Se um discountId geral for informado, ele tem precedência e os descontos individuais por procedimento são ignorados. Descontos expirados retornam 400 Bad Request.


Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/budgets' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"patient": {
"name": "João da Silva",
"dateBirth": "2000-01-01",
"cpf": "12345678900",
"gender": { "name": "M" },
"contact": { "phone": "81999999999" }
},
"procedures": [
{ "id": 1, "price": 252 }
]
}'

Respostas​

201 Criado​

{
"id": 25267,
"user": {
"id": 1,
"name": "Roberto Luis"
},
"budgetsProcedures": [
{
"price": "252"
}
],
"patient": {
"id": 17541,
"name": "João da Silva",
"contact": {
"phone": "81999999999"
}
},
"status": {
"name": "PENDING"
},
"createdAt": "2026-01-15T13:43:13.337Z",
"updatedAt": "2026-01-15T13:43:13.337Z",
"deletedAt": null
}

400 Desconto expirado​

{
"message": "Desconto expirado",
"error": "Bad Request",
"statusCode": 400
}

400 Bad Request​

{
"message": [
"patient should not be null or undefined",
"procedures must be an array"
],
"error": "Bad Request",
"statusCode": 400
}

500 Erro ao criar​

{
"message": "Erro ao criar orçamento",
"error": "Internal Server Error",
"statusCode": 500
}