Blog

Zoho Inventory, Zoho CRM und Zoho Flow per Webhook für Echtzeit-Auftragsabgleich integrieren

  • Beitrags-Autor:

Echtzeit-Daten-Sync: Wie du Zoho Inventory, Zoho CRM und externe Web-Apps nahtlos verbindest

In der heutigen digitalen Landschaft sind Dateninseln eines der größten Hindernisse für Effizienz. Informationen stecken in einzelnen Anwendungen fest und der manuelle oder zeitverzögerte Abgleich kostet Zeit, erzeugt Fehler und führt zu schlechten Entscheidungen. Wenn du das Zoho-Ökosystem nutzt, hast du bereits leistungsstarke Werkzeuge zur Hand, um diese Silos aufzubrechen. Doch die wahre Stärke entfaltet sich, wenn du nicht nur Zoho-Apps untereinander, sondern auch externe Systeme in Echtzeit anbindest. In diesem Artikel zeigen wir dir praxisnah, wie du einen typischen, langsamen Synchronisationsprozess zwischen Zoho Inventory und Zoho CRM durch eine ereignisgesteuerte Automatisierung ersetzt und dabei sogar eine externe Eigenentwicklung per API einbindest.

Praxisbeispiel: Das Problem der asynchronen Daten in der Auftragsabwicklung

Stell dir ein Handelsunternehmen vor, das Hardware vertreibt. Das Kerngeschäft wird über zwei zentrale Zoho-Anwendungen abgewickelt:

  • Zoho CRM ist das führende System für alle Kunden- und Kontaktdaten. Hier pflegt der Vertrieb seine Leads, Opportunities und Kundenbeziehungen.
  • Zoho Inventory wird für die gesamte Auftragsabwicklung, Lagerverwaltung und den Versand genutzt. Angebote werden hier zu Sales Orders, die dann verpackt und versendet werden.

Zusätzlich betreibt das Unternehmen eine eigene Webanwendung – nennen wir sie „Kunden-Informations-Modul (KIM)“ – die spezielle, branchenspezifische Daten zu Kundenprojekten anzeigt und auf die Daten aus dem CRM zugreift.

Die Herausforderung: Der Datenabgleich zwischen Inventory und CRM erfolgt über eine geplante Funktion, die nur alle zwei Stunden läuft. Wenn ein Vertriebsmitarbeiter im CRM einen Kunden aufruft, sieht er möglicherweise einen veralteten Auftragsstatus. Er weiß nicht, ob eine Bestellung, die vor 90 Minuten einging, bereits verpackt oder versendet wurde. Um den aktuellen Status zu erfahren, muss er sich separat in Zoho Inventory einloggen und nach dem Auftrag suchen. Das ist ineffizient und fehleranfällig. Die externe KIM-Anwendung leidet unter demselben Problem, da sie sich auf die veralteten Daten im CRM verlässt.

Schritt-für-Schritt Anleitung zur Echtzeit-Synchronisation

Unser Ziel ist es, bei jeder relevanten Änderung eines Auftrags in Zoho Inventory (z.B. Statusänderung auf „Verpackt“ oder „Versendet“) sofort und automatisch das entsprechende Kunden- oder Auftragsmodul im CRM sowie die externe KIM-Anwendung zu aktualisieren. Als zentrale Schaltstelle für diesen Prozess nutzen wir Zoho Flow.

Schritt 1: Den Prozess in Zoho Inventory mit einem Webhook anstoßen

Anstatt auf einen zeitgesteuerten Abruf zu warten, nutzen wir einen Webhook. Ein Webhook ist eine automatisierte Nachricht, die von einer App an eine andere gesendet wird, sobald ein bestimmtes Ereignis eintritt. In unserem Fall ist das Ereignis eine Änderung an einem Verkaufsauftrag (Sales Order).

  1. Gehe in Zoho Inventory zu Einstellungen > Automatisierung > Webhooks.
  2. Erstelle einen neuen Webhook. Gib ihm einen aussagekräftigen Namen, z.B. „SalesOrder Update an Flow“.
  3. Wähle als Modul „Verkaufsaufträge“.
  4. Definiere das auslösende Ereignis. Du kannst wählen zwischen „Erstellt“, „Bearbeitet“ oder beidem. Für unseren Fall ist „Bearbeitet“ am relevantesten, um Statusänderungen abzufangen.
  5. Bei der „URL to Notify“ fügst du zunächst einen Platzhalter ein. Die finale URL erhalten wir im nächsten Schritt von Zoho Flow.
  6. Als Methode wählst du POST. Unter „Parameter“ definierst du, welche Daten gesendet werden sollen. Wähle als Body-Typ „JSON“ und füge die relevanten Platzhalter aus Inventory ein. Ein einfacher Payload könnte so aussehen:

{
  "event_type": "${EVENT_TYPE}",
  "salesorder_id": "${SALESORDER.salesorder_id}",
  "salesorder_number": "${SALESORDER.salesorder_number}",
  "customer_id": "${SALESORDER.customer_id}",
  "status": "${SALESORDER.status}",
  "last_modified_time": "${SALESORDER.last_modified_time}"
}

Schritt 2: Die Logik in Zoho Flow als zentrale Drehscheibe aufbauen

Zoho Flow ist das ideale Werkzeug, um Workflows zwischen verschiedenen Apps zu erstellen, ohne tiefen Programmieraufwand betreiben zu müssen.

  1. Erstelle in Zoho Flow einen neuen Flow.
  2. Wähle als Trigger „App“ und suche nach „Webhook“.
  3. Konfiguriere den Webhook-Trigger. Flow generiert dir nun eine einzigartige URL. Kopiere diese URL.
  4. Gehe zurück zu deinem Webhook in Zoho Inventory und füge die kopierte URL in das Feld „URL to Notify“ ein. Speichere den Webhook.
  5. Damit Flow die Datenstruktur versteht, löse den Webhook einmal aus. Gehe dazu in Inventory, bearbeite und speichere einen beliebigen Verkaufsauftrag. Klicke dann in Flow auf „Test“. Flow sollte nun die JSON-Daten aus Schritt 1 empfangen und die Struktur erkennen.

Schritt 3: Daten im CRM aktualisieren mit einer Custom Function (Deluge)

Obwohl Flow vorgefertigte Aktionen für das CRM bietet, nutzen wir eine Custom Function, um mehr Kontrolle zu haben und die Leistungsfähigkeit von Deluge, der Scriptsprache von Zoho, zu demonstrieren.

  1. Füge im Flow-Builder nach dem Webhook-Trigger eine neue Aktion hinzu. Wähle „Custom Functions“.
  2. Erstelle eine neue Funktion. Gib ihr einen Namen wie `updateCrmFromInventory`.
  3. Definiere die Input-Argumente. Diese müssen den Schlüsseln aus deinem JSON-Payload entsprechen (z.B. `salesorder_id`, `customer_id`, `status`). Verknüpfe sie mit den entsprechenden Feldern aus dem Webhook-Trigger.
  4. Schreibe das Deluge-Skript. Die Logik ist wie folgt:
    1. Suche den zugehörigen Kontakt oder Account im CRM anhand der `customer_id` aus Inventory.
    2. Aktualisiere ein benutzerdefiniertes Feld (z.B. „Letzter Auftragsstatus“) im CRM-Datensatz.

Hier ist ein Beispiel-Skript:


// Deluge Script in Zoho Flow zur Aktualisierung eines CRM-Kontakts

void updateCrmFromInventory(string customer_id, string status, string salesorder_number) {
    
    // 1. Suche den Kontakt im CRM, dessen Zoho Finance ID der customer_id aus Inventory entspricht
    // Wir nehmen an, dass es ein benutzerdefiniertes Feld "Zoho_Finance_ID" im CRM-Kontaktmodul gibt
    search_response = zoho.crm.searchRecords("Contacts", "(Zoho_Finance_ID:equals:" + customer_id + ")");
    
    // 2. Prüfen, ob ein Kontakt gefunden wurde
    if (search_response.size() > 0) {
        
        // Den ersten gefundenen Kontakt nehmen
        contact_record = search_response.get(0);
        contact_id = contact_record.get("id");
        
        // 3. Ein Map-Objekt mit den zu aktualisierenden Daten erstellen
        // Wir nehmen an, es gibt benutzerdefinierte Felder für den letzten Auftragsstatus und die Auftragsnummer
        update_map = Map();
        update_map.put("Letzter_Auftragsstatus", status);
        update_map.put("Letzte_Auftragsnummer", salesorder_number);
        
        // 4. Den CRM-Datensatz aktualisieren
        update_response = zoho.crm.updateRecord("Contacts", contact_id, update_map);
        
        // Optional: Logging für Debugging-Zwecke
        info "CRM Update Response for Contact " + contact_id + ": " + update_response;
    } else {
        info "No CRM contact found for Inventory Customer ID: " + customer_id;
    }
}

Schritt 4: Die externe Web-App per API anstoßen

Jetzt erweitern wir den Flow, um auch die externe KIM-Anwendung zu informieren. Wir gehen davon aus, dass diese Anwendung einen REST-API-Endpunkt hat, der auf einen POST-Request wartet.

  1. Füge im Flow-Builder eine weitere Aktion hinzu, parallel oder nach der Custom Function.
  2. Wähle die Aktion „Invoke URL“ (manchmal auch „Call Webhook“).
  3. Gib die URL des API-Endpunkts deiner externen Anwendung ein (z.B. `https://kim.dein-unternehmen.de/api/update_order_status`).
  4. Wähle die Methode „POST“.
  5. Unter „Payload“ oder „Body“ erstellst du wieder eine JSON-Struktur mit den relevanten Daten aus dem ursprünglichen Trigger. Du kannst hier auch Daten aus der CRM-Antwort anreichern, falls nötig.

Dein fertiger Flow nimmt nun Daten aus Inventory entgegen, verarbeitet sie mit Deluge, um das CRM zu aktualisieren, und sendet parallel eine Benachrichtigung an deine externe Anwendung – alles in wenigen Sekunden nach der ursprünglichen Änderung.

Tipps und Best Practices

Die Umsetzung solcher Integrationen birgt einige Tücken, die du kennen solltest. Die Zoho-Plattform hat ihre Eigenheiten, besonders wenn es um Entwicklungsworkflows geht.

Umgang mit fehlenden Testumgebungen: „Operationen am offenen Herzen“ vermeiden

Eine der größten Herausforderungen im Zoho-Ökosystem ist das Fehlen von echten Sandbox- oder Staging-Umgebungen für viele Apps, insbesondere für Zoho Books und Zoho Inventory. Anders als bei Zoho CRM, das eine Sandbox-Funktion bietet, entwickelst du hier direkt am „offenen Herzen“.

  • Workaround: Separater Test-Account. Die gängigste Best Practice ist die Einrichtung eines zweiten, separaten Zoho One Accounts, der ausschließlich für Tests dient. Hier kannst du Integrationen und Automatisierungen gefahrlos bauen und testen.
  • Nachteile: Dieser Ansatz verursacht zusätzliche Kosten und erfordert einen manuellen Ex- und Import von Testdaten, da eine 1:1-Kopie der Live-Daten (z.B. aus Books) nicht automatisch möglich ist.

Version Control für Deluge-Code mit Git

Zoho bietet keine native Integration mit Versionskontrollsystemen wie Git. Das macht die Nachverfolgung von Änderungen und die Zusammenarbeit im Team schwierig.

  • Workaround: Manuelles Copy-Paste. Etabliere in deinem Team die Disziplin, jede fertige Deluge-Funktion (aus Zoho CRM, Flow, Creator etc.) manuell in einen lokalen Code-Editor (z.B. Visual Studio Code) zu kopieren und in ein Git-Repository (z.B. auf GitHub oder GitLab) zu committen.
  • Vorteile: Auch wenn es umständlich ist, hast du so eine Versionshistorie, kannst Änderungen nachvollziehen und Code wiederherstellen. Es fördert zudem das Vier-Augen-Prinzip, da Code-Änderungen über Pull Requests geprüft werden können.

Fehler-Handling und Monitoring

Was passiert, wenn eine API nicht erreichbar ist oder ein Skript fehlschlägt? Baue ein robustes Monitoring ein.

  • Zoho Flow History: Die Ausführungshistorie in Zoho Flow ist dein erster Anlaufpunkt für das Debugging. Hier siehst du, welche Schritte erfolgreich waren und wo Fehler aufgetreten sind.
  • Automatisierte Benachrichtigungen: Konfiguriere im Fehlerfall eine Aktion in deinem Flow, die eine Nachricht an einen dedizierten Kanal in Zoho Cliq oder per E-Mail (Zoho ZeptoMail) sendet. So erfährst du proaktiv von Problemen.

Zusätzliche Erweiterungsmöglichkeiten

Dieser Workflow ist nur der Anfang. Du kannst ihn mit weiteren Zoho-Apps anreichern:

  • Zoho Analytics: Führe die Daten aus Inventory und CRM in Zoho Analytics zusammen. Erstelle Dashboards, die den gesamten Prozess von der Lead-Generierung bis zur Auslieferung visualisieren und dir Kennzahlen wie die „Order-to-Cash“-Zeit liefern. Mit Zoho DataPrep kannst du vorher komplexe Datenbereinigungen durchführen, z.B. bei der Migration von Altsystemen wie SAP.
  • Zoho Sign: Löse automatisch den Versand eines Lieferdokuments oder einer Servicevereinbarung zur digitalen Signatur aus, sobald der Auftragsstatus in Inventory auf „Versendet“ gesetzt wird.
  • Zoho Projects: Erstelle automatisch ein Projektaufgabe für das Service-Team, sobald eine komplexe Hardware-Installation verkauft und versendet wurde.

Fazit: Vom Datensilo zum vernetzten Ökosystem

Die Umstellung von einem langsamen, zeitgesteuerten Abgleich auf einen schnellen, ereignisgesteuerten Workflow löst nicht nur ein technisches Problem – es transformiert deine Geschäftsprozesse. Dein Vertrieb hat stets aktuelle Informationen, manuelle Arbeitsschritte entfallen und deine Systeme arbeiten als einheitliches, vernetztes Ganzes. Der Schlüssel liegt darin, über die Grenzen einzelner Apps hinauszudenken und die Integrationswerkzeuge wie APIs, Webhooks und insbesondere Zoho Flow strategisch zu nutzen. Auch wenn es Herausforderungen wie das Fehlen von Testumgebungen gibt, lassen sich mit den richtigen Workarounds professionelle und skalierbare Lösungen im Zoho-Universum bauen.

Verwendete Zoho Apps in diesem Beispiel: