Retorna informações detalhadas sobre o histórico de veículos de uma Pessoa Física ou Jurídica com base no CNPJ ou CPF. Esta consulta aponta todos os veículos relacionados com o documento consultado, principalmente para fins de analise credito, cobrança e comportamental. Caso seja consultada a placa do veículo, retorna as informações detalhadas do veículo consultado. A consulta pode não apresentar os veículos mais atuais já que a API é atualizada anualmente.
Artigo do Blog
Consulta Veicular - Frotas PF e PJ
Casos de Uso
- Análise de crédito e comportamental com base no histórico de veículos.
- Identificação de frotas vinculadas a pessoas físicas ou jurídicas.
- Suporte a processos de cobrança e recuperação de ativos.
- Compliance e ESG com rastreamento de patrimônio veicular.
- Verificação de indicadores de roubo, furto e multas RENAINF.
Aplicações
- Compliance/ESG
Benefícios
- Acesso automatizado ao histórico veicular de CPF ou CNPJ.
- Reduz erros manuais e agiliza análises de crédito e risco.
- Facilita a visualização de frotas completas vinculadas a um documento.
- Integração simples e escalável com sistemas internos de compliance e crédito.
O endpoint /api/ConsultaVeicular permite consultar o histórico de veículos vinculados a uma pessoa física (CPF) ou jurídica (CNPJ), retornando dados detalhados de cada veículo como placa, modelo, cor, indicadores de roubo/furto e multas RENAINF. Esta documentação detalha como autenticar, enviar requisições, interpretar respostas e tratar erros durante a integração.
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/ConsultaVeicularFrotasEndpoint
GET https://apiv3.directd.com.br/api/ConsultaVeicularFrotas?Cpf={0}&Cnpj={1}&Token=Seu_TokenDescrição: Endpoint para realizar consultas Consulta Veicular - Frotas PF e PJ.
Nota: Esta consulta não gera comprovantes.
Campos Retornados
- Ano de Fabricação: Informa o ano de fabricação.
- Ano do Modelo: Informa o ano do modelo do veículo.
- Chassi: Informa o casshi do veículo.
- Cor: Informa a cor do veículo.
- Data de Atualização do Veículo: Informa a data de atualização do veículo.
- Documento Consultado: Documento consultado referente ao CPF/CNPJ
- Flag Indicador de Multa RENAINF: Informa se indica se possui ou não multa no RENAINF. True(verdadeiro) ou false(falso).
- Flag Indicador de Roubo e Furto: Informa se indica se possui ou não furto ou roubo. True(verdadeiro) ou false(falso).
- Lista de Veículos: Lista os veículos vinculados.
- Marca e Modelo: Informa a marca e modelo do veículo.
- Motor: Informa o motor do veículo.
- Nome do Proprietário: Informa o nome do proprietário.
- Observações: Informa as observações do registro.
- Placa: Informa a placa do veículo.
- Quantidade de Veículos: Informa a quantidade de veículos encontrados.
- RENAVAM: Informa o código RENAVAM do veículo
- Tipo do Veículo: Informa o tipo do veículo.
- UF: Unidade Federativa (estado) referente ao registro
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
CNPJ | string | Sim | O parâmetro CNPJ pode ser enviado com ou sem formatação. |
CPF | string | Sim | O parâmetro CPF pode ser enviado com ou sem formatação. |
TOKEN | string | Sim | O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br |
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"enviarCallback": false,
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"documentoConsultado": "string",
"nomeProprietario": "string",
"quantidadeVeiculos": 0,
"observacoes": "string",
"veiculos": [
{
"placa": "string",
"marcaModelo": "string",
"cor": "string",
"anoFabricacao": "string",
"anoModelo": "string",
"indicadorRouboFurto": true,
"indicadorMultaRenainf": true,
"dataAtualizacaoVeiculo": "string",
"uf": "string",
"tipoVeiculo": "string",
"chassi": "string",
"renavam": "string",
"motor": "string"
}
]
}
}Erros Comuns
| Código | Descrição |
|---|---|
400 | Requisição Inválida: a requisição está incorreta ou os parâmetros são inválidos. |
401 | Não Autenticado: o usuário não forneceu as credenciais corretas para acessar o recurso. |
403 | Não Autorizado: o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
404 | Não Encontrado: o servidor não encontrou uma representação atual do recurso solicitado. |
408 | Tempo Esgotado: o servidor não conseguiu retornar a requisição no prazo estabelecido. |
500 | Falha ao Realizar Consulta: o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
503 | Consulta em Manutenção: a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |
Notas Importantes
- Informe apenas um único documento por requisição
- Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
- Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228