Editar Proposta

Atualiza parcialmente os dados de uma proposta. Apenas os campos presentes no corpo da requisição serão modificados.

Requisição

Endpoint

• Metodo: PATCH
• Endpoint: /v2/proposals/{proposalId}

Parâmetros (Path)

Parâmetro	Tipo	Obrigatório	Descrição
proposalId	string (uuid)	✅	Identificador da proposta

Parâmetros (Body)

Todos os campos são opcionais. Envie apenas os campos que deseja alterar.

Parâmetro	Tipo	Descrição
name	string	Nome do tomador
dateOfBirth	string (date)	Data de nascimento do tomador
gender	string	Gênero do tomador
cpf	string	CPF do tomador
maritalStatus	EstadoCivil	Estado Civil do tomador
phone	string	Telefone do tomador
email	string	Email do tomador
creditContractId	string	Identificador do contrato de crédito
address	Address	Endereço do tomador

Exemplo de corpo

{
  "phone": "+5551999887766",
  "email": "novo@mail.com",
  "address": {
    "street": "Av. Ipiranga",
    "number": "6681",
    "zip": "90619-900",
    "neighborhood": "Partenon",
    "city": "Porto Alegre",
    "state": "RS"
  }
}

Resposta

Campos da resposta (200)

Retorna a proposta atualizada. Veja o schema completo em Consultar Proposta.

Exemplo (200)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa4",
  "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "PENDING_SIGNATURE",
  "expiresAt": "2025-08-11T02:07:49.030Z",
  "creditContractId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "quoteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "premium": "100.0",
  "luckyNumber": null,
  "coverageFrom": "2025-08-11T00:00:00.000Z",
  "coverageUntil": "2035-08-11T00:00:00.000Z",
  "loan": {
    "amount": "1000.0",
    "periodInMonths": 120
  },
  "person": {
    "name": "Fulano de Tal",
    "dateOfBirth": "2000-01-01",
    "gender": "M",
    "cpf": "01234567890",
    "maritalStatus": "SINGLE",
    "phone": "+5551999887766",
    "email": "novo@mail.com"
  },
  "address": {
    "street": "Av. Ipiranga",
    "number": "6681",
    "complement": null,
    "zip": "90619-900",
    "neighborhood": "Partenon",
    "city": "Porto Alegre",
    "state": "RS"
  },
  "signature": {
    "signatureId": null,
    "signedAt": null,
    "signatureProvider": null
  },
  "createdAt": "2025-08-10T02:07:49.030Z",
  "updatedAt": "2025-08-10T02:07:49.030Z",
  "cancelledAt": null
}

Erros

Código	HTTP	Descrição
NOT_FOUND	404	Proposta não encontrada.