Исходный код вики СНК-Метаника
Редактировал(а) Руслан Савельев 2025/09/24 03:56
Последние авторы
| author | version | line-number | content |
|---|---|---|---|
| 1 | == **1. Назначение** == | ||
| 2 | |||
| 3 | Программный модуль «**СНК-Метаника**» предназначен для обслуживания клиентов ПЦ Метаника на АГНКС, оборудованные программным обеспечением управления «[[СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.WebHome||target="_blank"]]», через мобильное приложение «**Метаника**» в режиме самообслуживания. | ||
| 4 | |||
| 5 | == **2. Требования** == | ||
| 6 | |||
| 7 | * Версия ПО «СНК-АЗС» должна быть не ниже 1.75.1. | ||
| 8 | * Необходима лицензия «**СНК-** **Метаника» **Лицензия должна отображаться в программе «[[KeyInfo>>doc:Prilozheniia_SNK.SNK-AZS.Informatsiia_po_kliucham_HASP_SNK-AZS.WebHome||target="_blank"]]». | ||
| 9 | * Получить идентификатор ТО от Метаника. | ||
| 10 | * Для сканирования QR-кодов из приложения клиента необходим сканер штрих-кодов. | ||
| 11 | |||
| 12 | == **3. Настройка в «Конфигураторе оборудования СНК-АЗС»** == | ||
| 13 | |||
| 14 | * Запустите приложение "[[Конфигуратор оборудования СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Konfigurator_oborudovaniia_SNK-AZS.WebHome||target="_blank"]]" | ||
| 15 | * В левом окне найдите группу «**Картридер**» и кликните по ней правой кнопкой мыши. | ||
| 16 | * Выберите «**Добавить устройство**». | ||
| 17 | |||
| 18 | [[Добавление нового считывателя>>image:1756116158987-640.png||data-xwiki-image-style-alignment="center" height="284" width="500"]] | ||
| 19 | |||
| 20 | В окне «**Настройки**» выберите тип подключаемого считывателя и введите его название: | ||
| 21 | |||
| 22 | * **Тип**: выберите «Ридер карт Метаника». | ||
| 23 | * **Имя**: введите имя добавляемого терминала (например - "Метаника"). | ||
| 24 | * **Группа**: Создайте группу и выберите ее, для этого: | ||
| 25 | ** В поле «Группа» выберите «+ Добавить группу…» | ||
| 26 | ** В появившемся окне «Добавить группу» введите название группы (например, «Группа сканер) и нажмите «ОК» | ||
| 27 | |||
| 28 | [[Создание группы, объединяющей работу устройств>>image:1756116256096-455.png||data-xwiki-image-style-alignment="center"]] | ||
| 29 | |||
| 30 | * **Инициализировать устройство при обращении**: установите флажок. | ||
| 31 | |||
| 32 | [[Выбор типа добавляемого считывателя>>image:1756116303382-937.png||data-xwiki-image-style-alignment="center" height="284" width="500"]] | ||
| 33 | |||
| 34 | Если сканер штрих-кодов отсутствует в списке устройств, то добавьте его: | ||
| 35 | |||
| 36 | * В левом окне найдите группу «**Сканер БАР-кодов**» и кликните по ней правой кнопкой мыши. | ||
| 37 | * Выберите «**Добавить устройство**». | ||
| 38 | |||
| 39 | [[Добавление нового сканера штрих-кодов>>image:1756116369551-243.png||data-xwiki-image-style-alignment="center" height="284" width="500"]] | ||
| 40 | |||
| 41 | В окне «**Настройки**» выберите тип подключаемого сканера и введите его название: | ||
| 42 | |||
| 43 | * **Тип**: выберите «Сканер Бар-кодов». | ||
| 44 | * **Имя**: введите имя добавляемого сканера (например - "Сканер"). | ||
| 45 | * **Группа**: Выберите ту же группу, что и для считывателя («Группа сканер») | ||
| 46 | * **Инициализировать устройство при обращении**: не используется. | ||
| 47 | |||
| 48 | [[Выбор типа добавляемого сканера>>image:1756116416663-501.png||data-xwiki-image-style-alignment="center" height="285" width="500"]] | ||
| 49 | |||
| 50 | Убедитесь, что считыватель и сканер настроены для работы в одной группе «**Группа сканер**» (справа от названия устройств будет отображаться группа, в которой они состоят). | ||
| 51 | |||
| 52 | [[Устройства работают в составе одной группы>>image:1756116470069-475.png||data-xwiki-image-style-alignment="center" height="255" width="600"]] | ||
| 53 | |||
| 54 | В левом окне выберите добавленный сканер. В правом окне настройте его параметры: | ||
| 55 | |||
| 56 | * **Порт**: укажите порт, по которому подключен сканер. | ||
| 57 | * **Суффикс**: укажите суффикс, установленный в сканере (для проверки установленного суффикса, нажмите кнопку «Сканировать» и просканируйте любой товар). Допустимые значения суффикса, установленного в сканере - **0D** или **0D0A**. | ||
| 58 | * **Скорость**: укажите скорость передачи данных подключенного сканера. | ||
| 59 | |||
| 60 | [[Параметры сканера штрих-кодов>>image:1756116653093-419.png||data-xwiki-image-style-alignment="center" height="255" width="600"]] | ||
| 61 | |||
| 62 | В левом окне выберите добавленные устройства. В правом окне настройте их параметры. | ||
| 63 | |||
| 64 | **Настройки сканера:** | ||
| 65 | |||
| 66 | * **Порт**: укажите порт, по которому подключен сканер. | ||
| 67 | * **Скорость**: укажите скорость передачи данных подключенного сканера. | ||
| 68 | * **Суффикс**: укажите суффикс, установленный в сканере. | ||
| 69 | |||
| 70 | **Настройки считывателя:** | ||
| 71 | |||
| 72 | * **Код эмитента**: код эмитента Метаника | ||
| 73 | * **Идентификатор ТО**: ИД, полученный для конкретной ТО от Метаника | ||
| 74 | * **Строка подключения**: адрес подключения к серверу Метаника | ||
| 75 | * **Логирование**: режим логирования работы драйвера считывателя | ||
| 76 | |||
| 77 | **Таблица соответствий кодов:** | ||
| 78 | |||
| 79 | В этой таблице настраивается соответствие кодов топлив в сервисе «Метаника» с кодами в СНК-АЗС. | ||
| 80 | |||
| 81 | * **Код топлива Метаника**: код топлива, используемый в сервисе «Метаника». | ||
| 82 | * **Наименование топлива Метаника**: расшифровка кода (наименование топлива). | ||
| 83 | * **Группа топлива**: группа топлива в СНК-АЗС. | ||
| 84 | * **Код в ПЦ**: код топлива в СНК-ПЦ. Посмотреть код можно в карточке топлива в программе «Управление товарами СНК-АЗС», в параметре «Код в ПЦ». | ||
| 85 | |||
| 86 | При необходимости, дополнительные строки соответствий можно добавить, нажав правую кнопку мыши под таблицей соответствий кодов и выбрав «Добавить». | ||
| 87 | |||
| 88 | [[Параметры настроек считывателя Метаника>>image:1756116773032-807.png||data-xwiki-image-style-alignment="center" height="419" width="600"]] | ||
| 89 | |||
| 90 | * Нажмите кнопку «**Сохранить настройки**», чтобы применить изменения. | ||
| 91 | |||
| 92 | == **4. Настройка считывателя в «Управлении скидками СНК-АЗС»** == | ||
| 93 | |||
| 94 | * Запустите программу "[[Управление скидками СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Upravlenie_skidkami_SNK-AZS.WebHome||target="_blank"]]". | ||
| 95 | * В левом окне выберите "**Топливные карты**". | ||
| 96 | * В правом окне перейдите на вкладку "**Эмитенты**". | ||
| 97 | * В поле вкладки нажмите правую кнопку мыши и выберите "**Создать сеть эмитентов**". | ||
| 98 | |||
| 99 | [[Создание сети эмитентов>>image:1756116917536-543.png||data-xwiki-image-style-alignment="center" height="394" width="600"]] | ||
| 100 | |||
| 101 | Появится окно настройки сети эмитентов. | ||
| 102 | |||
| 103 | * В строке "**Сеть эмитентов**" выберите "**Метаника**". | ||
| 104 | * Нажмите "**ОК**". | ||
| 105 | |||
| 106 | [[Выбор типа сети эмитентов>>image:1756116985363-941.png||data-xwiki-image-style-alignment="center" height="394" width="600"]] | ||
| 107 | |||
| 108 | * На строке "**Сеть эмитентов «Метаника»**" нажмите правую кнопку мыши и выберите "**Создать эмитента**". | ||
| 109 | |||
| 110 | [[Создание эмитента>>image:1756117064269-116.png||data-xwiki-image-style-alignment="center" height="393" width="600"]] | ||
| 111 | |||
| 112 | Откроется окно настройки эмитента, заполните параметры: | ||
| 113 | |||
| 114 | * **Имя**: Метаника | ||
| 115 | * **Код эмитента**: укажите тот же номер эмитента, который указали при настройке считывателя "Метаника" в "Конфигураторе оборудования" | ||
| 116 | * Нажмите **ОК** | ||
| 117 | |||
| 118 | [[Настройка эмитента>>image:1756117176242-279.png||data-xwiki-image-style-alignment="center" height="393" width="600"]] | ||
| 119 | |||
| 120 | * На строке эмитента «**Метаника**» нажмите правую кнопку мыши и выберите "П**одключить к данному типу оплаты**". | ||
| 121 | |||
| 122 | [[Подключение эмитента к типу оплаты>>image:1756117235907-563.png||data-xwiki-image-style-alignment="center" height="394" width="600"]] | ||
| 123 | |||
| 124 | == **5. Настройка сервиса в «Приложении оператора СНК-АЗС»** == | ||
| 125 | |||
| 126 | * Запустите «[[Приложение оператора СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Prilozhenie_operatora_SNK-AZS.WebHome||target="_blank"]]». | ||
| 127 | * В строке меню выберите «**Сервис**» - «**Настройка рабочего места**». | ||
| 128 | |||
| 129 | [[Меню "Сервис">>image:1756117326451-520.png||data-xwiki-image-style-alignment="center" height="85" width="600"]] | ||
| 130 | |||
| 131 | Добавление устройства и протоколов: | ||
| 132 | |||
| 133 | **На вкладке «Считыватели карт»:** | ||
| 134 | |||
| 135 | * Нажмите правой кнопкой мыши в поле вкладки и выберите «Добавить Метаника». | ||
| 136 | |||
| 137 | [[Добавление считывателя>>image:1756117398039-801.png||data-xwiki-image-style-alignment="center" height="237" width="400"]] | ||
| 138 | |||
| 139 | **На вкладке «Протоколы считывателей карт»:** | ||
| 140 | |||
| 141 | * Нажмите правой кнопкой мыши в поле вкладки и выберите «Добавить Метаника \ Метаника (топливные карты)». | ||
| 142 | |||
| 143 | [[Добавление протокола считывания>>image:1756117451475-956.png||data-xwiki-image-style-alignment="center" height="224" width="400"]] | ||
| 144 | |||
| 145 | * Нажмите кнопку "**ОК**" для сохранения настроек. | ||
| 146 | |||
| 147 | == **6. Порядок оформления продажи** == | ||
| 148 | |||
| 149 | === **6.1. Действия клиента** === | ||
| 150 | |||
| 151 | * Клиент запускает приложение на своем мобильном устройстве и нажимает кнопку «**Заправиться**». | ||
| 152 | |||
| 153 | [[Приложение "Метаника" на мобильном устройстве>>image:1756117563080-352.png||data-xwiki-image-style-alignment="center" height="533" width="400"]] | ||
| 154 | |||
| 155 | * Откроется раздел «**Новая заправка**», в нем клиент выбирает тип топлива, вводит объем заправки в литрах или рублях и нажимает кнопку «**Далее**». | ||
| 156 | |||
| 157 | [[Заявка на заправку в мобильном приложении>>image:1756117644998-829.png||data-xwiki-image-style-alignment="center" height="518" width="400"]] | ||
| 158 | |||
| 159 | * На экране мобильного устройства появится QR-код, который клиент показывает оператору АЗС и сообщает ему номер ТРК и тип топлива. | ||
| 160 | |||
| 161 | === **6.2. Действия оператора АЗС** === | ||
| 162 | |||
| 163 | * Оператор создает заявку на нужную ТРК, выбирает тип оплаты – «Топливные карты» через считыватель «Метаника» и считывает сканером QR-код клиента. | ||
| 164 | * Появится окно с запросом подтверждения информации по клиенту (тип транспорта, тип топлива и его объем в заявке), если все верно, то нажимает «ОК». | ||
| 165 | |||
| 166 | [[Окно запроса подтверждения данных клиента>>image:1756117745539-119.png||data-xwiki-image-style-alignment="center"]] | ||
| 167 | |||
| 168 | * В окне оформления продажи автоматически будет заполнено количество заправляемого топлива из приложения клиента. Тип оплаты – топливные карты. | ||
| 169 | * Оператор нажимает кнопку «**ПРОДАЖА**». | ||
| 170 | |||
| 171 | [[Окно оформления продажи>>image:1756117820747-457.png||data-xwiki-image-style-alignment="center" height="394" width="600"]] | ||
| 172 | |||
| 173 | * Заявка будет передана на ТРК и завершится автоматически. | ||
| 174 | |||
| 175 |