Handelsregister API &
Firmenbuch API

def enrich_lead(lead_company_name):
    """Reichert einen Lead mit Firmendaten an."""
    # Firma suchen
    results = requests.get(
        "https://api.firmium.io/v1/companies/",
        headers={"Authorization": f"Bearer {API_KEY}"},
        params={"search": lead_company_name, "country": "DE"}
    ).json()
    if results["results"]:
        company = results["results"][0]
        return {
            "name": company["name"],
            "register_number": company["register_number"],
            "address": company["address"],
            "legal_form": company["legal_form"],
            "employees": company.get("employee_count"),
            "revenue": company.get("revenue")
        }

async function verifyBusinessPartner(registerNumber) {
  // Unternehmen über Handelsregisternummer abrufen
  const company = await fetch(
    `https://api.firmium.io/v1/companies/?register_number=${registerNumber}`,
    { headers: { "Authorization": `Bearer ${API_KEY}` } }
  ).then(r => r.json());
  // Gesellschafter & wirtschaftlich Berechtigte abrufen
  const shareholders = await fetch(
    `https://api.firmium.io/v1/companies/${company.uuid}/shareholders/`,
    { headers: { "Authorization": `Bearer ${API_KEY}` } }
  ).then(r => r.json());
  return {
    verified: company.status === "active",
    companyData: company,
    ubos: shareholders.filter(s => s.share_percentage >= 25)
  };
}

# Watchdog erstellen für Firmen-Monitoring
watchdog = requests.post(
    "https://api.firmium.io/v1/watchdogs/",
    headers=headers,
    json={
        "name": "Kunden-Monitoring",
        "prompt": "Insolvenz, Geschäftsführer-Wechsel, Kapitaländerungen",
        "event_types": ["management", "financial", "event"]
    }
).json()
# Firmen zum Watchdog hinzufügen
requests.post(
    f"https://api.firmium.io/v1/watchdogs/{watchdog['uuid']}/subscribe/",
    headers=headers,
    json={"companies": ["uuid-1", "uuid-2"]}
)
# Events abrufen (z.B. täglich per Cronjob)
events = requests.get(
    f"https://api.firmium.io/v1/watchdogs/{watchdog['uuid']}/events/",
    headers=headers
).json()

# 1. Webhook-Endpoint registrieren
webhook = requests.post(
    "https://api.firmium.io/v1/webhooks/",
    headers=headers,
    json={
        "url": "https://yourapp.com/webhooks/firmium",
        "event_types": ["management", "financial"]
    }
).json()
# Secret für Signatur-Verifikation speichern
secret = webhook["secret"]
# 2. Webhook in Ihrer App empfangen (Flask Beispiel)
@app.route("/webhooks/firmium", methods=["POST"])
def handle_webhook():
    # HMAC Signatur verifizieren
    signature = request.headers.get("X-Firmium-Signature")
    payload = request.get_data(as_text=True)
    verify_signature(payload, signature, secret)
    event = request.json
    if event["type"] == "company.management_director":
        notify_sales_team(event["data"])
    return {"received": True}