Различия

Показаны различия между двумя версиями страницы.

--- external:интеграция_с_агрегаторами_доставки:02_installmod_config [2023/10/12 14:05] – Евгений Агеев
+++ external:интеграция_с_агрегаторами_доставки:02_installmod_config [2026/04/01 07:36] (текущий) – Роман Назаров
@@ Строка 5: / Строка 5: @@
 ===== Установка стыковочного модуля =====
-Распаковываем архив в папку:
+Распаковать архив в отдельную папку. Не нужно распаковывать на рабочем столе или в каталог с названием версии.
-**aggregator_delivery.exe** - создаём ярлык и запускаем службой/десктопом (ПКМ→Свойства→Ярлык и задаём ключ **/install** или **/desktop**)
+Приложение может работать как службой, так и в консольном режиме.
+В реальной эксплуатации рекомендуется установить Модуль интеграции службой.
+В каталоге присутствуют несколько файлов для запуска:
+  * install.bat - устанавливает службу (запуск от имени администратора).
+  * desktop.bat - запускает приложение в консольном режиме.
+  * license.bat - запускает сервер с окном лицензирования до основного запуска.
-{{ :external:интеграция_с_агрегаторами_доставки:pasted:20210705-164832.png }}
+===== Лицензирование =====
-вся информация хранится в файле dbase.db
+Модуль способен работать без лицензии в режиме "заполнение меню". Все предварительные операции - настройка, подготовка меню - можно делать без лицензирования. Лицензии необходимы на этапе приёма заказов.
-После запуска службы сервис будет доступен по адресу **127.0.0.1:5000**
+Для работы модуля требуется одновременно две лицензии:
-====== Запуск службы и первичная настройка ======
-Создание заказов происходит через XML-интерфейс. Для этого в R_keeper создаётся [[https://wiki.carbis.ru/external/интеграция_с_агрегаторами_доставки/01preliminary_config_rk7|учётка]] с полными правами на кассовые операции.
+  * лицензия на стыковочный модуль от "Карбис"
+  * лицензия на xml_save_order от UCS (поддержана как lifetime, так и saas-версия лицензии)
-====   ====
+Для получения лицензии на **модуль от "Карбис"**  нужно написать заявку **на адрес info@carbis.ru**.  Для получения лицензии на **xml_save_order**  от UCS **нужно сделать заявку в UCS**  в стандартном порядке (или обратиться к дилеру, если вы представитель ресторана). Далее по тексту предполагается, что **лицензия на модуль от UCS уже активирована и не закончилась.**
-После запуска службы aggregator_delivery, веб-интерфейс приложения будет доступен по адресу **127.0.0.1:5000** (127.0.0.1 - если запускать настройку локально на том же ПК, где устанавливаем модуль интеграции)
+Запустить license.bat. Далее откроется окно, где нужно авторизоваться под дилерской учёткой lic.carbis.ru и выбрать ранее созданную лицензию.
-Заходим в **Параметры ** и задаём следующие свойства:
+{{  :internal:интеграция_яндекс.еда_-_rk7:pasted:20210701-231346.png  }}
-- API токен - при первом запуске модуля токен генерируется автоматически;
+Также модуль поддерживает XML SaaS. Подробнее об использовании XML лицензий [[https://wiki.carbis.ru/external/интеграция_с_агрегаторами_доставки/xml_saas_howto|по ссылке]]
+{{ :external:интеграция_с_агрегаторами_доставки:2025-05-29_13-46-39.png |}}
-- Адрес и порт кассового сервера;
+====== Настройка связи с r_keeper ======
-- Логин/пароль учётки с полными правами для создания заказов через XML;
+Создание заказов происходит через XML-интерфейс. Для этого в R_keeper создаётся [[https://wiki.carbis.ru/external/интеграция_с_агрегаторами_доставки/01preliminary_config_rk7|учётка]] с полными правами на кассовые операции.
-- Стол, на который будут приходить заказы из Яндекс.Еды:
-  * для платформы Яндекс
-  * для платформы Маркет деливери
-- Кассовая станция;
+После запуска службы aggregator_delivery, веб-интерфейс приложения будет доступен по адресу **127.0.0.1:5000** (127.0.0.1 - если запускать настройку локально на том же ПК, где устанавливаем модуль интеграции)
-- Выбираем классификацию меню (создаём при начальных настройках RK);
-- Категорию заказа.
+Для настройки необходимо перейти в Параметры → Установи → Настройки R-Keeper, указать в полях [[https://wiki.carbis.ru/external/интеграция_с_агрегаторами_доставки/01preliminary_config_rk7|настройки]] сделанные ранее :
-{{ :external:интеграция_с_агрегаторами_доставки:pasted:20231012-140309.png }}
+  * Адрес и порт кассового сервера.
-{{ :external:интеграция_с_агрегаторами_доставки:pasted:20231012-140443.png }}
+  * Логин/пароль учётки с полными правами для создания заказов через XML.
-**Опционально:** Функция передачи оплаты указанной валютой
+  * Стол, на который будут приходить заказы из Яндекс.Еды:
-При включении чекбокса "Добавлять предоплаты в заказы интеграции" станет доступен выбор Валюты и Причины внесения
+      *  для платформы Яндекс
-{{ :external:интеграция_с_агрегаторами_доставки:pasted:20231012-125146.png }}
+      *  для платформы Маркет деливери
+  * Кассовая станция.
+  * Классификация для выгрузки меню.
+  * Категория заказа.
+  * Блюдо для учёта платной доставки.
+  * Скидка на блюдо.
+  * Скидка на заказ.
+  * Количество гостей - параметр доступен от версии Модуля интеграции 1.7.9.275
+  * Отображение телефона, адреса доставки, имя клиента в пользовательских свойствах заказа - параметр доступен от версии Модуля интеграции 1.8.12.20.290.
-Приложение имеет функцию **Автоматического принятия заказов**, которая работает в трёх режимах:
-- Отключено;
+{{ :external:интеграция_с_агрегаторами_доставки:2026-03-18_13-34-17.png? |}}
+{{ :external:интеграция_с_агрегаторами_доставки:интеграция_с_агрегаторами_доставки.png |}}
-- Сохранить в r_keeper (создаст стол и сразу отправит сервис-печать);
+**Опционально:** Функция передачи оплаты указанной валютой.
+При включении чек-бокса "Добавлять предоплаты в заказы интеграции" станет доступен выбор Валюты и Причины внесения
+{{ :external:интеграция_с_агрегаторами_доставки:2026-02-03_16-11-30.png |}}
-- Сохранить с уточнением (сохранит как черновик, с необходимостью редактирования и подтверждения заказа до отправки сервис-печати).
+**Опционально:** Функция выбора официанта для создания заказа - доступен с версии 1.8.22.295.
+{{ :external:интеграция_с_агрегаторами_доставки:2026-03-18_13-36-12.png |}}
-Далее переходим во вкладку **"Меню"** и заполняем карточки блюд, которые выгрузились в интерфейс из ранее привязанной классификации.
+Отображение телефона, адреса доставки, имя клиента в пользовательские свойства заказа
+{{ :external:интеграция_с_агрегаторами_доставки:2026-02-03_16-16-15.png |}}
-На скриншоте показано, как должно быть всё заполнено.
+Данные параметры настраиваются через следующие поля:
-**Внимание!!!** Названия блюд здесь берутся из **расширенного свойства** **yaedaname**.
+**Свойство заказа для номера телефона** - Через данное поле настраивается отображения номера телефона в пользовательских свойствах заказа в r_keeper.
+**Свойство заказа для имени клиента** - Через данное поле настраивается отображения имени клиента в пользовательских свойствах заказа в r_keeper.
+**Свойство заказа для адреса доставки** - Через данное поле настраивается отображения адреса доставки в пользовательских свойствах заказа в r_keeper.
+===== Настройка для внешнего доступа =====
-{{ :internal:интеграция_яндекс.еда_-_rk7:pasted:20210702-100056.png }}
+Настройка внешнего доступа доступна от версии Aggregator_delivey v1.7.5.168.
+**Внешний доступ возможен, во внешней сети. Для такой работы необходим проброс.** Такой доступ даёт возможность открыть админку на нескольких устройствах. Для работы по внутренней сети проброс и разрешение доступа не требуется.
-===== Платная доставка курьерами ресторана =====
+В данном разделе можно задать только логин и пароль, для внешнего доступа. Все изменения нужно сохранить.
+Если логина и пароля по умолчанию нет, то внешний доступ получить невозможно.
+{{ :external:интеграция_с_агрегаторами_доставки:2025-04-24_18-14-49.png |}}
-<hidden>
-При настройке кипера мы создали блюдо с открытой ценой. Здесь в поле "Блюдо для учета платной доставки" оно выбирается. Механизм прост: Яндекс.Еда передаёт информацию о стоимости доставки курьером ресторана, приложение интеграции добавляет в стол блюдо с открытой ценной и задаёт ему эту стоимось. {{:external:интеграция_с_агрегаторами_доставки:pasted:20210813-150458.png}}
+===== Подключение к хосту =====
+Для дальнейшей настройки Модуля интеграции с агрегаторами доставки необходим проброс порта наружу.
-</hidden>
+Далее необходимо направить письмо **на адрес info@carbis.ru** следующего содержания:
+Тема:
-===== Лицензирование =====
-Модуль способен работать без лицензии в режиме "заполнение меню". Все предварительные операции - настройка, подготовка меню - можно делать без лицензирования. Лицензии необходимы на этапе приёма заказов.
-Для работы модуля требуется одновременно две лицензии:
-  - лицензия на стыковочный модуль от "Карбис"
-  - лицензия на xml_save_order от UCS (поддержана как lifetime, так и saas-версия лицензии)
-Для получения лицензии на **модуль от "Карбис"**  нужно написать заявку **на адрес info@carbis.ru**  Для получения лицензии на **xml_save_order**  от UCS **нужно сделать заявку в UCS**  в стандартном порядке (или обратиться к дилеру, если вы представитель ресторана). Далее по тексту предполагается, что **лицензия на модуль от UCS уже активирована и не закончилась.**
-Пример письма, которое нужно написать: Тема:
 <code>
@@ Строка 98: / Строка 105: @@
 </code>
-{{:external:интеграция_с_агрегаторами_доставки:pasted:20210712-175524.png}}
+{{ :external:интеграция_с_агрегаторами_доставки:2024-06-27_11-29-40.png |}}
 [[https://wikiint.carbis.ru/internal/int_soft/yayeda_admin|Для инженеров ГК "Карбис". Описание настройки на стороне сервера.]]
-В системе лицензирования 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  }}