В этом руководстве предполагается, что коннектор уже установлен. Если это не так, сначала ознакомьтесь с руководством по установке.

Открытие экрана настройки

В меню Gateway of Tally выберите SurveyAnalytica Connector. Экран настройки состоит из двух разделов: Global Settings сверху и таблицы Transaction Types ниже.

Шаг 1 — выберите среду

В верхней части экрана используйте раскрывающийся список Environment, чтобы выбрать:

• Test — отправляет данные в тестовую (staging) среду SurveyAnalytica. Используйте её при настройке и тестировании.
• Production — отправляет данные в вашу рабочую учётную запись SurveyAnalytica. Переключитесь на неё после завершения тестирования.

Шаг 2 — получите Webhook URL и API-ключ в SurveyAnalytica

1. В SurveyAnalytica откройте workflow, который должен получать данные из Tally.
2. Нажмите на шаг Trigger и убедитесь, что тип триггера установлен как Webhook.
3. Запишите значение KEY — это ваш API-ключ для коннектора.
4. Запишите Workflow ID — это уникальный идентификатор, указанный в URL webhook после /webhook/.

Шаг 3 — настройте типы транзакций

Таблица Transaction Types перечисляет все типы ваучеров и мастер-записи, доступные в вашей компании Tally, включая любые пользовательские типы, добавленные другими модулями TDL.

Для каждого типа транзакций, который нужно синхронизировать:

1. Установите Enable в значение Yes.
2. Введите Workflow ID из SurveyAnalytica (часть после /webhook/ в URL вашего webhook).
3. Введите API Key (значение KEY из панели триггера).
4. Выберите Auth Type:
   • API Key — стандартный вариант для большинства workflow.
   • Basic Auth — используйте имя пользователя и пароль, разделённые двоеточием, в поле API Key.
   • OAuth 2.0 — введите учётные данные вашего OAuth-клиента; коннектор автоматически получает и обновляет токены.
   • HMAC-SHA256 — генерирует подпись запроса для повышенной безопасности.
5. Выберите Trigger Mode:
   • Realtime — отправляет данные немедленно при каждом сохранении ваучера этого типа.
   • Batch — собирает ваучеры и отправляет их вместе с заданным интервалом (5, 15, 30 или 60 минут). Используйте этот режим, чтобы снизить сетевую нагрузку для типов транзакций с высоким объёмом.
   • Scheduled — выполняет полную синхронизацию ежедневно, еженедельно или ежемесячно в указанное вами время. Подходит для отчётов на конец дня.
   • One-time — используйте кнопку Sync Now в меню коннектора для разовых экспортов.

Вы можете настроить разные Workflow ID, Auth Type и Trigger Mode для каждого типа транзакций независимо.

Шаг 4 — сохраните настройки

Нажмите Ctrl+A или кнопку Save Config. Ваши настройки сохраняются внутри Tally и сохраняются после перезапуска.

Шаг 5 — проверьте соединение

1. В меню Gateway of Tally → SurveyAnalytica Connector выберите Test Connection.
2. Коннектор отправляет тестовый пинг на каждый включённый workflow и показывает сообщение об успехе или неудаче для каждого типа транзакций.
3. В SurveyAnalytica перейдите к триггеру workflow и нажмите Check Status, чтобы убедиться, что тестовые данные были получены.

Отправка тестового ваучера

Сохраните любой ваучер включённого типа в Tally (например, создайте тестовый Sales Voucher). Если режим триггера — Realtime, данные появятся в вашем workflow SurveyAnalytica в течение нескольких секунд. Их можно увидеть на панели Check Status workflow’а в панели триггера.

Устранение неполадок

Данные не поступают в SurveyAnalytica

• Убедитесь, что workflow находится в состоянии Active в SurveyAnalytica.
• Проверьте правильность введённых Workflow ID и API Key — копируйте и вставляйте их, а не вводите вручную.
• Убедитесь, что в коннекторе выбрана правильная среда (Test или Production).
• При использовании режима Batch дождитесь истечения интервала либо временно переключитесь на Realtime, чтобы убедиться, что соединение работает.

Меню SurveyAnalytica Connector отсутствует в Gateway of Tally

• Убедитесь, что файл TDL указан и включён в разделе F12 → TDL & Add-On.
• Проверьте наличие ошибок загрузки TDL через Help → TDL & Add-On.
• Убедитесь, что версия вашего Tally Prime — 7.0 или новее.

Test Connection показывает ошибку

• Убедитесь, что ваш компьютер с Tally имеет доступ в интернет и может обращаться к integration.surveyanalytica.com (Production) или к тестовому URL.
• Если в вашей компании используется прокси или межсетевой экран, попросите ИТ-отдел разрешить исходящий HTTPS-трафик к этим доменам.