Установка и настройка модуля [База знаний ГК Карбис]

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

Актуальный дистрибутив: [[https://disk.yandex.ru/d/EV6ZnP9vBqb0AQ|https://disk.yandex.ru/d/EV6ZnP9vBqb0AQ]]

===== Установка стыковочного модуля =====

Распаковываем архив в папку:

**aggregator_delivery.exe** - создаём ярлык и запускаем службой/десктопом (ПКМ→Свойства→Ярлык и задаём ключ **/install** или **/desktop**)

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

вся информация хранится в файле dbase.db

После запуска службы сервис будет доступен по адресу **127.0.0.1:5000**

====== Лицензирование ======

Модуль способен работать без лицензии в режиме "заполнение меню". Все предварительные операции - настройка, подготовка меню - можно делать без лицензирования. Лицензии необходимы на этапе приёма заказов.

Для работы модуля требуется одновременно две лицензии:

  - лицензия на стыковочный модуль от "Карбис"
  - лицензия на xml_save_order от UCS (поддержана как lifetime, так и saas-версия лицензии)

Для получения лицензии на **модуль от "Карбис"**  нужно написать заявку **на адрес info@carbis.ru**  Для получения лицензии на **xml_save_order**  от UCS **нужно сделать заявку в UCS**  в стандартном порядке (или обратиться к дилеру, если вы представитель ресторана). Далее по тексту предполагается, что **лицензия на модуль от UCS уже активирована и не закончилась.**

В системе лицензирования lic.carbis.ru создаётся мастер лицензия для модуля Aggregator_Delivery. Эту операцию выполняют сотрудники "Карбис" после подтверждения заявки на установку.
 {{:external:интеграция_с_агрегаторами_доставки:pasted:20210906-092824.png}}



Запускаем приложение с ключом /license

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

Откроется окно, где авторизуемся под дилерской учёткой lic.carbis.ru Затем выбираем ранее созданную мастер лицензию

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

Также модуль поддерживает XML SaaS. Подробнее об использовании XML лицензий [[https://wiki.carbis.ru/external/интеграция_с_агрегаторами_доставки/xml_saas_howto|по ссылке]]

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

Далее необходимо направить письмо **на адрес info@carbis.ru** следующего содержания:
Тема:
<code>

 Заявка на подключение модуля "интеграция с агрегаторами доставки".

</code>

Письмо:

<code>
Я, {имя}, представитель компании {Компания} прошу подключить интеграцию для ресторана {Название ресторана, предварительно заведённого в lic.carbis.ru}.
Внешний белый IP-адрес ресторана: {IP-адрес}
Порт, проброшенный для модуля интеграции: {порт, по умолчанию 5000}
API-токен для внешней системы {API-токен}. API-токен скопирован мною из этой секции настроек:
Адрес: фактический адрес данного конкретного ресторане (город, улица и т. д.)

</code>

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

[[https://wikiint.carbis.ru/internal/int_soft/yayeda_admin|Для инженеров ГК "Карбис". Описание настройки на стороне сервера.]]




====== Запуск службы и первичная настройка ======

Создание заказов происходит через XML-интерфейс. Для этого в R_keeper создаётся [[https://wiki.carbis.ru/external/интеграция_с_агрегаторами_доставки/01preliminary_config_rk7|учётка]] с полными правами на кассовые операции.

====   ====

После запуска службы aggregator_delivery, веб-интерфейс приложения будет доступен по адресу **127.0.0.1:5000** (127.0.0.1 - если запускать настройку локально на том же ПК, где устанавливаем модуль интеграции)

Заходим в **Параметры ** и задаём следующие свойства:

- API токен - при первом запуске модуля токен генерируется автоматически;

- Адрес и порт кассового сервера;

- Логин/пароль учётки с полными правами для создания заказов через XML;

- Стол, на который будут приходить заказы из Яндекс.Еды:
  * для платформы Яндекс
  * для платформы Маркет деливери

- Кассовая станция;

- Выбираем классификацию меню (создаём при начальных настройках RK);

- Категорию заказа.
{{ :external:интеграция_с_агрегаторами_доставки:pasted:20231012-140309.png }}
{{ :external:интеграция_с_агрегаторами_доставки:pasted:20231012-140443.png }}
**Опционально:** Функция передачи оплаты указанной валютой
При включении чекбокса "Добавлять предоплаты в заказы интеграции" станет доступен выбор Валюты и Причины внесения
{{ :external:интеграция_с_агрегаторами_доставки:pasted:20231012-125146.png }}

Приложение имеет функцию **Автоматического принятия заказов**, которая работает в трёх режимах:

- Отключено;

- Сохранить в r_keeper (создаст стол и сразу отправит сервис-печать);

- Сохранить с уточнением (сохранит как черновик, с необходимостью редактирования и подтверждения заказа до отправки сервис-печати).

Далее переходим во вкладку **"Меню"** и заполняем карточки блюд, которые выгрузились в интерфейс из ранее привязанной классификации.

На скриншоте показано, как должно быть всё заполнено.

**Внимание!!!** Названия блюд здесь берутся из **расширенного свойства** **yaedaname**.
{{ :external:интеграция_с_агрегаторами_доставки:2024-04-26_10-59-08.png |}}

===== Платная доставка курьерами ресторана =====

<hidden>

При настройке кипера мы создали блюдо с открытой ценой. Здесь в поле "Блюдо для учета платной доставки" оно выбирается. Механизм прост: Яндекс.Еда передаёт информацию о стоимости доставки курьером ресторана, приложение интеграции добавляет в стол блюдо с открытой ценной и задаёт ему эту стоимось. {{:external:интеграция_с_агрегаторами_доставки:pasted:20210813-150458.png}}

</hidden>