Help

Le SurveyAnalytica Tally Bridge met à profit les chiffres déjà présents dans TallyPrime : vos factures de vente parviennent à vos clients quelques minutes après leur enregistrement, vos listes de clients et de fournisseurs restent à jour, et vos chiffres de ventes, d’achats et de stock sont prêts pour vos tableaux de bord et pour un portail à votre image de marque. C’est un petit programme Windows installé sur le même PC que TallyPrime : il lit vos sociétés par la connexion intégrée de TallyPrime sur ce PC et envoie chaque enregistrement nouveau ou modifié à un workflow SurveyAnalytica — l’automatisation que vous construisez une seule fois. Il n’exige aucun module complémentaire dans TallyPrime et n’ouvre qu’une seule connexion sécurisée sortante : aucun port entrant, aucune ouverture de pare-feu.

Ce que vous pouvez en faire

Des factures qui parviennent au client

Une facture de vente part quelques minutes après son enregistrement : sur WhatsApp ou par e-mail avec un PDF à votre image, ou par SMS avec le lien.

Listes de clients et de fournisseurs synchronisées

Les comptes du grand livre classés sous Sundry Debtors et Sundry Creditors arrivent sous forme de contacts : vos listes restent à jour. Voir Listes de contacts.

Des relances de paiement sans coups de téléphone

Chaque facture porte le solde dû par ce client : un workflow planifié peut donc relancer les clients qui vous doivent de l’argent, les jours que vous choisissez.

Un avis client après la vente

Demandez au client comment s’est passée sa commande : le workflow qui a envoyé la facture peut enchaîner avec un court formulaire d’avis sur WhatsApp ou par e-mail.

Des tableaux de bord sur vos propres chiffres

Ajoutez une étape Data et les enregistrements sont aussi conservés pour l’analyse : ventes par client ou par article, solde dû par chaque client, tendances d’achat, état des stocks, pour une succursale ou pour toutes. Voir Tableaux de bord Analytics.

Un portail à votre image de marque

Vos clients se connectent et consultent leurs propres factures ainsi que le solde dû sur leur compte, chacun uniquement les siennes. Voir le Portail participant.

Les détails de la facture électronique GST (IRN et accusé de réception) accompagnent la facture dès que Tally en dispose, et un seul PC dessert plusieurs sociétés ou succursales, chacune acheminée là où elle doit aller.

Comment cela fonctionne

TallyPrime dispose d’un moyen intégré de partager ses données avec les autres logiciels du même PC — la fonction même qui sert à récupérer des états Tally dans Excel. Vous l’activez une seule fois, à l’étape 1 (Client/Server configuration, port 9000). Toutes les quelques minutes, ou une fois par nuit, le connecteur s’en sert pour demander ce qui a changé dans chaque type d’enregistrement que vous avez choisi : factures de vente, factures d’achat, comptes clients et fournisseurs, comptes bancaires, articles de stock. Ce qui revient est conservé dans une file d’attente sur le PC — un fichier qui garde chaque enregistrement en sécurité jusqu’à sa remise — puis transmis à votre workflow, qui fait le reste : la facture sur WhatsApp, par e-mail ou par SMS ; le compte devenu client ou fournisseur dans votre liste de contacts ; les chiffres sur vos tableaux de bord de ventes, d’achats et de stock ; les factures et le solde dû de chaque client sur votre portail.

Les enregistrements quittent votre PC par une seule connexion sortante. Votre workflow décide de la suite : la facture sur WhatsApp, le client dans votre liste, le chiffre sur votre tableau de bord, la page que votre client ouvre sur votre portail.

La fiabilité en un coup d’œil

Ce qui compte pour vous	Ce que vous obtenez
Point de reprise (RPO)	Pratiquement nul. Tally reste votre système de référence. Le connecteur conserve un repère par société et par type d’enregistrement, et ne l’avance qu’une fois ces enregistrements en sécurité dans sa file d’attente sur votre disque. Tout ce qui a été saisi pendant que la connexion Internet, le PC ou le connecteur étaient indisponibles est repris à l’exécution suivante — rien n’est ressaisi.
Temps de reprise (RTO)	Déterminé par votre PC, pas par l’intégration. Il n’y a pas de procédure de reprise : le connecteur reprend environ une minute après l’ouverture de session, rattrape toute exécution planifiée manquée pendant que le PC était éteint, et réessaie toutes les 15 minutes pour une société qui n’était pas ouverte.
Disponibilité	Il démarre à l’ouverture de session Windows, et Windows le relance s’il venait à s’arrêter — trois tentatives, à une minute d’intervalle. La file d’attente est un fichier sur votre disque : un redémarrage la laisse intacte, et la remise est réessayée jusqu’à acceptation.
Ni doublons, ni oublis	Chaque enregistrement porte l’identifiant permanent propre à Tally, et une pièce modifiée est renvoyée sous ce même identifiant. Désignez ce champ comme clé unique dans l’étape de votre workflow — le Guide de configuration indique où — et l’entrée est mise à jour sur place au lieu de se répéter. Rien n’est laissé de côté : le repère n’avance qu’une fois les enregistrements dans la file d’attente.
Sécurité	HTTPS sortant uniquement : aucun port entrant, aucune ouverture de pare-feu, aucun droit d’administrateur. Il ne demande ni ne conserve jamais de mot de passe Tally, et chaque workflow a sa propre clé.
Charge sur Tally	Il ne demande que ce qui a changé. Entre deux exécutions planifiées, il reste silencieux, hormis la légère vérification pour une société qui n’était pas ouverte.

Le temps de reprise, c’est le temps qu’il faut au PC Tally pour être de nouveau opérationnel : session Windows ouverte et sociétés chargées dans Tally. Rien à reconfigurer, rien à réimporter, rien à ressaisir : le connecteur reprend là où il s’était arrêté et, sur un PC devant lequel personne ne s’assoit, l’ouverture de session automatique de Windows rend même cela automatique.

Avant de commencer

TallyPrime 7.0 ou version ultérieure, sur Windows 64 bits.
Le connecteur s’installe sur le même PC que TallyPrime, et peut ouvrir Tally pour vous s’il n’est pas déjà lancé.
TallyPrime ouvert, avec les sociétés à synchroniser chargées. Si l’une demande un mot de passe, connectez-vous à celle-ci dans Tally comme d’habitude et laissez-la ouverte.
Un accès web sécurisé sortant. Derrière un proxy d’entreprise, le connecteur suit la variable HTTPS_PROXY définie pour le compte sous lequel il s’exécute.
Un compte SurveyAnalytica pouvant créer des workflows, et environ une heure pour la première installation.

Étape 1 — Laisser TallyPrime partager ses données (port 9000)

Dans TallyPrime, appuyez sur F1 (Help) et ouvrez Settings → Connectivity → Client/Server configuration — sur les versions récentes, également depuis Alt+Z (Exchange) puis Configure → Client/Server configuration.
Renseignez les trois champs ci-dessous, puis validez l’écran. Tally demande à redémarrer — acceptez.
Pour vérifier, appuyez sur F1 (Help) et ouvrez About : Client/Server with ODBC Services indique le port utilisé.
Si un ancien TallyConnector.tdl figure sous TDL & Add-On, retirez-le et redémarrez Tally, afin que chaque pièce emprunte une seule voie.

Champ	Valeur à saisir
TallyPrime acts as	`Both` (ou `Server`)
Enable ODBC	`Yes`
Port	`9000`

Si un autre programme utilise déjà le port 9000, Tally en prend un autre — notez-le pour l’étape 4.

Étape 2 — Télécharger et décompresser le connecteur

Dans SurveyAnalytica, ouvrez Compte → My Integrations et cliquez sur Parcourir les connecteurs — également depuis le panneau du déclencheur Webhook d’un workflow.
Ouvrez la fiche Tally Prime et cliquez sur Télécharger en regard de la version souhaitée.
Dans l’Explorateur de fichiers, saisissez C:\ProgramData dans la barre d’adresse et appuyez sur Enter — ce dossier est masqué, vous en tapez donc le chemin. S’il ne contient pas de dossier SurveyAnalytica, créez-en un avec Nouveau → Dossier (New → Folder).
Extrayez-y les trois fichiers. Tout ce que le connecteur crée se place à côté d’eux.

Il s’agit de sa-tally-bridge.exe, celui dans lequel vous saisissez les commandes ; de sa-tally-bridgew.exe, la copie sans fenêtre que Windows utilise en arrière-plan ; et de bridge.example.yml, un exemplaire de référence de tous les réglages, pour des modifications manuelles ultérieures.

Étape 3 — Créer le workflow qui reçoit les enregistrements

Le workflow vient en premier : c’est lui qui vous donne les deux éléments à copier, une adresse web et une clé.

Ouvrez l’onglet Flux de votre espace de travail et cliquez sur Flux (workflow).
Choisissez À partir de zéro (partir de zéro). Dans la fenêtre Créer un flux, saisissez un Nom du flux de travail tel que Tally records, choisissez un Espace de travail si la question vous est posée, puis appuyez sur Enregistrer.
Cliquez sur Déclencheur en haut du panneau de droite et choisissez Webhook. Une clé est créée dès que vous le sélectionnez.
Copiez les valeurs en regard de URL : et de KEY :, prêtes pour l’étape 4.
Laissez vides les champs HMAC Signature (Optional) (signature HMAC, facultative) ; la clé seule sécurise la connexion.
Enregistrez le workflow. Vous l’activerez à l’étape 6, une fois ses étapes créées.

Le panneau du déclencheur Webhook : les lignes à copier sont intitulées KEY : et URL :. Vérifier le statut et Appliquer interviennent à l’étape 5.

Un seul workflow peut tout recevoir, ou chaque type d’enregistrement peut avoir le sien, avec ses propres URL et KEY — voir le Guide de configuration.

Astuce. Générer un nouveau émet une nouvelle clé. Une fois la nouvelle clé émise, collez-la dans bridge.yml, redémarrez le connecteur, puis appuyez sur Mettre à jour la version en ligne.

Étape 4 — Exécuter l’assistant de configuration

Ouvrez C:\ProgramData\SurveyAnalytica dans l’Explorateur de fichiers, cliquez dans la barre d’adresse, saisissez cmd par-dessus le chemin et appuyez sur Enter : une Invite de commandes s’ouvre dans ce dossier, et Ctrl+V y colle le presse-papiers.

Avant de commencer : enregistrez dans Tally toute pièce en cours de saisie. L’assistant règle TallyPrime pour qu’il ouvre les sociétés choisies au démarrage (en conservant une copie de vos réglages d’origine sous tally.ini.sa-backup), et peut redémarrer Tally pour les charger.

Invite de commandes

sa-tally-bridge.exe init

L’assistant affiche === SurveyAnalytica Tally Bridge Setup === et pose une question à la fois, chacune avec sa réponse suggérée entre crochets ; Enter l’accepte. Utilisez l’assistant pour la première installation : il repart d’une page blanche à chaque fois, effectuez donc les modifications ultérieures dans bridge.yml avec le Bloc-notes (Notepad), comme l’explique le Guide de configuration.

Les questions, dans l’ordre

Ce qui est demandé	Ce qu’il faut répondre
`Tally HTTP Gateway URL [http://localhost:9000]:` `Tally executable path [C:\Program Files\TallyPrime\tally.exe]:` `Tally ini path [C:\Program Files\TallyPrime\tally.ini]:` `Tally Data Folder Path [...]:`	Enter à chacune. Ne changez le port que si l’étape 1 en a pris un autre, et le chemin de l’exécutable que si TallyPrime est installé ailleurs — le chemin du fichier ini en découle, et le dossier de données provient des réglages de Tally.
`Enter company folder numbers comma-separated (or 'all') [all]:`	Au-dessus, l’assistant dresse la liste des dossiers de sociétés présents sur le disque. Saisissez les numéros à synchroniser, par exemple `1,3`, ou Enter pour toutes — Tally les ouvrira de lui-même désormais.
`Tally is running but reports no open companies. Restart Tally to load the selection? (y/n) [y]:` `Tally's gateway is not answering yet (login screens still open?). Keep waiting? (y/n) [y]:`	Posé pendant le chargement de Tally. `y` redémarre Tally avec votre sélection, puis attend par tranches de deux minutes que vous ayez validé les écrans Company Login.
`Enter company numbers comma-separated (or 'all') [all]:`	La liste correspond maintenant aux sociétés ouvertes dans Tally ; choisissez celles à synchroniser. Si aucune liste n’est revenue, l’assistant demande plutôt `Company name 1:` — saisissez chaque nom tel que Tally l’orthographie, en terminant par une ligne vide.
`Enter numbers comma-separated (e.g., 1,3,7) [1,3,7]:`	Les enregistrements à synchroniser, parmi le menu ci-dessous, pour chacune des sociétés que vous avez sélectionnées.
`Global fallback Webhook URL (used when a transaction has no specific one):` `API key (code) for the global webhook:`	Collez l’URL : puis la KEY : de l’étape 3 ; tout ce qui n’a pas d’adresse propre arrive ici.
`Webhook URL for sales (empty = global):` `API key (code) for the sales webhook:`	Posé pour chaque type d’enregistrement. Enter reprend l’adresse ci-dessus ; collez l’URL et la clé d’un autre workflow pour y envoyer ce type.
`How often should the bridge read Tally? [1/2] [1]:`	Enter pour `1`, automatique : la première synchronisation lit tout votre historique, mieux vaut donc la lancer pendant que vous êtes devant le PC. Passez ensuite à une heure nocturne dans bridge.yml.
`Time of day (24h HH:MM) [21:30]:` `Timezone (IANA name) [Asia/Kolkata]:`	Posé uniquement après avoir répondu `2`. Saisissez une heure telle que `21:30` ; Enter à la question suivante donne l’heure de l’Inde.

Les types d’enregistrement proposés

Available Transactions to Sync:
1) Sales Vouchers (sales)
2) Purchase Vouchers (purchase)
3) Customers — Sundry Debtors only (ledgers/debtors)
4) Suppliers — Sundry Creditors only (ledgers/creditors)
5) Bank Accounts (ledgers/bank)
6) ALL Ledgers — full chart of accounts (ledgers)
7) Stock Items (stockItems)
Enter numbers comma-separated (e.g., 1,3,7) [1,3,7]:

Il enregistre les réglages et affiche :

Invite de commandes

Setup complete! Configuration saved to bridge.yml
Sync schedule: every 5m0s
Start it with:  sa-tally-bridge run --config bridge.yml
Start at logon: sa-tally-bridge task install --config bridge.yml

Bon à savoir. Si l’assistant évoque des enregistrements « dropped », les enregistrements attendent en sécurité dans la file d’attente jusqu’à ce qu’une destination soit définie.

Étape 5 — Envoyer un test

Le test envoie directement au workflow une dizaine d’enregistrements récents de chaque type : vous voyez ainsi vos propres chiffres arriver avant le début de la synchronisation complète. Le repère ne bouge pas et rien n’est mis en file d’attente, la première exécution réelle couvre donc bien tout votre historique.

Invite de commandes

sa-tally-bridge.exe test --config bridge.yml

Une exécution réussie affiche une ligne par société et par type d’enregistrement, puis une ligne de clôture :

Invite de commandes

[TEST] Acme Traders/sales: 10 records delivered OK
[TEST] Acme Traders/ledgers/debtors: 10 records delivered OK
Test run complete — all sampled streams delivered. Watermarks
untouched; the real run will still sync full history.

no recent records found signifie que cette société n’a encore rien de ce type. Les lignes concernant des sociétés non ouvertes, ou Tally qui ne répond pas, sont traitées dans le tableau de dépannage ci-dessous. webhook delivery FAILED signifie que l’adresse ou la clé ne correspond pas au workflow : recopiez les deux depuis le panneau du déclencheur.

Apprenez maintenant au workflow la forme des données :

Dans le panneau du déclencheur, appuyez sur Vérifier le statut : il récupère le dernier élément arrivé, d’où l’intérêt de faire le test d’abord.
Vérifiez qu’un enregistrement Tally s’affiche, puis appuyez sur Appliquer. Le workflow connaît désormais les noms des champs.

Bon à savoir. Lorsque de nombreux enregistrements sont arrivés en même temps, ce panneau en affiche une copie abrégée — tous les noms de champs y figurent, c’est tout ce dont Appliquer a besoin, et les exécutions complètes envoient tout.

Étape 6 — Activer, puis lancer la première synchronisation

Construisez les étapes qui s’exécutent sur chaque enregistrement — le Guide de configuration explique comment transformer les enregistrements en actions.
Appuyez sur Activer et vérifiez que le workflow affiche Actif. Activez le workflow d’abord, afin que chaque facture soit traitée dès la toute première synchronisation. (Tant qu’il n’est pas actif, le workflow ne conserve qu’un échantillon de test.)

La première synchronisation est la plus grosse : elle lit tout l’historique de chaque société et de chaque type d’enregistrement en une seule exécution, à environ 5 000 enregistrements par minute — une société comptant 100 000 pièces demande donc une vingtaine de minutes. Faites-la devant le PC, dans le mode automatique de l’étape 4.

Invite de commandes

sa-tally-bridge.exe run --config bridge.yml

La fenêtre affiche Bridge running... (Press Ctrl+C to stop) et rend compte de chaque cycle ; laissez-la ouverte. Dans une seconde Invite de commandes, demandez où il en est :

Invite de commandes

sa-tally-bridge.exe status --config bridge.yml

Le rapport est écrit lorsqu’un passage complet sur Tally se termine : tant que le premier n’est pas fini, status répond no status yet. Guettez dans la première fenêtre une ligne commençant par Cycle, puis redemandez.

Ce qu’il affiche

Last run    : Sat, 19 Sep 2026 11:04:12 IST → 11:04:48 (partial)
Next run    : Sat, 19 Sep 2026 11:09:12 IST
Records     : 1250 enqueued last run; outbox depth 0
Pending     : 1 stream(s) awaiting retry
   - Globex Industries / sales : company_closed
   ok Acme Traders / sales : up_to_date (watermark 260409/260409, 0 records)

Vous attendez une ligne ok indiquant up_to_date pour chaque société et chaque type d’enregistrement, avec outbox depth 0 et aucune ligne Pending. Tout ce qui est encore en cours figure sous Pending avec son motif : company_closed signifie que cette société n’est pas ouverte dans Tally — ouvrez-la et elle est reprise en quelques minutes.

Vérifiez le workflow entre-temps : les enregistrements doivent arriver et vos étapes s’exécuter. Lorsque chaque société et chaque type d’enregistrement affichent up_to_date, appuyez sur Ctrl+C. Pour passer à une heure nocturne, ouvrez bridge.yml dans le Bloc-notes et redémarrez le connecteur, comme l’explique le Guide de configuration.

Étape 7 — Le faire démarrer tout seul

Déclarez le connecteur auprès de Windows pour qu’il démarre à chaque ouverture de session, en le pointant vers le fichier sans fenêtre afin qu’aucune fenêtre ne reste sur le bureau.

Invite de commandes

sa-tally-bridge.exe task install --exe sa-tally-bridgew.exe

Il vérifie vos réglages, signale ce qui manque, puis confirme la tâche :

Invite de commandes

Scheduled task "\SurveyAnalytica\Tally Bridge" installed.
  runs   : ...\sa-tally-bridgew.exe run --config "...\bridge.yml"
  as     : the current account (SID ...), interactive session only
  starts : at logon, after PT1M
  sync   : every 5m0s

Les chemins complets sont abrégés ci-dessus. after PT1M signifie qu’il démarre environ une minute après l’ouverture de session, ce qui laisse à Tally le temps de se charger, et task status confirme l’enregistrement à tout moment. Le connecteur s’exécute dans votre session Windows ouverte, aux côtés de Tally ; pour un PC devant lequel personne ne s’assoit, activez l’ouverture de session automatique de Windows et il revient de lui-même après un redémarrage.

Démarrez-le maintenant. La tâche prend le relais à votre prochaine ouverture de session : donnez-lui donc son premier démarrage à la main — les trois mêmes clics que vous utiliserez après chaque changement de réglage.

Démarrer et redémarrer le connecteur

Le connecteur lit bridge.yml au démarrage : une modification prend donc effet au démarrage suivant — et ces trois clics lui donnent ce premier démarrage :

Ouvrez le Planificateur de tâches (Task Scheduler) de Windows et accédez à Bibliothèque du Planificateur de tâches → SurveyAnalytica → Tally Bridge.
S’il est en cours d’exécution, faites un clic droit sur la tâche et choisissez Fin (End).
Faites de nouveau un clic droit dessus et choisissez Exécuter (Run).

Fermer votre session Windows puis la rouvrir produit le même effet ; une minute ou deux plus tard, status rend compte d’une exécution terminée.

Mise à niveau vers une nouvelle version

Arrêtez le connecteur : dans le Planificateur de tâches, faites un clic droit sur la tâche et choisissez Fin.
Téléchargez le nouveau fichier .zip et remplacez les deux fichiers du programme, en conservant les mêmes noms.
Faites de nouveau un clic droit sur la tâche et choisissez Exécuter.

Vos réglages, la file d’attente et le relevé de ce qui a déjà été envoyé se trouvent à côté du programme et restent tels quels. version indique la version installée ; status indique celle qui a produit la dernière exécution. Après avoir déplacé le dossier, exécutez de nouveau task install.

Retirer le connecteur

Exécutez sa-tally-bridge.exe task uninstall. Il répond Scheduled task removed.
Mettez fin à la tâche dans le Planificateur de tâches si elle est encore en cours d’exécution.
Supprimez le dossier — ou conservez-le si vous prévoyez de réinstaller, puisqu’il contient le relevé de ce qui a été envoyé ; un dossier neuf repart du début de l’historique.
Pour rétablir la liste d’ouverture automatique précédente de Tally, copiez tally.ini.sa-backup par-dessus tally.ini.

Si quelque chose demande votre attention

Ce que vous voyez	Ce que cela signifie	Ce qu’il faut faire
Windows a protégé votre ordinateur (Windows protected your PC), ou le fichier disparaît après le téléchargement	Windows et certains antivirus se montrent prudents avec les nouveaux téléchargements.	Cliquez sur Informations complémentaires (More info), puis sur Exécuter quand même (Run anyway). Si l’antivirus a pris le fichier, restaurez-le depuis la quarantaine et autorisez le dossier.
Le test affiche `could not reach Tally's gateway` ou `Tally answered but has no companies open` ; ou `status` indique `Blocked : gateway_error` ou `gateway_empty`	Tally est fermé, un écran de connexion attend au premier plan, ou Tally partage ses données sur un autre port. (`gateway` est le mot employé par le connecteur pour cette connexion sur le port 9000.)	Regardez la fenêtre Tally, connectez-vous là où c’est demandé, laissez les sociétés ouvertes. Si elles sont déjà ouvertes, vérifiez l’étape 1 : appuyez sur `F1` (Help), ouvrez About, et assurez-vous que le port correspond à celui indiqué à l’assistant.
L’assistant a affiché `Warning: could not update ... tally.ini`	Ce fichier se trouve dans le dossier programme de TallyPrime, que les comptes ordinaires peuvent seulement lire : la liste d’ouverture automatique est donc inchangée.	Ouvrez les sociétés vous-même avant l’exécution du connecteur, ou relancez `init` depuis une Invite de commandes ouverte avec Exécuter en tant qu’administrateur (Run as administrator).
Rien ne se synchronise après un redémarrage	La tâche s’exécute pendant que ce compte Windows a une session ouverte.	Ouvrez la session et lancez Tally avec ses sociétés ; le connecteur reprend environ une minute plus tard. Pour un PC sans opérateur, utilisez l’ouverture de session automatique.
`task install` mentionne `SCHED_S_SOME_TRIGGERS_FAILED`	La tâche a été enregistrée pour un compte autre que le compte interactif de cette machine.	Le message nomme le compte : ouvrez une session avec celui qui utilise Tally et exécutez-y `task install`.
Il a fonctionné, puis s’est mis en pause, et le journal répète `Webhook returned HTTP 401`	La clé a été changée avec Générer un nouveau et le workflow a été remis en ligne : il attend donc la nouvelle clé.	Copiez la nouvelle KEY : dans bridge.yml et redémarrez le connecteur ; les enregistrements en file d’attente partent dès qu’elle correspond.
Un double-clic sur sa-tally-bridgew.exe affiche SurveyAnalytica Tally Bridge — wrong executable	C’est la copie sans fenêtre qu’utilise la tâche planifiée.	Saisissez plutôt vos commandes dans sa-tally-bridge.exe.

Le connecteur tient son propre journal, sa-tally-bridge.log, à côté du fichier de réglages : texte brut, les lignes les plus récentes en dernier.

Et ensuite

Le connecteur est installé, testé et démarre tout seul. La suite : quelles sociétés et quels types d’enregistrement il envoie, où va chacun, et ce que votre workflow en fait — Connecteur Tally Prime — Guide de configuration.