Исходный код вики Интеграции
Версия 1.1 от Ярослава Ерина на 2024/07/17 12:17
Скрыть последних авторов
| author | version | line-number | content |
|---|---|---|---|
![]() |
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/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 |
