Установка и настройка [База знаний ГК Карбис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Установка и настройка ======

====== Установка ======

Актуальную версию модуля интеграции вы можете [[https://disk.yandex.ru/d/0sQ-Ln-WdSvZ9w|скачать по ссылке]]

Минимальные системные требования:

  * r_keeper 7.6.4+ или 7.6.5+
  * OS Windows7 и выше

ПО поставляется в zip архиве. Установка на конечный компьютер осуществляется путем распаковки архива в любую папку на жестком диске компьютера (полный путь НЕ должен содержать кириллицу). После распаковки архива необходимо установить службу командой (с правами Администратора)
<code>

yandex_courier.exe /install

</code>

В результате на компьютере будет установлена служба "Carbis Yandex Courier Service" которую необходимо запустить

{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-084226.png}}

**Внимание!**  По умолчанию служба занимает номер порта 11022. При работе с сервисом по сети необходимо открыть этот порт в брандмауэре и антивирусах.

Удаление службы можно произвести командой

<code>
yandex_courier.exe /uninstall

</code>

====== Настройка 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.
Проверить соединение, при успешном соединении сохранить настройки.