Blog

Du betrachtest gerade Zoho CRM Layout-Regeln und Wizard für hybrides B2B-Onboarding mit API-Anbindung

Zoho CRM Layout-Regeln und Wizard für hybrides B2B-Onboarding mit API-Anbindung

  • Beitrags-Autor:

Zoho CRM Masterclass: Der hybride Onboarding-Prozess für komplexe B2B-Kunden

Das Onboarding neuer Geschäftskunden ist oft ein kritischer, aber auch fehleranfälliger Prozess. Besonders im B2B-Umfeld, wo je nach Rechtsform des Kunden unterschiedliche Daten, Dokumente und Ansprechpartner erforderlich sind, wird es schnell unübersichtlich. Ein standardisierter Prozess passt selten für alle. Wie schaffst Du es also, Deinem Vertrieb ein einfaches, geführtes Werkzeug an die Hand zu geben, während Deine Fachexperten im Backoffice weiterhin schnell und flexibel arbeiten können? Die Antwort liegt in einem hybriden Ansatz innerhalb von Zoho CRM, der die Stärken von Layout-Regeln und der Wizard-Funktion (früher Kiosk) intelligent kombiniert und durch externe API-Anbindungen erweitert wird.

Dieser Artikel zeigt Dir praxisnah, wie Du einen robusten und skalierbaren Onboarding-Prozess für komplexe Szenarien aufbaust. Wir verzichten auf Marketing-Floskeln und konzentrieren uns auf die technische Umsetzung, die Du direkt in Deinem System nachbauen kannst.

Das Praxisbeispiel: Onboarding für einen Payment-Anbieter

Stell Dir vor, Du arbeitest für einen Finanzdienstleister, der Zahlungsterminals und Online-Payment-Lösungen anbietet. Der Onboarding-Prozess für neue Händler ist streng reguliert und komplex. Die benötigten Informationen hängen stark von der Rechtsform des Unternehmens ab:

  • Ein Einzelunternehmer muss seine persönlichen Daten und eine Gewerbeanmeldung einreichen.
  • Eine GmbH benötigt einen Handelsregisterauszug, die Identifikation der Geschäftsführer und die Offenlegung der wirtschaftlich Berechtigten (Ultimate Beneficial Owners, UBOs).
  • Eine GbR erfordert die Daten aller Gesellschafter.

Diese Komplexität stellt zwei Nutzergruppen vor unterschiedliche Herausforderungen:

  1. Das Vertriebsteam: Mitarbeiter im Außendienst sind oft unterwegs und nicht immer mit jeder juristischen Feinheit vertraut. Sie benötigen einen idiotensicheren, schrittweisen Prozess, der sie durch die Datenerfassung führt und sicherstellt, dass nichts vergessen wird.
  2. Das Backoffice-Team: Diese Experten kennen die Anforderungen genau. Sie benötigen eine effiziente Ansicht, in der sie schnell Daten ergänzen, prüfen und bearbeiten können, ohne sich durch einen langen Wizard klicken zu müssen.

Die Lösung ist ein hybrides Modell, das beiden Gruppen gerecht wird. Wir nutzen die Stärken verschiedener Zoho-Funktionen, um einen nahtlosen Prozess zu schaffen.

Schritt-für-Schritt: Die technische Umsetzung im Detail

Wir bauen den Prozess in vier logischen Schritten auf. Als Basis dient das Modul „Firmen“ (Accounts) in Zoho CRM.

Schritt 1: Das Fundament – Layout-Regeln für Experten

Die Layout-Regeln sind das Rückgrat für unser Backoffice-Team. Sie sorgen dafür, dass in der Detailansicht eines Firmendatensatzes nur die relevanten Felder für die jeweilige Rechtsform angezeigt werden.

  1. Voraussetzung: Du benötigst ein Auswahllistenfeld (Picklist) im Firmen-Modul, das wir „Rechtsform“ nennen. Trage hier alle relevanten Optionen ein (z. B. GmbH, AG, Einzelunternehmen, GbR).
  2. Layout-Regel erstellen: Gehe zu Einstellungen > Anpassung > Module und Felder > Firmen > Layout-Regeln.
  3. Neue Regel anlegen: Nenne sie z.B. „Anzeige nach Rechtsform“.
  4. Bedingung definieren: Wähle das Feld „Rechtsform“ und die entsprechende Option, z.B. „ist GmbH“.
  5. Aktionen auslösen: Wähle die Aktion „Felder anzeigen“ und markiere alle Felder, die nur für eine GmbH relevant sind (z.B. „Handelsregisternummer“, „Amtsgericht“, „UBO-Informationen“). Verstecke gleichzeitig Felder, die nicht relevant sind.
  6. Wiederholen: Erstelle für jede Rechtsform eine eigene Bedingung mit den entsprechenden Aktionen.

Ergebnis: Wählt ein Mitarbeiter im Backoffice die Rechtsform „GmbH“ aus, erscheinen sofort die richtigen Felder. Das schafft Klarheit und Effizienz für die Experten.

Schritt 2: Der geführte Prozess – Den Wizard konfigurieren

Der Wizard ist das Werkzeug für den Vertrieb. Er führt den Nutzer Schritt für Schritt durch die Datenerfassung und stellt sicher, dass alle Pflichtinformationen in der richtigen Reihenfolge abgefragt werden.

  1. Wizard erstellen: Gehe zu Einstellungen > Anpassung > Module und Felder > Firmen > Wizards. Erstelle einen neuen Wizard namens „Kunden-Onboarding“.
  2. Struktur definieren (die „Schienen“): Wir teilen den Prozess in logische Abschnitte (im System „Transitions“ genannt). Für unser Beispiel definieren wir vier Stufen:
    • 1. Firmendaten: Stammdaten, Adresse, Bankverbindung.
    • 2. Konditionen & Terminal: Vertragskonditionen, gewünschtes Terminalmodell, Standortdaten (z.B. Integration mit Zoho RouteIQ zur Standortvalidierung).
    • 3. Zeichnungsberechtigte: Erfassung der Geschäftsführer oder Prokuristen (kann auf ein verknüpftes Kontakte-Modul verweisen).
    • 4. Wirtschaftlich Berechtigte (UBO): Erfassung der UBO-Daten, die ab einer bestimmten Beteiligungsschwelle notwendig sind.
  3. Felder zuordnen: Ziehe per Drag & Drop die entsprechenden Felder in jeden Abschnitt. Definiere, welche Felder Pflichtfelder sind, um zur nächsten Stufe zu gelangen.
  4. Kontrollfelder anlegen: Um den Prozess besser steuern und nachverfolgen zu können, legen wir zwei zusätzliche Felder im Firmen-Modul an:
    • Onboarding Status: Eine Auswahlliste (Picklist), deren Werte unseren Wizard-Schritten entsprechen („1. Firmendaten erfasst“, „2. Konditionen erfasst“, etc.).
    • Onboarding Debug Log: Ein mehrzeiliges Textfeld, in dem wir per Skript wichtige Informationen und Fehler protokollieren.

Schritt 3: Die Logik – Steuerung per Deluge Custom Function

Damit der Status automatisch gesetzt wird und der Prozess sauber protokolliert wird, nutzen wir eine Custom Function, die wir in den Wizard-Übergängen („Transitions“) auslösen.

Gehe in der Wizard-Konfiguration bei einem Übergang (z.B. nach Abschluss von „1. Firmendaten“) auf den Reiter „Aktionen“ und wähle „Funktion ausführen“. Erstelle eine neue Funktion mit der Skriptsprache Deluge.

Diese Funktion aktualisiert den Status und schreibt einen Log-Eintrag. Sie wird bei jedem Schritt des Wizards mit den entsprechenden Parametern aufgerufen.


// Funktion: updateOnboardingStatus
// Zweck: Aktualisiert den Onboarding-Status und schreibt einen Log-Eintrag.
// Parameter:
//   accountId (BIGINT): Die ID des Firmen-Datensatzes
//   newStatus (STRING): Der neue Status, der gesetzt werden soll
//   logMessage (STRING): Eine zusätzliche Info für das Debug-Log

void updateOnboardingStatus(bigint accountId, string newStatus, string logMessage)
{
    // Aktuellen Datensatz abrufen, um das bestehende Log zu laden
    current_record = zoho.crm.getRecordById("Accounts", accountId);
    
    // Bestehendes Log auslesen
    existing_log = ifnull(current_record.get("Onboarding_Debug_Log"), "");
    
    // Neuen Log-Eintrag mit Zeitstempel erstellen
    timestamp = now.toString("yyyy-MM-dd HH:mm:ss");
    new_log_entry = timestamp + " | Status: " + newStatus + " | Info: " + logMessage;
    
    // Kombiniere altes und neues Log
    updated_log = new_log_entry + "n" + existing_log;
    
    // Daten für das Update vorbereiten
    update_map = Map();
    update_map.put("Onboarding_Status", newStatus);
    update_map.put("Onboarding_Debug_Log", updated_log);
    
    // Datensatz in Zoho CRM aktualisieren
    update_response = zoho.crm.updateRecord("Accounts", accountId, update_map);
    
    // Response loggen (nützlich für die Fehlersuche)
    info update_response;
}

In jedem Wizard-Schritt rufst Du diese Funktion dann mit den passenden Werten auf, z.B. updateOnboardingStatus(accountId, "2. Konditionen erfasst", "Firmendaten erfolgreich validiert.");

Schritt 4: Die externe Anbindung – Bonitätsprüfung via API

Ein Onboarding-Prozess endet selten im CRM. Oft müssen externe Dienste abgefragt werden, z.B. für eine Bonitätsprüfung. Hier zeigen wir beispielhaft, wie Du eine externe API (z.B. von Anbietern wie Creditreform, Schufa oder Dun & Bradstreet) per Deluge anbindest.

Wir erstellen eine weitere Custom Function, die wir als benutzerdefinierten Button im Firmen-Modul oder als Aktion im Wizard einbinden können.


// Funktion: checkCreditRating
// Zweck: Ruft eine externe API zur Bonitätsprüfung auf und speichert das Ergebnis.
// Parameter:
//   accountId (BIGINT): Die ID des Firmen-Datensatzes

void checkCreditRating(bigint accountId)
{
    // Firmendaten aus dem CRM abrufen
    account_details = zoho.crm.getRecordById("Accounts", accountId);
    company_name = account_details.get("Account_Name");
    // Handelsregisternummer oder eine andere eindeutige ID
    registration_number = account_details.get("Handelsregisternummer"); 
    
    if (registration_number != null)
    {
        // API-Endpunkt und Authentifizierung
        api_url = "https://api.bonitaets-anbieter.de/v2/check";
        api_key = "DEIN_GEHEIMER_API_SCHLUESSEL"; // Sicher in Connections speichern!
        
        // Header für die Anfrage definieren
        headers = Map();
        headers.put("Authorization", "Bearer " + api_key);
        headers.put("Content-Type", "application/json");
        
        // Request-Body zusammenbauen
        request_body = Map();
        request_body.put("companyName", company_name);
        request_body.put("registrationNumber", registration_number);
        
        try 
        {
            // API-Aufruf mit invokeurl
            api_response = invokeurl
            [
                url :api_url
                type :POST
                headers:headers
                parameters:request_body.toString()
            ];

            // Antwort verarbeiten (Annahme: JSON-Response)
            response_json = api_response.toJSON();
            credit_score = response_json.get("score");
            risk_level = response_json.get("riskLevel");
            
            // Ergebnis im CRM-Datensatz speichern
            update_map = Map();
            update_map.put("Bonitaetsscore", credit_score);
            update_map.put("Risikostufe", risk_level);
            zoho.crm.updateRecord("Accounts", accountId, update_map);
            
            // Log-Eintrag über die andere Funktion erstellen
            updateOnboardingStatus(accountId, account_details.get("Onboarding_Status"), "Bonitätsprüfung erfolgreich: Score " + credit_score);
        }
        catch (e)
        {
            // Fehlerbehandlung
            updateOnboardingStatus(accountId, account_details.get("Onboarding_Status"), "Fehler bei Bonitätsprüfung: " + e.toString());
        }
    }
}

Wichtig: Speichere API-Schlüssel niemals direkt im Code. Nutze stattdessen die „Connections“ in Zoho, um Authentifizierungsdaten sicher zu hinterlegen.

Tipps und Best Practices aus der Praxis

  • Modularer Deluge-Code: Deluge hat als proprietäre Skriptsprache einige Eigenheiten. Es fehlen Konstrukte wie Klassen oder erweiterte Schleifen. Um Deinen Code wartbar zu halten, lagere wiederkehrende Logik in separate Custom Functions aus (wie unsere updateOnboardingStatus-Funktion). So simulierst Du eine Art Modularität und vermeidest Code-Duplizierung.
  • Versionskontrolle mit Git: Die eingebaute Versionskontrolle für Deluge-Skripte ist rudimentär. Für professionelle Entwicklung, besonders im Team, empfiehlt es sich, den Code in einem externen Git-Repository (z.B. über GitHub oder GitLab) zu verwalten. Das schafft eine saubere Änderungshistorie und erleichtert die Zusammenarbeit.
  • Nutze Zoho Flow für komplexe Orchestrierung: Wenn Dein Prozess über mehrere Apps hinweggeht (z.B. Erstellung eines Vertrags in Zoho Sign, Anlegen eines Projekts in Zoho Projects und Buchung des Umsatzes in Zoho Books), wird der Wizard schnell unübersichtlich. Nutze hierfür Zoho Flow als zentrale Orchestrierungs-Engine, die auf Statusänderungen im CRM reagiert und die nachgelagerten Prozesse anstößt.
  • Denke an die Datenanalyse: Die gesammelten Status- und Zeitstempeldaten sind Gold wert. Nutze Zoho Analytics, um Auswertungen zu fahren: Wie lange dauert das Onboarding im Durchschnitt? Bei welchem Schritt gibt es die meisten Verzögerungen? So kannst Du Deinen Prozess datengestützt optimieren.

Fazit: Mehr als nur ein Wizard

Dieser hybride Ansatz zeigt eindrucksvoll, wie Du die Boardmittel von Zoho CRM intelligent kombinieren und erweitern kannst, um maßgeschneiderte Lösungen für komplexe Geschäftsanforderungen zu bauen. Anstatt Dich für ein Werkzeug zu entscheiden, nutzt Du die Stärken von beiden: Die Flexibilität der Layout-Regeln für Experten und die Sicherheit eines geführten Wizards für den Vertrieb. Durch die Anreicherung mit Custom Functions und externen API-Anbindungen schaffst Du einen automatisierten, robusten und transparenten Onboarding-Prozess.

Die Umsetzung erfordert zwar eine sorgfältige Planung und etwas Deluge-Know-how, aber der Gewinn ist enorm: weniger Fehler, kürzere Einarbeitungszeiten, eine höhere Datenqualität und letztlich zufriedenere Kunden und Mitarbeiter.

Verwendete Zoho Apps in diesem Beispiel: