Исходный код вики Интеграция с FuelUp

Версия 1.1 от Ярослава Ерина на 2024/07/17 13:29

Скрыть последних авторов
Ярослава Ерина 1.1 1 |=(((
2 == Важно! ==
3
4 Перед настройкой Топаз-АЗС необходимо обновить ее до версии **3.15.16.9006 **или выше. Последнюю актуальную версию можно запросить в техподдержке или [[скачать на сайте topazelectro >>url:http://topazelectro.ru/product/azs/program/topaz_azs/]]в разделе Документация.
5
6 Пункты, отмеченные звёздочкой ( *** **), необходимо выполнять только в том случае, если Вы впервые регистрируетесь на сайте [[topazoffice.ru >>url:http://topazoffice.ru/]]и впервые настраиваете интеграцию Топаз-АЗС с сервисами внешних наливов, доступными по подписке. Если у Вас уже есть активные подписки, убедитесь в правильной настройке отмеченных пунктов.
7 )))
8
9
10 **В браузере GoogleChrome**
11
12 |=(((
13 1* . Зайдите на сайт [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]]
14
15 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_15-59-8.png?version=1&modificationDate=1716441197000&api=v2]]
16
17 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_16-11-21.png?version=1&modificationDate=1716441205000&api=v2]]
18
19 2* . Зарегистрируйтесь на сайте и активируйте аккаунт по ссылке с электронной почты
20
21 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-20-22.png?version=1&modificationDate=1716441220000&api=v2]]
22
23 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_16-19-29.png?version=1&modificationDate=1716441230000&api=v2]]
24
25 3* . Зайдите на вкладку "АЗС"
26
27 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_16-22-12.png?version=1&modificationDate=1716441241000&api=v2]]
28
29 4* . Если хотите переименовать АЗС
30
31 1. Кликните на строку с АЗС
32 1. Введите новый код
33 1. Нажмите кнопку "Сохранить"
34 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_16-30-35.png?version=1&modificationDate=1716441263000&api=v2]]
35
36 5* . Пройдите по пути “Настройки” -> “Настройки АЗС”
37
38 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_16-36-38.png?version=1&modificationDate=1716441279000&api=v2]]
39
40 6* . В разделе введите “Адрес”, “Широту” и “Долготу”. Нажмите кнопку “Сохранить”
41 )))
42
43
44 **В "Топаз АЗС"**
45
46 |=(((
47 7. Закрыть смену и закрыть программу "Топаз АЗС"
48
49 8. Запустить скрипт backupBeforeSync.cmd в корневом каталоге и дождаться его завершения
50
51 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-1-13.png?version=1&modificationDate=1716441296000&api=v2]]
52
53 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-3-0.png?version=1&modificationDate=1716441316000&api=v2]]
54
55 9. Запустите "Топаз АЗС" и зайдите в режим "Настройки"
56
57 10* . Зайдите в меню "WebOffice" -> "Регистрация"
58
59 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-7-26.png?version=1&modificationDate=1716441333000&api=v2]]
60 )))
61
62
63 **На сайте [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]]**
64
65 |=(((
66 11* . На вкладке "АЗС" выберите АЗС с помощью галки в первой колонке
67
68 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-10-37.png?version=1&modificationDate=1716441349000&api=v2]]
69
70 12* . Нажмите кнопку "Сгенерировать код регистрации"
71
72 13* . В появившемся окне скопируйте код
73
74 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-13-12.png?version=1&modificationDate=1716441360000&api=v2]]
75 )))
76
77
78 **В "Топаз АЗС"**
79
80 |=(((
81 14* . Вставьте код из окна с сайта [[https:~~/~~/topazoffice.ru/ >>url:https://topazoffice.ru/]]в поле "Код регистрации" в меню "WebOffice" -> “Регистрация”
82
83 15* . Нажмите кнопку "Зарегистрировать" и дождитесь появления окна с текстом "Регистрация прошла успешно"
84
85 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-3_17-16-43.png?version=1&modificationDate=1716441369000&api=v2]]
86
87 16* . Создайте экземпляр менеджера оборудования "Прочие устройства" -> "WebOfficeActiveDevice" и, по желанию, назовите его "Внешние наливы"
88
89 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-6_8-37-31.png?version=1&modificationDate=1716441382000&api=v2]]
90
91 17. Создайте вид оплаты "Регистрация внешних заказов", назовите его "FuelUp (физ.лица)"
92
93 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-8_16-13-45.png?version=1&modificationDate=1716441400000&api=v2]]
94
95 18. Создайте ещё один вид оплаты "Регистрация внешних заказов", назовите его " FuelUp(юр.лица) ".
96
97 19. Для данных видов оплаты установить следующие параметры
98
99 1.
100 1*. Печать чека на фискальном регистраторе: “<Не выбран>”
101 1*. Печать квитанции на принтере: “<Не выбран>”
102 1*. Регистрация в базе данных: “Безналичный расчет”
103 1*. (((
104 Внешний код - введите числовое значение, уникальное для каждого из видов оплаты
105
106 Нажмите кнопку Изменить для сохранения параметров
107 )))
108
109 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-8_16-21-42.png?version=1&modificationDate=1716441415000&api=v2]]
110
111 20. Убедитесь, что в видах нефтепродуктов каждый вид топлива имеет уникальный внешний код (столбец “Код” в настройках видов топлива). Внешние коды топлива должны быть числовыми
112
113 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-8_16-38-33.png?version=1&modificationDate=1716441423000&api=v2]]
114
115 21* . Если Вы хотите, чтобы частично налитые заказы автоматически зарывались после того как был повешен кран, то:
116
117 1.
118 1*. Закройте ТопазАЗС
119 1*. Откройте файл <Путь до ТопазАЗС>/Ini/localsettings.ini
120 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-6_9-21-18.png?version=1&modificationDate=1716441443000&api=v2]]
121 1*. Добавьте в секцию [Pumps] следующие строки
122 1. (((
123 IsAutoCancel=1
124
125 AutoCancelTimeout=30
126
127 Где 30 - время ожидания от момента перехода в состояние остановки в секундах
128 )))
129
130 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-6_9-23-32.png?version=1&modificationDate=1716441458000&api=v2]]
131
132 22. Откройте смену
133
134
135 )))
136
137
138 **На сайте [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]]**
139
140 |=(((
141 23* . Зайдите на вкладку  "Настройки" -> “Настройка компании ”, в секции “Реквизиты” заполните поля “ИНН”, “БИК”, “Номер банковского счета”, “Почтовый адрес” и нажмите кнопку “Сохранить”.
142
143 (поле Почтовый адрес используется для отправки бухгалтерских документов).
144
145 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-6_15-51-51.png?version=1&modificationDate=1716441478000&api=v2||width="1200"]]
146
147 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-6_9-46-30.png?version=1&modificationDate=1716441498000&api=v2]]
148
149 24. Зайдите на вкладку "Настройки" -> "Подписки"
150
151 25. Перейдите в раздел "Подписки", выберите вашу АЗС и в столбце FuelUP установите желаемый период
152
153 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2022-4-25_8-47-33.png?version=1&modificationDate=1716441508000&api=v2||width="1200"]]
154
155 26. Нажмите кнопку "Продлить на выбранный период" в нижнем правом углу таблицы. Цена на интеграцию составляет 600 руб/АЗС/мес
156
157 27. Перейдите в пункт меню "FuelUp"
158
159 28. В блоке “Настройки компании” введите апикей Вашей сети АЗС, который Вам выдал **FuelUP**
160
161 29. В поля “Физические лица” и “Юридические лица” введите соответствующие коды видов оплаты с АЗС (п.19).
162
163 (в случае, если в Web Офис не заполнены коды, на АЗС будет использоваться вид оплаты с кодом 98)
164
165 30. Нажмите кнопку “Сохранить” под блоком “Настройки компании”
166
167 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-8_16-44-23.png?version=1&modificationDate=1716441543000&api=v2||width="1200"]]
168
169
170 31. В блоке “Настройки АЗС” выберите необходимую АЗС.
171
172 Убедитесь, что появившейся таблице виды топлива, цены и внешние коды совпадают с указанными на АЗС (п.20)
173
174 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-8_16-55-31.png?version=1&modificationDate=1716441566000&api=v2||width="1200"]]
175
176 32. Настройте последний столбец таблицы в соответствии с видами топлива FuelUP.
177
178 Нажмите кнопку сохранить под блоком  “Настройки АЗС”
179
180 [[image:https://wiki.topazelectro.ru/download/attachments/1180166/image2021-12-8_16-57-32.png?version=1&modificationDate=1716441583000&api=v2]]
181 )))
182 |(% colspan="1" %)
183
184 33. Сообщите в **FuelUP **что **настройка со стороны WEB Офиса завершена. **Если настройка была произведена корректно, то **FuelUP **должен увидеть конфигурацию Ваших АЗС (ид АЗС, виды топлива и цены).
185
186 34. Как только **FuelUP **установит номер АЗС в своей системе, попытайтесь сделать тестовый налив через мобильное приложение.