{"id":4267,"date":"2026-01-22T14:57:12","date_gmt":"2026-01-22T13:57:12","guid":{"rendered":"https:\/\/sprintcx.net\/automatisierte-ubo-prufung-und-angebotsprozess-mit-zoho-crm-deluge-und-externer-api-tutorial-fur-fintech-workflows\/"},"modified":"2026-01-22T15:57:42","modified_gmt":"2026-01-22T14:57:42","slug":"automatisierte-ubo-prufung-und-angebotsprozess-mit-zoho-crm-deluge-und-externer-api-tutorial-fur-fintech-workflows","status":"publish","type":"post","link":"https:\/\/wordpress.sprintcx.net\/de\/automatisierte-ubo-prufung-und-angebotsprozess-mit-zoho-crm-deluge-und-externer-api-tutorial-fur-fintech-workflows\/","title":{"rendered":"Automatisierte UBO-Pr\u00fcfung und Angebotsprozess mit Zoho CRM, Deluge und externer API \u2013 Tutorial f\u00fcr FinTech-Workflows"},"content":{"rendered":"

Automatisierte UBO-Pr\u00fcfung und flexible Angebotserstellung: Ein FinTech-Workflow mit Zoho CRM und externen APIs<\/h2>\n

Wenn du in einer regulierten Branche wie dem FinTech- oder Zahlungsdienstleistungssektor t\u00e4tig bist, kennst du die Herausforderungen: Komplexe Compliance-Anforderungen wie die KYC-Pr\u00fcfung (Know Your Customer) und die Ermittlung wirtschaftlich Berechtigter (UBO – Ultimate Beneficial Owner) treffen auf individuelle, schwer zu standardisierende Preismodelle. Diese Prozesse manuell abzuwickeln, ist nicht nur zeitaufwendig, sondern auch fehleranf\u00e4llig. Genau hier zeigt sich die St\u00e4rke eines gut konfigurierten Zoho-\u00d6kosystems: Durch die intelligente Kombination von Zoho CRM<\/a> mit Custom Functions und der Anbindung externer APIs kannst du nicht nur Compliance-Aufgaben automatisieren, sondern auch einen hochflexiblen Vertriebsprozess f\u00fcr komplexe Produkte abbilden. In diesem Artikel zeigen wir dir einen praxisnahen L\u00f6sungsansatz, der beide Herausforderungen meistert.<\/p>\n

Praxisbeispiel: Der Anwendungsfall eines Zahlungsdienstleisters<\/h3>\n

Stell dir ein Unternehmen im Bereich der Zahlungsabwicklung vor. Der Vertriebsprozess ist zweigeteilt und stellt das Team vor spezifische Herausforderungen:<\/p>\n

    \n
  1. Compliance-Pr\u00fcfung bei der Kundenanlage:<\/strong> Vor Vertragsabschluss m\u00fcssen die wirtschaftlich Berechtigten (UBOs) eines potenziellen Gesch\u00e4ftskunden identifiziert werden. Laut Geldw\u00e4schegesetz (GwG) ist dies f\u00fcr alle Personen mit einem Anteil von \u00fcber 25 % an einem Unternehmen zwingend erforderlich. Die manuelle Recherche in Handelsregistern ist m\u00fchsam. Ziel ist es, diesen Prozess direkt bei der Anlage eines neuen Firmenkunden (Accounts) in Zoho CRM<\/a> zu automatisieren, indem eine externe API wie die von OpenRegister (ein fiktives Beispiel f\u00fcr eine Handelsregister-API) abgefragt wird.<\/li>\n
  2. Komplexe Angebotserstellung:<\/strong> Die Preisgestaltung ist nicht standardisiert. Jedes Angebot enth\u00e4lt eine Mischung aus fixen monatlichen Geb\u00fchren, variablen Transaktionskosten, volumenabh\u00e4ngigen Rabatten und einmaligen Setup-Kosten. Eine einfache Produktliste, wie sie in Zoho Books<\/a> \u00fcblich ist, reicht hier nicht aus. Der Vertrieb ben\u00f6tigt maximale Flexibilit\u00e4t bei der Gestaltung der Angebotsdokumente, um auf individuelle Kundenw\u00fcnsche eingehen zu k\u00f6nnen.<\/li>\n<\/ol>\n

    Die Gesamtaufgabe besteht darin, einen durchg\u00e4ngigen, digitalen Prozess zu schaffen: von der automatisierten UBO-Pr\u00fcfung \u00fcber die flexible Angebotserstellung bis hin zur sp\u00e4teren Vertragsgenerierung und digitalen Signatur.<\/p>\n

    Schritt-f\u00fcr-Schritt-Anleitung zur L\u00f6sung<\/h3>\n

    Wir teilen die L\u00f6sung in zwei Hauptteile auf: Zuerst k\u00fcmmern wir uns um die Automatisierung der UBO-Pr\u00fcfung, danach um die Implementierung der flexiblen Angebotserstellung.<\/p>\n

    Teil 1: Automatisierte UBO-Pr\u00fcfung mit Deluge und externer API<\/h4>\n

    Das Herzst\u00fcck dieser L\u00f6sung ist eine Custom Function in Zoho CRM<\/a>, die auf Knopfdruck die Daten eines Firmenkunden an eine externe API sendet und die zur\u00fcckgelieferten Gesellschafterdaten verarbeitet.<\/p>\n

    1. Die Datenquelle: Eine API f\u00fcr Handelsregisterdaten<\/h5>\n

    Wir gehen davon aus, dass du Zugriff auf eine API hast, die dir basierend auf einer Firmen-ID (z. B. Handelsregisternummer) eine Liste der Gesellschafter und deren Beteiligungsquoten im JSON-Format zur\u00fcckgibt. Ein typischer API-Endpunkt k\u00f6nnte so aussehen: https:\/\/api.openregister.eu\/v1\/company\/{firmen_id}\/shareholders<\/code>.<\/p>\n

    2. Die Umsetzung in Zoho CRM<\/h5>\n

    Im Modul „Firmen“ (Accounts) erstellst du eine Subform namens „Wirtschaftlich Berechtigte (UBO)“. Diese Subform sollte mindestens die Felder Vorname, Nachname, Geburtsdatum und Anteil in Prozent enthalten. Zus\u00e4tzlich legst du einen Button an (z.B. „UBO-Pr\u00fcfung starten“), der unsere Deluge-Funktion ausl\u00f6st.<\/p>\n

    3. Das Deluge-Skript zur UBO-Pr\u00fcfung<\/h5>\n

    Die folgende Custom Function wird an den Button gekn\u00fcpft. Sie holt die Handelsregisternummer aus dem Firmendatensatz, ruft die externe API auf, filtert die Ergebnisse nach dem Schwellenwert von > 25 % und tr\u00e4gt die relevanten Personen in die Subform ein.<\/p>\n

    \n\/\/ Deluge Custom Function f\u00fcr das Modul \"Firmen\" (Accounts)\n\/\/ Argument: accountId (Long)\n\n\/\/ Firmendatensatz abrufen, um die Handelsregisternummer zu erhalten\naccountDetails = zoho.crm.getRecordById(\"Accounts\", accountId);\nhandelsregisterNr = ifnull(accountDetails.get(\"Handelsregisternummer\"),\"\");\n\nif(handelsregisterNr != \"\")\n{\n    \/\/ API-Aufruf vorbereiten\n    \/\/ Wichtig: API-Keys immer \u00fcber Connections verwalten, nicht hardcoden!\n    apiConnectionName = \"openregister_api\"; \/\/ Name deiner Connection in Zoho Flow\/CRM\n    apiUrl = \"https:\/\/api.openregister.eu\/v1\/company\/\" + handelsregisterNr + \"\/shareholders\";\n    \n    try \n    {\n        \/\/ API aufrufen\n        response = invokeurl\n        [\n            url :apiUrl\n            type :GET\n            connection:apiConnectionName\n        ];\n        \n        \/\/ JSON-Antwort verarbeiten\n        shareholders = response.get(\"data\").get(\"shareholders\");\n        \n        \/\/ Liste f\u00fcr die Subform vorbereiten und bestehende Eintr\u00e4ge l\u00f6schen\n        uboList = List();\n        updateMap = Map();\n        updateMap.put(\"Wirtschaftlich_Berechtigte_UBO\", uboList);\n        zoho.crm.updateRecord(\"Accounts\", accountId, updateMap);\n\n        \/\/ Gesellschafter durchlaufen und UBOs filtern (> 25%)\n        for each shareholder in shareholders\n        {\n            anteil = ifnull(shareholder.get(\"anteil_prozent\"), 0.0).toDecimal();\n            \n            \/\/ Die entscheidende Gesch\u00e4ftslogik: Nur Anteile \u00fcber 25% sind relevant\n            if(anteil > 25.0)\n            {\n                row = Map();\n                row.put(\"Vorname\", shareholder.get(\"vorname\"));\n                row.put(\"Nachname\", shareholder.get(\"nachname\"));\n                row.put(\"Geburtsdatum\", ifnull(shareholder.get(\"geburtsdatum\"),\"\").toDate());\n                row.put(\"Anteil_in_Prozent\", anteil);\n                uboList.add(row);\n            }\n        }\n        \n        \/\/ Gefilterte UBO-Liste in die Subform des Firmendatensatzes eintragen\n        if (uboList.size() > 0)\n        {\n             updateMap.put(\"Wirtschaftlich_Berechtigte_UBO\", uboList);\n             updateResponse = zoho.crm.updateRecord(\"Accounts\", accountId, updateMap);\n             info \"UBO-Pr\u00fcfung erfolgreich. \" + uboList.size() + \" wirtschaftlich Berechtigte gefunden und eingetragen.\";\n        }\n        else\n        {\n             info \"UBO-Pr\u00fcfung abgeschlossen. Keine Person mit \u00fcber 25% Anteil gefunden.\";\n        }\n    }\n    catch(e)\n    {\n        \/\/ Fehlerbehandlung f\u00fcr den Fall, dass die API nicht erreichbar ist\n        info \"Fehler bei der UBO-Pr\u00fcfung: \" + e;\n    }\n}\nelse\n{\n    info \"Bitte geben Sie eine Handelsregisternummer an, um die Pr\u00fcfung zu starten.\";\n}\n<\/code><\/pre>\n
    Mit diesem Skript hast du einen automatisierten und vor allem dokumentierten Prozess zur Erf\u00fcllung deiner Compliance-Pflichten direkt im CRM verankert.<\/p>\n
    Teil 2: Flexible Angebotserstellung im Zoho CRM<\/h4>\n
    F\u00fcr komplexe Preismodelle ist das Standard-Angebotsmodul von Zoho Books<\/a> oft zu starr. Die St\u00e4rke von Zoho CRM<\/a> liegt in seiner Flexibilit\u00e4t. Deshalb bauen wir den Angebotsprozess hier auf.<\/p>\n
    1. Die strategische Entscheidung: Zoho CRM statt Zoho Books<\/h5>\n
    Warum Zoho CRM<\/a> f\u00fcr diese Aufgabe besser geeignet ist:<\/p>\n