Различия

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

--- external:r_keeper_и_яндекс.доставка:1_установка_и_настройка [2023/06/02 08:44] – Алексей Коробов
+++ external:r_keeper_и_яндекс.доставка:1_установка_и_настройка [2023/06/02 11:16] (текущий) – Алексей Коробов
@@ Строка 1: / Строка 1: @@
 ====== Установка и настройка ======
-===== Установка =====
+====== Установка ======
 Актуальную версию модуля интеграции вы можете [[https://disk.yandex.ru/d/0sQ-Ln-WdSvZ9w|скачать по ссылке]]
@@ Строка 30: / Строка 30: @@
 </code>
-===== Настройка r_keeper =====
+====== Настройка r_keeper ======
 Для взаимодействия с кассовым сервером r_keeper необходимо настроить XML интерфейс (лицензия XML Write Order - не нужна)
@@ Строка 49: / Строка 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]]
@@ Строка 57: / Строка 57: @@
 {{:external:r_keeper_и_яндекс.доставка:pasted:20230602-084404.png}}
-==== Раздел "r_keeper" ====
+===== Раздел "r_keeper" =====
 В данном разделе необходимо ввести параметры подключения к r_keeper, настроенные ранее:
@@ Строка 71: / Строка 71: @@
 {{: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
@@ Строка 97: / Строка 102: @@
   * пос. Восход, ул Ленина 1
-"пос Восход" в нашу зону покрытия не попадает, а населенные пункты Новосибирск и Бердск - попадают. Для того чтобы при заказе на адрес "ул Ленина 1" мы могли корректно определить координаты точки, необходимо добавить уточнение города (Новосибирск или Бердск)
+"пос Восход" в нашу зону покрытия не попадает, а населенные пункты Новосибирск и Бердск - попадают. Для того, чтобы при заказе на адрес "ул Ленина 1" мы могли корректно определить координаты точки, необходимо добавить уточнение города (Новосибирск или Бердск)
 Для такого случае, в разделе "Список доступных городов" добавляем 2 значения:
@@ Строка 104: / Строка 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}}
-  * Минидоставка
+Настройка данного пункта  - не обязательна.
-  * Delivery_POS
+Вне зависимости от того, какая система доставки используется на предприятии, вызвать курьера можно для любого стола, открытого на кассе r_keeper.
-  * Delivery_v7
+В случае, если настройки из данного пункта инструкции сделаны, при оформлении заказа из стола, созданного из системы доставки,  будут автоматически подставляться данные клиента - ФИО, адрес, телефон.
-Для настройки подключения к минидоставки, требуется прописать адрес подключения к минидоставки и токен.
-{{:external:r_keeper_и_яндекс.доставка:pasted:20210831-140658.png}}
+В данном разделе можно указать настройки подключения к различным системам доставки, совместимым с r_keeper.
+Поддержаны:
+  * Минидоставка - [[external:доставка:02_dlvhatch|Статья про настройку Мини-доставки)]]
+  * Delivery_POS - [[https://docs.rkeeper.ru/delivery/zapusk-priloyoeniya-deliverypos-19597214.html|Информация о системе]]
+  * Delivery_v7 - [[https://docs.rkeeper.ru/delivery/r_keeper-delivery7-12093162.html|Информация о системе]]
+Для настройки подключения к Мини-доставке, требуется прописать адрес подключения к Мини-Доставки и токен.
 Настройки подключения Delivery_POS  аналогичны Delivery_v7
 Требуется прописать параметры подключения к Fireberd
@@ Строка 149: / Строка 160: @@
 Активировать переключатель проверять заказы в Delivery.
 Проверить соединение, при успешном соединении сохранить настройки.
-{{:external:r_keeper_и_яндекс.доставка:pasted:20210831-140851.png}}