Detalhe Comunicação de Venda
Data da venda e do registro, nome e CPF/CNPJ do comprador e documento do vendedor, quando há comunicação de venda registrada.
Resumo
| Item | Valor |
|---|---|
| Identificador técnico | comunicacao-venda |
| Dados exigidos | placa, finalidade e declaracao_finalidade: true (no catálogo: placa) |
| O que devolve | JSON com a data da venda e do registro, o comprador (nome e CPF/CNPJ) e o documento do vendedor + PDF |
| Preço vigente | R$ 6,99. Com a sua chave, GET /v1/servicos traz o seu preço. |
| Prazo | Poucos minutos. |
| Bloco veiculo | Não |
| Observação | Traz dado pessoal do comprador: exige finalidade declarada e fica registrado quem consultou, quando e para quê. Sem comunicação registrada, nada é cobrado. |
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-comunicacao-venda" \
-d '{"servico":"comunicacao-venda","placa":"ABC1D23","finalidade":"NEGOCIACAO_VEICULO","declaracao_finalidade":true}'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",
"renavam": "01253850418",
"data_venda": "2025-08-22",
"data_registro_venda": "2025-08-22",
"comprador": { "nome": "FULANO DE TAL", "documento": "12345678909", "tipo_documento": "CPF" },
"vendedor": { "documento": "12345678000195", "tipo_documento": "CNPJ" }
}Particularidades
- finalidade e declaracao_finalidade: true são obrigatórios: sem eles, 400 FINALIDADE_OBRIGATORIA antes de cobrar.
- Sem comunicação de venda registrada, a consulta termina em erro com retryable: false e o valor é estornado.
- Devolve nome e CPF/CNPJ completos do comprador: dado pessoal de terceiro.
No sandbox
Valida finalidade e declaração como a produção e devolve dados fictício no formato do serviço, sem bloco veiculo. Cenários de erro pela placa: TST0404 e TST0503.
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.