API CPF e CNPJ para Cooperativas Financeiras: Abertura de Conta e Crédito Cooperativo

# Python exemplo para validação onboarding cooperativa
import requests
from datetime import datetime

def validar_cooperado(dados_cooperado):
    """
    Valida cooperado para abertura de conta conforme Circular 3.978
    """
    cpf = dados_cooperado['cpf'].replace('-', '').replace('.', '')

    try:
        response = requests.get(
            f'https://api.cpfcnpj.com.br/{TOKEN}/{PACKAGE}/{cpf}',
            timeout=15
        )
        resultado = response.json()

        # 1. Valida existência e situação
        if not resultado.get('valido'):
            return criar_resposta('REJEITAR', 'CPF inválido')

        if resultado.get('situacao') != 'REGULAR':
            return criar_resposta('REJEITAR',
                f"CPF {resultado.get('situacao')}")

        # 2. Cross-valida nome (similaridade > 85%)
        nome_declarado = dados_cooperado['nome'].upper()
        nome_oficial = resultado['nome'].upper()
        score_nome = calcular_similaridade(nome_declarado, nome_oficial)

        if score_nome < 0.60:
            return criar_resposta('REJEITAR', 'Nome divergente')
        elif score_nome < 0.85:
            return criar_resposta('REVISAR_MANUAL',
                f'Similaridade nome: {score_nome:.2%}')

        # 3. Valida data nascimento se disponível
        if 'data_nascimento' in resultado:
            if resultado['data_nascimento'] != dados_cooperado['data_nasc']:
                return criar_resposta('REVISAR_MANUAL',
                    'Data nascimento divergente')

        # 4. Registra log compliance (auditoria Bacen)
        registrar_log_compliance({
            'timestamp': datetime.now(),
            'cpf': cpf,
            'resultado_validacao': 'APROVADO',
            'score_confianca': score_nome,
            'fonte_validacao': 'RECEITA_FEDERAL_API',
            'circular_bacen': '3978_art3',
            'cooperativa': dados_cooperado['cooperativa_id']
        })

        return criar_resposta('APROVAR',
            f'Validado Receita Federal - score {score_nome:.2%}')

    except Exception as e:
        # Fallback: erro de API não deve bloquear abertura
        # mas direciona para revisão manual com SLA prioritário
        return criar_resposta('REVISAR_MANUAL',
            f'Validação automática indisponível: {str(e)}')