Como validar CPF de entregadores em plataformas de last-mile delivery

Plataformas de last-mile delivery validam o CPF de entregadores chamando GET https://api.cpfhub.io/cpf/{CPF} com o header x-api-key durante o cadastro. A API retorna nome completo, data de nascimento e gênero em cerca de 900ms — dados suficientes para confirmar identidade, verificar idade mínima e preencher automaticamente o perfil, sem travar o onboarding do entregador.

Introdução

Plataformas de last-mile delivery -- responsáveis pela última etapa da entrega ao consumidor final -- dependem de uma rede ampla de entregadores. Aplicativos de entrega de comida, encomendas, supermercado e farmácia precisam garantir que cada entregador cadastrado é uma pessoa real, identificável e com dados confiáveis.

A validação de CPF dos entregadores é uma medida de segurança essencial. Ela protege tanto a plataforma quanto os consumidores, garantindo que apenas pessoas com identidade verificada realizem entregas. Além disso, atende a exigências trabalhistas e regulatórias que demandam identificação precisa dos prestadores de serviço.

Os desafios do cadastro de entregadores

Alta rotatividade

Plataformas de delivery têm rotatividade elevada de entregadores. Novos cadastros acontecem diariamente, exigindo validação contínua e ágil.

Cadastros fraudulentos

Entregadores que se cadastram com dados falsos podem usar a plataforma para golpes: roubo de mercadorias, uso de contas de terceiros ou operação sem habilitação para veículos motorizados.

Segurança do consumidor

O consumidor precisa confiar que o entregador é uma pessoa identificada. Incidentes de segurança envolvendo entregadores não verificados prejudicam a reputação da plataforma.

Obrigações legais

A identificação precisa dos entregadores é necessária para emissão de recibos, pagamento de serviços e cumprimento de obrigações fiscais e trabalhistas.

Como a validação de CPF resolve

1. Verificação no cadastro

Quando o entregador se cadastra na plataforma, o CPF informado é validado via API. O sistema confirma que o CPF existe e que o nome corresponde ao titular.

2. Preenchimento automático de dados

A API retorna nome completo e data de nascimento, que são preenchidos automaticamente no cadastro. O entregador confirma os dados, reduzindo erros.

3. Verificação de idade

Plataformas que exigem idade mínima (ex.: 18 anos) podem utilizar a data de nascimento retornada pela API para confirmar automaticamente.

4. Revalidação periódica

A plataforma pode revalidar CPFs periodicamente para garantir que os dados continuam atualizados e que nenhum entregador está operando com informações inconsistentes.

Implementação em Ruby

Exemplo de integração para validar entregadores em uma plataforma Ruby:

require 'net/http'
require 'json'
require 'uri'

CPFHUB_API_KEY = 'SUA_CHAVE_DE_API'

def validar_entregador(cpf, nome_informado)
    uri = URI("https://api.cpfhub.io/cpf/#{cpf}")
    http = Net::HTTP.new(uri.host, uri.port)
    http.use_ssl = true
    http.read_timeout = 10
    http.open_timeout = 10

    request = Net::HTTP::Get.new(uri)
    request['x-api-key'] = CPFHUB_API_KEY
    request['Accept'] = 'application/json'

    response = http.request(request)
    resultado = JSON.parse(response.body)

    unless resultado['success']
    return { status: 'rejeitado', motivo: 'CPF nao encontrado' }
    end

    dados = resultado['data']

    # Verificar nome
    unless nome_informado.upcase.strip == dados['nameUpper'].strip
    return {
    status: 'divergente',
    motivo: 'Nome nao confere',
    nome_informado: nome_informado,
    nome_base: dados['name']
    }
    end

    # Verificar idade minima (18 anos)
    hoje = Date.today
    nascimento = Date.new(dados['year'], dados['month'], dados['day'])
    idade = hoje.year - nascimento.year
    idade -= 1 if hoje < nascimento.next_year(idade)

    if idade < 18
    return { status: 'rejeitado', motivo: "Idade insuficiente: #{idade} anos" }
    end

    {
    status: 'aprovado',
    nome: dados['name'],
    cpf: dados['cpf'],
    nascimento: dados['birthDate'],
    idade: idade
    }
end

# Uso
resultado = validar_entregador('12345678900', 'Carlos Santos')
puts resultado

Fluxo de cadastro de entregadores

Cenários de aplicação

Entrega de alimentos

Aplicativos de delivery de comida precisam garantir que entregadores são pessoas reais e identificáveis, tanto para segurança dos restaurantes quanto dos consumidores.

Entrega de encomendas

Plataformas de last-mile para e-commerce precisam vincular cada entrega a um entregador com CPF validado, garantindo rastreabilidade.

Entregas sensíveis

Entregas de medicamentos, documentos ou itens de alto valor exigem identificação rigorosa do entregador.

Entrega por veículo

Plataformas que permitem entrega com veículos motorizados podem cruzar o CPF validado com dados da CNH para verificar habilitação.

Benefícios para a plataforma

• Segurança -- Apenas entregadores com identidade verificada operam na plataforma.

• Confiança do consumidor -- Clientes se sentem mais seguros ao saber que o entregador é identificado.

• Conformidade legal -- Identificação precisa para fins fiscais e trabalhistas.

• Agilidade no onboarding -- Validação em ~900ms, sem travar o fluxo de cadastro.

• Rastreabilidade -- Cada entrega vinculada a um CPF validado.

Planos recomendados

O plano Corporativo é indicado para plataformas com alta rotatividade de entregadores e necessidade de disponibilidade garantida.

Perguntas frequentes

Quais dados a API retorna ao validar o CPF de um entregador?

A API retorna name, nameUpper, gender, birthDate, day, month e year. Com esses dados é possível confirmar a identidade do entregador, verificar a idade mínima e preencher o perfil automaticamente — sem solicitar upload de documento na etapa inicial do cadastro.

O que acontece se o nome informado pelo entregador não corresponder ao CPF?

A plataforma recebe o nome correto na resposta da API e pode comparar com o que foi digitado. Em caso de divergência, o cadastro pode ser pausado para revisão manual ou o entregador pode ser orientado a corrigir os dados — evitando fraudes por uso de CPF de terceiros.

A API CPFHub.io suporta o volume de validações de plataformas com alta rotatividade?

Sim. O plano Pro cobre 1.000 consultas mensais por R$149; consultas excedentes são cobradas a R$0,15 cada, sem bloqueio. Para grandes plataformas com milhares de novos cadastros por mês, o plano Corporativo oferece volume personalizado e SLA de 99,9%.

Como garantir conformidade com a LGPD ao coletar CPF de entregadores?

A ANPD orienta que dados pessoais de trabalhadores devem ser coletados com base legal documentada — neste caso, execução de contrato (Art. 7, V da LGPD). Armazene apenas o necessário, criptografe o CPF em repouso, mantenha logs de acesso e documente o fluxo de dados no registro de operações de tratamento exigido pela lei.

Conclusão

A validação de CPF via API é uma medida de segurança indispensável para plataformas de last-mile delivery. Ao verificar a identidade dos entregadores no momento do cadastro, a plataforma protege consumidores, reduz fraudes e garante conformidade com obrigações legais. A integração é simples e não impacta a velocidade do onboarding.

Cadastre-se em cpfhub.io — 50 consultas mensais gratuitas, sem cartão de crédito — e comece a validar o CPF de cada novo entregador antes de habilitá-lo para receber entregas.