Laudo ECV Premium

Base estadual e nacional, débitos, restrições, leilão e remarketing, roubo e furto, quilometragem, proprietários e anúncios.

ecv-premiumJSONPDFR$ 42,99

Resumo

Item	Valor
Identificador técnico	`ecv-premium`
Dados exigidos	placa (no catálogo: `placa`)
O que devolve	JSON estruturado no formato da Consulta Completa (historicoKm, historicoProprietarios, rouboFurto, csv e blocos inclusos, sem fotosLeilao) mais remarketing, anuncios e codigosFipe + PDF
Preço vigente	R$ 42,99. Com a sua chave, `GET /v1/servicos` traz o seu preço.
Prazo	Poucos minutos.
Bloco veiculo	Sim (contrato normalizado da ZapCar)
Observação	Traz a cadeia de proprietários com documento: dado pessoal de terceiros.

Requisição

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

cURLPOST /v1/consultas (ecv-premium)

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-ecv-premium" \
  -d '{"servico":"ecv-premium","placa":"ABC1D23"}'

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`, `veiculo`, `risco` e `pdf_url`.
erro	Valor estornado. `erro_codigo` diz o motivo e `retryable` se vale criar uma consulta nova.

Campo dados

Estruturado por seção, no contrato da família da Consulta Completa.

JSONExemplo ilustrativo: campo dados (ecv-premium)

{
  "placa": "ABC1D23",
  "marcaModelo": "FORD/FOCUS TI 2.0",
  "leilao": { "baseDisponivel": true, "ocorrencias": [
    { "lote": "88", "data": "12/08/2020", "leiloeiro": "LEILOES SA", "comitente": "FROTA Y", "condicao": "PEQUENA MONTA" }
  ] },
  "remarketing": {
    "marcaModelo": "FORD/FOCUS", "situacaoChassi": "NORMAL", "segmento": "FINANCEIRA", "subSegmento": "RETOMADA",
    "checklist": { "dataInspecao": "28/05/2019", "garantia": "SEM GARANTIA", "fotos": 2,
      "itens": [{ "parte": "Frente", "estado": "AMASSADO" }, { "parte": "Motor", "estado": "OK" }] }
  },
  "anuncios": [{ "data": "10/03/2024", "km": 82000, "valor": 45900, "opcionais": ["AR CONDICIONADO"], "fotos": 1 }],
  "codigosFipe": ["003281-6"],
  "historicoKm": { "registros": [{ "km": 82000, "data": "10/03/2024", "dataIso": "2024-03-10" }], "inconsistente": false },
  "blocos": { "REMARKETING": { "respondeu": true, "quantidade": 1, "descricao": null } }
}

O bloco veiculo é o mesmo em todos os serviços que o têm. Ver o exemplo completo em Resultados e os campos no dicionário.

Particularidades

Mesmo formato de dados da consulta-completa, sem fotosLeilao, com três blocos a mais: remarketing, anuncios e codigosFipe.
As passagens por leilão do remarketing entram em leilao.ocorrencias.
Traz a cadeia de proprietários com documento: dado pessoal de terceiros.

No sandbox

Cenário escolhido pela placa (TST0001 limpo, TST0002 gravame, TST0003 RENAJUD, TST0004 débitos, TST0005 sinistro e leilão, TST0404 não encontrado, TST0503 falha retentável, TST9999 nunca conclui). Bloco veiculo fiel ao contrato; dados reduzido e marcado com _sandbox.

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.