Исходный код вики MBank

Редактировал(а) Руслан Савельев 2025/09/03 05:29

Последние авторы
1 == **1. Назначение** ==
2
3 В настоящем руководстве представлено описание необходимых настроек для подключения банковского терминала MBank к системе управления АЗС «СНК-АЗС» с целью управления оплатой от «СНК-АЗС» за покупки банковскими картами.
4
5 == **2. Требования** ==
6
7 **2.1. Версия ПО**
8
9 * Версия ПО «СНК-АЗС» должна быть не ниже 1.74.23.
10
11 **2.2. Лицензия**
12
13 * Наличие на ТО действующей лицензии «**СНК-MBANK MKassa [Киргизия]**». Лицензия должна отображаться в программе «[[Информация по ключам HASP СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Informatsiia_po_kliucham_HASP_SNK-AZS.WebHome||target="_blank"]]».
14
15 == **3. Настройка в «Конфигураторе оборудования СНК-АЗС»** ==
16
17 * Запустите приложение "[[Конфигуратор оборудования СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Konfigurator_oborudovaniia_SNK-AZS.WebHome||target="_blank"]]"
18 * В левом окне найдите группу «**Картридер**» и кликните по ней правой кнопкой мыши.
19 * Выберите «**Добавить устройство**».
20
21 [[Добавление нового устройства>>image:1755769745547-301.png||data-xwiki-image-style-alignment="center" height="312" width="600"]]
22
23 В окне «**Настройки**» выберите тип подключаемого терминала и введите его название:
24
25 * **Тип**: выберите «Банковский терминал MBANK».
26 * **Имя**: введите имя добавляемого терминала (например - "MBank").
27 * **Группа**: //не используется.//
28 * **Инициализировать устройство при обращении**: //не используется.//
29
30 [[Выбор типа добавляемого устройства>>image:1755769852954-194.png||data-xwiki-image-style-alignment="center" height="334" width="600"]]
31
32 В левом окне выберите добавленное устройство MBANK. В правом окне появятся его настройки.
33
34 * Настройте параметры:
35 ** **Код эмитента-владельца** – 14 (номер лицензии НБКР)
36 ** **Код эквайера** – код банка-эквайера того банка, который предоставил терминал. Необходим для разделения банковских терминалов, когда их несколько.
37 ** **Строка подключения** – строка с адресом и портом терминала, в формате http:~/~/ipv4:port/ (IP адрес берется из настроек терминала)
38 ** **Формировать копию** – формировать копию терминального чека.
39
40 * Нажмите кнопку «**Сохранить настройки**», чтобы применить изменения.
41
42 [[Параметры устройства>>image:1755769939346-346.png||data-xwiki-image-style-alignment="center" height="331" width="600"]]
43
44 == **4. Настройка терминала в «Управлении скидками СНК-АЗС»** ==
45
46 === **3.1. Запуск приложения** ===
47
48 * Запустите программу "[[Управление скидками СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Upravlenie_skidkami_SNK-AZS.WebHome||target="_blank"]]".
49
50 === **3.2. Добавление сети эмитентов** ===
51
52 * В левом окне выберите "**Банковские карты**".
53 * В правом окне перейдите на вкладку "**Эмитенты**".
54 * В поле вкладки нажмите правую кнопку мыши и выберите "**Создать сеть эмитентов**".
55
56 [[Создание сети эмитентов>>image:1755770669138-948.png||data-xwiki-image-style-alignment="center" height="420" width="700"]]
57
58 Появится окно настройки сети эмитентов.
59
60 * В строке "**Сеть эмитентов**" выберите "**Банковские карты**".
61 * Нажмите "**ОК**".
62
63 [[Выбор типа сети эмитентов>>image:1755770751163-312.png||data-xwiki-image-style-alignment="center" height="420" width="700"]]
64
65 === **3.3. Создание эмитента** ===
66
67 * На строке "**Сеть эмитентов 'Банковские карты**'" нажмите правую кнопку мыши и выберите "**Создать эмитента**".
68
69 [[Создание эмитента>>image:1755770872489-114.png||data-xwiki-image-style-alignment="center" height="420" width="700"]]
70
71 * Откроется окно настройки эмитента, заполните параметры:
72 ** Имя: **MBANK**
73 ** Код эмитента: **14** (номер лицензии НБКР)
74 ** Нажмите **ОК**
75
76 [[Ввод данных эмитента>>image:1755770930105-731.png||data-xwiki-image-style-alignment="center" height="457" width="700"]]
77
78 === **3.4. Подключение эмитента к типу оплаты** ===
79
80 * На строке эмитента "**MBANK**" нажмите правую кнопку мыши и выберите "**Подключить к данному типу оплаты**".
81
82 [[Подключение эмитента к типу оплаты>>image:1755771010943-379.png||data-xwiki-image-style-alignment="center" height="458" width="700"]]
83
84 == **5. Настройка в «Приложении оператора СНК-АЗС»** ==
85
86 * Запустите «[[Приложение оператора СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Prilozhenie_operatora_SNK-AZS.WebHome||target="_blank"]]».
87 * В строке меню выберите '**Сервис**' -> '**Настройка рабочего места**'.
88
89 [[Открыт пункт меню "Сервис">>image:1755771205989-106.png||data-xwiki-image-style-alignment="center" height="85" width="600"]]
90
91 **На вкладке «Считыватели карт»:**
92
93 * Нажмите правой кнопкой мыши в поле вкладки и выберите «**Добавить MBANK**».
94
95 [[Добавление считывателя карт>>image:1755771262984-319.png||data-xwiki-image-style-alignment="center" height="241" width="400"]]
96
97 **На вкладке «Протоколы считывателей карт»:**
98
99 * Нажмите правой кнопкой мыши в поле вкладки и выберите «**Добавить Оптима банк \ VISA MasterCard**».
100
101 [[Добавление протокола считывателя карт>>image:1755771329944-459.png||data-xwiki-image-style-alignment="center" height="222" width="400"]]
102
103 * Нажмите кнопку "**ОК**" для сохранения настроек.
104
105 == **6. Настройка сменного отчета** ==
106
107 Полные возвраты по карте работают стандартно.
108
109 Возврат по QR и частичные возвраты оформляются через возврат наличных.
110
111 Для учета таких возвратов в сменный отчет добавляется 212 отчет.
112
113 Настройка сменных отчетов производится в программе настроек в разделе «Сменные отчеты».
114
115 Для добавления отчета:
116
117 * Завершите работу всех приложений СНК-АЗС и Бэк-Офис СНК-АЗС.
118 * Запустите .\SNC_AZS\server\Settings.exe
119 * Перейдите в разделе «Сменные отчеты»
120 * Выберите параметр «Наполнение сменного отчета»
121 * Кликните по кнопке с тремя точками справа значения параметра
122
123 [[Настройка состава сменного отчета>>image:1755771503924-334.png||data-xwiki-image-style-alignment="center" height="404" width="700"]]
124
125 Откроется окно списка отчетов.
126
127 * Нажмите правую кнопку мыши и выберите 212 отчет для его добавления в список.
128
129 [[Список отчетов в составе сменного>>image:1755771529658-420.png||data-xwiki-image-style-alignment="center" height="377" width="300"]]
130
131 * Кода отчет будет добавлен, нажмите кнопку **Закрыть.**
132
133 [[Отчет №212 добавлен в состав сменного>>image:1755771572896-175.png||data-xwiki-image-style-alignment="center" height="343" width="300"]]
134
135 * Нажмите кнопку «**Сохранить настройки**» и закройте программу настроек.
136
137 == **7. Осуществление возвратов клиенту** ==
138
139 При осуществлении частичного возврата средств на карту (например, при заправке топливом на меньший, чем оплаченный литраж) программа отобразит окно ошибки обработки карты.
140
141 * Нажмите «**Возврат без карты**».
142
143 [[Окно ошибки возврата на карту>>image:1755771667666-702.png||data-xwiki-image-style-alignment="center" height="190" width="350"]]
144
145 Затем появится запрос на продолжение без возврата средств на карту, нажмите «**Да**» на этот запрос. (Так как возврат будет выдан наличными средствами).
146
147 [[Подтверждение продолжения операции без возврата на карту>>image:1755771717522-856.png||data-xwiki-image-style-alignment="center" height="186" width="350"]]
148
149