Introdução — Garantia Veicular

A API de Garantia Veicular da QI Tech permite o acompanhamento do registro de gravames e contratos veiculares junto ao Sistema Nacional de Gravame (SNG/B3) e ao DETRAN/Registradora.

O registro de gravame, contrato, envio de imagem e cancelamento são realizados internamente pela QI Tech a partir dos dados enviados na criação da operação de crédito (POST /debt). Os endpoints abaixo são exclusivamente de consulta (GET), permitindo que você acompanhe o progresso do registro em tempo real.

Funcionalidades

• Consultas — Status atual e histórico completo de pedidos
• Consultas por Chassi — Último pedido criado ou registrado por chassi
• Webhooks — Notificações assíncronas de mudanças de status
• Mapa de Status — Referência de etapas e status do processo

Como funciona

1. Você simula a operação de crédito via POST /debt_simulation com collateral_type: "car_collateral" para obter as condições financeiras;
2. Você cria a operação de crédito via POST /debt incluindo os dados do veículo no objeto collaterals (veja Campos da Garantia Veicular);
3. A QI Tech processa internamente a inclusão de gravame no SNG/B3 e o registro do contrato no DETRAN/Registradora;
4. Você acompanha o progresso via endpoints GET e recebe notificações via webhooks.

Autenticação

A autenticação para os endpoints de consulta segue o padrão da API QI Tech descrito na seção de Primeiros Passos.

URLs Base

Homologação: Fornecida pela QI Tech durante o onboarding.
Produção: Fornecida pela QI Tech após homologação.

Códigos HTTP

200 = Sucesso · 400 = Falha na validação · 401 = Não autorizado · 403 = Requisição indevida · 404 = Não encontrado · 500 = Erro interno