Blog

Du betrachtest gerade Zoho CRM Custom Functions und Sheet API für Lizenzabrechnung Reports automatisieren

Zoho CRM Custom Functions und Sheet API für Lizenzabrechnung Reports automatisieren

  • Beitrags-Autor:

Automatisierte Lizenzabrechnungen: Wie Du mit Zoho CRM und APIs komplexe Reports erstellst

In vielen Branchen, insbesondere im Medienvertrieb, Verlagswesen oder bei Software-Lizenzen, sind regelmäßige und präzise Abrechnungen für Lizenzgeber ein kritischer, aber oft mühsamer Prozess. Daten aus verschiedenen Quellen müssen zusammengeführt, Währungen umgerechnet und Berichte in einem ganz bestimmten Format erstellt werden. Dieser manuelle Aufwand ist nicht nur zeitintensiv, sondern auch extrem fehleranfällig. Wenn Du Zoho CRM als zentrale Datenbasis nutzt, fragst Du Dich vielleicht, wie Du diesen Prozess automatisieren kannst. In diesem Fachartikel zeigen wir Dir, wie Du von einer manuellen Excel-Routine zu einem automatisierten, dynamischen Reporting auf Knopfdruck kommst, indem Du die Stärken von Zoho mit externen APIs kombinierst.

Praxisbeispiel: Die Herausforderung der Quartalsabrechnung

Stell Dir ein Medienunternehmen vor, das die Rechte an hunderten von Filmen und Serien verwaltet und diese auf verschiedenen Plattformen weltweit lizenziert. Am Ende jedes Quartals müssen detaillierte Abrechnungen für jeden Lizenzgeber erstellt werden. Die Herausforderungen sind dabei vielfältig:

  • Komplexe Vertragsstrukturen: Ein einzelner Lizenzgeber hat möglicherweise Verträge mit mehreren Tochterfirmen des Medienunternehmens und tritt unter verschiedenen Namen auf.
  • Daten aus verschiedenen Quellen: Die Umsatzzahlen liegen im CRM, müssen aber pro Titel und Region korrekt zugeordnet werden.
  • Währungsumrechnung: Einnahmen werden oft in US-Dollar erzielt, die Abrechnung und Auszahlung erfolgt aber in Euro. Dafür wird ein tagesaktueller Wechselkurs benötigt.
  • Spezifische Formatvorgaben: Jeder Lizenzgeber erwartet einen Bericht in einem bestimmten Excel-Format, inklusive genauer Spaltenbezeichnungen, Summenformeln und der Angabe des verwendeten Wechselkurses.

Der typische manuelle Prozess involviert das Exportieren von CRM-Daten, mühsames Kopieren und Einfügen in Excel-Vorlagen, manuelle Währungsumrechnung und das Versenden Dutzender E-Mails. Das Ziel ist es, diesen gesamten Workflow zu automatisieren.

Schritt-für-Schritt Anleitung zur automatisierten Lösung

Wir bauen eine Lösung, die direkt aus dem Lizenzgeber-Datensatz in Zoho CRM heraus einen perfekt formatierten Excel-Report generiert. Dafür nutzen wir Custom Functions (Deluge), eine externe Währungs-API und die Zoho Sheet API.

Schritt 1: Das Datenmodell in Zoho CRM optimieren

Eine saubere Datenstruktur ist die Grundlage für jede Automatisierung. In unserem Fallbeispiel hat ein Lizenzgeber (im Modul „Vendors“ oder einem Custom Module) mehrere zugeordnete Firmennamen und Verträge. Ein einfaches Textfeld reicht hier nicht aus. Wir müssen eine skalierbare Beziehung herstellen.

  • Subform anpassen: Anstatt die zugeordneten Firmen in einer Subform mit einfachen Textfeldern zu verwalten, stellen wir diese auf ein Multi-Select-Lookup-Feld um. Dies ermöglicht uns, einem Lizenzgeber-Namen mehrere Firmen (die ebenfalls als Datensätze im CRM, z.B. im „Accounts“-Modul, gepflegt werden) sauber zuzuordnen.
  • Originaltitel pflegen: Wir stellen sicher, dass es für unsere Medientitel ein dediziertes Feld „Original Title“ gibt. Dies ist entscheidend, da in der Abrechnung immer dieser Titel verwendet werden soll, falls er vom internen Arbeitstitel abweicht.

Diese Anpassungen ermöglichen es uns später, die Daten für den Report präzise zu filtern, selbst bei komplexen Strukturen wie „Gib mir alle Umsätze für Lizenzgeber X, der unter dem Namen Y für unsere Firma Z kontrahiert ist“.

Schritt 2: Die Logik mit einer Custom Function (Deluge) aufbauen

Das Herzstück unserer Automatisierung ist eine Custom Function in Zoho CRM, geschrieben in der Zoho-eigenen Skriptsprache Deluge. Diese Funktion wird durch einen Klick auf einen Custom Button im Lizenzgeber-Datensatz ausgelöst.

Die Funktion übernimmt folgende Aufgaben:

  1. Sie holt sich die ID des aktuellen Lizenzgeber-Datensatzes.
  2. Sie prüft, ob dieser Lizenzgeber mehrere zugeordnete Namen oder Firmen hat. Falls ja, öffnet sie ein Popup (Widget), in dem der Anwender die richtige Kombination für den Report auswählen kann.
  3. Sie sammelt alle relevanten Umsatzdaten aus den verknüpften Modulen, gefiltert nach den ausgewählten Kriterien.
  4. Sie ruft eine externe API auf, um den tagesaktuellen Wechselkurs von USD zu EUR zu erhalten.
  5. Sie bereitet die Daten für die Erstellung der Excel-Datei vor.

Schritt 3: Währungsumrechnung via externer API

Für die Währungsumrechnung benötigen wir einen zuverlässigen, aktuellen Kurs. Anstatt diesen manuell nachzuschlagen, binden wir einen externen Dienst wie ExchangeRate-API an. Viele dieser Dienste bieten einen kostenlosen Plan für eine moderate Anzahl von Anfragen.

Der Deluge-Code für einen solchen API-Aufruf ist erstaunlich einfach. Zuerst musst Du Dir einen API-Schlüssel beim Anbieter besorgen und diesen sicher, z.B. in Zoho Vault, speichern.


// Deluge-Beispiel für den Abruf des Wechselkurses
// vendorId ist die ID des Lizenzgebers, die an die Funktion übergeben wird.

// 1. API-Schlüssel sicher abrufen (hier als Beispiel hartcodiert)
apiKey = "DEIN_EXCHANGERATE_API_KEY";
url = "https://v6.exchangerate-api.com/v6/" + apiKey + "/latest/USD";

// 2. API via invokeUrl aufrufen
response = invokeurl
[
	url: url
	type: GET
];

// 3. JSON-Antwort verarbeiten und Kurs extrahieren
if (response != null && response.get("result") == "success")
{
	conversionRates = response.get("conversion_rates");
	usdToEurRate = conversionRates.get("EUR");
	info "Aktueller USD zu EUR Kurs: " + usdToEurRate;
    
    // Den Kurs für spätere Verwendung in einer Variable speichern
    context.put("exchangeRate", usdToEurRate);
    context.put("rateDate", today);
}
else
{
	// Fehlerbehandlung: Was passiert, wenn die API nicht erreichbar ist?
	// z.B. eine Benachrichtigung an den Admin senden
	sendmail
	[
		to: "[email protected]"
		subject: "Fehler: Wechselkurs-API nicht erreichbar"
		message: "Die ExchangeRate-API konnte nicht abgefragt werden. Response: " + response
	];
	// Funktion hier abbrechen oder mit einem Standardkurs weiterarbeiten
	return;
}

Schritt 4: Die Excel-Datei dynamisch mit der Zoho Sheet API erstellen

Der direkte Export eines CRM-Reports als Excel-Datei ist oft nicht flexibel genug, um komplexe Formatierungen und dynamische Inhalte wie den Wechselkurs abzubilden. Ein professionellerer Weg ist die Nutzung der Zoho Sheet API.

Die Vorgehensweise ist wie folgt:

  1. Erstelle eine Vorlage: Lege in Zoho Sheet eine Vorlagendatei an. Diese enthält bereits die Kopfzeile, die Spaltenformatierungen und eventuell sogar das Firmenlogo.
  2. Kopiere die Vorlage: Erstelle per API eine Kopie dieser Vorlage in einem Zielordner in Zoho WorkDrive und benenne sie dynamisch, z.B. „Abrechnung_[Lizenzgeber-Name]_[Quartal].xlsx“.
  3. Fülle die Daten ein: Schreibe die in Schritt 2 gesammelten und mit dem Wechselkurs angereicherten Daten Zeile für Zeile per API in das neue Sheet.
  4. Schreibe Summen und Metadaten: Füge am Ende der Tabelle die Summenformeln und in einer separaten Zelle den verwendeten Wechselkurs samt Datum ein.
  5. Teile den Download-Link: Generiere einen Download-Link für die fertige Datei und präsentiere ihn dem Anwender in Zoho CRM.

// Konzeptionelles Deluge-Beispiel zum Füllen von Zoho Sheet
// Annahme: 'reportDataList' ist eine Liste von Maps, die unsere aufbereiteten Daten enthält.
// 'newSheetResourceId' ist die ID der neu erstellten Sheet-Datei.

// Verbindung zu Zoho Sheet herstellen
connectionName = "zoho_sheet_connection"; 

// Datenzeilen in das Sheet schreiben (beginnend bei Zeile 2)
rowIndex = 2;
for each rowData in reportDataList
{
    // Daten für die API-Anfrage vorbereiten
    cellData = {
        "A" + rowIndex: rowData.get("OriginalTitle"),
        "B" + rowIndex: rowData.get("GrossRevenueUSD"),
        "C" + rowIndex: rowData.get("LicensorSharePercentage"),
        "D" + rowIndex: rowData.get("LicensorShareUSD"),
        "E" + rowIndex: rowData.get("LicensorShareEUR") // Bereits umgerechneter Wert
    };

    // API-Aufruf zum Aktualisieren einer Zelle/eines Bereichs
    response = invokeurl
    [
        url: "https://sheet.zoho.com/api/v2/" + newSheetResourceId + "/values?range=A" + rowIndex
        type: PUT
        connection: connectionName
        content-type: "application/json"
        body: {"values": [cellData]}
    ];
    rowIndex = rowIndex + 1;
}

// Summen und Wechselkurs eintragen
totalRowIndex = rowIndex + 1;
exchangeRateInfo = "Wechselkurs USD/EUR am " + rateDate + ": " + exchangeRate;

sumData = {
    "D" + totalRowIndex: "=SUM(D2:D" + (rowIndex - 1) + ")",
    "E" + totalRowIndex: "=SUM(E2:E" + (rowIndex - 1) + ")",
    "A" + (totalRowIndex + 1): exchangeRateInfo
};
// Weiterer API-Aufruf zum Schreiben der Summen...

Tipps und Best Practices

  • Datenintegrität ist alles: Die beste Automatisierung scheitert an schlechten Daten. Sorge mit Validierungsregeln und Pflichtfeldern in Zoho CRM dafür, dass alle für die Abrechnung notwendigen Informationen (z.B. Lizenzanteil, Währung) immer gepflegt sind.
  • Fehlerbehandlung: Was passiert, wenn die Währungs-API nicht antwortet oder ein Datensatz unvollständig ist? Deine Deluge-Funktion sollte solche Fälle abfangen und eine klare Fehlermeldung ausgeben oder einen Admin per Zoho Cliq benachrichtigen.
  • Skalierbarkeit: Wenn Du hunderte Reports gleichzeitig erstellen musst, kann eine Custom Function an ihre Grenzen stoßen. Für solche Massenverarbeitungen solltest Du überlegen, einen geplanten Prozess (Scheduled Function) zu nutzen oder die Logik in die Serverless-Plattform Zoho Catalyst auszulagern.
  • API-Keys sicher verwalten: Speichere API-Schlüssel und andere Zugangsdaten niemals direkt im Code. Nutze die Verbindungen (Connections) in Zoho oder Zoho Vault, um sie sicher und zentral zu verwalten.

Zusätzliche Hinweise: Der Weg zur Vollautomatisierung

Die Erstellung des Reports auf Knopfdruck ist bereits ein riesiger Fortschritt. Doch der Prozess lässt sich noch weiter optimieren:

  • Interner Freigabeprozess: Bevor ein Report versendet wird, muss er vielleicht intern geprüft werden. Dies kannst Du mit den Blueprints in Zoho CRM abbilden. Ein Report erhält den Status „Zur Freigabe“ und muss von einem Vorgesetzten auf den Status „Freigegeben“ gesetzt werden, bevor der nächste Schritt ausgelöst wird.
  • Automatischer E-Mail-Versand: Nach der Freigabe kann eine weitere Workflow-Regel oder ein Deluge-Skript den Versandprozess anstoßen. Das Skript holt sich die fertige Excel-Datei aus Zoho WorkDrive, hängt sie an eine E-Mail-Vorlage an und versendet diese direkt aus dem CRM an den richtigen Ansprechpartner des Lizenzgebers.
  • Self-Service für die Buchhaltung: Anstatt die Buchhaltung mit E-Mails zu überfluten, gib dem Team eigene Lizenzen für Zoho CRM. Der versendete Report und die E-Mail-Kommunikation sind direkt im Lizenzgeber-Datensatz protokolliert. Geht die Rechnung des Lizenzgebers ein, kann die Buchhaltung die Summen im CRM abgleichen, die Rechnung als Anhang hochladen und den Status des Vorgangs auf „geprüft“ oder „bezahlt“ setzen. Dies schafft eine lückenlose Dokumentation und eine Verbindung zum Prozess in Zoho Books.

Fazit

Die Automatisierung komplexer Reporting-Prozesse ist mehr als nur eine Zeitersparnis. Sie steigert die Datenqualität, reduziert Fehler drastisch und erhöht die Professionalität gegenüber Deinen Partnern. Dieses Beispiel zeigt eindrücklich, wie die Kombination aus einem sauberen Datenmodell in Zoho CRM, der Flexibilität von Deluge-Skripten und der gezielten Anbindung von externen APIs sowie anderen Zoho-Diensten einen ehemals manuellen Albtraum in einen effizienten, skalierbaren Workflow verwandelt. Der Schlüssel zum Erfolg liegt darin, das Zoho-Ökosystem nicht als eine Sammlung einzelner Apps zu betrachten, sondern als eine integrierte Plattform, die Dir die Werkzeuge an die Hand gibt, um Deine individuellen Geschäftsprozesse präzise abzubilden und zu automatisieren.

Verwendete Zoho Apps in diesem Szenario: