Decodificação de Motor
Dados do veículo a partir do número do motor.
Resumo
| Item | Valor |
|---|---|
| Identificador técnico | decodificacao-motor |
| Dados exigidos | motor (no catálogo: motor) |
| O que devolve | JSON do veículo (sem FIPE) + PDF |
| Preço vigente | R$ 3,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-motor" \
-d '{"servico":"decodificacao-motor","motor":"KD05E1234567"}'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.
{
"placa": "ABC1D23",
"chassi": "9C2KD0540CR506454",
"motor": "KD05E1234567",
"renavam": "00123456789",
"marca": "HONDA",
"modelo": "NXR150 BROS ESD",
"cor": "VERMELHA",
"ano_fabricacao": "2011",
"ano_modelo": "2012",
"tipo": "MOTOCICLO",
"especie": "PASSAGEIRO",
"categoria": "PARTICULAR",
"situacao": "CIRCULACAO",
"municipio": "SALVADOR",
"uf": "BA",
"combustivel": "ALCOOL/GASOLINA",
"tipo_possivel": []
}Particularidades
- Não usa placa: o identificador é o número do motor.
- tipo_possivel vem sempre vazio neste serviço. marca e modelo podem vir null quando a base não os informa. Para FIPE, use decodificacao-chassi ou os endpoints de FIPE.
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.