Pular para o conteúdo
ZapCar
Developersv1

Decodificação de Chassi

Marca, modelo, ano e características a partir do chassi.

decodificacao-chassiJSONPDFR$ 2,99

Resumo

ItemValor
Identificador técnicodecodificacao-chassi
Dados exigidoschassi (no catálogo: chassi)
O que devolveJSON do provedor + PDF
Preço vigenteR$ 2,99. Com a sua chave, GET /v1/servicos traz o seu preço.
PrazoPoucos minutos.
Bloco veiculoNão

Requisição

Pelo endpoint comum de consultas, POST /v1/consultas. Os valores do exemplo são fictícios.

cURLPOST /v1/consultas (decodificacao-chassi)
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:

statusO que vem
processandoSó o envelope. Consulte de novo em 3 a 5 s.
concluidodados e pdf_url.
erroValor 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.

JSONExemplo ilustrativo: campo dados (decodificacao-chassi)
{
  "placa": "ABC1D23",
  "placa_mercosul": "ABC1D23",
  "chassi": "9C2KD0540CR506454",
  "motor": "KD05E1234567",
  "marca": "HONDA",
  "modelo": "NXR150 BROS ESD",
  "cor": "VERMELHA",
  "ano_fabricacao": "2011",
  "ano_modelo": "2012",
  "tipo": "MOTOCICLO",
  "especie": "PASSAGEIRO",
  "uf": "BA",
  "combustivel": "ALCOOL/GASOLINA",
  "municipio": "CONCEICAO DO JACUIPE",
  "importado": "NAO",
  "tipo_possivel": [
    {
      "referencia": "julho/2026",
      "tipo_codigo": "811154-3",
      "ano_modelo": "2012",
      "tipo_veiculo": "MOTOCICLETA",
      "marca": "HONDA",
      "modelo": "NXR 150 BROS ESD",
      "combustivel": "GASOLINA",
      "valor": "R$ 9.800,00"
    }
  ]
}

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.