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

Версия 5.1 от Ярослава Ерина на 2024/11/28 07:24

Последние авторы
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 **На сайте [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]]**
59
60
61 )))
62
63 |=(((
64 10* . На вкладке "АЗС" выберите АЗС с помощью галки в первой колонке
65
66 [[image:https://topazoffice.ru/xwiki/bin/download/actyvaciya/WebHome/1732184406508-921.png?rev=1.1||alt="1732184406508-921.png"]]
67
68 11* . Нажмите кнопку "Сгенерировать код регистрации"
69
70 12* . В появившемся окне скопируйте код
71
72 [[image:https://topazoffice.ru/xwiki/bin/download/actyvaciya/WebHome/1732184457004-353.png?rev=1.1||alt="1732184457004-353.png"]]
73 )))
74
75 **В "Топаз АЗС"**
76
77 |=(((
78 13* . Вставьте код из окна с сайта [[https:~~/~~/topazoffice.ru/ >>url:https://topazoffice.ru/]]в поле "Код регистрации" в меню "WebOffice" -> “Код регистрации”
79
80 [[image:https://topazoffice.ru/xwiki/bin/download/actyvaciya/WebHome/1732184518186-631.png?rev=1.1||alt="1732184518186-631.png"]]
81
82 14* . Нажмите кнопку "Отправить" и дождитесь появления сообщения: "Регистрация выполнена, Активирована."
83
84 [[image:https://topazoffice.ru/xwiki/bin/download/actyvaciya/WebHome/1732185025975-793.png?rev=1.1||alt="1732185025975-793.png"]]
85
86 15* . Создайте экземпляр менеджера оборудования "Прочие устройства" -> "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 16. Создайте вид оплаты "Регистрация внешних заказов", назовите его "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 17. Создайте ещё один вид оплаты "Регистрация внешних заказов", назовите его " FuelUp(юр.лица) ".
95
96 18. Для данных видов оплаты установить следующие параметры
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 19. Убедитесь, что в видах нефтепродуктов каждый вид топлива имеет уникальный внешний код (столбец “Код” в настройках видов топлива). Внешние коды топлива должны быть числовыми
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 20* . Если Вы хотите, чтобы частично налитые заказы автоматически зарывались после того как был повешен кран, то:
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 21. Откройте смену
132
133
134 )))
135
136 **На сайте [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]]**
137
138 |=(((
139 22* . Зайдите на вкладку  "Настройки" -> “Настройка компании ”, в секции “Реквизиты” заполните поля “ИНН”, “БИК”, “Номер банковского счета”, “Почтовый адрес” и нажмите кнопку “Сохранить”.
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 23. Зайдите на вкладку "Настройки" -> "Подписки"
148
149 24. Перейдите в раздел "Подписки", выберите вашу АЗС и в столбце 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 25. Нажмите кнопку "Продлить на выбранный период" в нижнем правом углу таблицы. Цена на интеграцию составляет 600 руб/АЗС/мес
154
155 26. Перейдите в пункт меню "FuelUp"
156
157 27. В блоке “Настройки компании” введите апикей Вашей сети АЗС, который Вам выдал **FuelUP**
158
159 28. В поля “Физические лица” и “Юридические лица” введите соответствующие коды видов оплаты с АЗС (п.19).
160
161 (в случае, если в Web Офис не заполнены коды, на АЗС будет использоваться вид оплаты с кодом 98)
162
163 29. Нажмите кнопку “Сохранить” под блоком “Настройки компании”
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 30. В блоке “Настройки АЗС” выберите необходимую АЗС.
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 31. Настройте последний столбец таблицы в соответствии с видами топлива 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 32. Сообщите в **FuelUP **что **настройка со стороны WEB Офиса завершена. **Если настройка была произведена корректно, то **FuelUP **должен увидеть конфигурацию Ваших АЗС (ид АЗС, виды топлива и цены).
183
184 33. Как только **FuelUP **установит номер АЗС в своей системе, попытайтесь сделать тестовый налив через мобильное приложение.