API de consulta de CPF para validação de beneficiarios em folha de pagamento

import requests

class ValidadorFolha:
    def __init__(self, api_key):
    self.session = requests.Session()
    self.session.headers.update({
    'x-api-key': api_key,
    'Accept': 'application/json'
    })

    def validar_beneficiario(self, cpf, nome_informado):
    url = f'https://api.cpfhub.io/cpf/{cpf}'
    response = self.session.get(url, timeout=15)

    if response.status_code != 200:
    return {
    'valido': False,
    'motivo': f'Erro na consulta: HTTP {response.status_code}'
    }

    data = response.json()

    if not data.get('success'):
    return {
    'valido': False,
    'motivo': 'CPF nao encontrado na base'
    }

    nome_api = data['data']['name'].upper().strip()
    nome_check = nome_informado.upper().strip()

    # Comparacao flexivel de nomes
    similaridade = self._calcular_similaridade(nome_api, nome_check)

    return {
    'valido': similaridade >= 0.85,
    'cpf': data['data']['cpf'],
    'nome_retornado': data['data']['name'],
    'nome_informado': nome_informado,
    'similaridade': round(similaridade, 2),
    'genero': data['data']['gender'],
    'nascimento': data['data']['birthDate'],
    'motivo': 'aprovado' if similaridade >= 0.85 else 'nome_divergente'
    }

    def _calcular_similaridade(self, nome1, nome2):
    """Calcula similaridade simples por palavras em comum."""
    palavras1 = set(nome1.split())
    palavras2 = set(nome2.split())
    if not palavras1 or not palavras2:
    return 0.0
    intersecao = palavras1 & palavras2
    uniao = palavras1 | palavras2
    return len(intersecao) / len(uniao)

# Uso
validador = ValidadorFolha('SUA_CHAVE_DE_API')
resultado = validador.validar_beneficiario('12345678900', 'Joao da Silva')
print(resultado)

import csv
import time
from datetime import datetime

def auditar_folha(validador, arquivo_entrada, arquivo_saida):
    with open(arquivo_entrada, 'r') as f_in, \
    open(arquivo_saida, 'w', newline='') as f_out:

    reader = csv.DictReader(f_in)
    writer = csv.DictWriter(f_out, fieldnames=[
    'cpf', 'nome_folha', 'nome_api', 'valido',
    'similaridade', 'motivo', 'data_verificacao'
    ])
    writer.writeheader()

    total = 0
    validos = 0
    divergentes = 0

    for row in reader:
    resultado = validador.validar_beneficiario(
    row['cpf'], row['nome']
    )

    writer.writerow({
    'cpf': row['cpf'],
    'nome_folha': row['nome'],
    'nome_api': resultado.get('nome_retornado', ''),
    'valido': resultado['valido'],
    'similaridade': resultado.get('similaridade', 0),
    'motivo': resultado['motivo'],
    'data_verificacao': datetime.utcnow().isoformat()
    })

    total += 1
    if resultado['valido']:
    validos += 1
    else:
    divergentes += 1

    time.sleep(2) # respeitar rate limit

    print(f'Total: {total} | Validos: {validos} | Divergentes: {divergentes}')

auditar_folha(validador, 'beneficiarios.csv', 'auditoria_resultado.csv')

def validar_dependente(validador, cpf_dependente, nome_dependente, cpf_titular):
    resultado = validador.validar_beneficiario(cpf_dependente, nome_dependente)

    if not resultado['valido']:
    return {
    'aprovado': False,
    'motivo': resultado['motivo'],
    'cpf_titular': cpf_titular
    }

    # Verificar que o CPF do dependente e diferente do titular
    if cpf_dependente == cpf_titular:
    return {
    'aprovado': False,
    'motivo': 'cpf_dependente_igual_titular',
    'cpf_titular': cpf_titular
    }

    return {
    'aprovado': True,
    'nome_validado': resultado['nome_retornado'],
    'cpf_titular': cpf_titular
    }

def preparar_evento_esocial(validador, funcionario):
    resultado = validador.validar_beneficiario(
    funcionario['cpf'],
    funcionario['nome']
    )

    if not resultado['valido']:
    return {
    'pode_enviar': False,
    'erro': f'CPF {funcionario["cpf"]}: {resultado["motivo"]}',
    'acao': 'Corrigir cadastro antes de enviar ao eSocial'
    }

    return {
    'pode_enviar': True,
    'dados_validados': {
    'cpf': resultado['cpf'],
    'nome': resultado['nome_retornado'],
    'nascimento': resultado['nascimento']
    }
    }