# APIs de CPF para empresas de saúde ocupacional: validação de trabalhadores > Saiba como empresas de saúde ocupacional podem usar APIs de CPF para validar trabalhadores em exames admissionais, periódicos e demissionais. **Publicado:** 15/02/2025 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/apis-cpf-empresas-saude-ocupacional-validacao-trabalhadores --- Empresas de saúde ocupacional podem usar APIs de CPF para validar a identidade de trabalhadores no momento do agendamento de exames admissionais, periódicos e demissionais, prevenindo erros de vinculação de laudos e rejeições no eSocial. A validação em tempo real retorna nome completo, data de nascimento e gênero, permitindo preencher automaticamente o ASO com dados corretos. ## Introdução Empresas de saúde ocupacional gerenciam um volume significativo de dados pessoais de trabalhadores — desde exames admissionais até laudos periódicos e demissionais. Em todos esses processos, a identificação correta do trabalhador é fundamental para garantir que os exames e laudos estejam vinculados à pessoa certa. O CPF é o identificador que conecta o trabalhador ao seu prontuário ocupacional. --- ## O contexto da saúde ocupacional no Brasil ### Obrigações legais Empresas brasileiras são obrigadas por lei a realizar exames ocupacionais em seus empregados: * **Exame admissional** -- Antes da contratação. * **Exame periódico** -- Em intervalos regulares durante o vínculo empregatício. * **Exame de retorno ao trabalho** -- Após afastamento por doença ou acidente. * **Exame de mudança de função** -- Quando o trabalhador muda de atividade. * **Exame demissional** -- Até a data de homologação da demissão. Todos esses exames geram documentos (ASO — Atestado de Saúde Ocupacional) que devem ser vinculados ao CPF do trabalhador e registrados no eSocial. A [NR-7 do Ministério do Trabalho e Emprego](https://www.gov.br/trabalho-e-emprego/pt-br/acesso-a-informacao/participacao-social/conselhos-e-orgaos-colegiados/ctpp-nrs/normas-regulamentadoras-nrs/nr-7) detalha todas as obrigações do Programa de Controle Médico de Saúde Ocupacional (PCMSO). ### O papel do CPF no eSocial O eSocial exige que todas as informações de saúde ocupacional sejam enviadas com o CPF do trabalhador. Erros no CPF resultam em rejeição de eventos e possíveis penalidades. --- ## Problemas causados por CPFs incorretos na saúde ocupacional * **Laudos vinculados à pessoa errada** -- Um exame realizado com CPF incorreto pode ser atribuído ao trabalhador errado, gerando problemas legais. * **Rejeição no eSocial** -- Eventos enviados com CPF inválido são rejeitados, exigindo retrabalho. * **Impossibilidade de rastreamento** -- Sem CPF validado, o histórico ocupacional do trabalhador fica fragmentado. * **Riscos jurídicos** -- Em caso de doença ocupacional ou acidente de trabalho, a empresa precisa comprovar que os exames foram realizados para o trabalhador correto. --- ## Como a validação de CPF resolve esses problemas ### Validação no agendamento do exame O momento ideal para validar o CPF é quando o exame é agendado. A empresa contratante informa o CPF do trabalhador, e o sistema da clínica ocupacional valida os dados antes de confirmar o agendamento. ### Dados retornados pela API ```json { "success": true, "data": { "cpf": "12345678900", "name": "Pedro Henrique Almeida", "nameUpper": "PEDRO HENRIQUE ALMEIDA", "gender": "M", "birthDate": "08/12/1990", "day": 8, "month": 12, "year": 1990 } } ``` Com esses dados, a clínica pode: * Confirmar que o CPF é válido. * Verificar se o nome do trabalhador confere. * Preencher automaticamente dados como nome completo e data de nascimento. * Garantir que o ASO será emitido com dados corretos. --- ## Implementação: validação no agendamento de exames Exemplo em Python de como integrar a validação de CPF ao sistema de agendamento: ```python import requests from datetime import date CPFHUB_API_KEY = 'SUA_CHAVE_DE_API' def agendar_exame_ocupacional(cpf: str, nome_trabalhador: str, tipo_exame: str, data_exame: str) -> dict: """ Valida CPF do trabalhador e agenda exame ocupacional. """ # 1. Validar CPF via API url = f'https://api.cpfhub.io/cpf/{cpf}' headers = { 'x-api-key': CPFHUB_API_KEY, 'Accept': 'application/json' } response = requests.get(url, headers=headers, timeout=10) resultado = response.json() if not resultado.get('success'): return { 'status': 'erro', 'motivo': 'CPF nao encontrado. Verifique o numero informado.', 'agendamento': None } dados = resultado['data'] # 2. Verificar nome nome_confere = nome_trabalhador.upper().strip() == dados['nameUpper'].strip() if not nome_confere: return { 'status': 'divergencia', 'motivo': f'Nome informado ({nome_trabalhador}) difere do cadastro ({dados["name"]})', 'agendamento': None, 'sugestao': 'Confirme o CPF e o nome completo do trabalhador' } # 3. Criar agendamento agendamento = { 'cpf': cpf, 'nome': dados['name'], 'nascimento': dados['birthDate'], 'genero': dados['gender'], 'tipo_exame': tipo_exame, 'data_exame': data_exame, 'status': 'agendado' } return { 'status': 'sucesso', 'agendamento': agendamento, 'cpf_validado': True } # Exemplo de uso resultado = agendar_exame_ocupacional( cpf='12345678900', nome_trabalhador='Pedro Henrique Almeida', tipo_exame='admissional', data_exame='2025-03-01' ) print(resultado) ``` --- ## Fluxos de uso na saúde ocupacional ### 1. Exame admissional A empresa contratante envia a lista de trabalhadores a serem admitidos. A clínica valida o CPF de cada um antes de agendar os exames, garantindo que os ASOs serão emitidos com dados corretos. ### 2. Exames periódicos em lote Empresas com muitos empregados agendam exames periódicos em lote. A validação em lote identifica CPFs com problemas antes do agendamento, evitando exames realizados com dados incorretos. ### 3. Exame demissional No exame demissional, a validação do CPF garante que o ASO de desligamento está vinculado ao trabalhador correto — informação que pode ser necessária em processos trabalhistas futuros. ### 4. Integração com eSocial Antes de enviar eventos de saúde ocupacional ao eSocial, o sistema valida o CPF para evitar rejeições. Isso reduz o retrabalho e garante conformidade com os prazos legais. --- ## Conformidade e segurança de dados ### LGPD e dados de saúde Dados de saúde são classificados como dados sensíveis pela LGPD, exigindo proteção reforçada. A validação de CPF via API é uma etapa que antecede o tratamento de dados sensíveis — ela confirma a identidade sem processar informações de saúde. A API da CPFHub.io: * Processa apenas dados cadastrais (nome, CPF, data de nascimento, gênero). * Não armazena dados sensíveis. * Opera em conformidade com a LGPD. * Utiliza criptografia em todas as comunicações. ### NR-7 e PCMSO A Norma Regulamentadora 7 (NR-7) exige que o Programa de Controle Médico de Saúde Ocupacional (PCMSO) mantenha registros individualizados por trabalhador. A identificação correta via CPF é a base para esses registros. --- ## Impacto operacional | Métrica | Sem validação de CPF | Com validação via API | | --- | --- | --- | | Erros de CPF no eSocial | 5-15% dos envios | < 1% | | Retrabalho em ASOs | Frequente | Raro | | Tempo de agendamento | 10-15 minutos | 2-3 minutos | | Conformidade eSocial | Parcial | Automatizada | --- ## Planos recomendados para clínicas ocupacionais | Perfil | Plano CPFHub.io | | --- | --- | | Clínica pequena (até 50 exames/mês) | Gratuito (50 consultas/mês, R$0) | | Clínica média (até 1.000 exames/mês) | Pro (R$149/mês, 1.000 consultas + R$0,15/extra) | | Rede de clínicas | Pro com excedente (sem bloqueio, cobra R$0,15/consulta extra) | --- ## Perguntas frequentes ### A validação de CPF é obrigatória para emissão de ASO no eSocial? Sim. O eSocial rejeita eventos de saúde ocupacional com CPF inválido ou divergente. A Resolução eSocial exige que o CPF do trabalhador seja informado corretamente em todos os eventos de saúde, incluindo admissional (S-2220), periódico e demissional. A validação via API antes do envio elimina praticamente todos os erros de rejeição por CPF incorreto. ### É possível validar CPFs de trabalhadores em lote antes de um ciclo de exames periódicos? Sim. A API CPFHub.io aceita consultas individuais que podem ser executadas em sequência para processar lotes. A recomendação é distribuir as chamadas com um intervalo mínimo entre requisições e usar uma fila de processamento para volumes grandes. O plano Pro suporta 1.000 consultas mensais, com excedentes cobrados a R$0,15 cada — sem bloqueio do serviço. ### O que acontece se o nome do trabalhador não confere com o CPF retornado pela API? A clínica deve bloquear o agendamento e solicitar a correção dos dados à empresa contratante. Divergências de nome são um forte indicativo de CPF informado incorretamente ou, em casos mais graves, de tentativa de uso de CPF de terceiro. Registre a tentativa no log com timestamp para auditoria. ### A API CPFHub.io retorna dados de saúde do trabalhador? Não. A API retorna exclusivamente dados cadastrais: CPF, nome completo, gênero e data de nascimento. Nenhuma informação de saúde, situação trabalhista ou histórico médico é retornado ou armazenado. Isso mantém a separação clara entre identificação (responsabilidade da CPFHub.io) e prontuário ocupacional (responsabilidade da clínica). ### 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) - [LGPD: CPF é dado pessoal sensível ou não? Entenda a classificação correta](https://cpfhub.io/blog/lgpd-cpf-e-dado-pessoal-sensivel-ou-nao-entenda-a-classificacao-correta) - [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 Para empresas de saúde ocupacional, a validação de CPF é uma etapa fundamental para garantir que exames, laudos e eventos do eSocial estejam vinculados ao trabalhador correto. A API da [**CPFHub.io**](https://www.cpfhub.io/) oferece retorno completo de dados cadastrais em tempo real, sem bloqueio por volume e com conformidade LGPD — permitindo que clínicas eliminem erros de CPF no eSocial e reduzam drasticamente o retrabalho em ASOs. Cadastre-se em [cpfhub.io](https://www.cpfhub.io/) — 50 consultas mensais gratuitas, sem cartão de crédito — e comece a validar trabalhadores antes de cada exame ocupacional, garantindo ASOs corretos desde o agendamento.