Débitos Estaduais

Débitos na base estadual; campos exigidos variam por UF.

debitos-estadualJSONPDFR$ 6,99

Resumo

Item	Valor
Identificador técnico	`debitos-estadual`
Dados exigidos	placa e uf (as 27 UFs); renavam, documento e chassi não são mais exigidos (no catálogo: `placa, uf`)
O que devolve	JSON por categoria (IPVA, licenciamento, DPVAT, multas) + PDF
Preço vigente	R$ 6,99. Com a sua chave, `GET /v1/servicos` traz o seu preço.
Prazo	Poucos minutos; pode variar conforme a base do estado.
Bloco veiculo	Não

Requisição

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

cURLPOST /v1/consultas (debitos-estadual)

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-debitos-estadual" \
  -d '{"servico":"debitos-estadual","placa":"ABC1D23","uf":"SP"}'

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.

JSONExemplo ilustrativo: campo dados (debitos-estadual)

{
  "veiculo": { "placa": "ABC1D23", "renavam": "12345678901", "chassi": "9BWZZZ377VT004251", "marca": "VW", "modelo": "GOL", "ano_fabricacao": "2018", "ano_modelo": "2019", "uf": "SP" },
  "ipvas": [ { "descricao": "IPVA", "valor": 512.30, "status": "EM ABERTO" } ],
  "licenciamentos": [ { "descricao": "Licenciamento", "valor": 167.74, "status": "EM ABERTO" } ],
  "dpvats": [],
  "multas": [
    { "descricao": "Multas DETRAN", "orgao": "DETRAN", "valor": 195.23, "status": "EM ABERTO" },
    { "descricao": "EXCESSO DE VELOCIDADE", "orgao": "DER-MG", "ait": "X000000000", "data_infracao": "01/02/2026", "vencimento": null, "valor": 130.16, "status": "EM ABERTO" }
  ]
}

Particularidades

Basta placa e uf, em qualquer uma das 27 UFs. renavam, documento e chassi, se enviados, são ignorados.
UF ausente ou inválida é recusada com 400 UF_INDISPONIVEL, antes de cobrar (também no sandbox).
Item com valor: null é débito confirmado sem valor informado, nunca "nada consta".

No sandbox

Cenários de erro e de espera pela placa (TST0404 não encontrado, TST0503 falha retentável, TST9999 nunca conclui); qualquer outra placa conclui. Como em produção, a resposta não traz bloco veiculo; dados vem 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.