# Como validar CPF de entregadores em plataformas de last-mile delivery > Saiba como plataformas de last-mile delivery podem validar CPF de entregadores via API para garantir segurança, compliance e confiança dos clientes. **Publicado:** 31/01/2025 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/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: ```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 | Etapa | Descrição | | --- | --- | | 1. Download do app | Entregador baixa o aplicativo da plataforma | | 2. Informações básicas | CPF, nome, telefone e e-mail | | 3. Validação de CPF | API CPFHub.io confirma identidade | | 4. Verificação de idade | Data de nascimento validada automaticamente | | 5. Documentos adicionais | CNH (se aplicável), foto de perfil | | 6. Aprovação | Entregador habilitado para receber entregas | --- ## 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 | Porte da plataforma | Plano CPFHub.io | | --- | --- | | Startup em fase de teste | Gratuito (50 consultas/mês, R$ 0) | | Plataforma em crescimento | Pro (R$ 149/mês, 1.000 consultas) | | Grande operação de delivery | Corporativo (volume personalizado, SLA 99,9%) | 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](https://www.gov.br/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. ### Leia também - [KYC no Brasil: quais setores são obrigados a validar CPF por lei](https://cpfhub.io/blog/kyc-no-brasil-quais-setores-sao-obrigados-a-validar-cpf-por-lei) - [Onboarding digital em fintechs: como validar CPF em menos de 30 segundos](https://cpfhub.io/blog/onboarding-digital-em-fintechs-como-validar-cpf-em-menos-de-30-segundos) - [Diferença entre validação de CPF e consulta de CPF: quando usar cada uma](https://cpfhub.io/blog/diferenca-entre-validacao-de-cpf-e-consulta-de-cpf-quando-usar-cada-uma) - [API de CPF grátis para desenvolvedores: como começar em 5 minutos](https://cpfhub.io/blog/api-cpf-gratis-desenvolvedores-comecar-5-minutos) --- ## 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](https://www.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.