Различия

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

--- external:r_keeper_и_яндекс.доставка:1_установка_и_настройка [2023/05/29 08:50] – Алексей Коробов
+++ 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_и_яндекс.доставка:pasted:20210908-180710.png}}
+  * Токен Яндекс.Доставка - как его получить описано в [[external:r_keeper_и_яндекс.доставка:0_yandex_tokens|Предварительные операции (получение токенов)]]
+  * Токен Яндекс.Геокодера - как его получить описано в [[external:r_keeper_и_яндекс.доставка:0_yandex_tokens|Предварительные операции (получение токенов)]]
+  * Токен Dadata - как его получить описано в [[external:r_keeper_и_яндекс.доставка:0_yandex_tokens|Предварительные операции (получение токенов)]]
-Чтобы получить токен Яндекс.Доставка необходимо пройти [[https://dostavka.yandex.ru/business/self-registration?ya_source=businessdelivery&ya_medium=module&ya_campaign=rkeeper#form|процесс регистрации]].
+Важно! Используется либо Яндекс.Геокодер, либо Dadata. Один из двух сервисов на выбор, не оба сразу.
-После регистрации с отрывшемся окне перейти в профиль и получить TOKEN
+Но все поля в форме являются обязательными для заполнения, поэтому вместо неиспользуемого (не нужного) токена можно вписать произвольное значение.
-{{:external:r_keeper_и_яндекс.доставка:pasted:20210910-123125.png}}
+Какой именно будет использоваться - зависит от переключателя в настройках.
-Что бы получить токен геокодирования в системе Яндекс [[https://developer.tech.yandex.ru/|необходимо зарегистрироваться здесь]]. {{  :external:r_keeper_и_яндекс.доставка:pasted:2021-07-07_16-49-00.png  }}
+Здесь же - переключатель страны, в которой используется модуль.
-{{  :external:r_keeper_и_яндекс.доставка:yandexrkeeper.png  }}
-При регистрации, в поле "Ссылка на ваш сайт, где будет использоваться API" необходимо указать IP адрес компьютера на котором установлена служба "Carbis Yandex Courier Service", остальные поля заполнить также, как указано на скриншоте. После ввода настроек нажать кнопку «проверить соединение» и убедиться в положительном результате
-{{: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
@@ Строка 121: / Строка 102: @@
   * пос. Восход, ул Ленина 1
-"пос Восход" в нашу зону покрытия не попадает, а населенные пункты Новосибирск и Бердск - попадают. Для того чтобы при заказе на адрес "ул Ленина 1" мы могли корректно определить координаты точки, необходимо добавить уточнение города (Новосибирск или Бердск)
+"пос Восход" в нашу зону покрытия не попадает, а населенные пункты Новосибирск и Бердск - попадают. Для того, чтобы при заказе на адрес "ул Ленина 1" мы могли корректно определить координаты точки, необходимо добавить уточнение города (Новосибирск или Бердск)
 Для такого случае, в разделе "Список доступных городов" добавляем 2 значения:
@@ Строка 128: / Строка 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
@@ Строка 173: / Строка 160: @@
 Активировать переключатель проверять заказы в Delivery.
 Проверить соединение, при успешном соединении сохранить настройки.
-{{:external:r_keeper_и_яндекс.доставка:pasted:20210831-140851.png}}