Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия Следующая версияСледующая версия справа и слева |
external:r_keeper_и_яндекс.доставка:1_установка_и_настройка [2023/06/02 08:37] – Алексей Коробов | external:r_keeper_и_яндекс.доставка:1_установка_и_настройка [2023/06/02 09:44] – Алексей Коробов |
---|
====== Установка и настройка ====== | ====== Установка и настройка ====== |
| |
===== Установка ===== | ====== Установка ====== |
| |
Актуальную версию модуля интеграции вы можете [[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 - не нужна) |
{{: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-интерфейсу (регистр важен) |
* Пароль пользователя для подключения к 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|Предварительные операции (получение токенов)]] | * Токен Яндекс.Геокодера - как его получить описано в [[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 | * г Новосибирск, ул Ленина 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}} | Не забываем сохранить настройки кнопкой в правом нижнем углу страницы. |
| |
==== Раздел "Доставка" ==== | ===== Раздел "Настройки доставки" ===== |
В данном разделе можно указать настройки подключения к доставкам. При оформлении заказа, будут автоматически подставляться данные клиента, ФИО, адрес, телефон | В данном разделе можно указать настройки подключения к доставкам. При оформлении заказа, будут автоматически подставляться данные клиента, ФИО, адрес, телефон |
* Минидоставка | * Минидоставка |