API CPF e CNPJ para Mobilidade & Transporte: Validação de Passageiros

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

async def validar_passageiro(dados_passageiro):
    """
    Valida CPF para emissão de passagem (ANAC compliance)
    Retorna: {valido: bool, dados: dict, mensagem: str}
    """
    cpf = dados_passageiro['cpf'].replace('.', '').replace('-', '')

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

        # 1. Valida existência e situação
        if not validacao.get('valido'):
            await registrar_log({
                'tipo': 'PASSAGEM_BLOQUEADA',
                'motivo': 'CPF_INVALIDO',
                'cpf': cpf
            })
            return {
                'valido': False,
                'mensagem': 'CPF inválido. Verifique os números digitados.',
                'bloqueia_checkout': True
            }

        if validacao.get('situacao') != 'REGULAR':
            return {
                'valido': False,
                'mensagem': f"CPF {validacao.get('situacao')}. " +
                            "Regularize antes de comprar passagem.",
                'bloqueia_checkout': True
            }

        # 2. Cross-valida nome (requisito ANAC)
        nome_declarado = dados_passageiro['nome'].upper()
        nome_oficial = validacao['nome'].upper()
        score_nome = calcular_similaridade(nome_declarado, nome_oficial)

        if score_nome < 0.70:
            # Divergência alta - bloqueia por segurança
            await criar_alerta_fraude({
                'cpf': cpf,
                'tipo': 'DIVERGENCIA_NOME',
                'score': score_nome,
                'nome_declarado': nome_declarado,
                'nome_oficial': nome_oficial
            })
            return {
                'valido': False,
                'mensagem': 'Nome não confere com CPF. ' +
                            'Verifique seus dados ou contate suporte.',
                'bloqueia_checkout': True
            }

        # 3. Registra dados validados para emissão
        dados_validados = {
            'cpf': cpf,
            'nome_completo': nome_oficial,
            'situacao_receita': validacao.get('situacao'),
            'validado_em': datetime.utcnow(),
            'score_confianca': score_nome
        }

        # 4. Pré-preenche dados no sistema de reserva
        await salvar_dados_passageiro(dados_validados)

        return {
            'valido': True,
            'dados': dados_validados,
            'mensagem': 'CPF validado com sucesso.',
            'score_confianca': score_nome
        }

    except requests.Timeout:
        # Timeout: permite checkout mas registra para revisão
        await criar_caso_revisao({
            'cpf': cpf,
            'motivo': 'TIMEOUT_API',
            'prioridade': 'MEDIA'
        })
        return {
            'valido': True,  # não bloqueia por falha técnica
            'mensagem': 'Validação em processamento.',
            'requer_revisao': True
        }

    except Exception as e:
        await registrar_erro({'tipo': 'ERRO_VALIDACAO', 'erro': str(e)})
        return {
            'valido': True,
            'mensagem': 'Prosseguindo com validação padrão.',
            'requer_revisao': True
        }