Vehicle Collateral Fields

When creating a credit operation with vehicle collateral via POST /debt, vehicle data must be included in the collaterals object of the request body with collateral_type: "car_collateral". QI Tech uses this data to internally process lien registration at SNG/B3 and contract registration at DETRAN/Registrar.

Important

You do not need to call separate endpoints to register liens or contracts. Simply send the fields below when creating the credit operation and QI Tech will handle the entire process internally.

Collaterals Object Structure

{
    "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"
                }
            }
        }
    ]
}

collateral_data Fields

Field	Type	Description	Req.
plate	String	Vehicle plate (7 characters)	YES
licensing_state	String	Vehicle licensing state (2 chars, uppercase)	YES
licensing_city	String	Vehicle licensing city	YES
renavam	String	RENAVAM number (11 digits)	YES
chassi_type	String	Chassis type (Remarcado or Normal)	YES
chassi_number	String	Vehicle chassis number (4 to 21 chars, alphanumeric)	YES
kilometers	Integer	Current vehicle mileage	YES
car_color	String	Vehicle color	YES
car_value	Float	Vehicle value (2 decimal places)	YES
subcorban_document_number	String	Banking correspondent CNPJ (14 digits)	YES

model Object

Field	Type	Description	Req.
brand	String	Vehicle brand	YES
name	String	Vehicle model name	YES
year	String	Model year	YES
manufacturing_year	String	Manufacturing year	YES

seller Object

Field	Type	Description	Req.
name	String	Seller name	YES
document_number	String	Seller CPF (11 digits) or CNPJ (14 digits)	YES

collaterals Level Fields

Field	Type	Description	Req.
percentage	Float	Collateral percentage (1 = 100%)	YES
collateral_type	String	Collateral type. Must be "car_collateral"	YES
collateral_data	Object	Object containing vehicle data (see tables above)	YES

Enumerators

chassi_type

Value	Description
Remarcado	Remarked chassis
Normal	Normal chassis (default)