Различия

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

--- external:r_keeper_и_яндекс.доставка:1_установка_и_настройка [2023/05/30 13:25] – Алексей Коробов
+++ external:r_keeper_и_яндекс.доставка:1_установка_и_настройка [2023/06/02 11:16] (текущий) – Алексей Коробов
@@ Строка 1: / Строка 1: @@
 ====== Установка и настройка ======
-===== Установка =====
+====== Установка ======
 Актуальную версию модуля интеграции вы можете [[https://disk.yandex.ru/d/0sQ-Ln-WdSvZ9w|скачать по ссылке]]
@@ Строка 19: / Строка 19: @@
 В результате на компьютере будет установлена служба "Carbis Yandex Courier Service" которую необходимо запустить
-{{  :external:r_keeper_и_яндекс.доставка:pasted:20210701-131901.png  }}
+{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-084226.png}}
 **Внимание!**  По умолчанию служба занимает номер порта 11022. При работе с сервисом по сети необходимо открыть этот порт в брандмауэре и антивирусах.
@@ Строка 30: / Строка 30: @@
 </code>
-===== Настройка r_keeper =====
+====== Настройка r_keeper ======
 Для взаимодействия с кассовым сервером 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  }}
 ----
@@ Строка 69: / Строка 49: @@
 {{: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]]
-После запуска необходимо открыть настройки модуля пароль 051791 {{:external:r_keeper_и_яндекс.доставка:pasted:20210908-180029.png}}
+После запуска необходимо открыть настройки модуля пароль 051791
-==== Раздел "r_keeper" ====
+{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-084404.png}}
+===== Раздел "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|Предварительные операции (получение токенов)]]
+  * Токен Яндекс.Геокодера - как его получить описано в [[external:r_keeper_и_яндекс.доставка:0_yandex_tokens|Предварительные операции (получение токенов)]]
+  * Токен Dadata - как его получить описано в [[external:r_keeper_и_яндекс.доставка:0_yandex_tokens|Предварительные операции (получение токенов)]]
- После ввода настроек нажать кнопку «проверить соединение» и убедиться в положительном результате
+Важно! Используется либо Яндекс.Геокодер, либо Dadata. Один из двух сервисов на выбор, не оба сразу.
+Но все поля в форме являются обязательными для заполнения, поэтому вместо неиспользуемого (не нужного) токена можно вписать произвольное значение.
+Какой именно будет использоваться - зависит от переключателя в настройках.
-{{:external:r_keeper_и_яндекс.доставка:pasted:20210908-180900.png}}
+Здесь же - переключатель страны, в которой используется модуль.
+В нижней части окна кнопки проверки связи и ссылка на регистрацию в "Яндекс.Доставке".
-==== Раздел "Прочее" ====
-{{:external:r_keeper_и_яндекс.доставка:pasted:20210831-130624.png}}
-**Токен Dadata**. Для геокодирования адресов используются возможности бесплатного сервиса [[https://dadata.ru/suggestions/#address|dadata.ru]]. Необходимо пройти регистрацию на этом сервере для получение Токена (API-ключ). Значение полученного токена ввести в настройках.
-**Список доступных городов**. Если из текущего ресторана вы возите заказы только в рамках одного города, то в данном поле нужно ввести название этого города Если из одного ресторана вы осуществляете доставку в несколько городов-сателлитов то в данном поле нужно перечислить их все. Это нужно для корректного определения координат адреса в том случае, когда улица с одним и тем же названием есть в каждом городе из зоны доставки.
+===== Раздел "Настройки точки" =====
+{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-094341.png}}
-**Пример:**  город Новосибирск. В нем и близлежащих населенных пунктах есть адрес "ул Ленина 1". А именно:
+**Список доступных городов**. Если из текущего ресторана вы возите заказы только в рамках одного города, то в данном поле нужно ввести название этого города. Если из одного ресторана вы осуществляете доставку в несколько городов-сателлитов то в данном поле нужно перечислить их все. Это нужно для корректного определения координат адреса в том случае, когда улица с одним и тем же названием есть в каждом городе из зоны доставки.
+__Пример:__  город Новосибирск. В нем и близлежащих населенных пунктах есть адрес "ул Ленина 1". А именно:
   * г Новосибирск, ул Ленина 1
@@ Строка 114: / Строка 102: @@
   * пос. Восход, ул Ленина 1
-"пос Восход" в нашу зону покрытия не попадает, а населенные пункты Новосибирск и Бердск - попадают. Для того чтобы при заказе на адрес "ул Ленина 1" мы могли корректно определить координаты точки, необходимо добавить уточнение города (Новосибирск или Бердск)
+"пос Восход" в нашу зону покрытия не попадает, а населенные пункты Новосибирск и Бердск - попадают. Для того, чтобы при заказе на адрес "ул Ленина 1" мы могли корректно определить координаты точки, необходимо добавить уточнение города (Новосибирск или Бердск)
 Для такого случае, в разделе "Список доступных городов" добавляем 2 значения:
@@ Строка 121: / Строка 109: @@
   * Бердск
-Город введенный первым будет использоваться по умолчанию.
+Город, введенный первым, будет использоваться по умолчанию.
-После ввода Токена и Списка городов нажать на кнопку "Проверить настройки связи" и получить положительный результат {{: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
 Требуется прописать параметры подключения к Fireberd
@@ Строка 166: / Строка 160: @@
 Активировать переключатель проверять заказы в Delivery.
 Проверить соединение, при успешном соединении сохранить настройки.
-{{:external:r_keeper_и_яндекс.доставка:pasted:20210831-140851.png}}