Collateral Auto

Esta seção descreve as propriedades do objeto Collateral, que representa os dados da garantia de quem solicita o empréstimo para Garantia de auto.


Informações do veículo

Para melhor preenchimento das informações do veículo disponibilizamos endpoints para consulta de marca, modelo e valores à partir do ano que deseja consultar.

Acesse e veja mais informações.



Informações sobre os campos do payload


Request Body

CampoTipoObrigatórioDescrição
valuedouble Sim* (consulte informações)Valor da garantia
debtdoubleSimValor da dívida do veículo
brandstringSimMarca do veículo
Veja como consultar as marcas de veículos aceitas
modelstringSimModelo do veículo
Veja como consultar os modelos de veículos aceitos
modelYearintegerSimAno modelo do veículo
manufacturingYearintegerSimAno de fabricação do veículo
modelVersionstringSimVersão do modelo
Ex: HB20 VISION 1.0 12V MT5
borrowerVehicleOwnerbooleanSimSe o lead é o proprietário do veículo
licensePlatestringSimPlaca do veículo
numberOfDoors integer SimNúmero de portas
fuelTypestringSimTipo de combustível
Ex: Alcool
accessoryPackagestring SimPacote de acessórios do carro
Ex: Basico ou Completo
molicarCodestringNãoCódigo correspondente na tabela Molicar
ownerKinshipDegreestringNãoProprietário do veículo
Consulte os Valores para ownerKinshipDegree.

Informações sobre o campo value

Se você utilizar os endoints de Informações do veículo para obter as informações e nos enviar igualmente, o campo value não deverá ser enviado na request.
Isso ocorre porque ao enviar o response da consulta do modelo do veículo, o campo value é obtido através de chamadas internas em nossa API no momento da criação do lead - usando o valor exato do modelo passado - o que resulta em uma análise correta da garantia em questão.

Caso você solicite ao seu cliente e nos envie essa informação na request da criação da proposta, o campo value sobrescreverá o valor correto da garantia de acordo com nossa busca interna.


Exemplo do objeto JSON

{
  "collateral": {
        "brand": "HYUNDAI",
        "model": "HB20",
        "modelYear": 2021,
        "manufacturingYear": 2020,
        "modelVersion": "VISION 1.0 12V MT5",
        "borrowerVehicleOwner": true,
        "debt": 0,
        "licensePlate": "abc1234",
        "numberOfDoors": 4,
        "fuelType": "ALCO/GASOL.",
        "accessoryPackage": "Basico"
    }
}