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

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

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