PATCH/api/budgets/{id}

Atualizar Orçamentos

Atualiza um orçamento existente

Access Token

Para realizar requisições GET, POST, PUT, DELETE e PATCH nos endpoints da API você precisa de uma chave de autorização. Chamamos essa chave de accessToken.

Para ter acesso ao accessToken, é necessário que o usuário master da licença efetue a liberação deste pela interface do ImageMais Clinic. O accessToken tem validade de 1 hora.

Headers

AuthorizationOBRIGATÓRIO
Tipo:string
Token de autenticação no formato Bearer {accessToken}
Content-TypeOBRIGATÓRIO
Tipo:application/json
Tipo de conteúdo (application/json)

Parâmetros

idOBRIGATÓRIO
Tipo:number
ID do orçamento

Este parâmetro representa o ID do orçamento que será utilizado na requisição. O ID é um número único que identifica cada orçamento no sistema.

Observação: Para encontrar o ID do orçamento, para acessar a página de listar orçamentos.

Atenção: Caso o ID passado não exista no sistema, a requisição retornará um erro 404 Not Found.

statusIdOBRIGATÓRIO
Tipo:string
Status do orçamento (SEND, PENDING, FaIl)

Este parâmetro representa o status do orçamento. É um campo obrigatório e deve conter um dos valores aceitos pelo sistema.

Valores aceitos:

  • SEND - Orçamento enviado
  • PENDING - Orçamento pendente
  • FAIL - Orçamento com falha

Atenção: Caso seja passado um valor diferente dos valores aceitos (SEND, PENDING, FAIL), a API retornará um erro 400 Bad Request. Certifique-se de usar exatamente um dos valores listados acima.

patientOBRIGATÓRIO
Tipo:object
Dados do paciente

Este parâmetro é um objeto que contém todos os dados do paciente, incluindo informações pessoais, endereço e contato. O objeto patient é obrigatório e deve conter pelo menos o campo name.

Campos do objeto patient:

  • name (obrigatório) - Nome do paciente
  • cpf (Opcional) - CPF do paciente
  • contact (obrigatório) - Objeto com phone

Atenção: Caso o campo name seja removido da requisição, não seja fornecido ou esteja vazio, a API retornará um erro 400 Bad Request

Observação sobre o CPF: O campo cpf é opcional. Caso não seja fornecido na requisição, o orçamento será criado normalmente. No entanto, se o campo cpf for informado de forma inválida (formato incorreto, quantidade de caracteres insuficiente ou valores não numéricos), a API retornará um erro 400 Bad Request.

dateBirthOPCIONAL
Tipo:date
Data de nascimento do paciente (formato: YYYY-MM-DD)

Este parâmetro representa a data de nascimento do paciente. O campo é opcional e pode ser omitido na requisição sem causar erros.

Formato:

dateBirth: "2000-01-01"

Atenção: Caso o campo dateBirth seja fornecido na requisição, ele deve estar no formato correto (YYYY-MM-DD) e ser uma data válida. Se o formato estiver incorreto ou a data for inválida, a API retornará um erro 400 Bad Request com a mensagem: "patient.dateBirth must be a Date instance".

genderOPCIONAL
Tipo:string
Gênero do paciente (M ou F)

Este parâmetro representa o gênero do paciente. O campo é opcional e pode ser omitido na requisição sem causar erros.

Valores aceitos:

  • M - Masculino
  • F - Feminino

Atenção: Caso o campo gender seja fornecido na requisição, ele deve conter um dos valores aceitos (M ou F). Se for passado um valor diferente ou inválido, a API retornará um erro 400 Bad Request.

Request URL

https://api-dev.imagemais.com/api/budgets
curl -X 'PATCH' \
  'https://api-dev.imagemais.com/api/budgets' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOjEwLCJhY2NvdW50SWQiOjEsImlhdCI6MTc2NDg2NTEyMCwiZXhwIjoxNzY0ODY4NzIwLCJhdWQiOiJodHRwczovL2FwaS1kZXYuaW1hZ2VtYWlzLmNvbSIsImlzcyI6Imh0dHBzOi8vYXBwLWRldi5pbWFnZW1haXMuY29tIn0.oH8SXEgUN5WQ-hl9eEenIBGPibWXZGdxVhFlYpztjbI' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": 10722,
  "status": "SEND",
  "patient": {
    "name": "João da Silva",
    "cpf": "12345678900",
    "contact": {
      "phone": "81988727387"
    },
    "dateBirth": "2000-01-01",
    "gender": "F"
  }
}'
{
  "id": 10722,
  "status": "SEND",
  ...
{
  "id": 10722,
  "status": "SEND",
  "patient": {
    "name": "João da Silva",
    "cpf": "12345678900",
    "contact": {
      "phone": "81988727387"
    },
    "dateBirth": "2000-01-01",
    "gender": "F"
  }
}

Respostas

{
  "id": 1,
  "createUserId": 8,
  ...
{
  "id": 1,
  "createUserId": 8,
  "patientId": 6,
  "statusId": 2,
  "discountId": 1,
  "createdAt": "2025-03-07T13:34:14.785Z",
  "updatedAt": "2025-12-04T16:43:31.976Z",
  "deletedAt": null
}
{
  "message": [
    "patient.dateBirth must be a Date instance"
  ...
{
  "message": [
    "patient.dateBirth must be a Date instance"
  ],
  "error": "Bad Request"
}
{
  "message": [
    "status must be one of the following values: SEND, PENDING, FaIl"
  ...
{
  "message": [
    "status must be one of the following values: SEND, PENDING, FaIl"
  ],
  "error": "Bad Request"
}
{
  "message": [
    "gender must be one of the following values: M, F"
  ...
{
  "message": [
    "gender must be one of the following values: M, F"
  ],
  "error": "Bad Request"
}
{
  "message": [
    "patient.name should not be empty",
  ...
{
  "message": [
    "patient.name should not be empty",
    "patient.name must be shorter than or equal to 200 characters",
    "patient.name must be a string"
  ],
  "error": "Bad Request"
}
{
  "statusCode": 401,
  "message": "invalid token"
  ...
{
  "statusCode": 401,
  "message": "invalid token"
}
{
  "statusCode": 401,
  "message": "jwt expired"
  ...
{
  "statusCode": 401,
  "message": "jwt expired"
}
{
  "statusCode": 500,
  "message": "Internal server error"
  ...
{
  "statusCode": 500,
  "message": "Internal server error"
}