Предварительные настройки в r_keeper [База знаний ГК Карбис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Предварительные настройки в r_keeper ======

===== Создание расширенного свойства для названий блюд =====

**ВАЖНО!!! Обязательно ** создаём **__расширенное свойство__**  в RK7 с системным именем **yaedaname**. Это поле появится в справочнике "Меню" в свойствах блюд. В него необходимо вписывать названия блюд в соответствии с требованиями "Яндекса". Если название соответствует сразу - поле можно оставлять незаполненным.

Название блюда для Яндекс.Еды должно быть без спец.символов, без орфографических ошибок и не иметь в имени пограммовку

Настройки → Настройка → Расширенные свойства.

{{  :internal:pasted:20210616-171438.png  }}

В открывшемся окне переходим в "Свойства для справочников", ПКМ → Новый тип расширенных свойств. Задаём название и **"Список типов"** - Элемент меню

{{  :internal:pasted:20210629-080040.png  }}

Открыв окно "Список типов" жмём ПКМ и "Добавить элемент"

{{  :internal:pasted:20210629-080431.png  }}

Выбираем группу "Меню, Модификаторы, Цены" → Элемент меню{{  :internal:pasted:20210629-080632.png  }}
После настройки расширенного свойства необходимо перезапустить менеджерскую часть

Пример:

{{  :internal:pasted:20210629-082302.png  }}

===== Создание стола для сохранения заказа =====

<hidden>

Настройки - столы и залы - планы залов и столы. Создаём отдельный план зала(например, Доставка) и стол, защищаем кассовым правом.

{{  :external:интеграция_с_агрегаторами_доставки:pasted:20210705-154519.png  }}

</hidden>

===== Если в ресторане есть платная доставка =====

<hidden>

Яндекс.Еда передаёт информацию о стоимости доставки курьерами ресторана. Для этого в кипере создаём блюдо с открытой ценой (при дальнейших настройках приложения интеграции это блюдо будет выбираться в специальном поле)

{{  :external:интеграция_с_агрегаторами_доставки:pasted:20210813-150237.png  }}

</hidden>

===== Создание "категории заказа" =====

<hidden>

Заказ - категории заказа. Создаём отдельную категорию заказа "Яндекс (доставка)". Настраиваем использование этой категории заказа для стола доставки.

</hidden>

===== Создание работника для xml =====

<hidden>

  * В справочнике Персонал→Работники создать новую роль с названием "XML-Editing", поставить статус-"Активный", выдать группе максимум кассовых прав (Секция "Кассовые ограничния - операции".
  * Для новой роли создать работника с именем http (либо другое, написанное на латинице), поставить статус-"Активный"
  * Для работника с именем http, в свойствах в параметре «Учетная запись» задать произвольный пароль.
  * В свойствах группы работников в "Привилегиях на объекты" «HTTP Access»,«Тип цены основная», «Фискальные отчеты» поставить галочку. Привилегия "HTTP Access" должна быть предварительно создана.
  * Не забываем добавить роли право "Яндекс еда"

Право создаётся в справочнике Персонал→Права

{{  :external:интеграция_с_агрегаторами_доставки:pasted:20210705-155459.png  }}

{{  :external:интеграция_с_агрегаторами_доставки:pasted:20210705-160611.png  }}

</hidden>

===== Настройка Http-сервера =====

<hidden>

  * В справочнике Сервис→Станции и Устройства выбрать кассовый сервер, с которым будет работать модуль.
  * В свойствах кассового сервера задать свободный порт в параметре HTTP Data port. Оставлять порт 80 - не рекомендуется.
  * В параметрах HTTP API, Web interface, XML interface установить значение "HTTP Access" (это название привилегии на объект, которое также должно быть у учетки из "Персонал-работники"

{{  :external:интеграция_с_агрегаторами_доставки:pasted:20210705-162712.png  }}

  * Проверить, что у всех станций есть право "Яндекс Еда"

{{  :external:интеграция_с_агрегаторами_доставки:pasted:20210705-161612.png  }}

</hidden>

===== Настройка классификаций блюд =====

<hidden>

Для синхронизации меню между r_keeper и Яндекс.Еда необходимо указать какие блюда следует выгружать, а какие нет. Для этого необходимо создать новую классификацию блюд:

  - В справочнике Меню→Классификации блюд создать новую классификацию "Яндекс.Еда". Установить статус-"Активный".
  - Для данной классификации создать новые категории (с такими же названиями, как и разделы меню в Яндекс.Еде), сделать их активными.
  - Расставить категории всем имеющимся блюдам.

{{  :external:интеграция_с_агрегаторами_доставки:pasted:20210708-081930.png  }}

</hidden>

----

=====   =====

====== Настройка "веб-сервиса" ======

Для того, чтобы веб-интерфейс модуля был доступен на кассовой станции, необходимо произвести следующие настройки:

Настройки → Параметры → Установочные → Связь с другими системами → Сервисы

В свойстве "Строковый" пишем адрес и порт модуля в формате [[http://123.123.123.123:5000?source=rk7|http://192.168.0.1:5000?source=rk7]]

где 192.168.0.1 - ip адрес машины, на которой запущен server.exe модуля

5000 - порт модуля по умолчанию

 \\ {{  :internal:pasted:20210629-141336.png  }}

После этого можно будет открывать веб-интерфейс приложения с главного экрана кассы (см.скриншот)

{{  :internal:pasted:20210615-122335.png  }}

===== Настройка веб-сервиса через расширенное свойство (опционально, например, если у вас используется несколько сервисов с разными адресами) =====

<hidden>

Заходит в Настройки - > Настройка → Расширенные свойства

{{  :internal:pasted:20210616-171438.png  }}

Выбираем группу "Свойства для справочников", в окне "Типы расширенных свойств" ПКМ → Создать новый тип с названием и системным именем **yaedadlvAdress**

{{  :internal:интеграция_яндекс.еда_-_rk7:pasted:20210702-081735.png  }}

Открываем "Список Типов" нажав на троеточие либо двойным кликом

{{  :internal:интеграция_яндекс.еда_-_rk7:pasted:20210703-143319.png  }}

В открывшемся окне ПКМ → Добавить Элемент

{{  :internal:интеграция_яндекс.еда_-_rk7:pasted:20210703-143314.png  }}

Затем выбираем группу "Система" и "Ресторан"

{{  :internal:pasted:20210629-141358.png  }}

{{  :internal:pasted:20210629-141353.png  }}

После настройки расширенного свойства переходим в Настройки → Параметры → Установочные → Связь с другими системами → Сервисы

в URL web-сервиса в параметре "Строковый" вставляем [Restaurants.genyaedadlvAdress]

yaedadlvAdress - в нашем случае и есть то самое расширенное свойство

{{  :internal:pasted:20210629-141322.png  }}

В свойствах ресторана "Сервис - > Станции и устройства" заходим в Расширенные свойства и в созданном **yaedadlvAdress**  прописываем строку подключения к машине с модулем интеграции в формате: **[[http://192.168.0.1:5000?source=rk7|http://192.168.0.1:5000?source=rk7]]**

здесь **192.168.0.1 **- локальный **ip адрес**  станции, на которой стоит модуль ya_eda.exe

**5000**  - порт по умолчанию

{{  :internal:pasted:20210629-141328.png  }}

</hidden>

===== Изменение внешнего вида кнопки запуска на кассе (опционально) =====

<hidden>

По желанию можно визуально отредактировать форму, чтобы кнопка интерфейса была более привлекательной.

Настройки → Графический интерфейс → Селекторы. Выбираем группу селекторов, которая используется (можно посмотреть в Настройки → Графический интерфейс → Использование селекторов)

{{  :internal:интеграция_яндекс.еда_-_rk7:pasted:20210702-082250.png  }}

Затем открываем макет Главного меню и переходим к настройке кнопки "Сервис"

{{  :internal:интеграция_яндекс.еда_-_rk7:pasted:20210702-082402.png  }}

</hidden>