Zoho Inventory, CRM und Deluge Custom Function für Genehmigungs-Workflow

Smarte Auftragsverarbeitung: So verbindest Du E-Commerce, Zoho Inventory und CRM mit Deluge

Integrierte Systeme sind das Rückgrat effizienter Unternehmen. Doch oft existieren Insellösungen, besonders zwischen externen Plattformen wie einem B2B-Bestellportal und dem internen ERP-System. Manuelle Datenübertragungen sind nicht nur zeitaufwendig, sondern auch eine ständige Fehlerquelle. Dieser Artikel zeigt Dir, wie Du eine solche Lücke schließt. Wir bauen eine Automatisierung, die Bestelldaten aus einem externen System intelligent in Zoho Inventory anreichert und einen komplexen, rollenbasierten Genehmigungsworkflow auf Basis von Daten aus dem Zoho CRM implementiert. Das Herzstück dieser Lösung ist eine maßgeschneiderte Custom Function in Deluge, der Scripting-Sprache von Zoho.

Die Herausforderung: Daten aus drei Quellen in einem Auftrag vereinen

Stell Dir ein typisches Szenario in einem mittelständischen Unternehmen vor: Kunden oder Mitarbeiter bestellen Produkte über ein spezialisiertes E-Commerce-System oder ein B2B-Portal. Dieses System ist bereits per API an Zoho Inventory angebunden und legt bei jeder Bestellung automatisch einen neuen Auftrag an. Die Herausforderung liegt im Detail:

Das E-Commerce-Portal legt zusätzlich zu jeder Bestellung einen separaten Datensatz in einem benutzerdefinierten Modul in Zoho Inventory an. Dieser Datensatz enthält wichtige Metadaten pro Besteller, wie die Kostenstelle oder den zuständigen Genehmiger. Diese Informationen fehlen jedoch in den einzelnen Auftragspositionen (Line Items).
Die Berechtigungen und Genehmigungsregeln (z.B. „darf ohne Freigabe bestellen“ oder „hat ein Ausgabenlimit“) sind nicht im E-Commerce-System, sondern als benutzerdefinierte Rollen direkt an den Kontakten im Zoho CRM hinterlegt.
Der Prozess soll vollautomatisch, robust und flexibel sein, um auch manuelle Änderungen an Aufträgen korrekt zu verarbeiten.

Das Ziel ist es, diese drei Datenquellen – den Auftrag in Inventory, die Zusatzinformationen im Custom Module und die Berechtigungen aus dem CRM – automatisch zu verknüpfen, um für jede einzelne Artikelposition einen sauberen und nachvollziehbaren Genehmigungsstatus zu setzen.

Schritt-für-Schritt zur automatisierten Auftragsanreicherung

Wir lösen diese Aufgabe mit einer Workflow-Regel und einer darauf aufbauenden Custom Function in Zoho Inventory. Diese Vorgehensweise gibt uns maximale Flexibilität, um die komplexe Geschäftslogik abzubilden.

1. Die Datenbasis vorbereiten

Stelle sicher, dass Deine Datenstruktur die nötigen Informationen enthält:

Zoho Inventory: Im Modul „Aufträge“ (Sales Orders) benötigst Du benutzerdefinierte Felder auf Ebene der Artikelpositionen (Line Items), z.B. cf_genehmigungsstatus (Auswahlliste: „Wartet auf Genehmigung“, „Genehmigt“, „Abgelehnt“) und cf_genehmiger (Lookup-Feld zum Benutzer-Modul).
Benutzerdefiniertes Modul in Inventory: Erstelle ein Custom Module (z.B. mit dem API-Namen Besteller_Infos), das mit den Aufträgen verknüpft ist. Hier speicherst Du die vom E-Commerce-System gelieferten Daten wie Kostenstelle, Besteller (Lookup zum CRM-Kontakt) etc.
Zoho CRM: Im Modul „Kontakte“ benötigst Du ein Feld für die Genehmigungsrolle, z.B. cf_bestell_rolle (Auswahlliste: „Standard“, „Bestellen ohne Bestätigung“, „Management“).

2. Die Workflow-Regel in Zoho Inventory erstellen

Das Fundament unserer Automatisierung ist ein Workflow, der unsere Funktion zum richtigen Zeitpunkt auslöst.

Gehe in Zoho Inventory zu Einstellungen > Automatisierung > Workflow-Regeln.
Erstelle eine neue Regel für das Modul Aufträge.
Benenne die Regel aussagekräftig, z.B. „Auftragspositionen mit CRM-Daten anreichern & Genehmigung starten“.
Als Auslöser (Trigger) wählst Du Bei einer Datensatzaktion und dort Bearbeiten. Dies ist ein entscheidender Punkt: Wir wählen „Bearbeiten“ und nicht „Erstellen“, damit die Logik auch dann greift, wenn ein Auftrag nachträglich manuell geändert wird (z.B. ein Artikel hinzugefügt oder einem anderen Nutzer zugewiesen wird).
Bei den Filterkriterien kannst Du festlegen, dass die Regel nur für bestimmte Aufträge (z.B. nach Status) gilt. Für den Anfang lassen wir sie für alle Aufträge laufen.
Als Aktion wählst Du unter Benutzerdefinierte Funktionen die Option „Neue benutzerdefinierte Funktion erstellen“.

3. Die Deluge Custom Function entwickeln

Hier findet die eigentliche Magie statt. Wir schreiben ein Deluge-Skript, das die Daten ausliest, die Logik anwendet und den Auftrag aktualisiert.

Lege eine neue Funktion an und definiere als Argument die Auftrags-ID, die vom Workflow übergeben wird. Nenne das Argument z.B. salesorderId.

// Funktion zur Anreicherung von Auftragspositionen und zur Implementierung der Genehmigungslogik
void anreichernUndGenehmigen(int salesorderId)
{
	try 
	{
		// 1. Hole alle Details des aktuellen Auftrags
		so_details = zoho.inventory.getRecordById("salesorders", organizationId, salesorderId);
		
		// 2. Prüfe auf eine globale Überschreibung auf Auftragskopf-Ebene
		global_user_id = so_details.get("cf_nutzer_fur_gesamten_auftrag");
		global_cost_center = so_details.get("cf_kostenstelle_fur_gesamten_auftrag");
		is_global_override = global_user_id != null;

		// 3. Hole die verknüpften Besteller-Informationen aus dem Custom Module
		// Ersetze "Besteller_Infos" durch den API-Namen deiner Related List / deines Custom Modules
		related_records = zoho.inventory.getRelatedRecords("Besteller_Infos", "salesorders", salesorderId);
		
		if (related_records.size() > 0)
		{
			besteller_info = related_records.get(0);
			line_items_list = so_details.get("line_items");
			updated_line_items = List();

			// 4. Loope durch jede einzelne Artikelposition des Auftrags
			for each item in line_items_list
			{
				// WICHTIG: Überspringe bereits manuell genehmigte Positionen
				if (item.get("cf_genehmigungsstatus") == "Genehmigt")
				{
					updated_line_items.add(item);
					continue;
				}

				// 5. Daten ermitteln: Globale Überschreibung oder aus Besteller-Info
				user_id_to_check = if(is_global_override, global_user_id, besteller_info.get("Besteller").get("id"));
				cost_center_to_apply = if(is_global_override, global_cost_center, besteller_info.get("Kostenstelle"));

				item.put("cf_kostenstelle", cost_center_to_apply);

				// 6. Hole die Besteller-Rolle aus dem Zoho CRM
				if (user_id_to_check != null)
				{
					crm_contact = zoho.crm.getRecordById("Contacts", user_id_to_check.toLong());
					if (crm_contact.get("id") != null)
					{
						bestell_rolle = crm_contact.get("cf_bestell_rolle");

						// 7. Implementiere die Genehmigungslogik basierend auf der CRM-Rolle
						if (bestell_rolle == "Bestellen ohne Bestätigung")
						{
							item.put("cf_genehmigungsstatus", "Genehmigt");
						}
						else
						{
							item.put("cf_genehmigungsstatus", "Wartet auf Genehmigung");
							// Hier könntest Du weitere Logik einbauen, um die zuständigen Genehmiger zu ermitteln
							// z.B. aus der Rolle oder dem Kontakt im CRM
							// manager_id = crm_contact.get("Reporting_To").get("id");
							// item.put("cf_genehmiger", manager_id);
						}
					}
				}
				updated_line_items.add(item);
			}

			// 8. Aktualisiere den Auftrag mit den angereicherten Artikelpositionen
			update_map = Map();
			update_map.put("line_items", updated_line_items);
			update_response = zoho.inventory.updateRecord("salesorders", organizationId, salesorderId, update_map);
			info update_response;
		}
	}
	catch (e)
	{
		// Fehlerbehandlung: Sende eine Nachricht an einen Cliq-Kanal oder erstelle ein Ticket
		error_message = "Fehler bei der Auftragsanreicherung für SO-ID " + salesorderId + " : " + e;
		zoho.cliq.postToChannel("dein_channel_name", error_message);
	}
}

Speichere und verknüpfe diese Funktion mit Deiner Workflow-Regel. Ab sofort wird bei jeder Bearbeitung eines Auftrags dieses Skript ausgeführt, die Daten aus dem CRM geholt und die Genehmigungsstati entsprechend gesetzt.

Tipps und Best Practices

Entwicklung in der Sandbox: Entwickle und teste solche komplexen Funktionen immer zuerst in einer Sandbox-Umgebung von Zoho. So vermeidest Du Fehler im produktiven System.
Idempotenz ist entscheidend: Die Zeile if (item.get("cf_genehmigungsstatus") == "Genehmigt") { continue; } ist extrem wichtig. Sie verhindert, dass Deine Automatisierung eine bereits manuell erteilte Genehmigung fälschlicherweise wieder zurücksetzt. Deine Funktion muss so geschrieben sein, dass sie bei mehrmaliger Ausführung auf denselben Daten zum gleichen korrekten Ergebnis führt.
Robustes Fehlerhandling: Nutze try...catch-Blöcke, um auf unerwartete Fehler zu reagieren (z.B. wenn ein CRM-Kontakt nicht gefunden wird). Sende im Fehlerfall eine Benachrichtigung über Zoho Cliq an Deinen Admin-Kanal, um schnell reagieren zu können.
API-Limits beachten: Schreibe Deinen Code effizient. Vermeide API-Aufrufe innerhalb von Schleifen, wenn es nicht unbedingt nötig ist. Zoho hat tägliche API-Call-Limits, die Du im Auge behalten solltest.
Dokumentation im Code: Kommentiere Deinen Deluge-Code gut. So können Du oder Deine Kollegen auch in sechs Monaten noch nachvollziehen, was das Skript genau tut. Die Aufgabenverwaltung für solche Entwicklungen lässt sich hervorragend mit Zoho Projects steuern.

Zusätzliche Hinweise: Der Blick über den Tellerrand

Diese Lösung ist nur der Anfang. Du kannst sie auf vielfältige Weise erweitern:

Dashboards in Zoho Analytics: Übertrage die angereicherten Auftragsdaten an Zoho Analytics. Erstelle Dashboards, um Genehmigungszeiten, Bestellvolumen pro Kostenstelle oder die Auslastung der Genehmiger auszuwerten.
Alternative mit Zoho Flow: Für einfachere Daten-Mappings ohne komplexe, bedingte Logik kann Zoho Flow eine gute, No-Code-Alternative zu einer Custom Function sein.
Automatisierung im Support: Ähnliche Logiken lassen sich auch in anderen Bereichen anwenden. Ein „Quick-Win“ ist oft die Automatisierung in Zoho Desk: Erstelle einen Workflow, der bei einem neuen Ticket die E-Mail-Domain des Absenders prüft und das Ticket automatisch dem richtigen Firmenkontakt aus dem CRM zuordnet.

Fazit: Mehr als nur eine Automatisierung

Die Umsetzung eines solchen Workflows zeigt eindrucksvoll die Stärke des Zoho-Ökosystems. Es geht nicht nur darum, eine einzelne Aufgabe zu automatisieren. Es geht darum, eine Brücke zwischen verschiedenen Systemen (E-Commerce-Portal, Inventory, CRM) zu schlagen und eine komplexe Geschäftslogik abzubilden, die Dein Unternehmen wirklich voranbringt. Mit Deluge hast Du ein mächtiges Werkzeug an der Hand, um Standardprozesse zu verlassen und Zoho-Anwendungen exakt an Deine individuellen Anforderungen anzupassen.

Du reduzierst manuelle Arbeit, minimierst Fehler und schaffst einen transparenten, nachvollziehbaren Genehmigungsprozess, der direkt mit Deinen Kundendaten im CRM verknüpft ist. Das ist der entscheidende Schritt von einer reinen Datenerfassung hin zu einem intelligenten, prozessgesteuerten System.

Verwendete Zoho Apps in dieser Lösung:

Zoho Inventory als zentrales System für die Auftragsverarbeitung.
Zoho CRM als „Single Source of Truth“ für Kunden- und Berechtigungsdaten.
Deluge als Scripting-Sprache für die Custom Function.
(Optional) Zoho Cliq für das Fehler-Monitoring.
(Optional) Zoho Projects zur Steuerung der Entwicklungsaufgaben.