====== Установка и настройка модуля ======

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

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

Распаковать архив в отдельную папку. Не нужно распаковывать на рабочем столе или в каталог с названием версии.

Приложение может работать как службой, так и в консольном режиме.
В реальной эксплуатации рекомендуется установить Модуль интеграции службой.
В каталоге присутствуют несколько файлов для запуска:
  * install.bat - устанавливает службу (запуск от имени администратора).
  * desktop.bat - запускает приложение в консольном режиме.
  * license.bat - запускает сервер с окном лицензирования до основного запуска.

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

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

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

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

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

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

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

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

====== Настройка связи с r_keeper ======

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


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


Для настройки необходимо перейти в Параметры → Установи → Настройки R-Keeper, указать в полях [[https://wiki.carbis.ru/external/интеграция_с_агрегаторами_доставки/01preliminary_config_rk7|настройки]] сделанные ранее :
  * Адрес и порт кассового сервера.
  * Логин/пароль учётки с полными правами для создания заказов через XML.
  * Стол, на который будут приходить заказы из Яндекс.Еды:
      *  для платформы Яндекс
      *  для платформы Маркет деливери
  * Кассовая станция.
  * Классификация для выгрузки меню. 
  * Категория заказа.
  * Блюдо для учёта платной доставки.
  * Скидка на блюдо.
  * Скидка на заказ.
{{ :external:интеграция_с_агрегаторами_доставки:2024-06-27_10-59-19.png |}}
{{ :external:интеграция_с_агрегаторами_доставки:2024-06-27_11-15-57.png |}}

**Опционально:** Функция передачи оплаты указанной валютой.
При включении чек-бокса "Добавлять предоплаты в заказы интеграции" станет доступен выбор Валюты и Причины внесения
{{ :external:интеграция_с_агрегаторами_доставки:2024-07-01_16-02-48.png |}}

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

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

</code>

Письмо:

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

</code>

{{ :external:интеграция_с_агрегаторами_доставки:2024-06-27_11-29-40.png |}}

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