Интеграции

|(((

== **Важно!** ==

**Перед настройкой Топаз-АЗС необходимо обновить ее до версии 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

**В браузере GoogleChrome**

10

11

|(((

12

**1* . Зайдите на сайт [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]]**

13

14

[[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-51-48.png?version=1&modificationDate=1716375108000&api=v2||height="250"]]

15

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"]]

18

19

20

**2* . Зарегистрируйтесь на сайте и активируйте аккаунт по ссылке с электронной почты**

21

22

23

[[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-53-11.png?version=1&modificationDate=1716375191000&api=v2||data-xwiki-image-style-border="true" height="229"]]

24

25

[[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-53-21.png?version=1&modificationDate=1716375201000&api=v2||data-xwiki-image-style-border="true" height="83"]]

26

27

**3* . Зайдите на вкладку "АЗС"**

28

29

[[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-53-31.png?version=1&modificationDate=1716375211000&api=v2||height="250"]]

30

31

**4* . Если хотите переименовать АЗС**

32

33

1. ** Кликните на строку с АЗС**

34

1. ** Введите новый код**

35

1. ** Нажмите кнопку "Сохранить"**

36

[[image:https://wiki.topazelectro.ru/download/thumbnails/1179743/image2024-5-22_13-54-0.png?version=1&modificationDate=1716375240000&api=v2||height="250"]]

37

38

**5* . Пройдите по пути “Профиль компании” -> “Настройки АЗС”**

39

40

[[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-54-11.png?version=1&modificationDate=1716375251000&api=v2||height="250"]]

41

42

**6* . В разделе введите “Адрес”, “Широту” и “Долготу”. Нажмите кнопку “Сохранить”**

)))

**В "Топаз АЗС"**

|(((

**7. Закрыть смену и закрыть программу "Топаз АЗС"**

49

50

**8. Запустить скрипт backupBeforeSync.cmd в корневом каталоге и дождаться его завершения**

51

52

[[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-54-31.png?version=1&modificationDate=1716375271000&api=v2||height="250"]]

53

54

[[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-54-38.png?version=1&modificationDate=1716375278000&api=v2||height="250"]]

55

56

**9. Запустите "Топаз АЗС" и зайдите в режим "Настройки"**

57

58

**10* . Зайдите в меню "WebOffice" -> "Регистрация"**

59

60

[[image:https://wiki.topazelectro.ru/download/thumbnails/1179743/image2024-5-22_13-54-55.png?version=1&modificationDate=1716375295000&api=v2||height="250"]]

61

)))

62

63

**На сайте [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]]**

64

65

|(((

66

**11* . На вкладке "АЗС" выберите АЗС с помощью галки в первой колонке**

67

68

[[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-55-10.png?version=1&modificationDate=1716375310000&api=v2||height="250"]]

69

70

**12* . Нажмите кнопку "Сгенерировать код регистрации"**

71

72

**13* . В появившемся окне скопируйте код**

73

74

**~ [[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-55-22.png?version=1&modificationDate=1716375322000&api=v2||height="250"]]**

)))

**В "Топаз АЗС"**

|(((

**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

**На сайте [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]]**

127

128

|(((

129

**22* . Зайдите на вкладку "Профиль компании" -> “Настройка компании ”, в секции “Реквизиты” заполните поля “ИНН”, “БИК”, “Номер банковского счета”, “Почтовый адрес” и нажмите кнопку “Сохранить”.**

130

131

**(поле Почтовый адрес используется для отправки бухгалтерских документов).**

132

133

[[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-17.png?version=1&modificationDate=1716375437000&api=v2||height="250"]]**23. Зайдите на вкладку "Подписки"**

134

135

**24. В таблице "Ваши подписки на плагины" в колонке названием Вашей внешней интеграции выберите подписку на интересующий Вас срок**

136

137

[[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-43.png?version=1&modificationDate=1716375463000&api=v2||height="250"]]

138

139

**25. Нажмите кнопку "Сохранить" в нижнем правом углу таблицы. Цена на интеграцию составляет 600 руб/АЗС/мес**

140

141

**26. Перейдите в пункт меню " Внешние наливы " - > "Название необходимой внешней интеграции"**

142

143

[[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-51.png?version=1&modificationDate=1716375471000&api=v2||height="250"]]

144

145

**27. В блоке “Настройки компании” введите апикей Вашей сети АЗС, который Вам выдал интегратор**

146

147

**28. Нажмите на кнопку "+" под блоком "Настройки компании" и добавьте вид оплаты для внешнего налива. В поле "Тип заказа" введите значение "contractId", полученный от интегратора, а в поле "код вида оплаты",**

148

149

**внешний код из п.18**

150

151

[[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-57-59.png?version=1&modificationDate=1716375479000&api=v2||height="250"]]

**~ **

**29. Нажмите кнопку “Сохранить” под блоком “Настройки компании”**

156

157

**30. В блоке “Настройки АЗС” выберите необходимую АЗС.**

158

159

**Убедитесь, что появившейся таблице виды топлива, цены и внешние коды совпадают с указанными на АЗС (п.19)**

160

161

**31. Настройте последний столбец таблицы в соответствии с видами топлива интегратора.**

162

163

**Нажмите кнопку сохранить под блоком “Настройки АЗС”**

164

165

[[image:https://wiki.topazelectro.ru/download/attachments/1179743/image2024-5-22_13-58-7.png?version=1&modificationDate=1716375487000&api=v2||height="250"]]

)))

|

32. Сообщите интегратору, что **настройка со стороны WEB Офиса завершена. **Если настройка была произведена корректно, то интегратор должен увидеть конфигурацитю Ваших АЗС (ид АЗС, виды топлива и цены).

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