Decodificação de Chassi
Marca, modelo, ano e características a partir do chassi.
Resumo
| Item | Valor |
|---|---|
| Identificador técnico | decodificacao-chassi |
| Dados exigidos | chassi (no catálogo: chassi) |
| O que devolve | JSON do provedor + PDF |
| Preço vigente | R$ 2,99. Com a sua chave, GET /v1/servicos traz o seu preço. |
| Prazo | Poucos minutos. |
| Bloco veiculo | Não |
Requisição
Pelo endpoint comum de consultas, POST /v1/consultas. Os valores do exemplo são fictícios.
curl -X POST "https://api.zapcarconsulta.com.br/v1/consultas" \
-H "Authorization: Bearer $ZAPCAR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: pedido-erp-984281-decodificacao-chassi" \
-d '{"servico":"decodificacao-chassi","chassi":"9C2KD0540CR506454"}'Resposta
O POST devolve 201 com o id e status: "processando". O resultado sai em GET /v1/consultas/{id}, que passa por um destes estados:
| status | O que vem |
|---|---|
| processando | Só o envelope. Consulte de novo em 3 a 5 s. |
| concluido | dados e pdf_url. |
| erro | Valor estornado. erro_codigo diz o motivo e retryable se vale criar uma consulta nova. |
Campo dados
No formato da base consultada (camada de espelho): nomes e preenchimento acompanham a fonte. Para dado com forma garantida, use o bloco veiculo quando o serviço tiver.
Particularidades
- Não usa placa: o identificador é o chassi.
- tipo_possivel[] traz sugestões da Tabela FIPE e pode vir vazio quando não há correspondência.
No sandbox
Sem placa, os cenários TST* não se aplicam: a consulta conclui com dados fictício reduzido e, como em produção, sem bloco veiculo.
Cobrança
Debitado no POST, antes do processamento, e estornado automaticamente se a consulta terminar em erro. Pedido recusado na validação (400, 402, 409, 422) não cobra. Ler o resultado e baixar o documento são gratuitos. Ver Cobrança e estorno.
Testar no sandbox: abrir no API Explorer. Base da API: https://api.zapcarconsulta.com.br.