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