Различия
Показаны различия между двумя версиями страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
external:доставка:api:install [2020/12/06 14:18] – [Дополнительные настройки RK7] Алексей Коробов | external:доставка:api:install [2021/09/12 11:21] (текущий) – [Настройка меню] Александр Ильин | ||
---|---|---|---|
Строка 1: | Строка 1: | ||
====== Дополнительные настройки RK7 ====== | ====== Дополнительные настройки RK7 ====== | ||
- | Для полноценной работы API доставки необходимо выполнить несколько дополнительных настроек. | + | Для полноценной работы API доставки необходимо выполнить несколько дополнительных настроек. API работает с версиями RK7 7.6.4+ На версии RK7 7.6.2 - работать не будет. |
- | API работает с версиями RK7 7.6.4+ | + | |
- | На версии RK7 7.6.2 - работать не будет. | + | |
===== Настройка меню ===== | ===== Настройка меню ===== | ||
Строка 9: | Строка 7: | ||
Для возможности получения меню внешней системой необходимо определить для доставки список блюд, видимых через API. | Для возможности получения меню внешней системой необходимо определить для доставки список блюд, видимых через API. | ||
- | - В менеджерской RK7 перейдите в справочник Меню | + | - В менеджерской RK7 перейдите в справочник Меню |
- Создайте новую классификацию " | - Создайте новую классификацию " | ||
- | - Для новой классификации создайте категории такие, какие | + | - Для новой классификации создайте категории такие, какие группы блюд будут на сайте, запомните **Идентификатор** |
- | - Назначьте всем блюдам, | + | - Назначьте всем блюдам, |
- | **Важно!**\\ | + | **Важно!** |
- | API доставки не поддерживает комбо-блюда, блюда с обязательными модификаторами и сами модификаторы, а так же блюда с дробным количеством (весовые)\\ | + | API доставки |
Для предотвращения программных ошибок и проблем с сохранением заказов воздержитесь от использования таких блюд для внешних заказов. | Для предотвращения программных ошибок и проблем с сохранением заказов воздержитесь от использования таких блюд для внешних заказов. | ||
Строка 24: | Строка 22: | ||
Для автоматического добавления блюд из интернет заказа необходимо добавить скрипт в форму редактирования заказа доставки. | Для автоматического добавления блюд из интернет заказа необходимо добавить скрипт в форму редактирования заказа доставки. | ||
- | - Перейдите в справочник Настройки | + | - Перейдите в справочник Настройки |
- | - В группе Заказ | + | - В группе Заказ |
- Для объекта DesignForm перейдите на вкладку " | - Для объекта DesignForm перейдите на вкладку " | ||
- В открывшимся редакторе укажите следующий скрипт, | - В открывшимся редакторе укажите следующий скрипт, | ||
- | - **ВНИМАНИЕ** Убедитесь, | + | - **ВНИМАНИЕ** |
< | < | ||
+ | |||
procedure DesignFormOnShowScript(Sender: | procedure DesignFormOnShowScript(Sender: | ||
var | var | ||
Строка 39: | Строка 38: | ||
if httpget(' | if httpget(' | ||
begin | begin | ||
- | GUI.ShowMessage(' | + | GUI.ShowMessage(' |
end; | end; | ||
end; | end; | ||
+ | |||
</ | </ | ||
- | **При настройке использования схемы форм с данной формой не задавайте категорию заказа.** | + | **При настройке использования схемы форм с данной формой не задавайте категорию заказа.** |
- | " | + | |
---- | ---- | ||
===== Настройка использования предоплат ===== | ===== Настройка использования предоплат ===== | ||
+ | |||
Чтобы иметь возможность получать с сайта (через API) заказы с уже произведённой оплатой - в rk7 должно быть включено использование предоплат. Оплата заказа через API добавляется в заказ как " | Чтобы иметь возможность получать с сайта (через API) заказы с уже произведённой оплатой - в rk7 должно быть включено использование предоплат. Оплата заказа через API добавляется в заказ как " | ||
- | Для корректной работы такого механизма следует настроить параметр: | + | Для корректной работы такого механизма следует настроить параметр: |
- | Настройки | + | |
- | {{: | + | {{ : |
- | Нужно выбрать именно значение **" | + | Нужно выбрать именно значение **" |
- | Если в ресторане предоплаты используются по настоящему - сделайте исключение параметра и привяжите его категории заказа доставки. | + | |
- | **Валюта и причина внесения денег** для приема предоплат указывается в DeliveryHatch.ini - **rkPayCode** и **rkPayReasonCode** соответственно. | + | **Валюта и причина внесения денег** |
- | Пример настроек валюты и причины внесения: | + | В стандартном случае, |
- | {{: | + | |
- | {{: | + | {{ : |
+ | |||
+ | {{ : | ||
---- | ---- | ||
Строка 71: | Строка 70: | ||
===== Модуль доставки ===== | ===== Модуль доставки ===== | ||
- | В файл DeliveryHatch.ini в секцию [RK] добавьте новый параметр: | + | В файл DeliveryHatch.ini в секцию [RK] добавьте новый параметр: |
- | Этот параметр определяет классификацию блюд, с которой будет работать API доставки.\\ | + | |
- | Значением данного параметра необходимо указать **идентификатор** классификации " | + | |
- | **С версии 3.0.5.1053** в секцию [RK] можно добавить параметр **rkHitCateg** \\ | + | **С версии 3.0.5.1053** |
- | Параметр определяет категорию меню для пометки блюд как " | + | |
- | Значением данного параметра необходимо указать **идентификатор** категории " | + | |
- | **C версии 3.1.8.1521** в доставку добавлена поддержка модификаторов блюд. | + | **C версии 3.1.8.1521** |
- | **С версии 3.1.8.1616 ** добавлен механизм фильтрации служебных модификаторов по весу. | + | **С версии 3.1.8.1616 ** добавлен механизм фильтрации служебных модификаторов по весу. Теперь через API доступны только модификаторы, |
- | Теперь через API доступны только модификаторы, | + | |
- | Отключить фильтрацию по весу можно в DeliveryHatch.ini в сексии RK с помощью параметра rkFilterModiWeights. Установить значение - 0. | + | |
- | В том же файле добавьте новую секцию " | + | В том же файле добавьте новую секцию " |
- | **Токен для каждой внешней системы нужно придумать самостоятельно!!!** \\ | + | |
- | Сделать это можно при помощи генераторов паролей | + | |
* [[https:// | * [[https:// | ||
Строка 100: | Строка 91: | ||
---- | ---- | ||
- | |||
===== Доступ к API через интернет ===== | ===== Доступ к API через интернет ===== | ||
- | Последним этапом необходимо открыть сетевой порт для внешнего IP заведения, | + | Последним этапом необходимо открыть сетевой порт для внешнего IP заведения, |
- | Как это сделать - зависит от конкретного оборудования в заведении. | + | |
- | Важно помнить, | + | Важно помнить, |
- | То есть невозможно получить доступ к стандартному графическому интерфейсу не из локальной сети. | + | |
---- | ---- | ||
===== Как проверить корректность настройки API? ===== | ===== Как проверить корректность настройки API? ===== | ||
+ | |||
Для этого есть сервис тестирования: | Для этого есть сервис тестирования: | ||
- | Необходимо ввести параметры подключения к вашему экземпляру, | + | Необходимо ввести параметры подключения к вашему экземпляру, |
- | {{ : | + | |
- | При корректно выполненной настройке, | + | |
- | {{ : | + | |
- | PS Сервис находится в режиме beta-тестирования. В случае получения ошибки вида " | + | |