Интеграция с FuelUp

Версия 3.1 от Ярослава Ерина на 2024/11/27 11:13

Важно!

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

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

В браузере GoogleChrome

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

1730119808080-110.png

1730119902774-575.png

2* . Зарегистрируйтесь на сайте и активируйте аккаунт по ссылке с электронной почты

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-20-22.png?version=1&modificationDate=1716441220000&api=v2

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_16-19-29.png?version=1&modificationDate=1716441230000&api=v2

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

1732705702265-981.png

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

  1. Кликните на строку с АЗС
  2. Введите новый код
  3. Нажмите кнопку "Сохранить"

1732705769727-389.png

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_16-36-38.png?version=1&modificationDate=1716441279000&api=v2

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

В "Топаз АЗС"

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

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-1-13.png?version=1&modificationDate=1716441296000&api=v2

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-3-0.png?version=1&modificationDate=1716441316000&api=v2

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

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-7-26.png?version=1&modificationDate=1716441333000&api=v2

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

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-10-37.png?version=1&modificationDate=1716441349000&api=v2

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

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-13-12.png?version=1&modificationDate=1716441360000&api=v2

В "Топаз АЗС"

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

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-16-43.png?version=1&modificationDate=1716441369000&api=v2

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-6_8-37-31.png?version=1&modificationDate=1716441382000&api=v2

17. Создайте вид оплаты "Регистрация внешних заказов", назовите его "FuelUp (физ.лица)"

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-8_16-13-45.png?version=1&modificationDate=1716441400000&api=v2

18. Создайте ещё один вид оплаты "Регистрация внешних заказов", назовите его " FuelUp(юр.лица) ".

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


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

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-8_16-21-42.png?version=1&modificationDate=1716441415000&api=v2

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-8_16-38-33.png?version=1&modificationDate=1716441423000&api=v2

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


    • Закройте ТопазАЗС
    • Откройте файл <Путь до ТопазАЗС>/Ini/localsettings.ini
      https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-6_9-21-18.png?version=1&modificationDate=1716441443000&api=v2
    • Добавьте в секцию [Pumps] следующие строки
  1. IsAutoCancel=1

    AutoCancelTimeout=30

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-6_9-23-32.png?version=1&modificationDate=1716441458000&api=v2

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

 

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

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

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-6_15-51-51.png?version=1&modificationDate=1716441478000&api=v2

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-6_9-46-30.png?version=1&modificationDate=1716441498000&api=v2

24. Зайдите на вкладку "Настройки" -> "Подписки"

25. Перейдите в раздел "Подписки", выберите вашу АЗС и в столбце FuelUP установите желаемый период

https://wiki.topazelectro.ru/download/attachments/1180166/image2022-4-25_8-47-33.png?version=1&modificationDate=1716441508000&api=v2

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

27. Перейдите в пункт меню "FuelUp"

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

29. В поля “Физические лица” и “Юридические лица” введите соответствующие коды видов оплаты с АЗС (п.19).

(в случае, если в Web Офис не заполнены коды, на АЗС будет использоваться вид оплаты с кодом 98)

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-8_16-44-23.png?version=1&modificationDate=1716441543000&api=v2

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

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-8_16-55-31.png?version=1&modificationDate=1716441566000&api=v2

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

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

https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-8_16-57-32.png?version=1&modificationDate=1716441583000&api=v2

 

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

34. Как только FuelUP установит номер АЗС в своей системе, попытайтесь сделать тестовый налив через мобильное приложение.