APIs de CPF para empresas de auditoria e consultoria empresarial

import requests
from datetime import datetime

CPFHUB_API_KEY = "sua_api_key_aqui"
CPFHUB_BASE_URL = "https://api.cpfhub.io/cpf"
TIMEOUT_SECONDS = 10

def verificar_socios(lista_socios: list) -> dict:
    """
    Verifica os CPFs de uma lista de sócios durante
    um processo de due diligence.
    """
    resultados = {
        "verificados": [],
        "divergentes": [],
        "nao_encontrados": [],
        "erros": []
    }

    headers = {
        "x-api-key": CPFHUB_API_KEY,
        "Accept": "application/json"
    }

    for socio in lista_socios:
        cpf_limpo = socio["cpf"].replace(".", "").replace("-", "")

        if len(cpf_limpo) != 11 or not cpf_limpo.isdigit():
            resultados["erros"].append({
                **socio,
                "problema": "CPF com formato inválido"
            })
            continue

        try:
            response = requests.get(
                f"{CPFHUB_BASE_URL}/{cpf_limpo}",
                headers=headers,
                timeout=TIMEOUT_SECONDS
            )
            response.raise_for_status()
            resultado = response.json()
        except requests.exceptions.Timeout:
            resultados["erros"].append({
                **socio,
                "problema": "Timeout na consulta"
            })
            continue
        except requests.exceptions.RequestException as e:
            resultados["erros"].append({
                **socio,
                "problema": f"Erro: {str(e)}"
            })
            continue

        if not resultado.get("success"):
            resultados["nao_encontrados"].append({
                **socio,
                "alerta": "CPF não localizado — possível empresa fantasma"
            })
            continue

        dados = resultado["data"]
        nome_api = dados.get("nameUpper", "").strip()
        nome_socio = socio["nome"].strip().upper()

        if nome_api == nome_socio:
            resultados["verificados"].append({
                "cpf": dados["cpf"],
                "nome": dados["name"],
                "genero": dados["gender"],
                "data_nascimento": dados["birthDate"],
                "participacao": socio.get("participacao", "N/I"),
                "status": "OK"
            })
        else:
            resultados["divergentes"].append({
                "cpf_informado": socio["cpf"],
                "nome_informado": socio["nome"],
                "nome_base": dados["name"],
                "participacao": socio.get("participacao", "N/I"),
                "alerta": "Nome divergente — requer investigação"
            })

    # Resumo
    total = len(lista_socios)
    resultados["resumo"] = {
        "total_analisados": total,
        "verificados": len(resultados["verificados"]),
        "divergentes": len(resultados["divergentes"]),
        "nao_encontrados": len(resultados["nao_encontrados"]),
        "erros": len(resultados["erros"]),
        "data_analise": datetime.now().isoformat()
    }

    return resultados

# Exemplo de uso
socios = [
    {"cpf": "123.456.789-09", "nome": "Marcos Eduardo Pinto", "participacao": "40%"},
    {"cpf": "987.654.321-00", "nome": "Carla Mendes Silva", "participacao": "35%"},
    {"cpf": "456.789.123-45", "nome": "Nome Fictício", "participacao": "25%"}
]

resultado = verificar_socios(socios)

print("=== RELATÓRIO DE DUE DILIGENCE ===")
print(f"Total analisados: {resultado['resumo']['total_analisados']}")
print(f"Verificados: {resultado['resumo']['verificados']}")
print(f"Divergentes: {resultado['resumo']['divergentes']}")
print(f"Não encontrados: {resultado['resumo']['nao_encontrados']}")

if resultado["divergentes"]:
    print("\nALERTAS:")
    for d in resultado["divergentes"]:
        print(f"  CPF {d['cpf_informado']}: {d['alerta']}")
        print(f"  Nome informado: {d['nome_informado']}")
        print(f"  Nome na base: {d['nome_base']}")

curl -X GET "https://api.cpfhub.io/cpf/12345678909" \
  -H "x-api-key: sua_api_key_aqui" \
  -H "Accept: application/json" \
  --max-time 10

{
  "success": true,
  "data": {
    "cpf": "123.456.789-09",
    "name": "Marcos Eduardo Pinto",
    "nameUpper": "MARCOS EDUARDO PINTO",
    "gender": "M",
    "birthDate": "02/10/1972",
    "day": "02",
    "month": "10",
    "year": "1972"
  }
}

const axios = require("axios");

const CPFHUB_API_KEY = "sua_api_key_aqui";
const CPFHUB_BASE_URL = "https://api.cpfhub.io/cpf";

async function auditarFolhaPagamento(funcionarios) {
  const relatorio = {
    regulares: [],
    irregulares: [],
    alertas: []
  };

  for (const func of funcionarios) {
    const cpfLimpo = func.cpf.replace(/\D/g, "");

    try {
      const response = await axios.get(`${CPFHUB_BASE_URL}/${cpfLimpo}`, {
        headers: {
          "x-api-key": CPFHUB_API_KEY,
          Accept: "application/json"
        },
        timeout: 10000
      });

      const resultado = response.data;

      if (!resultado.success) {
        relatorio.irregulares.push({
          ...func,
          irregularidade: "CPF não encontrado — possível funcionário fantasma"
        });
        continue;
      }

      const dados = resultado.data;
      const nomeApi = dados.nameUpper;
      const nomeFolha = func.nome.toUpperCase().trim();

      if (nomeApi !== nomeFolha) {
        relatorio.alertas.push({
          ...func,
          nomeBase: dados.name,
          alerta: "Nome na folha diverge do CPF"
        });
      } else {
        relatorio.regulares.push({
          cpf: dados.cpf,
          nome: dados.name,
          cargo: func.cargo,
          status: "regular"
        });
      }
    } catch (error) {
      relatorio.alertas.push({
        ...func,
        alerta: error.code === "ECONNABORTED"
          ? "Timeout na verificação"
          : `Erro: ${error.message}`
      });
    }

    await new Promise((resolve) => setTimeout(resolve, 500));
  }

  relatorio.resumo = {
    total: funcionarios.length,
    regulares: relatorio.regulares.length,
    irregulares: relatorio.irregulares.length,
    alertas: relatorio.alertas.length,
    dataAuditoria: new Date().toISOString()
  };

  return relatorio;
}

// Exemplo de uso
(async () => {
  const funcionarios = [
    { cpf: "123.456.789-09", nome: "Marcos Eduardo Pinto", cargo: "Diretor" },
    { cpf: "987.654.321-00", nome: "Carla Mendes Silva", cargo: "Gerente" },
    { cpf: "111.111.111-11", nome: "Funcionário Fantasma", cargo: "Analista" }
  ];

  const relatorio = await auditarFolhaPagamento(funcionarios);

  console.log("=== AUDITORIA DE FOLHA DE PAGAMENTO ===");
  console.log(`Total: ${relatorio.resumo.total}`);
  console.log(`Regulares: ${relatorio.resumo.regulares}`);
  console.log(`Irregulares: ${relatorio.resumo.irregulares}`);
  console.log(`Alertas: ${relatorio.resumo.alertas}`);

  if (relatorio.irregulares.length > 0) {
    console.log("\nIRREGULARIDADES:");
    relatorio.irregulares.forEach((i) => {
      console.log(`  ${i.nome} (${i.cargo}): ${i.irregularidade}`);
    });
  }
})();