API CPF e CNPJ para Saúde: Validação de Beneficiários e Prestadores

# Python exemplo para validação beneficiário saúde
import requests
from datetime import datetime

def validar_beneficiario_saude(dados_beneficiario):
    """
    Valida CPF de beneficiário para guia TISS (ANS compliance)
    Retorna: {valido: bool, dados_oficiais: dict, alerta: str}
    """
    cpf = dados_beneficiario['cpf'].replace('.', '').replace('-', '')

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

        # 1. Valida existência (requisito TISS)
        if not validacao.get('valido'):
            registrar_log_glosa_potencial({
                'cpf': cpf,
                'motivo': 'CPF_INEXISTENTE',
                'beneficiario': dados_beneficiario['nome']
            })
            return {
                'valido': False,
                'alerta': 'BLOQUEAR',
                'mensagem': 'CPF inexistente. Revisar carteirinha.'
            }

        # 2. Verifica situação (glosa se irregular)
        if validacao.get('situacao') != 'REGULAR':
            return {
                'valido': False,
                'alerta': 'BLOQUEAR',
                'mensagem': f"CPF {validacao.get('situacao')}. " +
                            "Guia TISS será glosada. Revisar."
            }

        # 3. Cross-valida nome (prevenção fraude)
        nome_carteirinha = dados_beneficiario['nome'].upper()
        nome_oficial = validacao['nome'].upper()
        score_nome = calcular_similaridade(nome_carteirinha, nome_oficial)

        if score_nome < 0.75:
            criar_alerta_fraude({
                'cpf': cpf,
                'tipo': 'DIVERGENCIA_NOME_BENEFICIARIO',
                'score': score_nome,
                'carteirinha': nome_carteirinha,
                'oficial': nome_oficial,
                'prioridade': 'ALTA' if score_nome < 0.50 else 'MEDIA'
            })
            return {
                'valido': False,
                'alerta': 'REVISAR_DOCUMENTOS',
                'mensagem': 'Nome divergente. Solicitar RG/CNH.'
            }

        # 4. Verifica óbito (fraude comum em planos)
        if validacao.get('obito'):
            bloquear_plano(cpf)
            notificar_fraude_obito({
                'cpf': cpf,
                'data_obito': validacao.get('data_obito'),
                'tentativa_uso': datetime.now()
            })
            return {
                'valido': False,
                'alerta': 'FRAUDE_OBITO',
                'mensagem': 'Titular falecido. Bloquear plano.'
            }

        # 5. Atualiza dados oficiais no cadastro
        atualizar_cadastro_beneficiario({
            'cpf': cpf,
            'nome_oficial_completo': nome_oficial,
            'situacao_receita': validacao.get('situacao'),
            'validado_em': datetime.now(),
            'pronto_tiss': True
        })

        return {
            'valido': True,
            'dados_oficiais': {
                'nome_completo': nome_oficial,
                'situacao': validacao.get('situacao')
            },
            'alerta': None,
            'mensagem': 'CPF validado. Autorização liberada.'
        }

    except Exception as e:
        # Erro não deve bloquear atendimento emergencial
        criar_caso_revisao_manual({
            'cpf': cpf,
            'motivo': 'ERRO_VALIDACAO_API',
            'prioridade': 'ALTA',
            'erro': str(e)
        })
        return {
            'valido': True,  # libera atendimento
            'alerta': 'REVISAR_POSTERIOR',
            'mensagem': 'Validar CPF posteriormente.'
        }