external:интеграция_с_агрегаторами_доставки:02_installmod_config

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

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

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

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

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

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

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

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

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

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

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

В системе лицензирования lic.carbis.ru создаётся мастер лицензия для модуля Aggregator_Delivery. Эту операцию выполняют сотрудники «Карбис» после подтверждения заявки на установку.

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

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

Также модуль поддерживает XML SaaS. Подробнее об использовании XML лицензий по ссылке

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

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

Письмо:

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

Для инженеров ГК "Карбис". Описание настройки на стороне сервера.

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

Создание заказов происходит через XML-интерфейс. Для этого в R_keeper создаётся учётка с полными правами на кассовые операции.

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

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

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

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

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

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

  • для платформы Яндекс
  • для платформы Маркет деливери

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

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

- Категорию заказа.


Опционально: Функция передачи оплаты указанной валютой
При включении чекбокса «Добавлять предоплаты в заказы интеграции» станет доступен выбор Валюты и Причины внесения

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

- Отключено;

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

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

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

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

Внимание!!! Названия блюд здесь берутся из расширенного свойства yaedaname.

Нажмите, чтобы отобразить

Нажмите, чтобы скрыть

При настройке кипера мы создали блюдо с открытой ценой. Здесь в поле «Блюдо для учета платной доставки» оно выбирается. Механизм прост: Яндекс.Еда передаёт информацию о стоимости доставки курьером ресторана, приложение интеграции добавляет в стол блюдо с открытой ценной и задаёт ему эту стоимось.

  • external/интеграция_с_агрегаторами_доставки/02_installmod_config.txt
  • Последнее изменение: 2024/02/27 15:43
  • Евгений Агеев