APIs de CPF para empresas de saúde ocupacional: validação de 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 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

{
    "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:

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

Planos recomendados para clínicas ocupacionais

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).

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 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 — 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.