====== Установка и настройка ====== ====== Установка ====== Актуальную версию модуля интеграции вы можете [[https://disk.yandex.ru/d/0sQ-Ln-WdSvZ9w|скачать по ссылке]] Минимальные системные требования: * r_keeper 7.6.4+ или 7.6.5+ * OS Windows7 и выше ПО поставляется в zip архиве. Установка на конечный компьютер осуществляется путем распаковки архива в любую папку на жестком диске компьютера (полный путь НЕ должен содержать кириллицу). После распаковки архива необходимо установить службу командой (с правами Администратора) yandex_courier.exe /install В результате на компьютере будет установлена служба "Carbis Yandex Courier Service" которую необходимо запустить {{:external:r_keeper_и_яндекс.доставка:pasted:20230602-084226.png}} **Внимание!** По умолчанию служба занимает номер порта 11022. При работе с сервисом по сети необходимо открыть этот порт в брандмауэре и антивирусах. Удаление службы можно произвести командой yandex_courier.exe /uninstall ====== Настройка r_keeper ====== Для взаимодействия с кассовым сервером r_keeper необходимо настроить XML интерфейс (лицензия XML Write Order - не нужна) Как настроить XML-HTTP интерфейс кассового сервера подробно описано в статье: [[external:zz_дополнительные_материалы:02_xml_interfaсe_rkeeper|Настройка XML интерфейса]] ---- Если работа с модулем будет производиться непосредственно на кассе r_keeper то необходимо добавить кнопку для вызова этого модуля в "Главное меню" * Настройки - параметры * Установочные - Связь с другими системами - Сервисы * Выбрать свободный сервис и заполнить поля * "URL web-сервиса" - [[http://192.168.0.1:11022|http://192.168.0.1:11022]] (подробнее смотри далее) * Имя web-сервиса - Яндекс.Доставка В результате этих действия в главном меню на кассе r_keeper появится кнопка "Яндекс.Доставка", нажатие на которую откроет данный модуль во встроенном в кассу браузере. {{: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:20230602-084404.png}} ===== Раздел "r_keeper" ===== В данном разделе необходимо ввести параметры подключения к r_keeper, настроенные ранее: * Адрес подключения к XML-интерфейсу кассового сервера r_keeper в формате IP:port * Имя пользователя для подключения к XML-интерфейсу (регистр важен) * Пароль пользователя для подключения к XML-интерфейсу * Можно выбрать категорию заказов. Тогда в списке заказов будут отображаться заказы только выбранной категории {{:external:r_keeper_и_яндекс.доставка:pasted:20230602-084145.png}} После ввода настроек нажать кнопку "проверить соединение" и убедиться в положительном результате, после чего сохранить. {{:external:r_keeper_и_яндекс.доставка:pasted:20230602-084328.png}} ===== Раздел "Яндекс.Доставка" ===== В данном разделе необходимо ввести параметры подключения к сервису Яндекс.Доставка: {{: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:20230602-094341.png}} **Список доступных городов**. Если из текущего ресторана вы возите заказы только в рамках одного города, то в данном поле нужно ввести название этого города. Если из одного ресторана вы осуществляете доставку в несколько городов-сателлитов то в данном поле нужно перечислить их все. Это нужно для корректного определения координат адреса в том случае, когда улица с одним и тем же названием есть в каждом городе из зоны доставки. __Пример:__ город Новосибирск. В нем и близлежащих населенных пунктах есть адрес "ул Ленина 1". А именно: * г Новосибирск, ул Ленина 1 * г Бердск, ул Ленина 1 * пос. Восход, ул Ленина 1 "пос Восход" в нашу зону покрытия не попадает, а населенные пункты Новосибирск и Бердск - попадают. Для того, чтобы при заказе на адрес "ул Ленина 1" мы могли корректно определить координаты точки, необходимо добавить уточнение города (Новосибирск или Бердск) Для такого случае, в разделе "Список доступных городов" добавляем 2 значения: * Новосибирск * Бердск Город, введенный первым, будет использоваться по умолчанию. **Использовать виртуальную клавиатуру** Если модуль планируется использовать непосредственно на POS терминале с экраном TouchScreen, то необходимо включить данную опцию, чтобы использовать для ввода данных экранную клавиатуру. **Отправлять заказы с оплатой курьеру** Если договор между вашим рестораном и сервисом Яндекс.Доставка включает в себя опцию "Оплату курьеру за заказ" то включите данный пункт и тогда при вызове курьера на конкретный заказ вы сможете дополнительно указать, должен ли курьер при передаче заказа получить оплату от клиента. **Отправлять заказы с термосумкой по умолчанию** При включении данной настройки по умолчанию будет включена необходимость наличия термосумки у курьера. **Комментарий ресторана** Введенная тут информация будет показана курьеру, который приедет забирать заказ. Тут можно дать пояснения для курьера как ему быстрее найти ваш ресторан. Например так: Красное трехэтажное здание, отдельное крыльцо с правого крыла, вывеска "Ресторан "Рога и Копыта". Подойти к администратору на входе. **Максимальная стоимость для автоподтверждения доставки** После размещения заявки на вызов курьера происходит автоматическая оценка стоимости выполнения такого заказа. После получения оценки ресторан должен будет подтвердить заявку. И только после этого курьер будет направлен за заказом. Если мы готовы автоматически подтверждать все заказы стоимость доставки который ниже некой пороговой суммы, то это значение необходимо ввести в данном поле. __Пример:__ в данном поле указано значение 200 руб. Ресторан делает две заявки на доставку по разным адресам. В результате оценки первой заявки стоимость доставки составляет 150 рублей - такая заявка будет подтверждена автоматически и курьер будет направлен в ресторан сразу же после завершения оценки. Вторая заявка получила оценку в 250 рублей. Такую заявку ресторан должен будет подтвердить в ручном режиме и только после этого курьер будет направлен за заказом. Если не заполнить это поле, то ресторан будет подтверждать все заявки, вне зависимости от полученной оценки стоимости выполнения заказа. **Город** - выбрать город (из введенного ранее списка) где находится наш текущий ресторан. **Адрес** - ввести адрес ресторана. **Номер телефона** - телефон для связи, по которому курьер сможет позвонить в ресторан в случае возникновения каких-либо вопросов. **ИНН** юридического лица от имени которого заключен договор с сервисом Яндекс.Доставка. **Налоговая ставка** по которой работает данное ЮЛ - для случая оплаты заказа курьеру. После ввода всех настроек нажать кнопку "Отобразить заданный адрес на карте" и проконтролировать верность ввода адреса. При желании метку на карте можно передвинуть, для того что бы более точно указать курьеру расположение входа в ресторан в здании по введенному адресу. Не забываем сохранить настройки кнопкой в правом нижнем углу страницы. ===== Раздел "Настройки доставки" ===== {{:external:r_keeper_и_яндекс.доставка:pasted:20230602-094547.png}} Настройка данного пункта - не обязательна. Вне зависимости от того, какая система доставки используется на предприятии, вызвать курьера можно для любого стола, открытого на кассе r_keeper. В случае, если настройки из данного пункта инструкции сделаны, при оформлении заказа из стола, созданного из системы доставки, будут автоматически подставляться данные клиента - ФИО, адрес, телефон. В данном разделе можно указать настройки подключения к различным системам доставки, совместимым с 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 по умолчанию следующие настройки IP адрес 127.0.0.1 PORT 3050 Пользователь SYSDBA Пароль masterkey Указать путь до базы, включая имя базы. Активировать переключатель проверять заказы в Delivery. Проверить соединение, при успешном соединении сохранить настройки.