Help

Il SurveyAnalytica Tally Bridge mette al lavoro i numeri che hai già in TallyPrime: le tue fatture di vendita raggiungono i clienti pochi minuti dopo essere state registrate, le tue liste di clienti e fornitori restano aggiornate e i tuoi dati di vendita, acquisto e magazzino sono pronti per le dashboard e per un portale con il tuo marchio. È un piccolo programma Windows sullo stesso PC di TallyPrime: legge le tue aziende attraverso la connessione integrata di TallyPrime su quel PC e invia ogni record nuovo o modificato a un flusso SurveyAnalytica — l’automazione che costruisci una volta sola. Non richiede nessun add-on dentro TallyPrime e apre una sola connessione sicura in uscita: nessuna porta in entrata, nessuna apertura del firewall.

Che cosa puoi fare con il bridge

Fatture che arrivano al cliente

Una fattura di vendita parte pochi minuti dopo che l’hai registrata: su WhatsApp o via email, in PDF con il tuo marchio, oppure come SMS che porta il link.

Liste clienti e fornitori sempre allineate

I conti (ledger) sotto Sundry Debtors e Sundry Creditors arrivano come contatti, così le tue liste restano aggiornate. Vedi Liste contatti.

Solleciti di pagamento senza telefonate

Ogni fattura porta con sé il saldo aperto di quel cliente, così un flusso pianificato può sollecitare chi deve ancora pagarti, nei giorni che scegli tu.

Feedback dopo la vendita

Chiedi al cliente com’è andato l’ordine: il flusso che ha inviato la fattura può far seguire un breve modulo di feedback su WhatsApp o via email.

Dashboard sui tuoi numeri

Aggiungi un passaggio Data e i record vengono conservati anche per l’analisi: vendite per cliente o per articolo, quanto deve ancora ogni cliente, andamento degli acquisti, situazione di magazzino, per una filiale o per tutte. Vedi Dashboard Analytics.

Un portale con il tuo marchio

I clienti accedono e vedono le proprie fatture e il saldo aperto sul proprio conto, ciascuno solo il proprio. Vedi il Participant Portal.

I dati della fattura elettronica GST (IRN e acknowledgement) viaggiano insieme alla fattura ogni volta che Tally li ha, e un solo PC serve più aziende o filiali, ciascuna instradata dove deve andare.

Come funziona

TallyPrime ha un modo integrato per condividere i suoi dati con altri software sullo stesso PC — la stessa funzione usata per portare i report di Tally in Excel. La attivi una volta sola, nel Passaggio 1 (Client/Server configuration, porta 9000). Ogni pochi minuti, oppure una volta a notte, il bridge la usa per chiedere che cosa è cambiato in ogni tipo di record che hai scelto: fatture di vendita, fatture di acquisto, ledger di clienti e fornitori, conti bancari, articoli di magazzino. Quello che torna viene tenuto in una coda sul PC — un file che custodisce ogni record finché non viene consegnato — e inviato al tuo flusso, che fa il resto: la fattura su WhatsApp, email o SMS; il ledger come cliente o fornitore nella tua lista contatti; i numeri sulle tue dashboard di vendite, acquisti e magazzino; le fatture e il saldo di ogni cliente sul tuo portale.

I record lasciano il tuo PC attraverso una sola connessione in uscita. È il tuo flusso a decidere che cosa succede dopo: la fattura su WhatsApp, il cliente nella tua lista, il numero sulla tua dashboard, la pagina che il tuo cliente apre sul portale.

L’affidabilità in breve

Che cosa ti interessa	Che cosa ottieni
Punto di ripristino (RPO)	Praticamente zero. Tally resta il tuo sistema di riferimento. Il bridge tiene un segnalibro per ogni azienda e tipo di record, e lo sposta solo quando quei record sono al sicuro nella sua coda sul tuo disco. Tutto ciò che è stato registrato mentre internet, il PC o il bridge non erano disponibili viene ripreso all’esecuzione successiva — non si reinserisce nulla a mano.
Tempo di ripristino (RTO)	Lo decide il tuo PC, non l’integrazione. Non c’è una procedura di ripristino: il bridge riparte circa un minuto dopo l’accesso, recupera gli orari pianificati saltati mentre il PC era spento e riprova ogni 15 minuti con le aziende che non erano aperte.
Disponibilità	Parte all’accesso a Windows, e Windows lo riavvia se dovesse fermarsi — tre tentativi, a un minuto di distanza. La coda è un file sul tuo disco, quindi un riavvio la lascia intatta, e la consegna viene ritentata finché non viene accettata.
Nessun duplicato, nessun buco	Ogni record porta con sé l’identificatore permanente di Tally, e un voucher modificato viene inviato di nuovo con lo stesso identificatore. Indica quel campo come chiave univoca nel passaggio del tuo flusso — la Guida alla configurazione mostra dove — e la voce si aggiorna al suo posto invece di ripetersi. Non viene saltato nulla: il segnalibro si sposta solo quando i record sono nella coda.
Sicurezza	Solo HTTPS in uscita: nessuna porta in entrata, nessuna apertura del firewall, nessun diritto di amministratore. Non chiede mai e non conserva nessuna password di Tally, e ogni flusso ha la sua chiave.
Carico su Tally	Chiede solo quello che è cambiato. Tra un’esecuzione pianificata e l’altra resta in silenzio, a parte il controllo leggero sull’azienda che non era aperta.

Il tempo di ripristino coincide con quello che serve al PC di Tally per tornare in funzione, con l’accesso fatto e le aziende aperte. Niente da riconfigurare, niente da reimportare, niente da reinserire: il bridge riprende da dove si era fermato e, su un PC a cui non siede nessuno, l’accesso automatico di Windows rende automatico anche quello.

Prima di iniziare

TallyPrime 7.0 o versione successiva, su Windows a 64 bit.
Il bridge va sullo stesso PC di TallyPrime e può aprire Tally al posto tuo se non è già in esecuzione.
TallyPrime aperto, con caricate le aziende che vuoi sincronizzare. Se una chiede una password, accedi in Tally come al solito e lasciala aperta.
Traffico web sicuro in uscita. Dietro un proxy aziendale, il bridge segue la variabile HTTPS_PROXY impostata per l’account con cui viene eseguito.
Un accesso SurveyAnalytica che può creare flussi, e circa un’ora per la prima configurazione.

Passaggio 1 — Lascia che TallyPrime condivida i suoi dati (porta 9000)

In TallyPrime premi F1 (Help) e apri Settings → Connectivity → Client/Server configuration — nelle release recenti anche da Alt+Z (Exchange) e poi Configure → Client/Server configuration.
Imposta i tre campi qui sotto, poi conferma la schermata. Tally chiede di riavviarsi — lascialo fare.
Per conferma, premi F1 (Help) e apri About: Client/Server with ODBC Services mostra la porta in uso.
Se sotto TDL & Add-On compare un vecchio TallyConnector.tdl, rimuovilo e riavvia Tally, così ogni voucher viaggia su una sola strada.

Campo	Imposta a
TallyPrime acts as (TallyPrime funziona come)	`Both` (oppure `Server`)
Enable ODBC (abilita ODBC)	`Yes`
Port (porta)	`9000`

Se un altro programma sta già usando la porta 9000, Tally ne prende un’altra — annotala per il Passaggio 4.

Passaggio 2 — Scarica e scompatta il bridge

In SurveyAnalytica apri Account → My Integrations e fai clic su Sfoglia i connettori — lo trovi anche nel pannello del trigger Webhook di un flusso.
Apri la scheda Tally Prime e fai clic su Scarica in corrispondenza della versione che vuoi.
In Esplora file (File Explorer), scrivi C:\ProgramData nella barra degli indirizzi e premi Enter — la cartella è nascosta, quindi il percorso si scrive a mano. Se dentro non c’è una cartella SurveyAnalytica, creala con Nuovo → Cartella (New → Folder).
Estrai lì dentro tutti e tre i file. Tutto quello che il bridge crea finisce accanto a loro.

Sono sa-tally-bridge.exe, quello in cui scrivi i comandi; sa-tally-bridgew.exe, la copia senza finestra che Windows usa in background; e bridge.example.yml, una copia di riferimento di tutte le impostazioni, per le modifiche a mano successive.

Passaggio 3 — Crea il flusso che riceve i record

Il flusso viene per primo: ti dà le due cose da copiare, un indirizzo web e una chiave.

Apri la scheda Flussi della tua area di lavoro e fai clic su Flusso.
Scegli Da vuoto. Nel riquadro Crea flusso scrivi un Nome del flusso di lavoro come Tally records, scegli un’Area di lavoro se te la chiede e premi Salva.
Fai clic su Trigger (il trigger) in cima al pannello di destra e scegli Webhook. La chiave viene creata nel momento in cui lo scegli.
Copia i valori accanto a URL : e KEY :, pronti per il Passaggio 4.
Lascia vuoti i campi HMAC Signature (Optional) (firma HMAC, facoltativa); la chiave da sola mette in sicurezza la connessione.
Salva il flusso. Lo attiverai nel Passaggio 6, quando i suoi passaggi saranno pronti.

Il pannello del trigger Webhook: le righe da copiare sono indicate con KEY : e URL :. Controlla lo stato e Fare domanda a si usano nel Passaggio 5.

Un solo flusso può ricevere tutto, oppure ogni tipo di record può avere il suo, con URL e KEY propri — vedi la Guida alla configurazione.

Suggerimento. Genera nuovo emette una chiave nuova. Dopo averlo usato, incolla la nuova chiave in bridge.yml, riavvia il bridge, poi premi Aggiorna versione live.

Passaggio 4 — Esegui la procedura guidata di configurazione

Apri C:\ProgramData\SurveyAnalytica in Esplora file, fai clic nella barra degli indirizzi, scrivi cmd sopra il percorso e premi Enter: si apre un Prompt dei comandi (Command Prompt) su quella cartella, e con Ctrl+V ci incolli dentro.

Prima di iniziare: salva in Tally i voucher che hai a metà. La procedura guidata imposta TallyPrime perché apra all’avvio le aziende che hai scelto (tenendo una copia delle tue impostazioni originali come tally.ini.sa-backup) e può riavviare Tally per caricarle.

Prompt dei comandi

sa-tally-bridge.exe init

La procedura guidata stampa === SurveyAnalytica Tally Bridge Setup === e fa una domanda alla volta, ciascuna con la risposta suggerita tra parentesi quadre; Enter la accetta. Usa la procedura guidata per la prima configurazione: ogni volta riparte da un foglio bianco, quindi le modifiche successive falle in bridge.yml con il Blocco note (Notepad), come mostra la Guida alla configurazione.

Le domande, in ordine

Che cosa chiede	Che cosa rispondere
`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 a ciascuna. Cambia la porta solo se nel Passaggio 1 ne è stata presa un’altra, e il percorso dell’eseguibile solo se TallyPrime è installato altrove — il percorso del file ini ne deriva, e la cartella dati arriva dalle impostazioni di Tally.
`Enter company folder numbers comma-separated (or 'all') [all]:`	Sopra, la procedura guidata elenca le cartelle delle aziende presenti sul disco. Scrivi i numeri da sincronizzare, ad esempio `1,3`, oppure Enter per tutte — da qui in avanti Tally le apre da solo.
`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]:`	Chiesto mentre Tally carica. `y` riavvia Tally con la tua selezione, poi aspetta a turni di due minuti finché non chiudi le eventuali schermate Company Login.
`Enter company numbers comma-separated (or 'all') [all]:`	Ora l’elenco è quello che Tally ha aperto; scegli le aziende da sincronizzare. Se non è arrivato nessun elenco, chiede invece `Company name 1:` — scrivi ogni nome come lo scrive Tally, chiudendo con una riga vuota.
`Enter numbers comma-separated (e.g., 1,3,7) [1,3,7]:`	Quali record sincronizzare, dal menu qui sotto, per ogni azienda che hai selezionato.
`Global fallback Webhook URL (used when a transaction has no specific one):` `API key (code) for the global webhook:`	Incolla l’URL : e poi la KEY : del Passaggio 3; tutto quello che non ha un indirizzo proprio arriva qui.
`Webhook URL for sales (empty = global):` `API key (code) for the sales webhook:`	Chiesto per ogni tipo di record. Enter usa l’indirizzo qui sopra; incolla URL e chiave di un altro flusso per mandare lì quel tipo.
`How often should the bridge read Tally? [1/2] [1]:`	Enter per `1`, automatico: la prima sincronizzazione legge tutto il tuo storico, quindi conviene che giri mentre sei al PC. Dopo, passa a un orario notturno in bridge.yml.
`Time of day (24h HH:MM) [21:30]:` `Timezone (IANA name) [Asia/Kolkata]:`	Chiesto solo dopo aver risposto `2`. Scrivi un orario come `21:30`; Enter sulla seconda domanda imposta l’ora indiana.

I tipi di record che propone

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]:

Salva le impostazioni e stampa:

Prompt dei comandi

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

Buono a sapersi. Se la procedura guidata parla di record “dropped”, i record aspettano al sicuro nella coda finché non viene impostata una destinazione.

Passaggio 5 — Invia un test

Il test manda una decina di record recenti di ogni tipo direttamente al flusso, così vedi arrivare i tuoi numeri prima che inizi la sincronizzazione completa. Il segnalibro non si sposta e non viene accodato nulla, quindi la prima esecuzione vera copre comunque tutto il tuo storico.

Prompt dei comandi

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

Un’esecuzione riuscita stampa una riga per ogni azienda e tipo di record, poi una riga di chiusura:

Prompt dei comandi

[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 significa che quell’azienda non ha ancora nulla di quel tipo. Le righe sulle aziende non aperte, o su Tally che non risponde, sono trattate nella tabella qui sotto. webhook delivery FAILED significa che l’indirizzo o la chiave non corrispondono al flusso: ricopiali entrambi dal pannello del trigger.

Adesso insegna al flusso la forma dei dati:

Nel pannello del trigger premi Controlla lo stato: recupera l’ultima cosa arrivata, ed è per questo che il test viene prima.
Verifica che compaia un record di Tally, poi premi Applica. Adesso il flusso conosce i nomi dei campi.

Buono a sapersi. Quando sono arrivati molti record insieme, questo pannello ne mostra una copia accorciata — i nomi dei campi ci sono tutti, ed è tutto ciò che serve al pulsante Applica, mentre le esecuzioni complete inviano tutto.

Passaggio 6 — Attiva, poi esegui la prima sincronizzazione

Costruisci i passaggi che girano su ogni record — la Guida alla configurazione spiega come trasformare i record in azioni.
Premi Attiva e verifica che il flusso mostri Attivo. Attivalo prima di avviare la sincronizzazione, così ogni fattura viene elaborata fin dalla primissima. (Finché non è attivo, il flusso conserva solo un campione di test.)

La prima sincronizzazione è quella grossa: legge in un’unica esecuzione tutto lo storico di ogni azienda e tipo di record, a circa 5.000 record al minuto, quindi un’azienda con 100.000 voucher in archivio richiede una ventina di minuti. Falla stando al PC, nella modalità automatica del Passaggio 4.

Prompt dei comandi

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

La finestra stampa Bridge running... (Press Ctrl+C to stop) e riporta ogni ciclo; lasciala aperta. In un secondo Prompt dei comandi, chiedi come sta andando:

Prompt dei comandi

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

Il report viene scritto quando finisce un giro completo su Tally, quindi finché il primo non è concluso status risponde no status yet. Aspetta nella prima finestra una riga che inizia con Cycle, poi richiedi lo stato.

Che cosa stampa

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)

Quello che aspetti è una riga ok con up_to_date per ogni azienda e tipo di record, con outbox depth 0 e nessuna riga Pending. Quello che è ancora in lavorazione compare sotto Pending con il suo motivo: company_closed significa che quell’azienda non è aperta in Tally — aprila e viene ripresa in pochi minuti.

Intanto controlla il flusso: i record dovrebbero arrivare e i tuoi passaggi girare. Quando ogni azienda e tipo di record segna up_to_date, premi Ctrl+C. Per passare a un orario notturno, apri bridge.yml nel Blocco note e riavvia il bridge, come mostra la Guida alla configurazione.

Passaggio 7 — Fai in modo che parta da solo

Registra il bridge in Windows perché parta a ogni tuo accesso, puntando al file senza finestra così da non lasciare nessuna finestra sul desktop.

Prompt dei comandi

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

Controlla le tue impostazioni, segnala che cosa manca, poi conferma l’attività pianificata:

Prompt dei comandi

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

Qui sopra i percorsi completi sono abbreviati. after PT1M significa che parte circa un minuto dopo l’accesso, dando a Tally il tempo di caricarsi, e task status conferma la registrazione in qualsiasi momento. Il bridge gira nella tua sessione di Windows, accanto a Tally; per un PC a cui non siede nessuno, attiva l’accesso automatico di Windows e dopo un riavvio torna su da solo.

Avvialo adesso. L’attività pianificata prende il comando al tuo prossimo accesso, quindi dagli tu il primo avvio — sono gli stessi tre clic che userai dopo ogni modifica alle impostazioni.

Avviare e riavviare il bridge

Il bridge legge bridge.yml all’avvio, quindi una modifica ha effetto al successivo avvio — e questi tre clic gli danno proprio quell’avvio:

Apri l’Utilità di pianificazione (Task Scheduler) di Windows e vai su Libreria Utilità di pianificazione → SurveyAnalytica → Tally Bridge.
Se è in esecuzione, fai clic con il pulsante destro sull’attività e scegli Termina (End).
Fai di nuovo clic con il pulsante destro e scegli Esegui (Run).

Disconnettersi e rientrare ha lo stesso effetto; un minuto o due dopo, status riporta un’esecuzione conclusa.

Aggiornamento a una versione più recente

Ferma il bridge: nell’Utilità di pianificazione, fai clic con il pulsante destro sull’attività e scegli Termina.
Scarica il nuovo .zip e sostituisci i due file del programma, mantenendo gli stessi nomi.
Fai di nuovo clic con il pulsante destro sull’attività e scegli Esegui.

Le tue impostazioni, la coda e la memoria di quello che è già stato inviato stanno accanto al programma e restano come sono. version riporta la versione installata; status riporta quella che ha prodotto l’ultima esecuzione. Dopo aver spostato la cartella, esegui di nuovo task install.

Rimuovere il bridge

Esegui sa-tally-bridge.exe task uninstall. Risponde Scheduled task removed.
Termina l’attività nell’Utilità di pianificazione se è ancora in esecuzione.
Elimina la cartella — oppure tienila se pensi di reinstallare, perché conserva la memoria di quello che è stato inviato; una cartella nuova riparte dall’inizio dello storico.
Per rimettere l’elenco di apertura automatica che Tally aveva prima, copia tally.ini.sa-backup su tally.ini.

Se qualcosa richiede attenzione

Che cosa vedi	Che cosa significa	Che cosa fare
Windows ha protetto il PC (Windows protected your PC), oppure il file sparisce dopo il download	Windows e alcuni antivirus sono prudenti con i download nuovi.	Fai clic su Ulteriori informazioni (More info), poi su Esegui comunque (Run anyway). Se l’antivirus ha preso il file, ripristinalo dalla quarantena e consenti la cartella.
Il test stampa `could not reach Tally's gateway` oppure `Tally answered but has no companies open`; oppure `status` mostra `Blocked : gateway_error` o `gateway_empty`	Tally è chiuso, davanti c’è una schermata di login in attesa, oppure Tally sta condividendo i suoi dati su un’altra porta. (`gateway` è la parola che il bridge usa per quella connessione sulla porta 9000.)	Guarda la finestra di Tally, accedi dove te lo chiede, lascia le aziende aperte. Se sono già aperte, ricontrolla il Passaggio 1: premi `F1` (Help), apri About e verifica che la porta corrisponda a quella data alla procedura guidata.
La procedura guidata ha stampato `Warning: could not update ... tally.ini`	Quel file si trova nella cartella di programma di TallyPrime, che gli account normali possono solo leggere, quindi l’elenco di apertura automatica è rimasto com’era.	Apri tu le aziende prima che il bridge giri, oppure esegui di nuovo `init` da un Prompt dei comandi aperto con Esegui come amministratore (Run as administrator).
Dopo un riavvio non si sincronizza nulla	L’attività pianificata gira quando quell’account Windows ha fatto l’accesso.	Accedi e apri Tally con le sue aziende; il bridge riprende circa un minuto dopo. Per un PC non presidiato, usa l’accesso automatico.
`task install` segnala `SCHED_S_SOME_TRIGGERS_FAILED`	È stata registrata per un account diverso da quello interattivo di questa macchina.	Il messaggio indica l’account: accedi con quello che usa Tally ed esegui lì `task install`.
Funzionava, poi si è fermato, e il log ripete `Webhook returned HTTP 401`	La chiave è stata cambiata con Genera nuovo e il flusso è stato ripubblicato, quindi si aspetta la chiave nuova.	Copia la nuova KEY : in bridge.yml e riavvia il bridge; i record in coda partono appena corrisponde.
Facendo doppio clic su sa-tally-bridgew.exe compare SurveyAnalytica Tally Bridge — wrong executable	Quella è la copia senza finestra che usa l’attività pianificata.	Scrivi invece i comandi in sa-tally-bridge.exe.

Il bridge tiene il suo log, sa-tally-bridge.log, accanto al file delle impostazioni: testo semplice, le righe più recenti in fondo.

Come proseguire

Il bridge è installato, testato e si avvia da solo. Adesso: quali aziende e tipi di record invia, dove va ciascuno e che cosa ne fa il tuo flusso — Connettore Tally Prime — Guida alla configurazione.