Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия |
external:r_keeper_и_яндекс.доставка:1_установка_и_настройка [2023/05/30 13:23] – Алексей Коробов | external:r_keeper_и_яндекс.доставка:1_установка_и_настройка [2023/06/02 11:16] (текущий) – Алексей Коробов |
---|
====== Установка и настройка ====== | ====== Установка и настройка ====== |
| |
===== Установка ===== | ====== Установка ====== |
| |
Актуальную версию модуля интеграции вы можете [[https://disk.yandex.ru/d/0sQ-Ln-WdSvZ9w|скачать по ссылке]] | Актуальную версию модуля интеграции вы можете [[https://disk.yandex.ru/d/0sQ-Ln-WdSvZ9w|скачать по ссылке]] |
В результате на компьютере будет установлена служба "Carbis Yandex Courier Service" которую необходимо запустить | В результате на компьютере будет установлена служба "Carbis Yandex Courier Service" которую необходимо запустить |
| |
{{ :external:r_keeper_и_яндекс.доставка:pasted:20210701-131901.png }} | {{:external:r_keeper_и_яндекс.доставка:pasted:20230602-084226.png}} |
| |
**Внимание!** По умолчанию служба занимает номер порта 11022. При работе с сервисом по сети необходимо открыть этот порт в брандмауэре и антивирусах. | **Внимание!** По умолчанию служба занимает номер порта 11022. При работе с сервисом по сети необходимо открыть этот порт в брандмауэре и антивирусах. |
</code> | </code> |
| |
===== Настройка r_keeper ===== | ====== Настройка r_keeper ====== |
| |
Для взаимодействия с кассовым сервером r_keeper необходимо настроить XML интерфейс (лицензия XML Write Order - не нужна) | Для взаимодействия с кассовым сервером r_keeper необходимо настроить XML интерфейс (лицензия XML Write Order - не нужна) |
| Как настроить XML-HTTP интерфейс кассового сервера подробно описано в статье: [[external:zz_дополнительные_материалы:02_xml_interfaсe_rkeeper|Настройка XML интерфейса]] |
* Станция Менеджера → Сервис → Станции и устройства | |
* Выбрать нужный кассовый сервер и перейти на закладку Свойства | |
* В разделе "HTTP Ограничения" выбрать любое существующее право (при желании можно завести отдельное право для данного модуля) | |
* В разделе "HTTP Server" указать любой свободный порт в поле "HTTP Data Port" и запомнить это значение, оно нам пригодится для дальнейшей настройки | |
* Сохранить изменения и перезапустить кассовый сервер | |
| |
{{ :external:r_keeper_и_яндекс.доставка:pasted:20210702-075104.png }}Если на кассовом сервере уже проделаны эти настройки, то дополнительно ничего не требуется. | |
| |
* Открыть справочник Персонал → Работники | |
* В ветке "Центральный офис" завести отдельную "Роль" (минимальный набор прав должен позволять чтение списка заказов). | |
* Менеджерские ограничения → Привилегии на объекты - дать право которым мы защитили кассовый сервер. | |
| |
{{ :external:r_keeper_и_яндекс.доставка:pasted:20210702-080639.png }} | |
| |
* Перейти на закладку "Работники". | |
* Создать новую учетную запись. ВНИМАНИЕ! В Названии использовать только латиницу. | |
* Задать не пустой пароль для данного Работника. | |
* Имя работника и его пароль потребуются нам для дальнейшей настройки. | |
| |
{{ :external:r_keeper_и_яндекс.доставка:pasted:20210702-080316.png }} | |
| |
---- | ---- |
{{:external:r_keeper_и_яндекс.доставка:pasted:20210908-175936.png}} | {{:external:r_keeper_и_яндекс.доставка:pasted:20210908-175936.png}} |
| |
===== Запуск и настойка модуля ===== | ====== Запуск и настойка модуля ====== |
| |
Дальнейшая настройка и работа с модулем осуществляется в браузере. Для этого необходимо перейти по адресу [[http://192.168.0.1:11022|http://192.168.0.1:11022]] где "192.168.0.1" это IP адрес компьютера на котором установлена служба "Carbis Yandex Courier Service", для локальной работы так же можно использовать адрес [[http://127.0.0.1:11022|http://127.0.0.1:11022]] | Дальнейшая настройка и работа с модулем осуществляется в браузере. Для этого необходимо перейти по адресу [[http://192.168.0.1:11022|http://192.168.0.1:11022]] где "192.168.0.1" это IP адрес компьютера на котором установлена служба "Carbis Yandex Courier Service", для локальной работы так же можно использовать адрес [[http://127.0.0.1:11022|http://127.0.0.1:11022]] |
| |
После запуска необходимо открыть настройки модуля пароль 051791 {{:external:r_keeper_и_яндекс.доставка:pasted:20210908-180029.png}} | После запуска необходимо открыть настройки модуля пароль 051791 |
| |
==== Раздел "r_keeper" ==== | {{:external:r_keeper_и_яндекс.доставка:pasted:20230602-084404.png}} |
| |
| ===== Раздел "r_keeper" ===== |
| |
В данном разделе необходимо ввести параметры подключения к r_keeper, настроенные ранее: | В данном разделе необходимо ввести параметры подключения к r_keeper, настроенные ранее: |
| |
* Адрес подключения к XML интерфейсу r_keeper | * Адрес подключения к XML-интерфейсу кассового сервера r_keeper в формате IP:port |
* Имя пользователя (регистр важен) | * Имя пользователя для подключения к XML-интерфейсу (регистр важен) |
* Пароль пользователя | * Пароль пользователя для подключения к XML-интерфейсу |
* Можно выбрать категорию заказов. Тогда в списке заказов будут отображаться заказы, только выбранной категории | * Можно выбрать категорию заказов. Тогда в списке заказов будут отображаться заказы только выбранной категории |
| |
{{:external:r_keeper_и_яндекс.доставка:pasted:20210908-180447.png}} | {{:external:r_keeper_и_яндекс.доставка:pasted:20230602-084145.png}} |
| |
После ввода настроек нажать кнопку "проверить соединение" и убедиться в положительном результате, после чего сохранить | После ввода настроек нажать кнопку "проверить соединение" и убедиться в положительном результате, после чего сохранить. |
| {{:external:r_keeper_и_яндекс.доставка:pasted:20230602-084328.png}} |
| |
==== Раздел "Яндекс.Доставка" ==== | ===== Раздел "Яндекс.Доставка" ===== |
| |
В данном разделе необходимо ввести параметры подключения к сервису Яндекс.Доставка: | В данном разделе необходимо ввести параметры подключения к сервису Яндекс.Доставка: |
| |
* Адрес Yandex - адрес сервера Яндекс.Доставка для отправки запросов. Заполнять не требуется. | {{:external:r_keeper_и_яндекс.доставка:pasted:20230602-092858.png}} |
* Токен Яндекс.Доставка | |
* Токен Геокодера Яндекс | |
| |
| * Токен Яндекс.Доставка - как его получить описано в [[external:r_keeper_и_яндекс.доставка:0_yandex_tokens|Предварительные операции (получение токенов)]] |
| * Токен Яндекс.Геокодера - как его получить описано в [[external:r_keeper_и_яндекс.доставка:0_yandex_tokens|Предварительные операции (получение токенов)]] |
| * Токен Dadata - как его получить описано в [[external:r_keeper_и_яндекс.доставка:0_yandex_tokens|Предварительные операции (получение токенов)]] |
| |
==== Раздел "Прочее" ==== | Важно! Используется либо Яндекс.Геокодер, либо Dadata. Один из двух сервисов на выбор, не оба сразу. |
{{:external:r_keeper_и_яндекс.доставка:pasted:20210831-130624.png}} | Но все поля в форме являются обязательными для заполнения, поэтому вместо неиспользуемого (не нужного) токена можно вписать произвольное значение. |
| Какой именно будет использоваться - зависит от переключателя в настройках. |
| |
**Токен Dadata**. Для геокодирования адресов используются возможности бесплатного сервиса [[https://dadata.ru/suggestions/#address|dadata.ru]]. Необходимо пройти регистрацию на этом сервере для получение Токена (API-ключ). Значение полученного токена ввести в настройках. | Здесь же - переключатель страны, в которой используется модуль. |
| |
**Список доступных городов**. Если из текущего ресторана вы возите заказы только в рамках одного города, то в данном поле нужно ввести название этого города Если из одного ресторана вы осуществляете доставку в несколько городов-сателлитов то в данном поле нужно перечислить их все. Это нужно для корректного определения координат адреса в том случае, когда улица с одним и тем же названием есть в каждом городе из зоны доставки. | В нижней части окна кнопки проверки связи и ссылка на регистрацию в "Яндекс.Доставке". |
| |
**Пример:** город Новосибирск. В нем и близлежащих населенных пунктах есть адрес "ул Ленина 1". А именно: | |
| |
| ===== Раздел "Настройки точки" ===== |
| {{:external:r_keeper_и_яндекс.доставка:pasted:20230602-094341.png}} |
| |
| **Список доступных городов**. Если из текущего ресторана вы возите заказы только в рамках одного города, то в данном поле нужно ввести название этого города. Если из одного ресторана вы осуществляете доставку в несколько городов-сателлитов то в данном поле нужно перечислить их все. Это нужно для корректного определения координат адреса в том случае, когда улица с одним и тем же названием есть в каждом городе из зоны доставки. |
| |
| __Пример:__ город Новосибирск. В нем и близлежащих населенных пунктах есть адрес "ул Ленина 1". А именно: |
| |
* г Новосибирск, ул Ленина 1 | * г Новосибирск, ул Ленина 1 |
* пос. Восход, ул Ленина 1 | * пос. Восход, ул Ленина 1 |
| |
"пос Восход" в нашу зону покрытия не попадает, а населенные пункты Новосибирск и Бердск - попадают. Для того чтобы при заказе на адрес "ул Ленина 1" мы могли корректно определить координаты точки, необходимо добавить уточнение города (Новосибирск или Бердск) | "пос Восход" в нашу зону покрытия не попадает, а населенные пункты Новосибирск и Бердск - попадают. Для того, чтобы при заказе на адрес "ул Ленина 1" мы могли корректно определить координаты точки, необходимо добавить уточнение города (Новосибирск или Бердск) |
| |
Для такого случае, в разделе "Список доступных городов" добавляем 2 значения: | Для такого случае, в разделе "Список доступных городов" добавляем 2 значения: |
* Бердск | * Бердск |
| |
Город введенный первым будет использоваться по умолчанию. | Город, введенный первым, будет использоваться по умолчанию. |
| |
После ввода Токена и Списка городов нажать на кнопку "Проверить настройки связи" и получить положительный результат {{:external:r_keeper_и_яндекс.доставка:pasted:20210908-181036.png}} | |
| |
**Внимание!** Сервис Dadata используется для геокодирования адресов в России, при работе на территории Казахстана необходимо использовать геокодер Яндекс и переключить настройки на использование соответствующего региона | **Использовать виртуальную клавиатуру** Если модуль планируется использовать непосредственно на POS терминале с экраном TouchScreen, то необходимо включить данную опцию, чтобы использовать для ввода данных экранную клавиатуру. |
| |
---- | |
| |
**Использовать виртуальную клавиатуру** Если модуль планируется использовать непосредственно на POS терминале с экраном TouchScreen, то необходимо включить данную опцию чтобы использовать для ввода данных экранную клавиатуру. | |
| |
**Отправлять заказы с оплатой курьеру** Если договор между вашим рестораном и сервисом Яндекс.Доставка включает в себя опцию "Оплату курьеру за заказ" то включите данный пункт и тогда при вызове курьера на конкретный заказ вы сможете дополнительно указать, должен ли курьер при передаче заказа получить оплату от клиента. | **Отправлять заказы с оплатой курьеру** Если договор между вашим рестораном и сервисом Яндекс.Доставка включает в себя опцию "Оплату курьеру за заказ" то включите данный пункт и тогда при вызове курьера на конкретный заказ вы сможете дополнительно указать, должен ли курьер при передаче заказа получить оплату от клиента. |
| |
**Получать данные из сторонних служб доставки** Если вам необходимо автоматически загружать информацию о клиенте из сторонних служб доставки, включите данный пункт. | **Отправлять заказы с термосумкой по умолчанию** При включении данной настройки по умолчанию будет включена необходимость наличия термосумки у курьера. |
| |
**Комментарий ресторана** Введенная тут информация будет показана курьеру, который приедет забирать заказ. Тут можно дать пояснения для курьера как ему быстрее найти ваш ресторан. Например так: Красное трехэтажное здание, отдельное крыльцо с правого крыла, вывеска "Ресторан "Рога и Копыта". Подойти к администратору на входе. | **Комментарий ресторана** Введенная тут информация будет показана курьеру, который приедет забирать заказ. Тут можно дать пояснения для курьера как ему быстрее найти ваш ресторан. Например так: Красное трехэтажное здание, отдельное крыльцо с правого крыла, вывеска "Ресторан "Рога и Копыта". Подойти к администратору на входе. |
| |
**Максимальная стоимость для автоподтверждения доставки** После размещения заявки на вызов курьера происходит автоматическая оценка стоимости выполнения такого заказа. После получения оценки ресторан должен будет подтвердить заявку. и только после этого курьер будет направлен за заказом. Если мы готовы автоматически подтверждать все заказы стоимость доставки который ниже некой пороговой суммы, то это значение необходимо ввести в данном поле. | **Максимальная стоимость для автоподтверждения доставки** После размещения заявки на вызов курьера происходит автоматическая оценка стоимости выполнения такого заказа. После получения оценки ресторан должен будет подтвердить заявку. И только после этого курьер будет направлен за заказом. Если мы готовы автоматически подтверждать все заказы стоимость доставки который ниже некой пороговой суммы, то это значение необходимо ввести в данном поле. |
| |
**Пример:** в данном поле указано значение 200 руб. Ресторан делает две заявки на доставку по разным адресам. В результате оценки первой заявки стоимость доставки составляет 150 рублей - такая заявка будет подтверждена автоматически и курьер будет направлен в ресторан сразу же после завершения оценки. Вторая заявка получила оценку в 250 рублей. Такую заявку ресторан должен будет подтвердить в ручном режиме и только после этого курьер будет направлен за заказом. Если не заполнить это поле, то ресторан будет подтверждать все заявки, вне зависимости от полученной оценки стоимости выполнения заказа. | __Пример:__ в данном поле указано значение 200 руб. Ресторан делает две заявки на доставку по разным адресам. В результате оценки первой заявки стоимость доставки составляет 150 рублей - такая заявка будет подтверждена автоматически и курьер будет направлен в ресторан сразу же после завершения оценки. Вторая заявка получила оценку в 250 рублей. Такую заявку ресторан должен будет подтвердить в ручном режиме и только после этого курьер будет направлен за заказом. Если не заполнить это поле, то ресторан будет подтверждать все заявки, вне зависимости от полученной оценки стоимости выполнения заказа. |
| |
---- | **Город** - выбрать город (из введенного ранее списка) где находится наш текущий ресторан. |
| |
Переходим на вторую страницу настроек. На ней необходимо указать параметры нашего ресторана. **Город** - выбрать город (из введенного ранее списка) где находится наш текущий ресторан. **Адрес** - ввести адрес ресторана. **Номер телефона** - телефон для связи, по которому курьер сможет позвонить в ресторан в случае возникновения каких-либо вопросов. **ИНН** юридического лица от имени которого заключен договор с сервисом Яндекс.Доставка. Налоговая ставка по которой работает данное ЮЛ - для случая оплаты заказа курьеру. | **Адрес** - ввести адрес ресторана. |
| |
| **Номер телефона** - телефон для связи, по которому курьер сможет позвонить в ресторан в случае возникновения каких-либо вопросов. |
| |
| **ИНН** юридического лица от имени которого заключен договор с сервисом Яндекс.Доставка. |
| |
| **Налоговая ставка** по которой работает данное ЮЛ - для случая оплаты заказа курьеру. |
| |
После ввода всех настроек нажать кнопку "Отобразить заданный адрес на карте" и проконтролировать верность ввода адреса. При желании метку на карте можно передвинуть, для того что бы более точно указать курьеру расположение входа в ресторан в здании по введенному адресу. | После ввода всех настроек нажать кнопку "Отобразить заданный адрес на карте" и проконтролировать верность ввода адреса. При желании метку на карте можно передвинуть, для того что бы более точно указать курьеру расположение входа в ресторан в здании по введенному адресу. |
| |
{{:external:r_keeper_и_яндекс.доставка:pasted:20210908-180955.png}} | Не забываем сохранить настройки кнопкой в правом нижнем углу страницы. |
| |
| ===== Раздел "Настройки доставки" ===== |
| {{:external:r_keeper_и_яндекс.доставка:pasted:20230602-094547.png}} |
| Настройка данного пункта - не обязательна. |
| Вне зависимости от того, какая система доставки используется на предприятии, вызвать курьера можно для любого стола, открытого на кассе r_keeper. |
| В случае, если настройки из данного пункта инструкции сделаны, при оформлении заказа из стола, созданного из системы доставки, будут автоматически подставляться данные клиента - ФИО, адрес, телефон. |
| |
==== Раздел "Доставка" ==== | В данном разделе можно указать настройки подключения к различным системам доставки, совместимым с r_keeper. |
В данном разделе можно указать настройки подключения к доставкам. При оформлении заказа, будут автоматически подставляться данные клиента, ФИО, адрес, телефон | Поддержаны: |
* Минидоставка | * Минидоставка - [[external:доставка:02_dlvhatch|Статья про настройку Мини-доставки)]] |
* Delivery_POS | * Delivery_POS - [[https://docs.rkeeper.ru/delivery/zapusk-priloyoeniya-deliverypos-19597214.html|Информация о системе]] |
* Delivery_v7 | * Delivery_v7 - [[https://docs.rkeeper.ru/delivery/r_keeper-delivery7-12093162.html|Информация о системе]] |
Для настройки подключения к минидоставки, требуется прописать адрес подключения к минидоставки и токен. | Для настройки подключения к Мини-доставке, требуется прописать адрес подключения к Мини-Доставки и токен. |
{{:external:r_keeper_и_яндекс.доставка:pasted:20210831-140658.png}} | |
Настройки подключения Delivery_POS аналогичны Delivery_v7 | Настройки подключения Delivery_POS аналогичны Delivery_v7 |
Требуется прописать параметры подключения к Fireberd | Требуется прописать параметры подключения к Fireberd |
Активировать переключатель проверять заказы в Delivery. | Активировать переключатель проверять заказы в Delivery. |
Проверить соединение, при успешном соединении сохранить настройки. | Проверить соединение, при успешном соединении сохранить настройки. |
{{:external:r_keeper_и_яндекс.доставка:pasted:20210831-140851.png}} | |
| |