Ce guide suppose que vous avez déjà installé le connecteur. Si ce n’est pas le cas, consultez d’abord le Guide d’installation.

Ouverture de l’écran de configuration

Depuis Gateway of Tally, sélectionnez SurveyAnalytica Connector. L’écran de configuration comporte deux sections : Global Settings en haut et un tableau Transaction Types en dessous.

Étape 1 — Choisissez votre environnement

En haut de l’écran, utilisez le menu déroulant Environment pour sélectionner :

• Test — envoie les données vers l’environnement de préproduction de SurveyAnalytica. Utilisez ceci pendant la configuration et les tests.
• Production — envoie les données vers votre compte SurveyAnalytica actif. Passez à cette option une fois les tests terminés.

Étape 2 — Récupérez votre URL de webhook et votre clé API depuis SurveyAnalytica

1. Dans SurveyAnalytica, ouvrez le workflow qui doit recevoir les données Tally.
2. Cliquez sur l’étape Trigger et assurez-vous que le type de déclencheur est défini sur Webhook.
3. Notez la valeur KEY — il s’agit de votre clé API pour le connecteur.
4. Notez le Workflow ID — il s’agit de l’identifiant unique affiché dans l’URL du webhook après /webhook/.

Étape 3 — Configurez les types de transactions

Le tableau Transaction Types répertorie tous les types de pièces comptables (voucher types) et les fiches maîtres disponibles dans votre société Tally, y compris les types personnalisés ajoutés par d’autres modules TDL.

Pour chaque type de transaction que vous souhaitez synchroniser :

1. Réglez Enable sur Yes.
2. Saisissez le Workflow ID issu de SurveyAnalytica (la partie après /webhook/ dans votre URL de webhook).
3. Saisissez la API Key (la valeur KEY du panneau de déclencheur).
4. Choisissez un Auth Type :
   • API Key — choix standard pour la plupart des workflows.
   • Basic Auth — utilisez un nom d’utilisateur et un mot de passe séparés par deux-points dans le champ API Key.
   • OAuth 2.0 — saisissez vos identifiants client OAuth ; le connecteur récupère et actualise les jetons automatiquement.
   • HMAC-SHA256 — génère une signature de requête pour une sécurité renforcée.
5. Choisissez un Trigger Mode :
   • Realtime — envoie les données immédiatement à chaque enregistrement d’une pièce de ce type.
   • Batch — regroupe les pièces et les envoie ensemble à intervalle défini (5, 15, 30 ou 60 minutes). Utilisez ce mode pour réduire le trafic réseau des types de transactions à fort volume.
   • Scheduled — exécute une synchronisation complète quotidienne, hebdomadaire ou mensuelle à l’heure que vous spécifiez. Adapté aux rapports de fin de journée.
   • One-time — utilisez le bouton manuel Sync Now dans le menu du connecteur pour des exports ponctuels.

Vous pouvez configurer des Workflow ID, des Auth Types et des Trigger Modes différents pour chaque type de transaction, indépendamment les uns des autres.

Étape 4 — Enregistrez la configuration

Appuyez sur Ctrl+A ou cliquez sur Save Config. Vos paramètres sont enregistrés dans Tally et persistent après redémarrage.

Étape 5 — Testez la connexion

1. Depuis le menu Gateway of Tally → SurveyAnalytica Connector, sélectionnez Test Connection.
2. Le connecteur envoie un ping de test à chaque workflow activé et affiche un message de réussite ou d’échec pour chaque type de transaction.
3. Dans SurveyAnalytica, accédez au déclencheur du workflow et cliquez sur Check Status pour confirmer que la charge utile de test a bien été reçue.

Envoi d’une pièce de test

Enregistrez une pièce quelconque d’un type activé dans Tally (par exemple, créez un bon de vente (Sales Voucher) de test). Si le mode de déclenchement est Realtime, les données apparaissent dans votre workflow SurveyAnalytica en quelques secondes. Vous pouvez les consulter dans le panneau Check Status du workflow, dans le panneau du déclencheur.

Dépannage

Les données n’arrivent pas dans SurveyAnalytica

• Vérifiez que le workflow est à l’état Active dans SurveyAnalytica.
• Vérifiez que le Workflow ID et la clé API sont saisis correctement — copiez-collez-les plutôt que de les taper.
• Confirmez que le bon environnement (Test ou Production) est sélectionné dans le connecteur.
• Si vous utilisez le mode Batch, attendez que l’intervalle s’écoule, ou passez temporairement en mode Realtime pour vérifier que la connexion fonctionne.

Le menu SurveyAnalytica Connector est absent du Gateway of Tally

• Confirmez que le fichier TDL est listé et activé dans F12 → TDL & Add-On.
• Vérifiez la présence d’erreurs de chargement TDL via Help → TDL & Add-On.
• Assurez-vous que votre version de Tally Prime est 7.0 ou ultérieure.

Test Connection affiche un échec

• Vérifiez que votre poste Tally dispose d’un accès internet et peut atteindre integration.surveyanalytica.com (Production) ou l’URL de test.
• Si votre entreprise utilise un proxy ou un pare-feu, demandez à votre équipe informatique d’autoriser le trafic HTTPS sortant vers ces domaines.