Diese Anleitung setzt voraus, dass Sie den Connector bereits installiert haben. Falls nicht, lesen Sie zunächst die Installationsanleitung.

Öffnen des Konfigurationsbildschirms

Wählen Sie im Gateway of Tally die Option SurveyAnalytica Connector. Der Konfigurationsbildschirm besteht aus zwei Bereichen: Global Settings oben und einer Transaction Types-Tabelle darunter.

Schritt 1 — Wählen Sie Ihre Umgebung

Verwenden Sie oben auf dem Bildschirm das Dropdown-Menü Environment, um auszuwählen:

• Test — sendet Daten an die Staging-Umgebung von SurveyAnalytica. Verwenden Sie diese Option während der Einrichtung und beim Testen.
• Production — sendet Daten an Ihr aktives SurveyAnalytica-Konto. Wechseln Sie hierzu, sobald das Testen abgeschlossen ist.

Schritt 2 — Webhook-URL und API-Schlüssel von SurveyAnalytica abrufen

1. Öffnen Sie in SurveyAnalytica den Workflow, der die Tally-Daten empfangen soll.
2. Klicken Sie auf den Schritt Trigger und stellen Sie sicher, dass der Triggertyp auf Webhook gesetzt ist.
3. Notieren Sie sich den KEY-Wert — dies ist Ihr API-Schlüssel für den Connector.
4. Notieren Sie sich die Workflow ID — dies ist die eindeutige Kennung, die in der Webhook-URL nach /webhook/ angezeigt wird.

Schritt 3 — Transaktionstypen konfigurieren

Die Tabelle Transaction Types listet alle Belegarten und Stammdatensätze auf, die in Ihrem Tally-Unternehmen verfügbar sind, einschließlich benutzerdefinierter Typen, die von anderen TDL-Modulen hinzugefügt wurden.

Gehen Sie für jeden zu synchronisierenden Transaktionstyp wie folgt vor:

1. Setzen Sie Enable auf Yes.
2. Geben Sie die Workflow ID aus SurveyAnalytica ein (den Teil nach /webhook/ in Ihrer Webhook-URL).
3. Geben Sie den API Key ein (den KEY-Wert aus der Trigger-Leiste).
4. Wählen Sie einen Auth Type:
   • API Key — Standardwahl für die meisten Workflows.
   • Basic Auth — verwenden Sie Benutzername und Passwort, getrennt durch einen Doppelpunkt, im Feld API Key.
   • OAuth 2.0 — geben Sie Ihre OAuth-Client-Zugangsdaten ein; der Connector ruft Tokens ab und aktualisiert sie automatisch.
   • HMAC-SHA256 — generiert eine Anfragesignatur für erhöhte Sicherheit.
5. Wählen Sie einen Trigger Mode:
   • Realtime — sendet Daten sofort, jedes Mal wenn ein Beleg dieses Typs gespeichert wird.
   • Batch — sammelt Belege und sendet sie gemeinsam in einem festgelegten Intervall (5, 15, 30 oder 60 Minuten). Verwenden Sie dies, um den Netzwerkverkehr bei Transaktionstypen mit hohem Volumen zu reduzieren.
   • Scheduled — führt täglich, wöchentlich oder monatlich zu einer von Ihnen festgelegten Zeit eine vollständige Synchronisierung durch. Geeignet für Tagesendberichte.
   • One-time — verwenden Sie die manuelle Schaltfläche Sync Now im Connector-Menü für Ad-hoc-Exporte.

Sie können für jeden Transaktionstyp unabhängig voneinander unterschiedliche Workflow IDs, Auth Types und Trigger Modes konfigurieren.

Schritt 4 — Konfiguration speichern

Drücken Sie Ctrl+A oder klicken Sie auf Save Config. Ihre Einstellungen werden in Tally gespeichert und bleiben auch nach einem Neustart erhalten.

Schritt 5 — Verbindung testen

1. Wählen Sie im Menü Gateway of Tally → SurveyAnalytica Connector die Option Test Connection.
2. Der Connector sendet an jeden aktivierten Workflow einen Test-Ping und zeigt pro Transaktionstyp eine Erfolgs- oder Fehlermeldung an.
3. Gehen Sie in SurveyAnalytica zum Workflow-Trigger und klicken Sie auf Check Status, um zu bestätigen, dass die Test-Payload empfangen wurde.

Einen Testbeleg senden

Speichern Sie in Tally einen beliebigen Beleg eines aktivierten Typs (erstellen Sie beispielsweise einen Test-Sales Voucher). Wenn der Trigger Mode auf Realtime steht, erscheinen die Daten innerhalb weniger Sekunden in Ihrem SurveyAnalytica-Workflow. Sie können dies im Panel Check Status in der Trigger-Leiste des Workflows sehen.

Fehlerbehebung

Daten kommen nicht in SurveyAnalytica an

• Prüfen Sie, ob sich der Workflow in SurveyAnalytica im Status Active befindet.
• Überprüfen Sie, ob Workflow ID und API Key korrekt eingegeben wurden — kopieren und fügen Sie sie ein, anstatt sie einzutippen.
• Bestätigen Sie, dass im Connector die richtige Umgebung (Test vs. Production) ausgewählt ist.
• Wenn Sie den Batch-Modus verwenden, warten Sie das Intervall ab oder wechseln Sie vorübergehend zu Realtime, um die Verbindung zu überprüfen.

Das SurveyAnalytica-Connector-Menü fehlt im Gateway of Tally

• Bestätigen Sie, dass die TDL-Datei unter F12 → TDL & Add-On aufgeführt und aktiviert ist.
• Prüfen Sie auf TDL-Ladefehler über Help → TDL & Add-On.
• Stellen Sie sicher, dass Ihre Tally-Prime-Version 7.0 oder höher ist.

Test Connection zeigt einen Fehler an

• Prüfen Sie, ob Ihr Tally-PC über Internetzugang verfügt und integration.surveyanalytica.com (Production) oder die Test-URL erreichen kann.
• Wenn Ihr Unternehmen einen Proxy oder eine Firewall verwendet, bitten Sie Ihre IT-Abteilung, ausgehenden HTTPS-Verkehr zu diesen Domains zuzulassen.