Status Map and Stages
API under development
The API is still in development phase, therefore, this manual is subject to changes.
Overview — Complete Lifecycle
The diagram below presents the complete lifecycle of a vehicle collateral operation, from debt creation through contract registration and image submission.
Collateral Lifecycle (Lien)
After the contract signature, QI Tech automatically sends the lien inclusion request to SNG/B3.
| Status | Enumerator | Description |
|---|---|---|
| Reservation Pending | pending_reservation | Data entered in the platform, awaiting submission to SNG/B3 |
| Reservation Confirmation Pending | pending_reservation_confirmation | Data sent to SNG/B3. Awaiting lien registration confirmation |
| Reserved | reserved | Lien registered successfully at SNG/B3. Operation ready for disbursement and contract registration |
| Requester Action Pending | pending_requester_action | Error in submitted data or restriction detected. Partner must correct and resubmit |
| Canceled | canceled | Request canceled on the platform |
Cancellation Lifecycle (Lien Deletion)
When an operation needs to be canceled after the lien has been registered, the deletion flow is triggered:
| Status | Enumerator | Description |
|---|---|---|
| Deletion Pending | pending_deletion | Cancellation requested, awaiting deletion submission to SNG/B3 |
| Deletion Confirmation Pending | pending_deletion_confirmation | Deletion request sent. Awaiting SNG/B3 confirmation |
| Deleted | deleted | Collateral and contract fully canceled at SNG/B3 and DETRAN |
Contract Lifecycle
After the lien is confirmed (reserved) and disbursement is completed, QI Tech automatically sends the contract registration to DETRAN/Registrar.
| Status | Enumerator | Description |
|---|---|---|
| Registration Confirmation Pending | pending_registration_confirmation | Contract sent to DETRAN/Registrar. Awaiting validation and registration |
| Registered | registered | Contract registered successfully at DETRAN. Next step: image submission |
| Contract Send Pending | pending_send_contract | Contract registered, awaiting contract image submission |
| Contract Send Confirmation Pending | pending_send_contract_confirmation | Image sent to DETRAN/Registrar. Awaiting validation |
| Requester Action Pending | pending_requester_action | DETRAN counter (DF/TO: debtor must appear in person) or invalid data/image |
| Deleted | deleted | Contract canceled on the platform |
Internal Statuses
Image validation statuses (e.g., invalid_image) are exclusively internal and are not sent to external clients via webhook.