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

Версия 10.2 от Ярослава Ерина на 2025/02/21 09:47

Последние авторы
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 (% class="mark" %)1* (%%). Зайдите на сайт [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]]
11
12 [[image:https://topazoffice.ru/xwiki/bin/download/nachalo_raboty/start/WebHome/1730119808080-110.png?rev=1.1||alt="1730119808080-110.png"]]
13
14 [[image:https://topazoffice.ru/xwiki/bin/download/nachalo_raboty/start/WebHome/1730119902774-575.png?rev=1.1||alt="1730119902774-575.png"]]
15
16 (% class="mark" %)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 (% class="mark" %)3* (%%). Зайдите на вкладку "АЗС"
23
24 [[image:1732705702265-981.png]]
25
26 (% class="mark" %)4* (%%). Если хотите переименовать АЗС
27
28 1. Кликните на строку с АЗС
29 1. Введите новый код
30 1. Нажмите кнопку "Сохранить"
31
32 [[image:1732705769727-389.png]]
33
34 (% class="mark" %)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 (% class="mark" %)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 (% class="mark" %)10* (%%). На вкладке "АЗС" выберите АЗС с помощью галки в первой колонке
65
66 [[image:https://topazoffice.ru/xwiki/bin/download/actyvaciya/WebHome/1732184406508-921.png?rev=1.1||alt="1732184406508-921.png"]]
67
68 (% class="mark" %)11* (%%). Нажмите кнопку "Сгенерировать код регистрации"
69
70 (% class="mark" %)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 (% class="mark" %)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 (% class="mark" %)14* (%%). Нажмите кнопку "Отправить" и дождитесь появления сообщения: "Регистрация выполнена, Активирована."
83
84 [[image:https://topazoffice.ru/xwiki/bin/download/actyvaciya/WebHome/1732185025975-793.png?rev=1.1||alt="1732185025975-793.png"]]
85
86 (% class="mark" %)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 (% class="mark" %)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 (% class="mark" %)22* (%%). Зайдите на вкладку  Иконка пользователя → “Профиль компании” → “Настройка компании”, заполните поля “Почтовый адрес”, “Email”, “Контактный телефон”, “Юридический адрес”, “ИНН”, “БИК”, “Номер банковского счета”, и нажмите кнопку “Сохранить”.
140
141 Поле Почтовый адрес используется для отправки бухгалтерских документов.
142
143 [[image:https://topazoffice.ru/xwiki/bin/download/yandex/WebHome/1732782173353-674.png?rev=1.1||alt="1732782173353-674.png"]]
144
145
146 23. Перейдите в раздел "Подписки", выберите вашу АЗС и в столбце FuelUP установите желаемый период
147
148 [[image:1732799450285-339.png]]
149
150 25. Нажмите кнопку "Продлить на выбранный период" в нижнем правом углу таблицы. Цена на интеграцию составляет 600 руб/АЗС/мес
151
152 26. Перейдите в меню "Главная" → "FuelUp"
153
154 27. В блоке “Настройки компании” введите апикей Вашей сети АЗС, который Вам выдал **FuelUP**
155
156 28. В поля “Физические лица” и “Юридические лица” введите соответствующие коды видов оплаты с АЗС (п.19).
157
158 (в случае, если в Web Офис не заполнены коды, на АЗС будет использоваться вид оплаты с кодом 98)
159
160 29. Нажмите кнопку “Сохранить” под блоком “Настройки компании”
161
162 [[image:1732799659361-518.png]]
163
164
165 30. В блоке “Настройки АЗС” выберите необходимую АЗС.
166
167 Убедитесь, что в появившейся таблице виды топлива, цены и внешние коды совпадают с указанными на АЗС (п.20)
168
169 [[image:1732800137272-300.png]]
170
171 31. Настройте последний столбец таблицы в соответствии с видами топлива FuelUP.
172
173 Нажмите кнопку сохранить под блоком  “Настройки АЗС”
174
175 [[image:1732800160622-260.png]]
176 )))
177 |(% colspan="1" %)
178
179 32. Сообщите в **FuelUP **что **настройка со стороны WEB Офиса завершена. **Если настройка была произведена корректно, то **FuelUP **должен увидеть конфигурацию Ваших АЗС (ид АЗС, виды топлива и цены).
180
181 33. Как только **FuelUP **установит номер АЗС в своей системе, попытайтесь сделать тестовый налив через мобильное приложение.