Skip to main content

Introduction — Vehicle Collateral

The QI Tech Vehicle Collateral API enables tracking the registration of liens and vehicle contracts with the National Lien System (SNG/B3) and DETRAN/Registrar.

Lien registration, contract registration, image submission, and cancellation are handled internally by QI Tech based on the data sent when creating a credit operation (POST /debt). The endpoints below are exclusively for consultation (GET), allowing you to track registration progress in real time.

Features​

  • Queries — Current status and full request history
  • Queries by Chassis — Last order created or registered by chassis
  • Webhooks — Asynchronous status change notifications
  • Status Map — Reference for process stages and statuses

How it works​

  1. You simulate the credit operation via POST /debt_simulation with collateral_type: "car_collateral" to obtain financial conditions;
  2. You create the credit operation via POST /debt including vehicle data in the collaterals object (see Vehicle Collateral Fields);
  3. QI Tech internally processes lien registration at SNG/B3 and contract registration at DETRAN/Registrar;
  4. You track progress via GET endpoints and receive notifications via webhooks.
Authentication

Authentication for the consultation endpoints follows the standard QI Tech API pattern described in the Getting Started section.

Base URLs

Staging: Provided by QI Tech during onboarding.
Production: Provided by QI Tech after staging approval.

HTTP Codes

200 = Success · 400 = Validation failed · 401 = Unauthorized · 403 = Improper request · 404 = Not found · 500 = Internal error