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

Версия 2.1 от Ярослава Ерина на 2024/07/17 12:17

Последние авторы
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/1179743/image2024-5-22_13-51-48.png?version=1&modificationDate=1716375108000&api=v2||height="250"]]
16
17 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-51-57.png?version=1&modificationDate=1716375117000&api=v2||height="250"]]**2* . Зарегистрируйтесь на сайте и активируйте аккаунт по ссылке с электронной почты**
18
19
20 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-53-11.png?version=1&modificationDate=1716375191000&api=v2||height="229"]]
21
22 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-53-21.png?version=1&modificationDate=1716375201000&api=v2||height="83"]]
23
24 **3* . Зайдите на вкладку "АЗС"**
25
26 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-53-31.png?version=1&modificationDate=1716375211000&api=v2||height="250"]]
27
28 **4* . Если хотите переименовать АЗС**
29
30 1. ** Кликните на строку с АЗС**
31 1. ** Введите новый код**
32 1. ** Нажмите кнопку "Сохранить"**
33 [[image:https://wiki.topazelectro.ru/download/thumbnails/1179743/image2024-5-22_13-54-0.png?version=1&modificationDate=1716375240000&api=v2||height="250"]]
34
35 **5* . Пройдите по пути “Профиль компании” -> “Настройки АЗС”**
36
37 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-54-11.png?version=1&modificationDate=1716375251000&api=v2||height="250"]]
38
39 **6* . В разделе введите “Адрес”, “Широту” и “Долготу”. Нажмите кнопку “Сохранить”**
40 )))
41
42
43 **В "Топаз АЗС"**
44
45 |(((
46 **7. Закрыть смену и закрыть программу "Топаз АЗС"**
47
48 **8. Запустить скрипт backupBeforeSync.cmd в корневом каталоге и дождаться его завершения**
49
50 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-54-31.png?version=1&modificationDate=1716375271000&api=v2||height="250"]]
51
52 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-54-38.png?version=1&modificationDate=1716375278000&api=v2||height="250"]]
53
54 **9. Запустите "Топаз АЗС" и зайдите в режим "Настройки"**
55
56 **10* . Зайдите в меню "WebOffice" -> "Регистрация"**
57
58 [[image:https://wiki.topazelectro.ru/download/thumbnails/1179743/image2024-5-22_13-54-55.png?version=1&modificationDate=1716375295000&api=v2||height="250"]]
59 )))
60
61
62 **На сайте [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]]**
63
64 |(((
65 **11* . На вкладке "АЗС" выберите АЗС с помощью галки в первой колонке**
66
67 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-55-10.png?version=1&modificationDate=1716375310000&api=v2||height="250"]]
68
69 **12* . Нажмите кнопку "Сгенерировать код регистрации"**
70
71 **13* . В появившемся окне скопируйте код**
72
73 **~ [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-55-22.png?version=1&modificationDate=1716375322000&api=v2||height="250"]]**
74
75
76 )))
77
78
79 **В "Топаз АЗС"**
80
81 |(((
82 **14* . Вставьте код из окна с сайта [[https:~~/~~/topazoffice.ru/ >>url:https://topazoffice.ru/]]в поле "Код регистрации" в меню "WebOffice" -> “Регистрация”**
83
84 **15* . Нажмите кнопку "Зарегистрировать" и дождитесь появления окна с текстом "Регистрация прошла успешно"**
85
86 [[image:https://wiki.topazelectro.ru/download/thumbnails/1179743/image2024-5-22_13-55-32.png?version=1&modificationDate=1716375332000&api=v2||height="250"]]
87
88 **16* . Создайте экземпляр менеджера оборудования "Прочие устройства" -> "WebOfficeActiveDevice" и, по желанию, назовите его "Внешние наливы"**
89
90 [[image:https://wiki.topazelectro.ru/download/thumbnails/1179743/image2024-5-22_13-55-41.png?version=1&modificationDate=1716375341000&api=v2||height="250"]]
91
92 **17. Создайте вид оплаты "Регистрация внешних заказов", назовите его по Вашему усмотрению**
93
94 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-55-54.png?version=1&modificationDate=1716375354000&api=v2||height="250"]]
95
96 **18. Для данного вида оплаты установить следующие параметры**
97
98 * **Печать чека на фискальном регистраторе: “<Не выбран>”**
99 * **Печать квитанции на принтере: “<Не выбран>”**
100 * **Регистрация в базе данных: “Безналичный расчет”**
101 * **Внешний код - введите любое числовое значение, уникальное для каждого из видов оплаты**
102
103 **Нажмите кнопку Изменить для сохранения параметров**
104
105 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-56-15.png?version=1&modificationDate=1716375375000&api=v2||height="250"]]
106
107 **19. Убедитесь, что в видах нефтепродуктов каждый вид топлива имеет уникальный внешний код (столбец “Код” в настройках видов топлива, кодом может быть любое числовое значение ). Внешние коды топлива должны быть числовыми**
108
109 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-56-23.png?version=1&modificationDate=1716375383000&api=v2||height="250"]]
110
111 **20* . Если Вы хотите, чтобы частично налитые заказы автоматически зарывались после того как был повешен кран, то:**
112
113 * **Закройте ТопазАЗС**
114 * **Откройте файл <Путь до ТопазАЗС>/Ini/localsettings.ini**
115 * **Добавьте в секцию [Pumps] следующие строки**
116 **~ IsAutoCancel=1**
117 **AutoCancelTimeout=30**
118
119 **Где 30 - время ожидания от момента перехода в состояние остановки в секундах**
120
121 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-5.png?version=1&modificationDate=1716375425000&api=v2||height="250"]]
122
123 **21. Откройте смену**
124 )))
125
126
127 **На сайте [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]]**
128
129 |(((
130 **22* . Зайдите на вкладку  "Профиль компании" -> “Настройка компании ”, в секции “Реквизиты” заполните поля “ИНН”, “БИК”, “Номер банковского счета”, “Почтовый адрес” и нажмите кнопку “Сохранить”.**
131
132 **(поле Почтовый адрес используется для отправки бухгалтерских документов).**
133
134 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-17.png?version=1&modificationDate=1716375437000&api=v2||height="250"]]**23. Зайдите на вкладку "Подписки"**
135
136 **24. В таблице "Ваши подписки на плагины" в колонке названием Вашей внешней интеграции выберите подписку на интересующий Вас срок**
137
138 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-43.png?version=1&modificationDate=1716375463000&api=v2||height="250"]]
139
140 **25. Нажмите кнопку "Сохранить" в нижнем правом углу таблицы. Цена на интеграцию составляет 600 руб/АЗС/мес**
141
142 **26. Перейдите в пункт меню " Внешние наливы " - > "Название необходимой внешней интеграции"**
143
144 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-51.png?version=1&modificationDate=1716375471000&api=v2||height="250"]]
145
146 **27. В блоке “Настройки компании” введите апикей Вашей сети АЗС, который Вам выдал интегратор**
147
148 **28. Нажмите на кнопку "+" под блоком "Настройки компании" и добавьте вид оплаты для внешнего налива. В поле "Тип заказа" введите значение "contractId", полученный от интегратора, а в поле "код вида оплаты",**
149
150 **внешний код из п.18**
151
152 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-59.png?version=1&modificationDate=1716375479000&api=v2||height="250"]]
153
154 **~ **
155
156 **29. Нажмите кнопку “Сохранить” под блоком “Настройки компании”**
157
158 **30. В блоке “Настройки АЗС” выберите необходимую АЗС.**
159
160 **Убедитесь, что появившейся таблице виды топлива, цены и внешние коды совпадают с указанными на АЗС (п.19)**
161
162 **31. Настройте последний столбец таблицы в соответствии с видами топлива интегратора.**
163
164 **Нажмите кнопку сохранить под блоком  “Настройки АЗС”**
165
166 [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-58-7.png?version=1&modificationDate=1716375487000&api=v2||height="250"]]
167 )))
168 |
169
170 32. Сообщите интегратору, что **настройка со стороны WEB Офиса завершена. **Если настройка была произведена корректно, то интегратор должен увидеть конфигурацитю Ваших АЗС (ид АЗС, виды топлива и цены).
171
172