Перейти к содержимому

Исходный код вики Svoy Club

Редактировал(а) Руслан Савельев 2025/09/03 05:29
Последние авторы
1 == **1. Информация** ==
2
3 SVOY.CLUB – для СНК является сторонней сетью эмитентов под брэндом Svoy.Club. Каждый эмитент сети Svoy.Club выпускает свои топливные карты, имеющие уникальный идентификатор кода эмитента (первые 4 цифры графического номера карты).
4 В отличии от интеграций других сторонних процессингов в СНК, для эмитентов Svoy.Club имеется возможность через СНК-ПЦ контролировать баланс счета эмитентов Svoy.Club с которыми заключены договоры. Контроль производится до начала отпуска в режиме онлайн запроса в СНК-ПЦ. Важно понимать, что дебетование счета эмитента происходит не в режиме онлайн, а в момент офлайн приема транзакций в СНК-ПЦ.
5
6 == **2. Требования** ==
7
8 **2.1. Версия ПО**
9
10 * Версия ПО «СНК-АЗС» должна быть не ниже 1.74.15.
11 * Версия ПО «СНК-ПЦ» должна быть не ниже 1.113.30.
12
13 **2.2. Лицензия**
14
15 * Наличие на ТО действующей лицензии «**СНК-Топливные карты Svoy.Club**». Лицензия должна отображаться в программе «[[Информация по ключам HASP СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Informatsiia_po_kliucham_HASP_SNK-AZS.WebHome||target="_blank"]]».
16
17 == **3. Установка и настройка драйвера на ПК** ==
18
19 (% class="box infomessage" %)
20 (((
21 **Все пункты этого раздела выполняют специалисты сети"Svoy.Club".**
22 )))
23
24 === **3.1. Подключение к ПК по USB** ===
25
26 * Подключите устройство к ПК через USB.
27 * Устройство появится в «**Диспетчере устройств**» Windows в группе «Другие устройства» со значком восклицательного знака:
28
29 [[Подключенное устройство в "Диспетчере устройств">>image:1753093719829-726.png||data-xwiki-image-style-alignment="center"]]
30
31 === **3.2. Установка драйвера** ===
32
33 * Специалисты от "Svoy.Club" скопируют на ПК папку **##C:\MPayNew##** из которой установят драйвер устройства.
34 * Специалисты от "Svoy.Club" обновят конфигурацию оборудования в «Диспетчере устройств» Windows. В списке оборудования появится новый раздел «**Устройства чтения смарт-карт**» с несколькими устройствами в этом разделе:
35
36 [[Подключенное устройство с установленными драйверами>>image:1753093888521-155.png||data-xwiki-image-style-alignment="center"]]
37
38 === **3.3. Настройка драйвера** ===
39
40 * Специалисты от "Svoy.Club" пропишут идентификатор, выданный для данной точки обслуживания, в файле **##MPayNewDrv.ini##**, в параметре **##NumToSvoyClub##**
41
42 === **3.4. Регистрация ТО в "Svoy.Club"** ===
43
44 * Специалисты от "Svoy.Club" запустят приложение **SendKey**.exe для регистрации идентификатора точки обслуживания на сервере Svoy.Club.
45
46 == **4. Настройка в «Конфигураторе оборудования СНК-АЗС»** ==
47
48 === **4.1. Запуск Конфигуратора оборудования** ===
49
50 * Запустите приложение "[[Конфигуратор оборудования СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Konfigurator_oborudovaniia_SNK-AZS.WebHome||target="_blank"]]"
51
52 === **4.2. Добавление устройства в группу "Картридер"** ===
53
54 * В левом окне найдите группу «**Картридер**» и кликните по ней правой кнопкой мыши.
55 * Выберите «**Добавить устройство**».
56
57 [[Добавление устройства в Конфигураторе оборудования>>image:1753094403744-638.png||data-xwiki-image-style-alignment="center" height="249" width="400"]]
58
59 === **4.3. Настройка параметров устройства** ===
60
61 * В появившемся окне «Настройки» введите параметры:
62 ** **Тип**: выберите «**Ридер карт Svoy.Club**».
63 ** **Имя**: введите имя добавляемого терминала (например - "**Svoy Club**").
64
65 [[Окно настроек с заполненными полями>>image:1753094498934-156.png||data-xwiki-image-style-alignment="center" height="311" width="500"]]
66
67 === **4.4. Конфигурация устройства** ===
68
69 В левом окне выберите добавленное устройство и в правом окне появятся его настройки:
70
71 [[Окно конфигурации устройства>>image:1753094732559-714.png||data-xwiki-image-style-alignment="center" height="396" width="500"]]
72
73 * **Путь к каталогу драйвера** - оставьте прописанный по умолчанию (**##C:\MPayNew##**)
74 * Заполните таблицу соответствия кодов топлива на терминале и кодов топлива в ПЦ:
75 ** При необходимости добавить строку с параметром, нажмите правую кнопку мыши ниже последней строки таблицы и выберите «**Добавить**»
76 ** Для удаления строки нажмите на ней правой кнопкой мыши и выберите «**Удалить**»
77
78 [[Добавление и удаление строк в таблицу соответствия кодов>>image:1753095116472-576.png||data-xwiki-image-style-alignment="center" height="159" width="700"]]
79
80 * Для выбора параметра, сопоставляемого между терминалом и кодом в ПЦ, нажмите левой кнопкой мыши в поле «**Группа топлива**»:
81
82 [[Выбор сопоставляемого параметра в добавленной строке>>image:1753095186653-253.png||data-xwiki-image-style-alignment="center"]]
83
84 (% class="box infomessage" %)
85 (((
86 Актуальные локальные коды на терминале можно запросить у партнёров «Svoy.Club». Эти коды находятся в файле **##MPayNewDrv.ini##**, в разделах ##[ProductSvoyClub]## и ##[ProductMPay]##
87 Например, строки: 
88 ##103=1
89 103_name=АИ 92##
90 означают, что топливо с маркой АИ-92, имеет локальный код на терминале, равный 1.
91 **Код топлива в справочнике ПЦ можно увидеть в приложении «Управление товарами СНК-АЗС», открыв карточку топлива.**
92 )))
93
94 [[Просмотр кода топлива в справочнике>>image:1753157692265-928.png||data-xwiki-image-style-alignment="center" height="574" width="700"]]
95
96 === **4.5. Сохранение настроек в «Конфигураторе оборудования СНК-АЗС»** ===
97
98 * Нажмите кнопку «**Сохранить настройки**», чтобы применить изменения.
99
100 == **5. Настройка в «Управлении скидками СНК-АЗС»** ==
101
102 === **5.1. Запуск "Управления скидками СНК-АЗС"** ===
103
104 * Запустите программу "[[Управление скидками СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Upravlenie_skidkami_SNK-AZS.WebHome||target="_blank"]]".
105
106 === **5.2. Добавление сети эмитентов** ===
107
108 * В левом окне выберите "**Топливные карты**".
109 * В правом окне перейдите на вкладку "**Эмитенты**".
110 * В поле вкладки нажмите правую кнопку мыши и выберите "**Создать сеть эмитентов**".
111
112 [[Создание сети эмитентов>>image:1753157996287-427.png||data-xwiki-image-style-alignment="center" height="524" width="700"]]
113
114 * Откроется окно мастера настройки сети эмитентов
115 * В строке "**Сеть эмитентов**" выберите "**Svoy.Club**"
116 * Нажмите "**ОК**"
117
118 [[Выбор типа сети эмитентов>>image:1753158106349-836.png||data-xwiki-image-style-alignment="center" height="524" width="700"]]
119
120 === **5.3. Создание эмитента** ===
121
122 * На строке "**Сеть эмитентов "Svoy.Club**" нажмите правую кнопку мыши и выберите "**Создать эмитента**".
123
124 [[Создание эмитента>>image:1753158210620-866.png||data-xwiki-image-style-alignment="center" height="525" width="700"]]
125
126 * Откроется окно мастера настройки эмитента, заполните в нем значения:
127 ** Имя: "**Svoy.Club**"
128 ** Код эмитента: //номер выдается партнёром "Svoy.Club" //
129
130 (% class="box" %)
131 (((
132 //Для примера, указан номер кода эмитента 9900, при реальной настройке нужно ввести тот номер, который будет выдан партнёром "Svoy.Club" для настраиваемой ТО//
133 )))
134
135 [[Ввод данных эмитента>>image:1753158366892-510.png||data-xwiki-image-style-alignment="center" height="524" width="700"]]
136
137 === **5.4. Подключение эмитента к типу оплаты** ===
138
139 * На строке эмитента "**Svoy.Club**" нажмите правую кнопку мыши и выберите "**Подключить к данному типу оплаты**".
140
141 [[Подключение эмитента к типу оплаты>>image:1753158453309-367.png||data-xwiki-image-style-alignment="center" height="524" width="700"]]
142
143 == **6. Настройка устройства в «Приложении оператора СНК-АЗС»** ==
144
145 === **6.1. Запуск «Приложения оператора СНК-АЗС»** ===
146
147 * Откройте «[[Приложение оператора СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Prilozhenie_operatora_SNK-AZS.WebHome||target="_blank"]]».
148
149 === **6.2. Вход в настройки** ===
150
151 * В строке меню выберите «**Сервис**» - «**Настройка рабочего места**»:
152
153 [[Открыт пункт меню "Сервис">>image:1753158618202-535.png||data-xwiki-image-style-alignment="center" height="78" width="550"]]
154
155 === **6.3. Добавление устройства и протоколов** ===
156
157 **На вкладке «Считыватели карт»:**
158
159 * Нажмите правой кнопкой мыши в поле вкладки и выберите «**Добавить Svoy Club**»:
160
161 [[Добавление считывателя карт>>image:1753158717714-138.png||data-xwiki-image-style-alignment="center" height="277" width="500"]]
162
163 **На вкладке «Протоколы считывателей карт»:**
164
165 * Нажмите правой кнопкой мыши в поле вкладки и выберите «**Добавить Svoy.Club  Топливные карты Svoy Club**»:
166
167 [[Добавление протокола считывателя карт>>image:1753158799384-437.png||data-xwiki-image-style-alignment="center" height="268" width="500"]]
168
169 * Нажмите кнопку «**ОК**» для сохранения настроек.
170
171 == **7. Сопряжение карт «Свой клуб» и ПЦ** ==
172
173 (% class="box infomessage" %)
174 (((
175 Последовательно выполняйте шаги из этого пункта.
176 )))
177
178 === **7.1. Создание покупателя** ===
179
180 * В ПЦ перейдите в раздел **Договоры \ Покупатели**.
181 * Нажмите на кнопку «**Добавить**» и создайте покупателя, для которого будет вестись контроль остатка денежных средств по картам «Свой клуб».
182
183 === **7.2. Добавление персоны, которой будет выдана карта.** ===
184
185 * Выберите в списке созданного покупателя
186 * Нажмите на кнопку «**Карты**» слева:
187
188 [[Вход в раздел карт выбранного покупателя>>image:1753159088757-288.png||data-xwiki-image-style-alignment="center" height="334" width="700"]]
189
190 * В открывшемся окне нажмите кнопку «**Добавить**» и подтвердите операцию:
191
192 [[Добавление персоны>>image:1753159280033-891.png||data-xwiki-image-style-alignment="center" height="353" width="700"]]
193
194 * Укажите ФИО персоны, кликнув левой кнопкой мыши в поле «**ФИО**»:
195
196 [[Введение данных персоны>>image:1753159490811-286.png||data-xwiki-image-style-alignment="center" height="236" width="700"]]
197
198 === **7.3. Выдача карты персоне** ===
199
200 * Нажмите на кнопку «**Чужая**» и в выпадающем меню выберите «**Ведомость**»:
201
202 [[Выдача карты персоне>>image:1753159800489-517.png||data-xwiki-image-style-alignment="center" height="334" width="700"]]
203
204 (% class="box infomessage" %)
205 (((
206 На эту карту будет учитываться весь отпуск по картам «Свой клуб».
207 )))
208
209 === **7.4. Добавление ограничения** ===
210
211 * Выберите в списке созданного покупателя:
212
213 [[Выбор строки покупателя>>image:1753159939986-382.png||data-xwiki-image-style-alignment="center" height="329" width="700"]]
214
215 * Нажмите кнопку «**Ограничения**» слева:
216
217 [[Вход в меню "Ограничения">>image:1753160007753-693.png||data-xwiki-image-style-alignment="center" height="329" width="700"]]
218
219 * В открывшемся окне добавьте ограничение типа «**Чужой эквайрер**»:
220
221 [[Добавление ограничения покупателю>>image:1753160510391-456.png||data-xwiki-image-style-alignment="center" height="348" width="700"]]
222
223 === **7.5. Настройка параметров** ===
224
225 * На созданной строке перейдите курсором в столбец «**Значение**».
226 * Нажмите кнопку «**Значения**» слева:
227
228 [[Открытие поля для редактирования значения>>image:1753161843427-168.png||data-xwiki-image-style-alignment="center" height="304" width="700"]]
229
230 * В строке «**Сеть**» выберите из списка «**Свой Клуб**».
231 * В строке «**Эквайрер**» укажите код эквайрера, полученный партнёра "Svoy.Club"
232
233 (% class="box" %)
234 (((
235 //Для примера, указан номер кода эквайрера - 9900, при реальной настройке нужно ввести тот номер, который будет выдан партнёром "Svoy.Club" для конкретного покупателя.//
236 )))
237
238 [[Установка сети и кода эквайрера>>image:1753161960361-765.png||data-xwiki-image-style-alignment="center" height="215" width="500"]]
239
240 Пример результата настроек:
241
242 [[Прописанные значения ограничения для покупателя>>image:1753162003663-839.png||data-xwiki-image-style-alignment="center" height="114" width="700"]]
243
244 === **7.6. Добавление нескольких покупателей** ===
245
246 Если покупателей несколько, то для каждого повторите вышеуказанные шаги. Убедитесь, что каждый покупатель имеет уникальный код эквайрера, выданный «Своим Клубом».
247
248