Campos da Garantia Veicular

Ao criar uma operação de crédito com garantia veicular via POST /debt, os dados do veículo devem ser incluídos no objeto collaterals do request body com collateral_type: "car_collateral". A QI Tech utiliza esses dados para realizar internamente a inclusão de gravame no SNG/B3 e o registro do contrato no DETRAN/Registradora.

Importante

Você não precisa chamar endpoints separados para registrar gravame ou contrato. Basta enviar os campos abaixo na criação da operação de crédito e a QI Tech cuidará de todo o processo internamente.

Estrutura do Objeto Collaterals

{
    "collaterals": [
        {
            "percentage": 1,
            "collateral_type": "car_collateral",
            "collateral_data": {
                "plate": "ABC1D23",
                "licensing_state": "SP",
                "licensing_city": "São Paulo",
                "renavam": "12345678901",
                "chassi_type": "Remarcado",
                "chassi_number": "9BWZZZ37780001234",
                "kilometers": 45000,
                "car_color": "Prata",
                "car_value": 85000.00,
                "subcorban_document_number": "12345678000195",
                "model": {
                    "brand": "Toyota",
                    "name": "Corolla XEI 2.0",
                    "year": "2022",
                    "manufacturing_year": "2021"
                },
                "seller": {
                    "name": "João da Silva Automóveis",
                    "document_number": "98765432000100"
                }
            }
        }
    ]
}

Campos do collateral_data

Campo	Tipo	Descrição	Obrig.
plate	String	Placa do veículo (7 caracteres)	SIM
licensing_state	String	UF de licenciamento do veículo (2 chars, sigla caixa alta)	SIM
licensing_city	String	Cidade de licenciamento do veículo	SIM
renavam	String	Número do RENAVAM (11 dígitos)	SIM
chassi_type	String	Tipo de chassi (Remarcado ou Normal)	SIM
chassi_number	String	Número do chassi do veículo (4 a 21 caracteres, alfanumérico)	SIM
kilometers	Integer	Quilometragem atual do veículo	SIM
car_color	String	Cor do veículo	SIM
car_value	Float	Valor do veículo (2 casas decimais)	SIM
subcorban_document_number	String	CNPJ do correspondente bancário (14 dígitos)	SIM

Objeto model

Campo	Tipo	Descrição	Obrig.
brand	String	Marca do veículo	SIM
name	String	Nome do modelo do veículo	SIM
year	String	Ano do modelo	SIM
manufacturing_year	String	Ano de fabricação	SIM

Objeto seller

Campo	Tipo	Descrição	Obrig.
name	String	Nome do vendedor	SIM
document_number	String	CPF (11 dígitos) ou CNPJ (14 dígitos) do vendedor	SIM

Campos do nível collaterals

Campo	Tipo	Descrição	Obrig.
percentage	Float	Percentual da garantia (1 = 100%)	SIM
collateral_type	String	Tipo de garantia. Deve ser "car_collateral"	SIM
collateral_data	Object	Objeto contendo os dados do veículo (ver tabelas acima)	SIM

Enumeradores

chassi_type

Valor	Descrição
Remarcado	Chassi remarcado
Normal	Chassi normal (padrão)