Tally Bridge चालू रहने पर, TallyPrime में आप जो भी बिक्री इनवॉइस सेव करते हैं वह कुछ ही मिनटों में आपके ग्राहक तक पहुँच सकता है: WhatsApp या ईमेल पर आपकी ब्रांडिंग वाली PDF के साथ, या लिंक ले जाने वाले SMS के रूप में। यही रिकॉर्ड आपकी ग्राहक और सप्लायर सूचियों को अपडेट रखते हैं, आपकी बिक्री, खरीद और स्टॉक के आँकड़े आपके डैशबोर्ड तक पहुँचाते हैं, जिन ग्राहकों पर अब भी बकाया है उनका फ़ॉलो-अप चलाते हैं, और आपके अपने ब्रांड वाले पोर्टल को भरते हैं, जहाँ हर ग्राहक अपने इनवॉइस और अपने खाते का बकाया देखता है। यह गाइड वही जगह है जहाँ आप यह सब तय करते हैं: कौन-सी कंपनियाँ और Tally के किस तरह के रिकॉर्ड — बिक्री इनवॉइस, खरीद बिल, ग्राहक, सप्लायर, बैंक खाते, स्टॉक आइटम — शेयर हों, हर एक कहाँ जाए, ब्रिज कितनी-कितनी देर में देखे, और आपका फ़्लो (वर्कफ़्लो), यानी SurveyAnalytica में आपका बनाया ऑटोमेशन, उनके साथ क्या करे। अगर ब्रिज अभी PC पर नहीं है, तो Tally Prime कनेक्टर — इंस्टॉलेशन गाइड देखें।

सेटिंग्स कहाँ रहती हैं

यह सब एक ही टेक्स्ट फ़ाइल में रहता है — bridge.yml, जो sa-tally-bridge.exe के बगल में होती है, आम तौर पर C:\ProgramData\SurveyAnalytica में। उस पर राइट-क्लिक करें, Open with (किससे खोलें) चुनें, फिर Notepad चुनें। यह YAML में लिखी सादा टेक्स्ट फ़ाइल है, जिसमें इंडेंटेशन यानी लाइन की शुरुआत में छोड़ी गई जगह का अपना अर्थ होता है।

bridge.yml वाले फ़ोल्डर में, File Explorer के एड्रेस बार में क्लिक करें, cmd टाइप करें, Enter दबाएँ, फिर sa-tally-bridge.exe run --config bridge.yml चलाएँ। अगर वह अपना शेड्यूल प्रिंट करके चलता रहे, तो फ़ाइल ठीक है: Ctrl+C दबाएँ, फिर ब्रिज को रीस्टार्ट करें।

बदलाव कैसे लागू करें

ब्रिज bridge.yml को शुरू होते समय पढ़ता है, इसलिए सेव किया गया बदलाव अगली बार शुरू होने पर लागू होता है। अगर वह अब भी किसी Command Prompt विंडो में चल रहा है, तो वहीं Ctrl+C दबाएँ और उसे दोबारा चलाएँ। जब वह अपने आप शुरू होने लगे (इंस्टॉलेशन गाइड का चरण 7), तो उसे Windows Task Scheduler से रीस्टार्ट करें: Task Scheduler Library → SurveyAnalytica → Tally Bridge खोलें, टास्क पर राइट-क्लिक करके End चुनें, फिर दोबारा राइट-क्लिक करके चलाएँ चुनें। साइन आउट करके दोबारा साइन इन करने से भी यही होता है: टास्क लॉगऑन पर शुरू हो जाता है।

विज़ार्ड, या Notepad

पहली बार के सेटअप के लिए विज़ार्ड, यानी sa-tally-bridge.exe init, का इस्तेमाल करें। वह हर बार ख़ाली शीट से शुरू करता है, इसलिए बाद के बदलाव Notepad में करें। हर कंपनी को एक ही key के नीचे रखें — वही नाम जो विज़ार्ड ने लिखा, या उसका फ़ोल्डर नंबर — और वह key वैसी ही रहने दें: यहीं ब्रिज उस कंपनी की जगह संभालकर रखता है, इसलिए हर रन सिर्फ़ नया हिस्सा पढ़ता है और हर रिकॉर्ड एक ही बार पहुँचता है।

कंपनियाँ और रिकॉर्ड के प्रकार

companies: ब्लॉक में सिंक होने वाली कंपनियाँ लिखी जाती हैं, हर कंपनी की एक एंट्री, ताकि एक ही Tally PC से कई कंपनियाँ या शाखाएँ चल सकें। हर एक की एक key आपकी पसंद की होती है, जो हर रिकॉर्ड के साथ companyCode के रूप में पहुँचती है; एक name, वैसा ही लिखा जैसा Tally में लिखा है; और एक transactions: ब्लॉक, जिसमें पढ़े जाने वाले रिकॉर्ड के प्रकार बताए जाते हैं।

bridge.yml — companies: ब्लॉक

companies:
  "010001":
    name: "Acme Traders"
    transactions:
      sales: {}
      purchase: {}
      ledgers/debtors: {}
      stockItems: {}

  "010002":
    name: "Globex Industries"
    transactions:
      sales: {}
      ledgers/debtors: {}

यहाँ दिया हर उदाहरण उसी एक फ़ाइल का हिस्सा है: global: और companies: एक-एक बार ही आते हैं, इसलिए सिर्फ़ वही लाइनें जोड़ें जो आपके पास नहीं हैं, उसी इंडेंटेशन पर। ख़ाली ब्रेसेस जान-बूझकर हैं: रिकॉर्ड के किसी प्रकार को सेटिंग्स तभी चाहिए जब उसका अपना गंतव्य हो, और वही अगले सेक्शन में है। ये सात प्रकार, जिन्हें स्ट्रीम कहा जाता है:

ग्राहक और सप्लायर रिकॉर्ड में पार्टी का वही विवरण जाता है जो Tally में रखा है — mailing name, ईमेल, फ़ोन, मोबाइल, GSTIN, आयकर नंबर, पता और क्लोजिंग बैलेंस — जिससे संपर्क सूची बिना दोबारा टाइप किए अपडेट रहती है। बिक्री और खरीद रिकॉर्ड पूरा वाउचर ले जाते हैं: हेडर, स्टॉक लाइनें, लेजर और टैक्स लाइनें, narration, और GST e-invoice का विवरण (IRN, acknowledgement नंबर और तारीख़) जब Tally के पास हो।

कनेक्टर किन चीज़ों को कवर करता है

बिक्री इनवॉइस और खरीद बिल, आपके अपने वाउचर टाइप सहित; ग्राहक, सप्लायर, बैंक खाते और, अगर आप चाहें तो, खातों की पूरी सूची; स्टॉक आइटम। बाक़ी वाउचर टाइप — receipts, payments, contra, journals, credit और debit notes, orders और delivery notes — फ़िलहाल कनेक्टर के दायरे से बाहर हैं।

कौन-सा रिकॉर्ड कहाँ जाता है

हर रिकॉर्ड ऐसे फ़्लो में जाता है जिसका ट्रिगर वेबहुक है — वही जो आपने इंस्टॉलेशन गाइड के चरण 3 में बनाया था, और उतने ही और भी जितने आप चाहें, हर एक उसी तरह बनाया हुआ। वही पैनल वे दो वैल्यू दिखाता है जिन्हें आप bridge.yml में कॉपी करते हैं: URL : और KEY : लिखी पंक्तियाँ, हर एक के साथ कॉपी बटन। URL वाली लाइन का नाम इस बात से तय होता है कि वह कहाँ लिखी है: global: के नीचे, किसी कंपनी के नीचे और रिकॉर्ड के किसी प्रकार के नीचे webhook_url; transaction_webhooks: और heartbeat: के अंदर url, और उसके बगल में KEY api_key के रूप में। नीचे दिए उदाहरण से ढाँचा कॉपी करें और वही नाम लिखें जो उस स्तर का है जिसे आप बदल रहे हैं — ब्रिज इसी वर्तनी को पढ़ता है। जिन रिकॉर्ड का गंतव्य अभी तय नहीं है, वे तय होने तक कतार में सुरक्षित रहते हैं।

सब कुछ एक ही फ़्लो में भेजें, या किसी कंपनी या रिकॉर्ड के किसी प्रकार को उसका अपना फ़्लो दें।

bridge.yml — global: और companies: ब्लॉक के हिस्से

global:
  webhook_url: "PASTE-THE-URL-FROM-THE-TRIGGER-PANEL"
  api_key: "PASTE-THE-KEY-FROM-THE-TRIGGER-PANEL"

  transaction_webhooks:
    sales:
      url: "PASTE-THE-SALES-FLOW-URL"
      api_key: "PASTE-THE-SALES-FLOW-KEY"
    ledgers/debtors:
      url: "PASTE-THE-CONTACTS-FLOW-URL"
      api_key: "PASTE-THE-CONTACTS-FLOW-KEY"

companies:
  "010002":
    name: "Globex Industries"
    webhook_url: "PASTE-THE-GLOBEX-FLOW-URL"
    api_key: "PASTE-THE-GLOBEX-FLOW-KEY"
    transactions:
      sales: {}

कौन-सा गंतव्य चुना जाता है

रिकॉर्ड समूहों में जाते हैं — एक समूह में एक कंपनी और रिकॉर्ड का एक प्रकार। हर समूह के लिए ब्रिज पहला भरा हुआ गंतव्य लेता है: यह कंपनी और रिकॉर्ड का यह प्रकार, फिर यह कंपनी, फिर रिकॉर्ड का यह प्रकार, फिर global फ़ॉलबैक। KEY उसी URL के साथ जाती है जिसके बगल में वह लिखी गई थी, इसलिए हर फ़्लो तक उसकी अपनी KEY से पहुँचा जाता है।

नई KEY जारी करना

ऑटोमैटिक या शेड्यूल्ड सिंक

ब्रिज Tally को या तो अपने आप, हर कुछ मिनट में पढ़ता है, या शेड्यूल पर, आपके चुने हुए समय पर — यह global के नीचे sync ब्लॉक में तय होता है। sync ब्लॉक न हो तो यह ऑटोमैटिक रहता है, हर पाँच मिनट में।

bridge.yml — global: ब्लॉक के अंदर, ऑटोमैटिक

global:
  sync:
    mode: interval
    every: 5m

bridge.yml — global: ब्लॉक के अंदर, शेड्यूल्ड

global:
  sync:
    mode: cron
    cron: "30 21 * * *"
    timezone: "Asia/Kolkata"

sync ब्लॉक की हर सेटिंग

cron के उदाहरण

पाँच हिस्से लिखें, छह नहीं: शुरू में सेकंड का हिस्सा जोड़ने से "0 30 21 * * *" का अर्थ बदलकर हर घंटे के 30वें मिनट पर हो जाएगा। ब्रिज शुरू होने से पहले इस expression की जाँच करता है और Command Prompt विंडो में global.sync.cron must have exactly 5 fields (minute hour day-of-month month day-of-week), got 6 in "0 30 21 * * *" प्रिंट करता है — इसलिए नया शेड्यूल ऊपर बताए तरीक़े से ख़ुद जाँच लें।

दोबारा कोशिश और कैच-अप

शेड्यूल किया हर समय एक साइकल शुरू करता है। अगर कोई कंपनी तैयार न हो — उसका लॉगिन प्रॉम्प्ट अब भी डेस्कटॉप पर हो, या Tally ने अभी जवाब देना शुरू न किया हो — तो ब्रिज उसे सूची में बनाए रखता है और हर retry_every पर दोबारा कोशिश करता है, डिफ़ॉल्ट रूप से पंद्रह मिनट में एक बार, जब तक वह सफल न हो जाए या अगला शेड्यूल किया समय न आ जाए: अगली सुबह 09:40 पर खोली गई कंपनी 09:40 पर ही सिंक हो जाती है।

अगर किसी शेड्यूल किए समय पर PC बंद था, तो एक ही कैच-अप रन उस अंतर को पूरा कर देता है: तीन छूटी हुई रातों के लिए भी एक ही रन, क्योंकि ब्रिज पिछली बार देखने के बाद से बदला हुआ सब कुछ माँगता है। शेड्यूल्ड मोड में रीस्टार्ट करने से तय समय आगे नहीं खिसकता, वह अपनी जगह ही रहता है; आँकड़े अभी चाहिए हों, तो उस दिन के लिए ऑटोमैटिक मोड पर चले जाएँ।

रिकॉर्ड से नतीजे तक

यहीं Tally के रिकॉर्ड वह बन जाते हैं जो आप चाहते थे: WhatsApp या ईमेल पर आपकी ब्रांडिंग वाली PDF के साथ भेजा गया इनवॉइस, या लिंक ले जाने वाला SMS; Sundry Debtors और Creditors के साथ क़दम मिलाकर चलती ग्राहक और सप्लायर सूचियाँ; Google Sheets या Excel में बिक्री का लाइव रजिस्टर; इनवॉइस जाने के बाद एक फ़ीडबैक सर्वे; आपके चुने हुए दिनों पर रिमाइंडर, जो शेड्यूल किए फ़्लो से उन ग्राहकों की संपर्क सूची पर भेजे जाते हैं जिन पर अब भी बकाया है; डैशबोर्ड और विश्लेषण के लिए आँकड़े; और आपके ब्रांड वाला पोर्टल, जहाँ ग्राहक अपने इनवॉइस और अपने खाते का बकाया देखते हैं।

1. Tally PC पर, ऊपर बताए तरीक़े से उसी फ़ोल्डर में Command Prompt खोलें और sa-tally-bridge.exe test --config bridge.yml चलाएँ। यह हर प्रकार के लगभग दस ताज़ा रिकॉर्ड तुरंत भेज देता है।
2. फ़्लो के Webhook ट्रिगर पैनल में स्थिति जाँचिए (Check Status) दबाएँ। यह आख़िरी आए हुए उदाहरण को एक बार लाता है — इसीलिए टेस्ट पहले चलाया जाता है। उदाहरण बटन के ऊपर दिखता है, बहुत बड़ा हो तो वहाँ छोटा करके दिखता है, जबकि लाइव रन में पूरा डेटा जाता है।
3. लागू करें दबाएँ। उस उदाहरण के फ़ील्ड ही वे फ़ील्ड बन जाते हैं जिन्हें फ़्लो इस्तेमाल कर सकता है।
4. एक स्टेप जोड़ें और उसका घटक प्रकार loop पर सेट करें — सूची में यह छोटे अक्षरों में है।
5. loop स्टेप में Array field to iterate को records पर सेट करें। अब उसके नीचे का सब कुछ हर रिकॉर्ड के लिए एक बार चलता है, हर समूह के लिए एक बार नहीं।
6. अगर नीचे के स्टेप को समूह का अपना विवरण चाहिए — कंपनी का नाम, रिकॉर्ड का प्रकार — तो Include parent fields in each entry चालू करें; यह डिफ़ॉल्ट रूप से बंद रहता है।
7. loop के नीचे के हर स्टेप पर उसका 1. फ़ील्ड कॉन्फ़िगर करें बटन दबाएँ और वे फ़ील्ड चुनें जो वह इस्तेमाल करता है।
8. सक्रिय करें दबाएँ, ताकि पहले ही सिंक से हर इनवॉइस पर कार्रवाई हो।

किन ऐक्शन को loop चाहिए

जहाँ loop ज़रूरी है, वहाँ स्टेप ख़ुद बता देता है और Add Loop बटन दिखाता है।

ब्रिज क्या भेजता है

हर रिक्वेस्ट उन्हीं समूहों में से एक होती है — एक बैच, एक कंपनी और रिकॉर्ड के एक प्रकार का — जो छह फ़ील्ड में लिपटा होता है।

records के अंदर फ़ील्ड के नाम Tally के अपने हैं, बड़े अक्षरों में, और आपके user-defined फ़ील्ड अपने सीधे नामों से ही आते हैं। हर वैल्यू टेक्स्ट होती है, राशि और तारीख़ें भी, और जो फ़ील्ड Tally में ख़ाली है वह उस रिकॉर्ड में शामिल नहीं होता — इसलिए हर स्टेप को उन्हीं फ़ील्ड पर बनाएँ जो आपने चरण 7 में चुने थे।

एक रिक्वेस्ट, संक्षेप में

{
  "companyCode": "010001",
  "companyName": "Acme Traders",
  "transactionType": "sales",
  "batchStart": 0,
  "batchTotal": 312,
  "records": [
    {
      "GUID": "0a1b2c3d-0000-4000-8000-000000000001-00000101",
      "REMOTEID": "0a1b2c3d-0000-4000-8000-000000000001-00000101",
      "DATE": "20250401",
      "VOUCHERNUMBER": "101",
      "VOUCHERTYPENAME": "GST SALES",
      "PARTYLEDGERNAME": "Example Customer Pvt Ltd",
      "AMOUNT": "5900.00",
      "PARTYGSTIN": "29XXXXXXXXXX1Z5",
      "ALLINVENTORYENTRIES": [
        {
          "STOCKITEMNAME": "Sample Item A",
          "BILLEDQTY": "10 Nos.",
          "RATE": "500.00/Nos.",
          "AMOUNT": "5000.00"
        }
      ]
    }
  ]
}

जिस फ़ील्ड पर सब कुछ बनाना है वह GUID है — उस वाउचर या लेजर के लिए Tally की स्थायी पहचान — और उसकी जगह REMOTEID, क्योंकि कुछ वाउचर इसे उसी नाम से रखते हैं। जब कोई इनवॉइस में बदलाव करता है, जब उसका e-invoice विवरण बाद में आता है, या जब कोई जवाब ब्रिज तक नहीं पहुँचता, तो वही रिकॉर्ड उसी पहचान के साथ दोबारा भेजा जाता है। उसी पर मिलान करके अपडेट करें, नया जोड़ने के बजाय: इससे एक इनवॉइस एक ही पंक्ति रहता है — शीट में, डैशबोर्ड में या पोर्टल में।

आपकी जानकारी

कौन-सी कंपनियाँ और रिकॉर्ड के कौन-से प्रकार शेयर हों, यह आप तय करते हैं। उनके लिए पूरा वाउचर या लेजर एन्क्रिप्टेड कनेक्शन पर जाता है: पार्टी और mailing नाम, GSTIN, PAN, डाक पता, ईमेल, फ़ोन और मोबाइल नंबर, आइटम के नाम, दरें, टैक्स की राशि और बैलेंस। ज़्यादातर फ़र्में खातों की पूरी सूची के बजाय ledgers/debtors और ledgers/creditors शेयर करती हैं, जिससे PC से बाहर जाने वाली जानकारी उन्हीं पार्टियों तक सीमित रहती है जिनके साथ आप वास्तव में कारोबार करते हैं।

वैकल्पिक: हर रन के बाद एक स्टेटस रिपोर्ट

रिकॉर्ड तभी जाते हैं जब कुछ बदला हो, इसलिए शांत रात का शांत रहना डिज़ाइन का हिस्सा है। पक्की पुष्टि चाहिए तो स्टेटस रिपोर्ट हर रन के बाद अपने अलग फ़्लो में एक सारांश भेजती है, उसी फ़्लो के URL और KEY के साथ। इसे ख़ुद जोड़ें:

bridge.yml — global: ब्लॉक के अंदर

global:
  heartbeat:
    url: "PASTE-THE-STATUS-FLOW-URL"
    api_key: "PASTE-THE-STATUS-FLOW-KEY"

हर रिपोर्ट में outcome (success, partial या blocked), blockedReason (gateway_error, gateway_empty, no_companies), outboxDepth, recordsEnqueued, pendingStreams, nextFireAt और hostname होते हैं। सबसे काम का अलर्ट: रात वाले शेड्यूल पर, अगर किसी मशीन से 26 घंटे तक कोई रिपोर्ट न आए तो संकेत उठाएँ।

यह जाँचना कि सब चल रहा है

Tally PC पर, ऊपर बताए तरीक़े से उसी फ़ोल्डर में Command Prompt खोलें और यह चलाएँ:

Command Prompt

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

यह क्या प्रिंट करता है

sa-tally-bridge [version] on TALLY-PC
Schedule    : cron "30 21 * * *" (Asia/Kolkata)
Last run    : Sat, 15 Aug 2026 21:30:04 IST → 21:34:11 (partial)
Next run    : Sat, 15 Aug 2026 21:45:04 IST
Records     : 312 enqueued last run; outbox depth 0
Pending     : 1 stream(s) awaiting retry
   - Globex Industries / sales : company_closed
   ok Acme Traders / sales : synced (watermark 260321/260409, 312 records)
   ok Acme Traders / stockItems : up_to_date (watermark 8821/8821, 0 records)

जब पूरा रन ही रुक गया हो, तब Last run और Next run के बीच एक Blocked     : लाइन दिखती है। outbox depth उन बैचों की गिनती है जो अभी डिलीवर होने बाक़ी हैं; 0 वही है जो आप चाहते हैं। watermark 260321/260409 सादे नंबरों में बुकमार्क है: जहाँ तक का चेंज नंबर पढ़ा जा चुका है, फिर कंपनी का अभी का चेंज नंबर — दोनों मिल जाएँ तो सब कुछ आ चुका है। status आख़िरी पूरे हुए रन की जानकारी देता है।

हर स्ट्रीम स्टेटस का क्या अर्थ है

bridge.yml के साथ वाली फ़ाइलें

• tally_outbox.db, साथ में दो और फ़ाइलें — लोकल कतार और यह बुकमार्क कि क्या-क्या भेजा जा चुका है। इसे रहने दें: इसी से हर रिकॉर्ड एक ही बार पहुँचता है।
• bridge-status.json — पिछले रन का नतीजा, वही जो status प्रिंट करता है।
• sa-tally-bridge.log — चलता हुआ लॉग, साथ में पाँच तक पुरानी कॉपियाँ, .1 से .5 तक। सपोर्ट को सबसे पहले यही भेजें।

समस्या निवारण

जानने योग्य बातें

• ब्रिज उसी PC पर चलता है जिस पर TallyPrime है, आपके साइन-इन किए हुए Windows सेशन में: इसी से वह Tally के फ़ोल्डर पढ़ पाता है और ज़रूरत पड़ने पर Tally शुरू कर पाता है।
• फ़्लो बनाते समय sa-tally-bridge.exe test जितनी बार चाहें चलाएँ: यह कोई बुकमार्क आगे नहीं बढ़ाता और जो पहले सिंक हो चुका है उसमें कुछ नहीं बदलता।
• कनेक्शन सिर्फ़ बाहर जाने वाले हैं, इसलिए आने वाले ट्रैफ़िक के लिए कोई फ़ायरवॉल नियम नहीं चाहिए। कंपनी के प्रॉक्सी के पीछे हों, तो जिस Windows खाते पर ब्रिज चलता है उसके लिए HTTPS_PROXY सेट करें — जैसे http://proxy.example.local:8080 — और उसे रीस्टार्ट करें।
• पहला सिंक कंपनी का पूरा इतिहास पढ़ता है, लगभग 5,000 रिकॉर्ड प्रति मिनट की रफ़्तार से, इसलिए जिस कंपनी में 100,000 वाउचर हैं उसमें क़रीब बीस मिनट लगते हैं। इसे सामने बैठकर, ऑटोमैटिक मोड में चलाएँ, और जब रिकॉर्ड का हर प्रकार up_to_date दिखाने लगे तब रात वाले शेड्यूल पर चले जाएँ।
• पासवर्ड से सुरक्षित कंपनियाँ कोई व्यक्ति ही खोलता है, Tally की अपनी लॉगिन स्क्रीन में: ब्रिज Tally का पासवर्ड न कभी माँगता है, न रखता है।

संबंधित

• Tally Prime कनेक्टर — इंस्टॉलेशन गाइड — Tally PC पर ब्रिज, और पहला सिंक।
• फ़्लो और ऑटोमेशन — ट्रिगर, शर्तें और ऐक्शन, जिनमें अनुसूची ट्रिगर भी है, जो फ़ॉलो-अप के लिए आपके ग्राहकों और उनके बकाया की संपर्क सूची पढ़ता है।
• संपर्क सूचियाँ — जहाँ आपके ग्राहक और सप्लायर पहुँचते हैं।
• कनेक्टर्स मार्केटप्लेस — अवलोकन — जहाँ डाउनलोड मिलता है।