{"id":4418,"date":"2026-01-29T14:56:21","date_gmt":"2026-01-29T13:56:21","guid":{"rendered":"https:\/\/sprintcx.net\/zoho-crm-workdrive-und-externe-api-automatisierte-kyc-und-angebotsprozesse-in-regulierten-branchen\/"},"modified":"2026-01-29T15:34:53","modified_gmt":"2026-01-29T14:34:53","slug":"zoho-crm-workdrive-und-externe-api-automatisierte-kyc-und-angebotsprozesse-in-regulierten-branchen","status":"publish","type":"post","link":"https:\/\/sprintcx.net\/de\/zoho-crm-workdrive-und-externe-api-automatisierte-kyc-und-angebotsprozesse-in-regulierten-branchen\/","title":{"rendered":"Zoho CRM, WorkDrive und externe API: Automatisierte KYC- und Angebotsprozesse in regulierten Branchen"},"content":{"rendered":"

Zoho CRM jenseits der Standards: Automatisierte KYC-Pr\u00fcfung und komplexe Angebote f\u00fcr die Finanzbranche<\/h2>\n

In regulierten Branchen wie FinTech, Rechtsberatung oder Unternehmensfinanzierung sind die Anforderungen an die Sorgfaltspflicht enorm. Die manuelle Recherche von Unternehmensstrukturen, die Ermittlung der wirtschaftlich Berechtigten (Ultimate Beneficial Owners, UBOs) und die Erstellung ma\u00dfgeschneiderter, komplexer Angebote sind nicht nur zeitaufwendig, sondern auch fehleranf\u00e4llig. Genau hier zeigt sich die wahre St\u00e4rke des Zoho-\u00d6kosystems: die F\u00e4higkeit, \u00fcber Standardfunktionen hinauszugehen und durch die intelligente Kombination von Apps, Custom Functions und externen APIs hochspezialisierte Prozesse zu automatisieren. Dieser Artikel zeigt Dir an einem praxisnahen Beispiel, wie Du Dein Zoho CRM<\/a> zu einem leistungsstarken Werkzeug f\u00fcr Compliance-Pr\u00fcfungen und dynamische Angebotserstellung ausbauen kannst, das weit \u00fcber die \u00fcbliche Lead- und Deal-Verwaltung hinausgeht.<\/p>\n

Praxisbeispiel: KYC und Angebotsprozess bei einem Zahlungsdienstleister<\/h3>\n

Stell Dir einen Zahlungsdienstleister vor, der neue Gesch\u00e4ftskunden onboarden m\u00f6chte. Bevor ein Vertrag zustande kommt, muss das Unternehmen im Rahmen des Know-Your-Customer-Prozesses (KYC) eine genaue Pr\u00fcfung durchf\u00fchren. Eine zentrale Herausforderung dabei ist die Identifizierung der UBOs, also der nat\u00fcrlichen Personen, die letztlich hinter einer Firma stehen. Dies wird besonders komplex, wenn es sich um verschachtelte Holding-Strukturen mit mehreren Untergesellschaften handelt.<\/p>\n

Die zweite Herausforderung liegt in der Angebotserstellung. Die Angebote sind keine simplen Produktlisten mit Artikelnummern. Stattdessen handelt es sich um beschreibende, modular aufgebaute Dokumente, die verschiedene Dienstleistungskategorien wie Hardware-Miete, Transaktionsgeb\u00fchren oder Implementierungsservices kombinieren. Das Standard-Angebotsmodul in Zoho CRM<\/a> st\u00f6\u00dft hier an seine Grenzen.<\/p>\n

Die Aufgabe ist also zweigeteilt:<\/p>\n

    \n
  1. Ein automatisierter Prozess, der auf Knopfdruck Firmendaten anreichert, die gesamte Gesellschafterstruktur rekursiv abfragt, die UBOs berechnet und alle relevanten Dokumente (z.B. Handelsregisterausz\u00fcge) zentral ablegt.<\/li>\n
  2. Eine flexible L\u00f6sung zur Erstellung von komplexen, kategorisierten Angeboten, die das Corporate Design exakt widerspiegelt und ohne starre Produktkataloge auskommt.<\/li>\n<\/ol>\n

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

    Wir teilen die L\u00f6sung in zwei Hauptmodule auf: Die automatisierte Datenanreicherung und die dynamische Angebotserstellung.<\/p>\n

    Teil 1: Automatisierte UBO- und Firmendaten-Analyse<\/h4>\n

    Das Ziel ist es, einen Button im Firmen-Modul (Accounts) von Zoho CRM<\/a> zu erstellen, der den gesamten KYC-Prozess anst\u00f6\u00dft.<\/p>\n

    Schritt 1: Die Grundlage in Zoho CRM und die externe API<\/h5>\n

    Als Basis dient das Modul „Firmen“ in Zoho CRM<\/a>. Um externe Firmendaten abzufragen, ben\u00f6tigst Du Zugang zu einer kommerziellen API f\u00fcr Unternehmensdaten, wie sie beispielsweise von Anbietern wie North Data, Dun & Bradstreet oder lokalen Handelsregistern bereitgestellt wird. F\u00fcr diesen Prozess ben\u00f6tigst Du einen API-Schl\u00fcssel, den Du sicher in Zoho Vault<\/a> hinterlegen solltest.<\/p>\n

    Schritt 2: Der Custom Button und die Deluge-Funktion<\/h5>\n

    Erstelle im Firmen-Modul einen neuen Button, z.B. mit dem Namen „KYC-Pr\u00fcfung starten“. Dieser Button ruft eine benutzerdefinierte Funktion auf, die in Deluge, der Scriptsprache von Zoho, geschrieben ist. Diese Funktion ist das Herzst\u00fcck der Automatisierung.<\/p>\n

    Schritt 3: Asynchrone Abfragen f\u00fcr komplexe Firmenstrukturen<\/h5>\n

    Eine einfache API-Abfrage w\u00fcrde bei komplexen Strukturen schnell an die Laufzeitgrenzen von Deluge sto\u00dfen. Der Trick besteht darin, die Abfragen asynchron zu gestalten. Die Hauptfunktion startet die Abfrage f\u00fcr die erste Firma und st\u00f6\u00dft f\u00fcr jede gefundene Gesellschafter-Firma eine weitere, unabh\u00e4ngige Abfrage an. So wird eine Kaskade von Abfragen parallel verarbeitet, was den Prozess enorm beschleunigt.<\/p>\n

    Hier ein vereinfachtes Deluge-Codebeispiel f\u00fcr eine solche Funktion, die eine externe API aufruft:<\/p>\n

    \/\/ Hauptfunktion, die durch den Button im CRM ausgel\u00f6st wird\n\/\/ accountId ist die ID der Firma, die gepr\u00fcft werden soll\nvoid processCompanyUBO(int accountId)\n{\n    \/\/ API-Key sicher aus Zoho Vault holen\n    apiKey = zoho.vault.getSecret(\"ExternalRegisterAPI_Key\");\n    \n    \/\/ Firmeninformationen aus CRM abrufen\n    companyDetails = zoho.crm.getRecordById(\"Accounts\", accountId);\n    companyName = companyDetails.get(\"Account_Name\");\n    \n    \/\/ URL zur externen API zusammenbauen\n    apiUrl = \"https:\/\/api.unternehmensregister.de\/v1\/company\/\" + companyName + \"?apiKey=\" + apiKey;\n    \n    \/\/ API asynchron aufrufen\n    \/\/ 'invokeurl' mit dem Parameter 'invokeAsynchronously' stellt die Anfrage in eine Warteschlange\n    \/\/ und l\u00e4sst das Skript weiterlaufen, ohne auf eine Antwort zu warten.\n    \/\/ Eine Callback-Funktion wird ben\u00f6tigt, um die Antwort zu verarbeiten.\n    paramMap = Map();\n    paramMap.put(\"callback_function\", \"handleApiResponse\");\n    paramMap.put(\"original_account_id\", accountId); \/\/ Wichtig: ID der Hauptfirma mitgeben\n    \n    response = invokeurl\n    [\n        url :apiUrl\n        type :GET\n        parameters:paramMap\n        connection:\"my_api_connection\"\n        invokeAsynchronously:true\n    ];\n    \n    info \"UBO-Pr\u00fcfung f\u00fcr \" + companyName + \" gestartet. Verarbeitung l\u00e4uft im Hintergrund.\";\n}\n\n\/\/ Callback-Funktion, die die API-Antwort verarbeitet (wird von Zoho im Hintergrund aufgerufen)\nvoid handleApiResponse(map response, map params)\n{\n    \/\/ Die ID der urspr\u00fcnglichen Hauptfirma aus den Parametern extrahieren\n    mainAccountId = params.get(\"original_account_id\").toLong();\n\n    \/\/ API-Antwort parsen\n    jsonResponse = response.get(\"response\").toJSON();\n    shareholders = jsonResponse.get(\"shareholders\");\n    \n    \/\/ Dokumente herunterladen und in WorkDrive speichern\n    registerExtractUrl = jsonResponse.get(\"documents\").get(\"register_extract_url\");\n    shareholderListUrl = jsonResponse.get(\"documents\").get(\"shareholder_list_url\");\n    \n    \/\/ Funktion aufrufen, die die Dokumente in WorkDrive ablegt\n    storeDocumentsInWorkDrive(mainAccountId, jsonResponse.get(\"companyName\"), registerExtractUrl, shareholderListUrl);\n    \n    \/\/ F\u00fcr jeden Gesellschafter pr\u00fcfen, ob es eine weitere Firma ist und den Prozess rekursiv starten\n    for each shareholder in shareholders\n    {\n        if(shareholder.get(\"type\") == \"company\")\n        {\n            \/\/ Hier w\u00fcrde man eine weitere asynchrone Abfrage f\u00fcr die Gesellschafter-Firma starten\n            \/\/ und dabei immer die ID der Hauptfirma (mainAccountId) weitergeben.\n        }\n        else\n        {\n            \/\/ Nat\u00fcrliche Person gefunden -> UBO-Berechnung durchf\u00fchren und in CRM speichern\n        }\n    }\n}<\/code><\/pre>\n
    Schritt 4: Zentrale Dokumentenablage mit Zoho WorkDrive<\/h5>\n
    Eine Schl\u00fcsselfunktion ist die zentrale Ablage aller gefundenen Dokumente. Statt die Gesellschafterliste einer Unterfirma bei eben dieser zu speichern, sollen alle Dokumente im Zoho WorkDrive<\/a>-Ordner der Hauptfirma landen. Dies erfordert die \u00dcbergabe der ID der Hauptfirma durch alle rekursiven Aufrufe.<\/p>\n
    Die Deluge-Funktion zum Hochladen der Datei k\u00f6nnte so aussehen:<\/p>\n
    \/\/ Funktion zum Speichern der Dokumente im WorkDrive-Ordner der Hauptfirma\nvoid storeDocumentsInWorkDrive(int mainAccountId, string subCompanyName, string documentUrl1, string documentUrl2)\n{\n    \/\/ WorkDrive-Ordner-ID der Hauptfirma abrufen (z.B. aus einem benutzerdefinierten Feld)\n    mainCompanyRecord = zoho.crm.getRecordById(\"Accounts\", mainAccountId);\n    workdriveFolderId = mainCompanyRecord.get(\"WorkDrive_Folder_ID\");\n    \n    if(workdriveFolderId != null)\n    {\n        \/\/ Dokument 1 (z.B. Handelsregisterauszug) herunterladen\n        fileContent1 = invokeurl[url: documentUrl1 type: GET];\n        fileName1 = subCompanyName + \"_Handelsregisterauszug.pdf\";\n        \n        \/\/ Datei in den richtigen WorkDrive-Ordner hochladen\n        uploadResponse1 = zoho.workdrive.uploadFile(fileContent1, workdriveFolderId, fileName1, true);\n        info \"Dokument 1 hochgeladen: \" + uploadResponse1;\n        \n        \/\/ Das gleiche f\u00fcr Dokument 2 (Gesellschafterliste)\n        fileContent2 = invokeurl[url: documentUrl2 type: GET];\n        fileName2 = subCompanyName + \"_Gesellschafterliste.pdf\";\n        uploadResponse2 = zoho.workdrive.uploadFile(fileContent2, workdriveFolderId, fileName2, true);\n        info \"Dokument 2 hochgeladen: \" + uploadResponse2;\n    }\n}<\/code><\/pre>\n
    Teil 2: Dynamische Angebotsvorlagen f\u00fcr Dienstleistungen<\/h4>\n
    Nachdem die Compliance-H\u00fcrde genommen ist, geht es an die Angebotserstellung. Hier ben\u00f6tigen wir eine flexible L\u00f6sung jenseits des Standard-Produktmoduls.<\/p>\n
    Schritt 1: Alternative zum Produktmodul: Subformulare nutzen<\/h5>\n
    Da die Angebote nicht auf Artikeln mit SKUs basieren, ist das Standard-Produktmodul ungeeignet. Eine weitaus flexiblere Methode ist die Verwendung eines Subformulars direkt im Angebotsmodul. Erstelle ein Subformular mit den Feldern, die Du wirklich ben\u00f6tigst:<\/p>\n