Criar Proposta

Requisição

Endpoint

• Metodo: POST
• Endpoint: /v2/proposals

Parâmetros (Body)

Parâmetro	Tipo	Obrigatório	Descrição
name	string	✅	Nome do tomador
date_of_birth	string (date)	✅	Data de nascimento do tomador
gender	string	✅	Gênero do tomador
cpf	string	✅	CPF do tomador
marital_status	EstadoCivil	✅	Estado Civil do tomador
phone	string	✅	Telefone do tomador
email	string	✅	Email do tomador
credit_contract_id	string	✅	Identificador do contrato de crédito
quote_id	string (uuid)	✅	Identificador da cotação
address	Address	✅	Endereço do tomador

Tipo Address

Parâmetro	Tipo	Obrigatório	Descrição
street	string	✅	Logradouro
number	string	✅	Número
complement	string	❌	Complemento
zip	string	✅	CEP
neighborhood	string	✅	Bairro
city	string	✅	Cidade
state	string	✅	Estado (UF)

Exemplo de corpo

{
  "name": "Fulano de Tal",
  "date_of_birth": "2000-01-01",
  "gender": "M",
  "cpf": "01234567890",
  "marital_status": "SINGLE",
  "phone": "+5551998043043",
  "email": "fulano@mail.com",
  "credit_contract_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "quote_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "address": {
    "street": "Rua das Flores",
    "number": "123",
    "complement": "Apto 4",
    "zip": "90010-000",
    "neighborhood": "Centro",
    "city": "Porto Alegre",
    "state": "RS"
  }
}

Resposta

Campos da resposta (200)

Parâmetro	Tipo	Descrição
id	string (uuid)	Identificador da proposta
client_id	string (uuid)	Identificador do cliente
status	string	Status da proposta
expires_at	string (date-time)	Data de expiração da proposta
credit_contract_id	string	Identificador do contrato de crédito
quote_id	string (uuid)	Identificador da cotação
premium	string	Prêmio do seguro
lucky_number	integer | null	Número da sorte (se aplicável)
coverage_from	string (date-time)	Início da cobertura
coverage_until	string (date-time)	Fim da cobertura
loan.amount	string	Valor emprestado
loan.period_in_months	integer	Duração do empréstimo (em meses)
person	PersonInfo	Informações do tomador
address	Address	Endereço do tomador
signature	Signature	Informações da assinatura
created_at	string (date-time)	Data de criação
updated_at	string (date-time)	Data da última atualização
cancelled_at	string (date-time) | null	Data de cancelamento

Exemplo (200)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa4",
  "client_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "PENDING_SIGNATURE",
  "expires_at": "2025-08-11T02:07:49.030Z",
  "credit_contract_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "quote_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "premium": "100.0",
  "lucky_number": null,
  "coverage_from": "2025-08-11T00:00:00.000Z",
  "coverage_until": "2035-08-11T00:00:00.000Z",
  "loan": {
    "amount": "1000.0",
    "period_in_months": 120
  },
  "person": {
    "name": "Fulano de Tal",
    "date_of_birth": "2000-01-01",
    "gender": "M",
    "cpf": "01234567890",
    "marital_status": "SINGLE",
    "phone": "+5551999998888",
    "email": "fulano@mail.com"
  },
  "address": {
    "street": "Rua das Flores",
    "number": "123",
    "complement": "Apto 4",
    "zip": "90010-000",
    "neighborhood": "Centro",
    "city": "Porto Alegre",
    "state": "RS"
  },
  "signature": {
    "signature_id": null,
    "signed_at": null,
    "signature_provider": null
  },
  "created_at": "2025-08-10T02:07:49.030Z",
  "updated_at": "2025-08-10T02:07:49.030Z",
  "cancelled_at": null
}

Erros

Código	HTTP	Descrição
NOT_FOUND	404	Cotação não encontrada.
DUPLICATE_PROPOSAL	409	Já existe uma proposta ativa para esse contrato.
AGE_NOT_ACCEPTABLE	422	Idade do tomador fora das regras de aceitação.
VALIDATION_ERROR	400	Um ou mais campos inválidos.