Blog

Zoho Inventory API und WooCommerce REST API: Tutorial zur Produkt- und Auftrags-Synchronisation

  • Beitrags-Autor:

Zoho Inventory als Herzstück deines WooCommerce-Shops: Die Königsklasse der Integration

Wenn du Zoho One oder einzelne Zoho-Apps wie Zoho Inventory und Zoho CRM für dein Backoffice nutzt, aber für deinen Onlineshop auf das bewährte Duo WordPress und WooCommerce setzt, kennst du die Herausforderung: Wie schaffst du eine nahtlose, zuverlässige und automatisierte Verbindung zwischen diesen beiden Welten? Oftmals liegt der Teufel im Detail, besonders wenn es um komplexe Produktdaten wie Variantenartikel geht. In diesem Artikel zeigen wir dir, wie du Zoho als deine zentrale Datenquelle (Single Source of Truth) etablierst und es über APIs und Webhooks tief mit WooCommerce verbindest. Wir gehen weg von wackeligen Plugins und hin zu einer robusten, maßgeschneiderten Lösung, die wirklich funktioniert und mit deinem Unternehmen wächst.

Praxisbeispiel: Der technische Händler und die Varianten-Falle

Stell dir ein mittelständisches technisches Handelsunternehmen vor. Das Kerngeschäft ist der B2B-Verkauf von Bauteilen, sagen wir Schrauben, Ventilen oder Dichtungen. Jedes dieser Produkte gibt es in unzähligen Varianten: verschiedene Größen, Materialien, Beschichtungen, Druckstufen. Das gesamte Artikel- und Lagermanagement, die Preisgestaltung und die Kundendaten werden in Zoho gepflegt. Zoho Inventory ist das führende System für Lagerbestände, während im Zoho CRM alle Kundenkontakte und Verkaufschancen liegen und die Buchhaltung über Zoho Books läuft.

Der Onlineshop auf Basis von WordPress mit WooCommerce dient als wichtigster Vertriebskanal. Und hier beginnt das Problem:

  • Datenkonsistenz: Wie stellst du sicher, dass die über 5.000 Variantenartikel im Shop immer die korrekten Lagerbestände aus Zoho Inventory anzeigen?
  • Prozessautomatisierung: Wie wird eine Online-Bestellung automatisch und fehlerfrei als Auftrag in Zoho Books oder Inventory angelegt, der Lagerbestand reserviert und der Kunde im CRM aktualisiert?
  • Stammdatenpflege: Was passiert, wenn ein neuer Artikel oder eine neue Variante in Zoho angelegt wird? Muss diese manuell im WooCommerce-Shop nachgepflegt werden?

Eine unzureichende Integration führt hier schnell zu Chaos: Falsche Lagerbestände im Shop, manuelle Übertragung von Bestellungen, inkonsistente Produktdaten und letztlich unzufriedene Kunden und ein hoher administrativer Aufwand. Genau hier setzen wir an.

Schritt-für-Schritt zur nahtlosen Integration

Die Lösung liegt darin, die Systeme nicht als getrennte Silos zu betrachten, sondern Zoho als das zentrale Gehirn und WooCommerce als den ausführenden Arm zu definieren. Die Kommunikation erfolgt über die jeweiligen APIs (Application Programming Interfaces) und ereignisgesteuerte Webhooks.

1. Die Grundlage: Zoho als „Single Source of Truth“ definieren

Der erste und wichtigste Schritt ist eine strategische Entscheidung: Alle Produktdaten, Lagerbestände und Preise werden ausschließlich in Zoho Inventory gepflegt. WooCommerce dient nur der Darstellung und dem Verkauf. Jegliche manuelle Änderung von Produktdaten in WordPress wird unterbunden. Der Schlüssel zur Verbindung der Artikel zwischen beiden Systemen ist die SKU (Stock Keeping Unit). Sie muss in beiden Systemen identisch und absolut eindeutig sein.

2. Die Brücke bauen: APIs und Webhooks verstehen

Sowohl Zoho als auch WooCommerce bieten mächtige REST-APIs. Damit können die Systeme programmatisch miteinander sprechen.

  • Die Zoho API erlaubt es dir, auf fast alle Daten in deinen Zoho-Apps zuzugreifen – Artikel, Kontakte, Aufträge, Rechnungen etc.
  • Die WooCommerce REST API ermöglicht es dir, Produkte, Bestellungen, Kunden und mehr in deinem Shop zu erstellen, zu lesen, zu aktualisieren und zu löschen.

Webhooks sind der Gegenpart: Sie senden automatisch eine Nachricht von einem System zum anderen, wenn ein bestimmtes Ereignis eintritt. Zum Beispiel: „Eine neue Bestellung ist in WooCommerce eingegangen“ oder „Der Lagerbestand eines Artikels hat sich in Zoho geändert“.

3. Produkt-Synchronisation von Zoho nach WooCommerce

Damit deine Shop-Artikel immer aktuell sind, bauen wir eine Funktion, die Daten aus Zoho Inventory holt und in WooCommerce einspielt. Dies lässt sich am besten über eine Custom Function in Zoho (z.B. in CRM, Creator oder Books) mit der Skriptsprache Deluge umsetzen.

Diese Funktion kann entweder zeitgesteuert (z.B. alle 15 Minuten) laufen oder manuell bei einer Produktänderung in Zoho getriggert werden.

Codebeispiel: Artikeldaten mit Deluge an WooCommerce senden

Dieses vereinfachte Deluge-Skript zeigt, wie du die Daten eines Variantenartikels (in Zoho als „Item Group“ bezeichnet) an die WooCommerce API senden kannst. Dafür benötigst du einen API-Key und ein Secret aus deinem WooCommerce-Backend.


// Annahme: 'itemGroupId' ist die ID der Artikelgruppe in Zoho Inventory
itemGroupDetails = zoho.inventory.getRecordsByID("ItemGroups", ZOHO_ORG_ID, itemGroupId);

// Varianten der Gruppe durchlaufen
for each variant in itemGroupDetails.get("items")
{
    // SKU als eindeutiger Schlüssel
    sku = variant.get("sku");
    
    // Daten für die WooCommerce API vorbereiten
    product_data = Map();
    product_data.put("name", variant.get("name"));
    product_data.put("type", "simple"); // oder "variation" im Kontext eines variablen Produkts
    product_data.put("regular_price", variant.get("rate").toString());
    product_data.put("sku", sku);
    product_data.put("stock_quantity", variant.get("actual_available_stock"));
    product_data.put("manage_stock", true);
    
    // API-Endpunkt für WooCommerce-Produkte
    // Zuerst prüfen, ob das Produkt mit der SKU bereits existiert
    search_url = "https://DEIN-SHOP.de/wp-json/wc/v3/products?sku=" + sku;
    api_headers = Map();
    // Base64-Encoding von Consumer Key und Secret für Basic Auth
    auth_string = "ck_deinkey:cs_deinsecret";
    encoded_auth = zoho.encryption.base64Encode(auth_string);
    api_headers.put("Authorization", "Basic " + encoded_auth);
    
    // Produkt in WooCommerce suchen
    existing_product_response = invokeurl
    [
        url :search_url
        type :GET
        headers:api_headers
    ];
    
    // Wenn Produkt gefunden -> Update (PUT), sonst -> Erstellen (POST)
    if(existing_product_response.size() > 0)
    {
        product_id = existing_product_response.get(0).get("id");
        update_url = "https://DEIN-SHOP.de/wp-json/wc/v3/products/" + product_id;
        response = invokeurl
        [
            url :update_url
            type :PUT
            headers:api_headers
            params:product_data.toString()
        ];
        info "Produkt " + sku + " aktualisiert: " + response;
    }
    else
    {
        create_url = "https://DEIN-SHOP.de/wp-json/wc/v3/products";
        response = invokeurl
        [
            url :create_url
            type :POST
            headers:api_headers
            params:product_data.toString()
        ];
        info "Produkt " + sku + " erstellt: " + response;
    }
}

Hinweis: Die Synchronisation von komplexen variablen Produkten in WooCommerce erfordert zusätzliche Logik, um das übergeordnete „variable“ Produkt und die einzelnen „variation“-Kinder zu verwalten. Das obige Skript dient als konzeptionelle Grundlage.

4. Bestellungen von WooCommerce nach Zoho übertragen

Hier kommen Webhooks ins Spiel. In WooCommerce gehst du zu Einstellungen → Erweitert → Webhooks und erstellst einen neuen Webhook für das Ereignis Bestellung erstellt (order.created).

Als „Zustell-URL“ gibst du die API-Endpunkt-URL einer Deluge-Funktion an. Diese kannst du am einfachsten mit Zoho Creator oder als Funktion in Zoho Catalyst erstellen. Zoho Flow ist hier ebenfalls eine hervorragende low-code Alternative.

Codebeispiel: Webhook aus WooCommerce mit Deluge verarbeiten

Wenn eine Bestellung eingeht, sendet WooCommerce ein JSON-Paket an deine URL. Deine Deluge-Funktion muss dieses Paket entgegennehmen, die Daten parsen und die entsprechenden Aktionen in Zoho ausführen.


// 'webhook_payload' ist der JSON-String, der von WooCommerce gesendet wird
order_data = webhook_payload.toJSON();

// 1. Kunden im CRM suchen oder anlegen
customer_email = order_data.get("billing").get("email");
search_response = zoho.crm.searchRecords("Contacts", "(Email:equals:" + customer_email + ")");

contact_id = null;
if(search_response.size() > 0)
{
    contact_id = search_response.get(0).get("id");
}
else
{
    // Neuen Kontakt anlegen
    new_contact = Map();
    new_contact.put("Last_Name", order_data.get("billing").get("last_name"));
    new_contact.put("First_Name", order_data.get("billing").get("first_name"));
    new_contact.put("Email", customer_email);
    create_response = zoho.crm.createRecord("Contacts", new_contact);
    contact_id = create_response.get("id");
}

// 2. Verkaufsauftrag (Sales Order) in Zoho Books/Inventory anlegen
so_data = Map();
so_data.put("customer_id", contact_id);
so_data.put("date", today);
so_data.put("salesorder_number", "WC-" + order_data.get("id"));

// Positionen durchlaufen
line_items = List();
for each item in order_data.get("line_items")
{
    line_item = Map();
    // Produkt-ID aus Zoho anhand der SKU aus WooCommerce finden
    product_response = zoho.inventory.getRecords("Items", ZOHO_ORG_ID, "sku=" + item.get("sku"));
    if(product_response.get("code") == 0)
    {
        line_item.put("item_id", product_response.get("items").get(0).get("item_id"));
        line_item.put("quantity", item.get("quantity"));
        line_item.put("rate", item.get("price"));
        line_items.add(line_item);
    }
}
so_data.put("line_items", line_items);

// Verkaufsauftrag erstellen
create_so_response = zoho.inventory.createRecord("SalesOrders", ZOHO_ORG_ID, so_data);
info "Verkaufsauftrag erstellt: " + create_so_response;

Tipps und Best Practices

  • Fehlerbehandlung ist entscheidend: Was passiert, wenn die WooCommerce API nicht erreichbar ist? Was, wenn eine SKU nicht gefunden wird? Deine Skripte müssen solche Fälle abfangen und protokollieren. Sende dir z.B. eine Benachrichtigung über Zoho Cliq oder lege einen Fehlereintrag in einem Custom Modul im CRM an.
  • Nutze eine Staging-Umgebung: Entwickle und teste solche tiefgreifenden Integrationen niemals am Live-System. Richte eine Kopie deines WordPress-Shops und eine Sandbox-Organisation in Zoho ein.
  • Skalierbarkeit bedenken: Wenn du Tausende von Produkten hast, ist eine synchrone Aktualisierung aller Artikel auf einmal keine gute Idee. Arbeite mit asynchronen Prozessen und Queues, z.B. indem du nur geänderte Artikel in eine Warteschlange (z.B. in Zoho Tables) schreibst und diese nach und nach abarbeitest.
  • Security First: Speichere API-Keys und andere Zugangsdaten sicher, z.B. in den Verbindungen von Zoho Flow oder als geschützte Variablen in Zoho Creator. Gib sie niemals direkt im Code preis.

Das Ökosystem erweitern: Mehr als nur Lager und Aufträge

Eine solche Integration ist nur der Anfang. Sobald die Daten sauber zwischen den Systemen fließen, kannst du weitere Prozesse automatisieren und analysieren:

  • Kundenservice mit Zoho Desk: Erstelle bei einer Bestellung mit einem bestimmten Kommentarfeld automatisch ein Support-Ticket in Zoho Desk.
  • Marketing mit Zoho Marketing Automation: Synchronisiere deine WooCommerce-Kunden mit Zoho Marketing Automation. Segmentiere sie nach Kaufverhalten und starte automatisierte Kampagnen (z.B. „Kunden, die Produkt A gekauft haben, erhalten nach 30 Tagen eine E-Mail mit Produkt B“).
  • Business Intelligence mit Zoho Analytics: Führe die Verkaufsdaten aus WooCommerce, die Kundendaten aus Zoho CRM und die Finanzdaten aus Zoho Books in Zoho Analytics zusammen. Erstelle Dashboards, die dir eine 360-Grad-Sicht auf dein E-Commerce-Geschäft geben, vom ersten Webseitenbesuch bis zur Marge pro verkauftem Artikel.

Fazit: Die Kontrolle zurückgewinnen

Die Integration von WooCommerce mit dem Zoho-Ökosystem über APIs und Webhooks ist kein triviales Unterfangen, aber der Lohn ist immens. Du ersetzt fehleranfällige manuelle Prozesse und starre Plugins durch eine flexible, skalierbare und vollautomatisierte Architektur. Indem du Zoho als das unbestrittene Master-System für deine Kerndaten etablierst, schaffst du eine solide Grundlage für dein digitales Wachstum. Du gewinnst nicht nur Effizienz, sondern auch wertvolle Daten, die dir helfen, bessere Geschäftsentscheidungen zu treffen.

Verwendete Zoho Apps in diesem Szenario: