O endpoint /api/ConsultaVeicular permite obter informações completas sobre um veículo a partir de sua placa, incluindo dados como marca, modelo, ano de fabricação, cor e demais características técnicas. A consulta também retorna informações do proprietário e o valor médio de mercado atualizado conforme a Tabela Fipe, proporcionando uma visão detalhada e confiável tanto do veículo quanto de seu proprietário.
Consulta Veicular
A Consulta Veicular permite obter informações completas sobre um veículo a partir de sua placa, incluindo dados como marca, modelo, ano de fabricação, cor e demais características técnicas. A consulta também retorna informações do proprietário e o valor médio de mercado atualizado conforme a Tabela Fipe, proporcionando uma visão detalhada e confiável tanto do veículo quanto de seu proprietário.
Casos de Uso
- Integração com Consulta Veicular
- Análise de histórico para compra e venda de veículos
- Subscrição e precificação de seguros
- Gestão de frotas com dados confiáveis
Aplicações
- Compliance/ESG
Benefícios
- Documentação de Consulta Veicular acessível e atualizada
- Reduz riscos de fraudes e sinistros
- Melhor precificação com histórico completo
- Dados integrados e atualizados
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/ConsultaVeicularEndpoint
GET https://apiv3.directd.com.br/api/ConsultaVeicular?Placa={0}&Token=Seu_TokenDescrição: Endpoint para realizar consultas Consulta Veicular .
Nota: Esta consulta não gera comprovantes.
Campos Retornados
- Ano de Competência: Ano de competência da parcela
- Ano de Exercício: Informa o ano de exercício.
- Ano de Fabricação: Informa o ano de fabricação.
- Ano do Modelo: Informa o ano do modelo do veículo.
- Capacidade de Carga: Informa a capacidade de carga do veículo.
- Capacidade de Passageiros: Informa a capacidade de passageiros do veículo.
- Chassi: Informa o casshi do veículo.
- Cilindrada: Informa a cilindrada do veículo.
- Combustível: Informa qual o tipo de combustível utilizado pelo veículo.
- Cor: Informa a cor do veículo.
- Documento: Documento referente ao CPF/CNPJ
- Espécie: Informa a espécie do veículo.
- FIPE: Detalhes sobre o veículo na tabela FIPE.
- Marca: Informa a marca do veículo.
- Mês de Competência: Mês de competência da parcela
- Modelo: Informa o modelo do veículo.
- Município: Município/cidade referente ao registro
- Número da Carroceria: Informa o número da carroceria do veículo.
- Número do Câmbio: Informa o número do câmbio.
- Número do Eixo Auxiliar: Informa o número do eixo auxiliar do veículo.
- Número do Eixo Traseiro: Informa o número do eixo traseiro do veículo.
- Número do Motor: Informa o número do motor.
- Número dos Eixos: Informa o número dos eixos do veículo.
- Placa: Informa a placa do veículo.
- Procedência do Veículo: Informa a procedência do veículo.
- Proprietário: Detalhes sobre o proprietário.
- RENAVAM: Informa o código RENAVAM do veículo
- Situação do Veículo: Informa a situação do veículo.
- Tipo: Tipo do registro em questão
- UF: Unidade Federativa (estado) referente ao registro
- Valor: Valor da parcela
- Veículo: Informa detalhes sobre o veículo.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
PLACA | string | Sim | O parâmetro PLACA 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": {
"proprietario": "string",
"documento": "string",
"anoExercicio": "string",
"veiculo": {
"renavam": "string",
"placa": "string",
"uf": "string",
"chassi": "string",
"municipio": "string",
"marca": "string",
"modelo": "string",
"anoModelo": "string",
"anoFabricacao": "string",
"tipo": "string",
"combustivel": "string",
"cor": "string",
"numeroMotor": "string",
"numeroCambio": "string",
"numeroCarroceria": "string",
"numeroEixoTraseiro": "string",
"numeroEixos": "string",
"numeroDoEixoAuxiliar": "string",
"especie": "string",
"situacaoVeiculo": "string",
"procedenciaVeiculo": "string",
"capacidadedePassageiros": "string",
"cilindrada": "string",
"capacidaDeCarga": "string",
"fipe": {
"mes": "string",
"ano": "string",
"valor": "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
- 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