Интеграции

Версия 2.1 от Ярослава Ерина на 2024/07/17 12:17

Важно!

Перед настройкой Топаз-АЗС необходимо обновить ее до версии 3.15.16.9006 или выше. Последнюю актуальную версию можно запросить в техподдержке или скачать на сайте topazelectro в разделе Документация.

Пункты, отмеченные звёздочкой ( * ), необходимо выполнять только в том случае, если Вы впервые регистрируетесь на сайте topazoffice.ru и впервые настраиваете интеграцию Топаз-АЗС с сервисами внешних наливов, доступными по подписке. Если у Вас уже есть активные подписки, убедитесь в правильной настройке отмеченных пунктов.

В браузере GoogleChrome

1* . Зайдите на сайт https://topazoffice.ru/

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-51-48.png?version=1&modificationDate=1716375108000&api=v2

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-51-57.png?version=1&modificationDate=1716375117000&api=v22* . Зарегистрируйтесь на сайте и активируйте аккаунт по ссылке с электронной почты

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-53-11.png?version=1&modificationDate=1716375191000&api=v2

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-53-21.png?version=1&modificationDate=1716375201000&api=v2

3* . Зайдите на вкладку "АЗС"

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-53-31.png?version=1&modificationDate=1716375211000&api=v2

4* . Если хотите переименовать АЗС

  1.     Кликните на строку с АЗС
  2.     Введите новый код
  3.     Нажмите кнопку "Сохранить"
    https://wiki.topazelectro.ru/download/thumbnails/1179743/image2024-5-22_13-54-0.png?version=1&modificationDate=1716375240000&api=v2

5* . Пройдите по пути “Профиль компании” -> “Настройки АЗС”

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-54-11.png?version=1&modificationDate=1716375251000&api=v2

6* . В разделе введите “Адрес”, “Широту” и “Долготу”. Нажмите кнопку “Сохранить”

В "Топаз АЗС"

7. Закрыть смену и закрыть программу "Топаз АЗС"

8. Запустить скрипт backupBeforeSync.cmd в корневом каталоге и дождаться его завершения

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-54-31.png?version=1&modificationDate=1716375271000&api=v2

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-54-38.png?version=1&modificationDate=1716375278000&api=v2

9. Запустите "Топаз АЗС" и зайдите в режим "Настройки"

10* . Зайдите в меню "WebOffice" -> "Регистрация"

https://wiki.topazelectro.ru/download/thumbnails/1179743/image2024-5-22_13-54-55.png?version=1&modificationDate=1716375295000&api=v2

На сайте https://topazoffice.ru/

11* . На вкладке "АЗС" выберите АЗС с помощью галки в первой колонке

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-55-10.png?version=1&modificationDate=1716375310000&api=v2

12* . Нажмите кнопку "Сгенерировать код регистрации"

13* . В появившемся окне скопируйте код

 https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-55-22.png?version=1&modificationDate=1716375322000&api=v2

 

В "Топаз АЗС"

14* . Вставьте код из окна с сайта https://topazoffice.ru/ в поле "Код регистрации" в меню "WebOffice" -> “Регистрация”

15* . Нажмите кнопку "Зарегистрировать" и дождитесь появления окна с текстом "Регистрация прошла успешно"

https://wiki.topazelectro.ru/download/thumbnails/1179743/image2024-5-22_13-55-32.png?version=1&modificationDate=1716375332000&api=v2

16* . Создайте экземпляр менеджера оборудования "Прочие устройства" -> "WebOfficeActiveDevice" и, по желанию, назовите его "Внешние наливы"

https://wiki.topazelectro.ru/download/thumbnails/1179743/image2024-5-22_13-55-41.png?version=1&modificationDate=1716375341000&api=v2

17. Создайте вид оплаты "Регистрация внешних заказов", назовите его по Вашему усмотрению

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-55-54.png?version=1&modificationDate=1716375354000&api=v2

18. Для данного вида оплаты установить следующие параметры

  • Печать чека на фискальном регистраторе: “<Не выбран>”
  • Печать квитанции на принтере: “<Не выбран>”
  • Регистрация в базе данных: “Безналичный расчет”
  • Внешний код - введите любое числовое значение, уникальное для каждого из видов оплаты

Нажмите кнопку Изменить для сохранения параметров

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-56-15.png?version=1&modificationDate=1716375375000&api=v2

19. Убедитесь, что в видах нефтепродуктов каждый вид топлива имеет уникальный внешний код (столбец “Код” в настройках видов топлива, кодом может быть любое числовое значение ). Внешние коды топлива должны быть числовыми

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-56-23.png?version=1&modificationDate=1716375383000&api=v2

20* . Если Вы хотите, чтобы частично налитые заказы автоматически зарывались после того как был повешен кран, то:

  • Закройте ТопазАЗС
  • Откройте файл <Путь до ТопазАЗС>/Ini/localsettings.ini
  • Добавьте в секцию [Pumps] следующие строки
     IsAutoCancel=1
    AutoCancelTimeout=30

Где 30 - время ожидания от момента перехода в состояние остановки в секундах

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-5.png?version=1&modificationDate=1716375425000&api=v2

21. Откройте смену

На сайте https://topazoffice.ru/

22* . Зайдите на вкладку  "Профиль компании" -> “Настройка компании ”, в секции “Реквизиты” заполните поля “ИНН”, “БИК”, “Номер банковского счета”, “Почтовый адрес” и нажмите кнопку “Сохранить”.

(поле Почтовый адрес  используется для отправки бухгалтерских документов).

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-17.png?version=1&modificationDate=1716375437000&api=v223. Зайдите на вкладку "Подписки"

24. В таблице "Ваши подписки на плагины" в колонке названием Вашей внешней интеграции выберите подписку на интересующий Вас срок

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-43.png?version=1&modificationDate=1716375463000&api=v2

25. Нажмите кнопку "Сохранить" в нижнем правом углу таблицы. Цена на интеграцию составляет 600 руб/АЗС/мес

26. Перейдите в пункт меню " Внешние наливы " - > "Название необходимой внешней интеграции"

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-51.png?version=1&modificationDate=1716375471000&api=v2

27. В блоке “Настройки компании” введите апикей Вашей сети АЗС, который Вам выдал интегратор

28. Нажмите на кнопку "+" под блоком "Настройки компании" и добавьте вид оплаты для внешнего налива. В поле "Тип заказа" введите значение "contractId", полученный от интегратора, а в поле "код вида оплаты",

внешний код из п.18

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-59.png?version=1&modificationDate=1716375479000&api=v2

 

29. Нажмите кнопку “Сохранить” под блоком “Настройки компании”

30. В блоке “Настройки АЗС” выберите необходимую АЗС.

Убедитесь, что появившейся таблице виды топлива, цены и внешние коды совпадают с указанными на АЗС (п.19)

31. Настройте последний столбец таблицы в соответствии с видами топлива интегратора.

Нажмите кнопку сохранить под блоком  “Настройки АЗС”

https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-58-7.png?version=1&modificationDate=1716375487000&api=v2

 

32. Сообщите интегратору, что настройка со стороны WEB Офиса завершена. Если настройка была произведена корректно, то интегратор должен увидеть конфигурацитю Ваших АЗС (ид АЗС, виды топлива и цены).