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

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

Актуальный дистрибутив: 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 и выбрать ранее созданную лицензию.

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

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

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

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

Для настройки необходимо перейти в Параметры → Установи → Настройки R-Keeper, указать в полях настройки сделанные ранее :

  • Адрес и порт кассового сервера.
  • Логин/пароль учётки с полными правами для создания заказов через XML.
  • Стол, на который будут приходить заказы из Яндекс.Еды:
    • для платформы Яндекс
    • для платформы Маркет деливери
  • Кассовая станция.
  • Классификация для выгрузки меню.
  • Категория заказа.
  • Блюдо для учёта платной доставки.
  • Скидка на блюдо.
  • Скидка на заказ.


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

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

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

Письмо:

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

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

  • external/интеграция_с_агрегаторами_доставки/02_installmod_config.txt
  • Последнее изменение: 2024/07/01 12:04
  • Евгений Горносталь