Mapa de Status e Etapas
A API ainda está em fase de desenvolvimento, sendo assim, este manual está sujeito a alterações.
Visão Geral — Ciclo de Vida Completo
O diagrama abaixo apresenta o ciclo de vida completo de uma operação com garantia veicular, desde a criação da dívida até a conclusão do registro de contrato e imagem.
Ciclo de Vida do Colateral (Gravame)
Após a assinatura do contrato, a QI Tech envia automaticamente a solicitação de inclusão de gravame ao SNG/B3.
| Status | Enumerador | Descrição |
|---|---|---|
| Reserva Pendente | pending_reservation | Dados inseridos na plataforma, aguardando envio ao SNG/B3 |
| Confirmação de Reserva Pendente | pending_reservation_confirmation | Dados enviados ao SNG/B3. Aguardando confirmação do registro de gravame |
| Reservado | reserved | Gravame registrado com sucesso no SNG/B3. Operação pronta para desembolso e registro de contrato |
| Ação do Requester Pendente | pending_requester_action | Erro nos dados enviados ou restrição detectada. Parceiro deve corrigir e reenviar |
| Cancelado | canceled | Solicitação cancelada na plataforma |
Ciclo de Cancelamento (Exclusão do Gravame)
Quando uma operação precisa ser cancelada após o gravame ter sido registrado, o fluxo de exclusão é acionado:
| Status | Enumerador | Descrição |
|---|---|---|
| Exclusão Pendente | pending_deletion | Cancelamento solicitado, aguardando envio da exclusão ao SNG/B3 |
| Confirmação de Exclusão Pendente | pending_deletion_confirmation | Solicitação de exclusão enviada. Aguardando confirmação do SNG/B3 |
| Excluído | deleted | Colateral e contrato totalmente cancelados no SNG/B3 e DETRAN |
Ciclo de Vida do Contrato
Após o gravame ser confirmado (reserved) e o desembolso realizado, a QI Tech envia automaticamente o registro de contrato ao DETRAN/Registradora.
| Status | Enumerador | Descrição |
|---|---|---|
| Confirmação de Registro Pendente | pending_registration_confirmation | Contrato enviado ao DETRAN/Registradora. Aguardando validação e registro |
| Registrado | registered | Contrato registrado com sucesso no DETRAN. Próximo passo: envio de imagem |
| Envio de Contrato Pendente | pending_send_contract | Contrato registrado, aguardando envio de imagem do contrato |
| Confirmação de Envio de Contrato Pendente | pending_send_contract_confirmation | Imagem enviada ao DETRAN/Registradora. Aguardando validação |
| Ação do Requester Pendente | pending_requester_action | Balcão DETRAN (DF/TO: devedor deve comparecer fisicamente) ou dados/imagem inválidos |
| Excluído | deleted | Contrato cancelado na plataforma |
Os status de validação de imagem (ex: invalid_image) são exclusivamente internos e não são enviados aos clientes externos via webhook.