APIs de CPF para empresas de vistoria veicular

Empresas de vistoria veicular podem usar APIs de CPF para confirmar a identidade do proprietário antes de emitir o laudo, prevenindo fraudes como clonagem de veículos e transferências com documentação falsa. A integração leva menos de 30 minutos e funciona tanto no agendamento quanto na conferência presencial no momento da vistoria.

Introdução

A vistoria veicular é uma etapa obrigatória em diversos processos envolvendo veículos no Brasil: transferência de propriedade, licenciamento, financiamento e seguros. Empresas credenciadas pelo DETRAN realizam vistorias para verificar a integridade do veículo, a conformidade com as normas de segurança e a regularidade da documentação. Em todos esses processos, a identificação correta do proprietário é fundamental.

O CPF é o documento que vincula o proprietário ao veículo, e sua validação via API permite que empresas de vistoria confirmem a identidade do solicitante antes de realizar o serviço. Isso previne fraudes, agiliza o atendimento e garante conformidade com as exigências dos DETRANs estaduais. A CPFHub.io oferece uma API REST com retorno em JSON que se integra a qualquer sistema de agendamento ou laudo de vistoria.

O CPF nos processos de vistoria veicular

Transferência de propriedade

Na compra e venda de veículos usados, o DETRAN exige vistoria para verificar a integridade do veículo e confirmar a identidade do novo proprietário. O CPF do comprador é um dado obrigatório.

Licenciamento anual

O licenciamento do veículo pode exigir vistoria em determinados estados ou situações. O CPF do proprietário é utilizado para vincular a vistoria ao documento do veículo.

Financiamento

Instituições financeiras exigem vistoria cautelar antes de aprovar financiamentos de veículos usados. O CPF do comprador/financiado é validado nesse processo.

Seguros

Seguradoras solicitam vistoria prévia para verificar o estado do veículo antes da contratação do seguro. O CPF do segurado deve estar correto para a emissão da apólice.

Mudança de município

A transferência do registro do veículo entre municípios ou estados exige nova vistoria, com identificação do proprietário por CPF.

Fraudes no setor de vistoria veicular

Clonagem de veículos

Veículos clonados são apresentados para vistoria com documentação falsa. A validação do CPF do suposto proprietário ajuda a detectar inconsistências.

Transferência fraudulenta

Golpistas utilizam CPFs de terceiros para transferir veículos obtidos de forma ilícita, tentando "limpar" o histórico do automóvel.

Vistoria com procurador falso

Terceiros se apresentam como procuradores do proprietário usando documentos falsificados. A validação de CPF do proprietário original permite detectar irregularidades.

Implementação com Python

import requests
from datetime import datetime

CPFHUB_API_KEY = "sua_api_key_aqui"
CPFHUB_BASE_URL = "https://api.cpfhub.io/cpf"
TIMEOUT_SECONDS = 10

def agendar_vistoria(cpf_proprietario: str, nome_proprietario: str,
    placa: str, tipo_vistoria: str) -> dict:
    """
    Agenda uma vistoria veicular após validar o CPF do proprietário.
    tipo_vistoria: transferencia, licenciamento, cautelar, seguro
    """
    cpf_limpo = cpf_proprietario.replace(".", "").replace("-", "")

    if len(cpf_limpo) != 11 or not cpf_limpo.isdigit():
    return {"agendado": False, "motivo": "CPF com formato inválido"}

    headers = {
    "x-api-key": CPFHUB_API_KEY,
    "Accept": "application/json"
    }

    try:
    response = requests.get(
    f"{CPFHUB_BASE_URL}/{cpf_limpo}",
    headers=headers,
    timeout=TIMEOUT_SECONDS
    )
    response.raise_for_status()
    resultado = response.json()
    except requests.exceptions.Timeout:
    return {"agendado": False, "motivo": "Timeout na consulta"}
    except requests.exceptions.RequestException as e:
    return {"agendado": False, "motivo": f"Erro: {str(e)}"}

    if not resultado.get("success"):
    return {"agendado": False, "motivo": "CPF não localizado"}

    dados = resultado["data"]
    nome_api = dados.get("nameUpper", "").strip()
    nome_informado = nome_proprietario.strip().upper()

    if nome_api != nome_informado:
    return {
    "agendado": False,
    "motivo": "Nome do proprietário diverge do CPF",
    "nome_base": nome_api,
    "nome_informado": nome_informado
    }

    agendamento = {
    "protocolo": f"VIS-{datetime.now().strftime('%Y%m%d%H%M%S')}",
    "proprietario": {
    "cpf": dados["cpf"],
    "nome": dados["name"],
    "data_nascimento": dados["birthDate"]
    },
    "veiculo": {
    "placa": placa
    },
    "tipo_vistoria": tipo_vistoria,
    "data_agendamento": datetime.now().isoformat(),
    "status": "agendado"
    }

    return {"agendado": True, "agendamento": agendamento}

# Exemplo de uso
resultado = agendar_vistoria(
    cpf_proprietario="123.456.789-09",
    nome_proprietario="André Luiz Barbosa",
    placa="ABC1D23",
    tipo_vistoria="transferencia"
)

if resultado["agendado"]:
    a = resultado["agendamento"]
    print(f"Protocolo: {a['protocolo']}")
    print(f"Proprietário: {a['proprietario']['nome']}")
    print(f"Placa: {a['veiculo']['placa']}")
    print(f"Tipo: {a['tipo_vistoria']}")
else:
    print(f"Agendamento negado: {resultado['motivo']}")

Consulta via cURL

curl -X GET "https://api.cpfhub.io/cpf/12345678909" \
    -H "x-api-key: sua_api_key_aqui" \
    -H "Accept: application/json" \
    --max-time 10

Resposta:

{
    "success": true,
    "data": {
    "cpf": "123.456.789-09",
    "name": "André Luiz Barbosa",
    "nameUpper": "ANDRÉ LUIZ BARBOSA",
    "gender": "M",
    "birthDate": "22/04/1985",
    "day": "22",
    "month": "04",
    "year": "1985"
    }
}

Validação no momento da vistoria presencial

No momento da vistoria presencial, o sistema do vistoriador pode consultar a API para confirmar os dados do proprietário em tempo real.

const axios = require("axios");

const CPFHUB_API_KEY = "sua_api_key_aqui";
const CPFHUB_BASE_URL = "https://api.cpfhub.io/cpf";

async function confirmarProprietarioVistoria(cpf, nomeApresentado, placa) {
    const cpfLimpo = cpf.replace(/\D/g, "");

    try {
    const response = await axios.get(`${CPFHUB_BASE_URL}/${cpfLimpo}`, {
    headers: {
    "x-api-key": CPFHUB_API_KEY,
    Accept: "application/json"
    },
    timeout: 10000
    });

    const resultado = response.data;

    if (!resultado.success) {
    return {
    confirmado: false,
    motivo: "CPF não encontrado",
    acao: "Solicitar outro documento de identificação"
    };
    }

    const dados = resultado.data;
    const nomeApi = dados.nameUpper;
    const nomeComparacao = nomeApresentado.toUpperCase().trim();

    if (nomeApi !== nomeComparacao) {
    return {
    confirmado: false,
    motivo: "Nome divergente do CPF",
    nomeBase: dados.name,
    nomeApresentado: nomeApresentado,
    acao: "Verificar documentação original"
    };
    }

    return {
    confirmado: true,
    proprietario: {
    cpf: dados.cpf,
    nome: dados.name,
    dataNascimento: dados.birthDate
    },
    placa: placa,
    confirmadoEm: new Date().toISOString()
    };
    } catch (error) {
    return {
    confirmado: false,
    motivo: error.code === "ECONNABORTED" ? "Timeout" : error.message,
    acao: "Tentar novamente ou prosseguir com verificação manual"
    };
    }
}

// Exemplo de uso
(async () => {
    const resultado = await confirmarProprietarioVistoria(
    "123.456.789-09",
    "André Luiz Barbosa",
    "ABC1D23"
    );

    if (resultado.confirmado) {
    console.log(`Proprietário confirmado: ${resultado.proprietario.nome}`);
    console.log(`Placa: ${resultado.placa}`);
    } else {
    console.log(`Alerta: ${resultado.motivo}`);
    console.log(`Ação: ${resultado.acao}`);
    }
})();

Integração com sistemas dos DETRANs

Muitos DETRANs estaduais possuem sistemas digitais onde as vistorias são registradas. A validação de CPF via API pode ser integrada ao fluxo de preenchimento desses sistemas, garantindo que os dados informados ao DETRAN são consistentes.

Fluxo integrado

1. O vistoriador recebe a solicitação de vistoria com os dados do veículo e proprietário.
2. Antes de iniciar a vistoria, o sistema valida o CPF do proprietário via API.
3. Os dados validados são utilizados para preencher automaticamente os formulários do DETRAN.
4. Ao final da vistoria, o laudo é emitido com os dados confirmados.
5. O resultado é enviado eletronicamente ao DETRAN para processamento.

Boas práticas para empresas de vistoria

• Validação no agendamento -- Valide o CPF antes de confirmar o agendamento da vistoria.
• Confirmação presencial -- Revalide o CPF no momento da vistoria presencial para garantir consistência.
• Laudos com dados validados -- Inclua os dados validados no laudo de vistoria para aumentar a credibilidade do documento.
• Treinamento de vistoriadores -- Capacite a equipe para identificar sinais de fraude e utilizar a validação de CPF como ferramenta auxiliar.
• Registro de auditoria -- Mantenha logs de todas as validações para fins de auditoria e eventual contestação.

Perguntas frequentes

Como a validação de CPF ajuda a detectar veículos clonados?

Ao cruzar o nome do suposto proprietário com os dados retornados pela API, o sistema identifica divergências imediatamente. Se o CPF apresentado não corresponde ao nome no documento do veículo, o agendamento é bloqueado antes mesmo de a vistoria começar — evitando que laudos sejam emitidos para veículos com documentação falsa.

A API de CPF substitui a consulta ao DETRAN durante a vistoria?

Não. A validação de CPF via API confirma a identidade do proprietário — nome, data de nascimento e status do documento. A consulta ao DETRAN continua necessária para verificar a situação do veículo (débitos, restrições, roubo/furto). As duas validações se complementam no processo de vistoria.

Qual volume de consultas é necessário para uma empresa de vistoria?

Depende do número de vistorias mensais. Para empresas com até 50 vistorias por mês, o plano gratuito da CPFHub.io (50 consultas/mês, sem cartão de crédito) já cobre. Para volumes maiores, o plano Pro inclui 1.000 consultas mensais por R$149. Se o limite for ultrapassado, a API não bloqueia — cobra R$0,15 por consulta adicional.

Como garantir conformidade com a LGPD ao validar CPF em vistorias?

Use o CPF apenas para confirmar a identidade do proprietário, armazene somente o necessário e documente a base legal (legítimo interesse ou cumprimento de obrigação legal). A ANPD orienta que dados de identificação devem ser tratados com o princípio da necessidade. A CPFHub.io opera em conformidade com a LGPD em todos os planos.

Conclusão

A validação de CPF via API é uma ferramenta essencial para empresas de vistoria veicular que buscam prevenir fraudes, agilizar o atendimento e manter a conformidade com as exigências dos DETRANs. Com a CPFHub.io, é possível confirmar a identidade do proprietário antes de emitir qualquer laudo — tanto no agendamento quanto na conferência presencial — usando a mesma integração REST em qualquer linguagem.

Cadastre-se em cpfhub.io e comece com 50 consultas gratuitas por mês, sem cartão de crédito. Para volumes maiores, o plano Pro cobre 1.000 consultas mensais por R$149 com SLA de 99%.