Webhooks — Garantia Veicular
Atenção!
Os webhooks da QI Tech não devem ser mapeadas de forma restrita. Campos adicionais podem ser incluídos aos payloads dos webhooks retornados em nossas APIs.
Notificações assíncronas enviadas via POST. A requisição deve ser respondida em até 10 segundos com HTTP 200.
Webhook de Status do Pedido
Notifica sobre mudanças de status nas etapas de contrato, gravame e imagem.
Payload
| Campo | Tipo | Descrição |
|---|---|---|
| transactionId | String | ID da transação (36 chars) |
| status | String | Status do pedido (ver Mapa de Status) |
| msgRetornoPlataforma | String | Mensagem de retorno da plataforma |
| codigoQiTech | String | Identificador único do pedido |
| etapaAtual | String | Etapa atual (Inclusão de Gravame / Registro do Contrato / Aditivo do Contrato / Imagem de Contrato) |
| timestamp | DATETIME | Momento do envio |
| dataUltimaAtualizacao | DATETIME | Data da atualização na plataforma |
| gravame | String | Número do gravame ("0" quando não houver) |
| uf | String | UF onde gravame foi criado (2 chars) |
| chassi | String | Chassi do veículo |
Atenção
O status "Em Processamento" não é enviado via webhook para as etapas Registro do Contrato, Inclusão de Gravame e Aditivo de Contrato.
Configuração
O Webhook de Status requer URLs cadastradas + seleção de etapas/status desejados. Consulte o time de onboarding para configurar.