Исходный код вики СНК-Яндекс.Заправка

Редактировал(а) Руслан Савельев 2025/12/09 08:28

Скрыть последних авторов
Руслан Савельев 27.1 1 == **Назначение** ==
Руслан Савельев 1.1 2
Руслан Савельев 2.1 3 Настоящая инструкция описывает перечень настроек параметров в СНК-АЗС для обслуживания клиентов (водителей), совершающих заправку топливом на АЗС через мобильное приложение **Яндекс.Заправка** без участия оператора АЗС.
Руслан Савельев 1.1 4
Руслан Савельев 27.1 5 == **Регламент подключения ТО** ==
Руслан Савельев 1.1 6
Руслан Савельев 3.1 7 (% class="box" %)
8 (((
Руслан Савельев 2.1 9 **Партнерская сеть ТО:**
Руслан Савельев 1.1 10
Руслан Савельев 2.1 11 ~1. Заполняет реквизиты подключаемых ТО (номер, адрес, GPS координаты) в личном кабинете сервиса «СНК-Менеджмент» и, при необходимости, выполняет сопоставление видов топлива на АЗС с мобильным сервисом;
12 2. Распределяет лицензию «СНК-Яндекс.Заправка» на hasp-ключ ТО;
13 3. Выполняет настройку программного обеспечения на ТО согласно данной инструкции;
14 4. Сообщает в СНК об окончании настройки ТО.
Руслан Савельев 1.1 15
Руслан Савельев 2.1 16 **СНК:**
Руслан Савельев 1.1 17
Руслан Савельев 2.1 18 5. Проводит проверку наличия связи с указанными ТО;
Руслан Савельев 25.1 19 6. Активирует на сервере СНК указанные ТО.
Руслан Савельев 2.1 20
21 **Сервис Яндекс:**
22
23 7. Проверяет доступность Сервера СНК и информацию по указанным ТО;
24 8. Активирует указанные ТО в мобильном приложении Яндекс.Заправка.
25
26 **Партнерская сеть ТО:**
27
28 9. Проверяет наличие ТО в мобильном приложении Яндекс.Заправка (сверяет название ТО и расположение на карте);
29 10. Проверяет соответствие номеров пистолетов и типов топлива с отображением в мобильном приложении;
30 ~11. Проводит контрольную заправку на своих ТО через мобильное приложение Яндекс.Заправка с участием водителя;
31 12. Проводит инструктаж персонала по работе с данным сервисом.
Руслан Савельев 3.1 32 )))
Руслан Савельев 2.1 33
34 (% class="box infomessage" %)
35 (((
36 **Далее в инструкции подробно описаны вышеперечисленные шаги регламента.**
37 )))
38
Руслан Савельев 27.1 39 == **1. Заполнение реквизитов ТО** ==
Руслан Савельев 2.1 40
Руслан Савельев 7.2 41 * В ЛК «[[СНК-Менеджмент>>doc:Prilozheniia_SNK.SNK_Menedzhment.WebHome||target="_blank"]]» должна быть заведена ТО с заполненными адресом и координатами ([[подробно тут>>doc:Prilozheniia_SNK.SNK_Menedzhment.Upravlenie_tochkami_obsluzhivaniia__TO_.Dobavlenie_novoi_TO.WebHome||target="_blank"]]).
Руслан Савельев 4.1 42 * Если в сети организации используются разные подвиды одного топлива (например, ДТ, ДТЛ, ДТЗ, АИ-92 и АИ-92 премиум и т.д.) то необходимо настроить соответствие видов топлива на АЗС с мобильным сервисом ([[подробно тут>>doc:Prilozheniia_SNK.SNK_Menedzhment.Rabota_s_mobil_nymi_servisami.Perekodirovka_topliva.WebHome||target="_blank"]]).
Руслан Савельев 2.1 43
Руслан Савельев 27.1 44 == **2. Распределение лицензии** ==
Руслан Савельев 2.1 45
Руслан Савельев 28.2 46 Для работы служб мобильных сервисов, необходимо распределить лицензию «**СНК-Яндекс.Заправка**» на hasp-ключ ТО ([[подробно тут>>doc:Prilozheniia_SNK.SNK_Menedzhment.Upravlenie_litsenziiami.Raspredelenie_dopolnitel_nykh_litsenzii_na_TO.WebHome||target="_blank"]]).
Руслан Савельев 2.1 47
Руслан Савельев 27.1 48 == **3. Настройка в «СНК-АЗС»** ==
Руслан Савельев 2.1 49
Руслан Савельев 27.1 50 === **3.1. Автозапуск контроллера терминалов** ===
Руслан Савельев 2.1 51
Руслан Савельев 24.1 52 Для работы с сервисом «СНК-Яндекс.Заправка», необходимо, чтобы программа «[[Контроллер терминалов АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Kontroller_terminalov_samoobsluzhivaniia_SNK-AZS.WebHome||target="_blank"]]» была запущена во время работы «[[СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.WebHome||target="_blank"]]»
Руслан Савельев 2.1 53
Руслан Савельев 24.1 54 {{display reference="Prilozheniia_SNK.SNK-AZS.Kontroller_terminalov_samoobsluzhivaniia_SNK-AZS.Avtozapusk_kontrollera_terminalov.WebHome"/}}
Руслан Савельев 2.1 55
Руслан Савельев 27.1 56 === **3.2. Добавление устройства ПОС-терминал** ===
Руслан Савельев 2.1 57
Руслан Савельев 12.2 58 Работа сервиса мобильных заявок осуществляется через настраиваемое программное устройство (терминал самообслуживания), для его добавления выполните следующие шаги:
Руслан Савельев 2.1 59
Руслан Савельев 12.2 60 * Запустите приложение «[[Конфигуратор оборудования СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Konfigurator_oborudovaniia_SNK-AZS.WebHome]]» и выберите группу «**ПОС-терминал**».
61 * Кликните правой кнопкой мыши на ней и выберите «**Добавить устройство**»:
Руслан Савельев 2.1 62
Руслан Савельев 12.2 63 (% style="width: 550px;" %)
64 [[Добавление устройства в группу>>image:1747217095196-728.png||data-xwiki-image-style-alignment="center"]]
Руслан Савельев 2.1 65
Руслан Савельев 12.2 66 * В открывшемся окне «**Настройки**» заполните значения:
67 ** **Тип** – ##Сервис мобильных заявок СНК##
68 ** **Имя** – ##Яндекс##
69 ** **Группа** – ##Не задано##
70 ** **Инициализировать устройство только при обращении** – параметр не отмечен
71 ** **Статус** – Доступно //(заполняется автоматически)//
72 * Нажмите «**ОК**»
Руслан Савельев 2.1 73
Руслан Савельев 12.2 74 [[Выбор типа устройства>>image:1747217384261-593.png||data-xwiki-image-style-alignment="center"]]
Руслан Савельев 2.1 75
Руслан Савельев 14.1 76 * В левом окне раскройте список устройств в группе «**ПОС-терминал**» нажав на** кнопку с плюсом** у названия этой группы.
Руслан Савельев 12.2 77 * Выберите добавленное устройство «**Яндекс**» и в правом окне появятся его настройки, заполните значения:
78 ** **Номер терминала** – номер устройства, должен быть уникальным среди всех терминалов на данной ТО
79 ** **Адрес сервера** – ##mobile.sncard.ru##
80 ** **ПОС-терминал** – ##mobile2.sncard.ru##
Руслан Савельев 21.1 81 ** **Порт** – ##2373## //(впишите в оба окна)//
Руслан Савельев 12.2 82 ** **Сервис заявок** – выберите значение «**СНК-API (сервис заявок)**», нажмите кнопку «**Загрузить**», дождитесь загрузки списка и выберите в нем **Yandex**
83 ** Отметьте флажками опции:
84 *** Передавать состояние ТРК
85 *** Передавать счетчик текущего расхода
86 *** Использовать для обмена канал NATS
87 * Нажмите кнопку «**Сохранить настройки**» и закройте «[[Конфигуратор оборудования>>doc:Prilozheniia_SNK.SNK-AZS.Konfigurator_oborudovaniia_SNK-AZS.WebHome||target="_blank"]]»:
Руслан Савельев 2.1 88
Руслан Савельев 12.2 89 [[Сохранение настроек устройства>>image:1747217705876-296.png||data-xwiki-image-style-alignment="center" height="318" width="700"]]
Руслан Савельев 2.1 90
Руслан Савельев 27.1 91 === **3.3. Добавление ведомости для проведения и учета заявок** ===
Руслан Савельев 2.1 92
Руслан Савельев 14.1 93 Ведомость необходима для проведения оплаты по заявкам в «СНК-АЗС», также по ней будут формироваться отчеты.
Руслан Савельев 2.1 94
Руслан Савельев 14.1 95 (% class="box infomessage" %)
96 (((
97 * Если используется разделение заявок по типу клиента (физические и юридические лица), то необходимо создать отдельные ведомости для каждого типа (например, «**Яндекс - физ. лица**» и «**Яндекс - юр. лица**»).
98 * Если разделение по типу клиента не используется, то добавьте одну ведомость (например, «**Яндекс**», по которой будут проводится все заявки от мобильного сервиса Яндекс.
99 )))
Руслан Савельев 2.1 100
Руслан Савельев 14.1 101 Ведомость может быть:
Руслан Савельев 2.1 102
Руслан Савельев 14.1 103 * **Централизованная** - создается в «СНК-Офис», либо в «СНК-ПЦ» и передается на точки обслуживания через «Коммуникационный сервер СНК».
104 * **Локальная** – создается на АЗС.
Руслан Савельев 2.1 105
Руслан Савельев 14.1 106 (% class="box infomessage" %)
107 (((
108 В случае, если на ТО используются только централизованные ведомости без локальных ведомостей, необходимо на ТО, в файле ##bo_app.snc## (##SNC_AZS\backofficeapp##) изменить значение параметра ##StatementBalanceToCard ##на ##1##, пример:
Руслан Савельев 2.1 109
Руслан Савельев 14.1 110 ##[ExchangeModule]
111 StatementBalanceToCard=1##
112 )))
Руслан Савельев 2.1 113
Руслан Савельев 14.1 114 Для создания локальной ведомости, выполните следующие шаги:
Руслан Савельев 2.1 115
Руслан Савельев 14.1 116 * Запустите приложение «[[Управление скидками СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Upravlenie_skidkami_SNK-AZS.WebHome||target="_blank"]]», выберите раздел «**Ведомости**» и перейдите на вкладку «**Организации**»:
Руслан Савельев 2.1 117
Руслан Савельев 15.2 118 [[Вкладка "Организации" в разделе "Ведомости">>image:1747218262874-972.png||data-xwiki-image-style-alignment="center" height="299" width="600"]]
Руслан Савельев 2.1 119
Руслан Савельев 15.2 120 В поле этой вкладки нажмите **правой кнопкой мыши** и выберите «**Создать организацию**»:
Руслан Савельев 2.1 121
Руслан Савельев 15.2 122 [[Создание новой ведомости>>image:1747218385440-666.png||data-xwiki-image-style-alignment="center" height="299" width="600"]]
Руслан Савельев 2.1 123
Руслан Савельев 15.2 124 * В открывшемся окне измените параметры:
Руслан Савельев 21.1 125 ** **Имя** – название ведомости (например, ##Яндекс##).
126 ** **Заблокировать** – ##Да## //(блокировка делает ведомость недоступной для оператора, при выборе им типа оплаты для расчета клиентов).//
Руслан Савельев 2.1 127
Руслан Савельев 18.2 128 [[Настройка параметров ведомости>>image:1747218511493-739.png||data-xwiki-image-style-alignment="center" height="282" width="370"]]
Руслан Савельев 2.1 129
Руслан Савельев 27.1 130 === **3.4. Настройка ПОС-терминала** ===
Руслан Савельев 2.1 131
Руслан Савельев 18.2 132 Добавленное программное устройство ПОС-терминал (терминал самообслуживания) необходимо настроить и привязать к нему ведомости для проведения по ним заявок, для этого выполните следующие шаги:
Руслан Савельев 2.1 133
Руслан Савельев 18.2 134 * Запустите приложение «[[Управление конфигурацией СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Upravlenie_konfiguratsiei_SNK_AZS.WebHome||target="_blank"]]» и выберите раздел «**Терминалы самообслуживания**»:
Руслан Савельев 2.1 135
Руслан Савельев 18.2 136 [[Раздел настроек ПОС-терминалов>>image:1747218682468-785.png||data-xwiki-image-style-alignment="center"]]
Руслан Савельев 2.1 137
Руслан Савельев 18.2 138 * На строке устройства «**Яндекс**» кликните правой кнопкой мыши и выберите «**Редактировать**»:
Руслан Савельев 2.1 139
Руслан Савельев 18.2 140 [[Вход в режим изменения настроек ПОС-терминала>>image:1747218763809-375.png||data-xwiki-image-style-alignment="center"]]
Руслан Савельев 2.1 141
Руслан Савельев 18.2 142 * В открывшемся окне «**Мастер настройки ТСО**» заполните значения:
143 ** **Тип терминала** – ##Терминалы других производителей##
144 ** **Вед. организация (по умолч.)** – ##Яндекс## //(созданная ведомость, добавить только, если создана одна общая ведомость, если создавались разные ведомости для физ. и юр. лиц, то оставить пустое значение)//
Руслан Савельев 21.1 145 ** **Вед. организация (физ. лица)** – ##Яндекс (физ. лица)##// (созданная ведомость, добавить только, если создана специальная ведомость для физ. лиц, если создавалась одна общая ведомость, то оставить пустое значение)//
Руслан Савельев 18.2 146 ** **Вед. организация (юр. лица)** – ##Яндекс (юр. лица)## //(созданная ведомость, добавить только, если создана специальная ведомость для юр. лиц, если создавалась одна общая ведомость, то оставить пустое значение)//
147 ** **Принудительный пуск ТРК** – ##Да##
Руслан Савельев 2.1 148
Руслан Савельев 20.1 149 [[Терминал настроен на одну общую ведомость>>image:1747218968786-897.png||data-xwiki-image-style-alignment="center"]]
Руслан Савельев 2.1 150
Руслан Савельев 27.1 151 === **3.5. Проверка доступности портов TCP** ===
Руслан Савельев 2.1 152
Руслан Савельев 21.1 153 * Убедитесь, что на ПК открыты входящие и исходящие порты: 1313, 2373
154 * Убедитесь в отсутствии блокировки соединения АЗС с сервером. Список возможных блокировок:
155 ** брандмауэр операционной системы блокирует соединение;
156 ** маршрутизатор сети блокирует подключение (белый список);
157 ** настройки модема ограничивают доступ в сеть интернет.
Руслан Савельев 2.1 158
Руслан Савельев 27.1 159 == **4. Сообщение в СНК о настроенной ТО** ==
Руслан Савельев 2.1 160
Руслан Савельев 20.1 161 * Сообщите об окончании настройки мобильного сервиса в СНК одним из способов:
162 ** по телефону в рабочее время
163 ** создав заявку на сайте техподдержки.
Руслан Савельев 2.1 164
Руслан Савельев 27.1 165 == **5. Проверка связи с ТО от СНК** ==
Руслан Савельев 2.1 166
Руслан Савельев 20.1 167 * СНК проверит наличие связи с указанной ТО.
Руслан Савельев 2.1 168
Руслан Савельев 27.1 169 == **6. Активация ТО от СНК** ==
Руслан Савельев 2.1 170
Руслан Савельев 21.1 171 * СНК активирует ТО. После активации, АЗС должна появиться в «[[СНК-Менеджмент>>doc:Prilozheniia_SNK.SNK_Menedzhment.WebHome||target="_blank"]]», в разделе мобильных сервисов, на вкладке «**Активность ТО**» в группе Яндекс, с соответствующим ТО номером ([[подробно тут>>doc:Prilozheniia_SNK.SNK_Menedzhment.Rabota_s_mobil_nymi_servisami.WebHome||target="_blank"]]).
Руслан Савельев 2.1 172
Руслан Савельев 27.1 173 == **7. Проверка информации сотрудниками Яндекса** ==
Руслан Савельев 2.1 174
Руслан Савельев 20.1 175 * Сотрудники Яндекса проверят доступность «Сервера СНК» и информацию по подключаемой ТО.
Руслан Савельев 2.1 176
Руслан Савельев 27.1 177 == **8. Активация ТО в приложениях Яндекс** ==
Руслан Савельев 2.1 178
Руслан Савельев 20.1 179 * Сотрудники Яндекса активируют подключаемую ТО в своем приложении.
Руслан Савельев 2.1 180
Руслан Савельев 27.1 181 == **9. Проверка наличия ТО в приложении клиента** ==
Руслан Савельев 2.1 182
Руслан Савельев 20.1 183 * В приложении клиента проверьте название ТО и его расположение на карте.
Руслан Савельев 2.1 184
Руслан Савельев 27.1 185 == **10. Проверка конфигурации пистолетов ТРК** ==
Руслан Савельев 2.1 186
Руслан Савельев 20.1 187 * В приложении клиента проверьте визуальное соответствие номера колонки и типов топлива с отображением в мобильном приложении. В мобильном приложении, чтобы сделать заявку, клиент выбирает номер колонки и тип топлива, поэтому нужно убедиться, что на АЗС правильно пронумерованы колонки и их стороны.
Руслан Савельев 2.1 188
Руслан Савельев 27.1 189 == **11. Контрольная заправка на ТО** ==
Руслан Савельев 2.1 190
Руслан Савельев 20.1 191 * Проведите тестовую заправку на ТО, используя мобильное приложение Яндекса.
Руслан Савельев 2.1 192
Руслан Савельев 27.1 193 == **12. Инструктаж персонала** ==
Руслан Савельев 2.1 194
Руслан Савельев 20.1 195 * Проинструктируйте операторов АЗС и заправщиков, как действовать при заявке от мобильных приложений (в какой момент снимать пистолет, когда включать колонку, если требуется и т.д.).
Руслан Савельев 2.1 196
Руслан Савельев 1.1 197