====== 4. Настройки модуля ======

Раздел "Настройки" состоит из четырех вкладок: "Подключение к r_keeper", "Справочники", "Агент и логи", "Внешний доступ". Первые две - одна форма: при любом изменении внизу появляется панель "Изменено полей: N" с кнопками "Отменить" и "Сохранить". Сохраненные настройки применяются сразу, без перезапуска службы.

===== Вкладка "Подключение к r_keeper" =====

^ Поле ^ Что указать ^
| Адрес и порт кассового сервера | IP и порт HTTP-XML интерфейса, например ''192.168.0.10:4545'' |
| Пользователь XML-интерфейса | логин работника r_keeper латиницей |
| Пароль | пароль этого работника |
| Кассовая станция | станция, от имени которой берутся цены меню и создаются заказы |
| Тип XML лицензии | "R_keeper модуль XML сохранения заказов" или "R_keeper модуль XML-интерфейс для приложения" (SaaS) |

Кнопка "Проверить связь" проверяет введенные данные до сохранения. Если адрес и учетку не меняли - показывает состояние текущего подключения и время последнего успешного ответа. После успешной проверки новых данных нужно нажать "Сохранить".

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s4_01.png |Вкладка "Подключение к r_keeper"}}

**SaaS XML лицензия.** При типе "XML-интерфейс для приложения" ниже появляется карточка "Параметры SaaS XML лицензии":
  - Указать логин (email) и пароль дилерской учетной записи l.ucs.ru. Пароль в открытом виде не хранится: после сохранения поля снова пустые, а в состоянии - "Учетная запись l.ucs.ru: Задана".
  - Выбрать "Тип SaaS XML лицензии" (1 или 12 мес.) - как в заявке на лицензию.
  - Нажать "Сохранить" и проверить состояние: "Действует до" заполнено, "Ошибка сервера l.ucs.ru" - "Ошибок нет".

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s4_02.png |Параметры SaaS XML лицензии}}

Другие кнопки карточки:
  * "Синхронизировать номер запроса" - после ошибки r_keeper о неверном порядковом номере запроса (seqNumber);
  * "Новый инстанс лицензии" - счетчик запросов начнется заново. Делать только по указанию поддержки UCS или при переносе лицензии на другой сервер.

Модуль запрашивает лицензию у l.ucs.ru не чаще раза в 90 минут. Если l.ucs.ru недоступен, работает на сохраненной ранее лицензии.

===== Вкладка "Справочники" =====

Все списки заполняются из r_keeper. Если r_keeper не ответил, сверху будет "Справочники r_keeper не загружены, списки пустые" - сначала настройте подключение. В списках можно искать по началу названия или коду.

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s4_03.png |Вкладка "Справочники": регион, токен, столы}}

^ Группа / поле ^ На что влияет ^
^ Регион и Яндекс Еда ^^
| Регион | Россия - в меню уходит маркировка, ОКПД 2, ТН ВЭД; Узбекистан - коды MXIK и упаковки, цены в сумах |
| API токен для внешней системы | токен, по которому хост Carbis обращается к модулю; генерируется модулем |
^ Коды Узбекистана (только для региона Узбекистан) ^^
| Свойство блюда с MXIK (ИКПУ), Свойство блюда с кодом упаковки | расширенные свойства блюда r_keeper, из которых берутся коды |
^ Столы для заказов ^^
| Курьер Яндекса, Свой курьер ресторана, Самовывоз | стол r_keeper для заказа Яндекс Еды по типу доставки; стол "Курьер Яндекса" также используется для цен и стоп-листа |
| Те же три поля "..., платформа Delivery Club" | столы для заказов Маркет Деливери |
^ Меню и заказ ^^
| Классификация для выгрузки меню | категории этой классификации становятся категориями меню в Яндекс Еде |
| Категория заказа | категория создаваемого заказа; по ней же берутся цены меню |
| Официант для создания заказа | не задан - заказ создается от имени системы; если r_keeper отказал, модуль повторяет без официанта |
| Количество гостей по умолчанию | если Яндекс не передал; если в r_keeper "Исп. количество гостей" = "Обязательное свойство", заказ с 0 гостей создается с 1 |
^ Скидки и доставка ^^
| Скидка на блюдо | для акций Яндекса на отдельные блюда |
| Скидка на заказ | для промокодов и скидок на весь заказ |
| Блюдо для платной доставки | блюдо со свободной ценой для стоимости доставки "Свой курьер" |
| Передавать время доставки в r_keeper (блок доставки) | в заказ r_keeper добавляется блок доставки со временем |
^ Предоплата ^^
| Вносить предоплату в заказ, Валюта предоплаты, Причина внесения | в заказ вносится предоплата выбранной валютой на неоплаченную сумму |
^ Автозакрытие заказа ^^
| Сотрудник для закрытия, Валюта оплаты | кем и чем закрывается заказ в режиме автопринятия "Принимать и закрывать" |
^ Свойства заказа в r_keeper ^^
| Имя клиента, Телефон, Адрес доставки | расширенные свойства заказа, куда записываются данные клиента; "Не задано" - не записываются |

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s4_04.png |Вкладка "Справочники": скидки, предоплата, автозакрытие}}

===== Вкладка "Агент и логи" =====

  * **Агент**: уровень логирования (0-10, по умолчанию 3; для разбора проблем - 8), сколько дней хранить логи, адрес и порт, на которых слушает модуль. Применяются после перезапуска службы.
  * **Статистика**: "Отправлять статистику работы модуля" - применяется сразу.
  * **Дизайн админки**: "Вернуться на старый дизайн". Выбор общий для всех, кто открывает веб-интерфейс. В старом дизайне вернуться на новый - Параметры -> "Перейти на новый дизайн".

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s4_05.png |Вкладка "Агент и логи"}}

===== Вкладка "Внешний доступ" =====

С самой кассы и из локальной сети веб-интерфейс открывается без пароля. С внешних адресов - только по логину и паролю (для этого нужен проброс порта). Пока логин и пароль не заданы, внешний доступ закрыт.
  * "Задать логин и пароль" / "Сменить логин и пароль" - открыть доступ по паролю;
  * "Закрыть внешний доступ" - сбросить логин и пароль.

Менять их можно только с локального адреса. На работу хоста Carbis и Яндекса эта настройка не влияет: они работают по API токену.

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s4_06.png |Вкладка "Внешний доступ"}}