Перейдите в раздел Меню и нажмите Синхронизировать с кассой — появится представление Касса

Если представление не появилось или не появились изменения по блюдам, то

  1. Перейдите в административную панель WhiteServer
  2. Найдите задачу GetMenuByParams

  3. Посмотрите логи у запроса. Возможно не настроен доступ к XML интерфейсу или ошибка в меню
  4. Исправьте ошибку и обновите меню кнопкой Синхронизировать с кассой в Доставке

  5. Если для сети ресторанов информация появилась, но блюда отображаются с нулевой стоимостью:

    1. Перейдите в административную панель r_k Delivery
    2. Зайдите в раздел меню Заведения
    3. Заполните категорию заказа в разделе Синхронизация меню во всех карточках заведений.
    4. Сохраните изменения.

Проблемы передачи заказа в кассу

  1. Проверьте, запущен ли WhiteServer Agent v2
  2. Проверьте конфигурацию агента
  3. Посмотрите логи сервера и агента по задачам на создание заказа CreateOrder. Как это сделать описано в статье карточка ресторана

Для решения данной проблемы необходимо с проблемного телефона (провайдера) сделать ping и tracert.

Установить приложение:
https://play.google.com/store/apps/details/Fing_Ferramentas_de_rede?id=com.overlook.android.fing&hl=en_ZA

1. Ping

  • "Сканирование сети" (Network Scan)
  • Далее три точки в правом верхнем углу -> Инструменты (Tools)
  • Ping
    delivery.ucs.ru
  • Start

и нужно отправить технической поддержке результирующий скриншот.

—

2. Traceroute

  • Инструменты (Tools) -> Traceroute
delivery.ucs.ru
  • Start

и нужно отправить технической поддержке результирующий скриншот.

Со стороны клиента нужно через Апи поддержать токен, позволяющий устранить дубли в заказах:

  • externalIdempotencyKey - Ключ идемпотентности. 

Для защиты от повторного создания заказа при повторных запросах Вида 05143f7f-bb12-4ef5-9412-079057f27766
Ключ идемпотентности. 
Используется для защиты от повторного создания заказа при повторных запросах. Ключ передается при создании нового заказа.
Если тот же ключ будет отправлен повторно, вернется уже созданный заказ (новый заказ не создастся).
Если передать значение null, идемпотентность будет проверяться по полю OriginalOrderId.
Если OriginalOrderId имеет пустое значение, заказ будет создан.
public Guid? ExternalIdempotencyKey { get; set; }


Сообщение об ошибкеНазвание ошибкиОписаниеРешение
Ошибки при создании и редактировании заказа

The Phone field is not a valid phone number.

Значение phone не может быть пустым.

Попытка создать заказ без номера телефона клиента, либо номер введен некорректно.Заполнить поле номер или проверить его крректность.

Неверно задан paymentTypeID.При создании заказа не указан способ оплаты.Выберите способ оплаты заказа.

Время выполнения заказа меньше, чем его реально приготовить.При создании заказа указывается недостаточно времени для его выполнения.

Если вы создаете заказ Ко времени, увеличьте время доставки.

Если вы создаете заказ Как можно скорее, увеличьте время доставки заказа в настройках. Подробнее читайте в статье Настройки.

Нельзя создать пустой заказ dishList.Попытка удалить все блюда из созданного заказа.Отмените заказ, если он вам не нужен.

Заказ не может быть переведен в указанный.Попытка перевести заказ в статус У курьера, без назначения курьера. Назначьте курьера.

RKInternal: Невозможно закрыть заказ, он не оплачен полностьюПопытка закрыть заказ без принятия оплаты.Оплатите заказ и снова переведите в статус Выполнен.

Order have FINAL 11 statusПопытка внести изменения в закрытый заказ.После закрытия или отмены заказа внесение изменений невозможно.

Тайм-аут запроса истек

Истек таймаут запроса к серверу r_k Delivery. Операция не совершена за ограниченное время таймаута.

Ошибка может возникнуть в интерфейсе заведения при передаче заказа на кухню или при оплате заказа.

Проверьте качество соединения с интернетом. После восстановления связи заказ будет передан на кухню или оплачен.

Если с интернетом все в порядке, проверьте корректность работы WSA: запущен ли агент и нет ли в его работе ошибок.

Необходимо указать идентификатор кассовой станции для работы со сменой Ошибка при нажатие на клавишу Открытие смены

Необходимо заполнить ID кассовой станции в административной панели. Для этого:

  1. В Административной панели, перейдите в раздел Заведения 
  2. Выберите свое заведение
  3. В пункте Параметры заказа, укажите ID кассовой станции
Оплата при получении недоступнаОплата при получении недоступна

Ошибка возникает при попытке создать заказ с интеграцией с Яндекс.Доставкой.

Запрет приема оплаты картой курьерами со стороны Яндекс.Доставки для вашего аккаунта Яндекс.Доставки. 

Свяжитесь с Яндекс.Доставкой и поменяйте условия либо используйте настройку Все онлайн оплаченные. В этом случае менеджеру ресторана придётся контролировать факт оплаты самостоятельно.
Чтобы выставить настройку Все онлайн оплаченные или при необходимости убрать ее, обратитесь на ServiceDesk.

Курьера можно менять до статуса Передача на кухнюПопытка назначить курьера после того, как статус заказа сменили на Передан на кухню.Курьера можно назначить в любой момент. Игнорируйте это сообщение.

Адрес доставки можно меня до статуса Принят в ресторанеПопытка изменить адрес доставки после того, как статус заказа перешел в Принят в ресторане.Адрес доставки можно править до того, как передаете заказ на кухню.

Для блюда необходимо передать правильную цену или не передавать.
В административной панели r_k Delivery переопубликуйте представление меню. 

Cannot find guest, loyalty error code: 3007.

r_k Loyalty не может найти гостя с заданным номером телефона.


Ничего не делайте, заказ можно создать. 

Ошибка валидации заказа в r_keeper (One or more errors occurred. (Не удалось определить перечисление Delivery))Создается заказ, но на кассу не попадает.

Есть 3 способа решения данной проблемы:

  1. Применить последовательно три XML-запроса к ref (важно, именно к ref) r_keeper через XML API.
    Важно применить их последовательно:

2. Обновить WSA до последней рекомендуемой версии.
Ошибки после обновления больше не будет, но при этом всё равно со временем рекомендуется применить способ в пункте 1 в том случае, если вы не будете обновлять сам r_keeper  в ближайшее время.
Это применение (п. 1) необходимо, если применять r_k Loyalty на объекте.

Ошибки, связанные с колл-центром

No error body was created on the server sideПопытка входа в колл-центр и в интерфейс заведения из одного браузера. Откройте один из интерфейсов в режиме инкогнито или настройте разный вход для сотрудников с разной ролью. Подробнее читайте в статье Проблемы при входе.

Заказ заблокирован кем-то из сотрудниковПопытка отредактировать заказ, который открыт сотрудником колл-центра.Закройте карточку заказа в колл-центре. 
Ошибки WSA

WSADuplicateOrder: Попытка повторного создания заказаПопытка создания или передачи заказа в один и тот же статус.Обновите страницу. 
Если у вас стоит подтверждение приема на кассе, убедитесь, что заказ подтвержден.

WsaOrderError: Ошибки MidServ. Компьютер принтера не подключенПопытка оплатить заказ в интерфейсе заведения при выключенном кассовом приложении.Запустить кассовое приложение и оплатить заказ еще раз.

WSAFillingOrderError. Data at the root level is invalidСистема не распознает данные заказа.Подождите немного, а затем повторите действие. 

WsaRkSystemNotAvaliable: Информационная R-Keeper cash server система не доступнаНе запущен кассовый сервер (MID).Запустите кассовый сервер.

WsaOrderError. RkInternal: Общая смена была открыта слишком давноОбщая смена открыта более 24 часов.

Закройте и откройте смену заново. Это можно сделать:

RK7Error: Нельзя закрыть смену, т.к. есть неоплаченный заказПопытка закрыть смену через Интерфейс заведения, когда в кассовом приложении не закрыт заказ. Перейдите в кассовое приложение и нажмите на кнопку Редактирование заказа. Закройте все заказы. Закройте общую смену. Вернитесь в Интерфейс заведения. 


WsaOrderError. RkInternal: Касса [xxx] Невозможно закрыть чек, т.к. имеется дисбаланс для валюты

WsaOrderError. RkInternal: Касса [xxx] Недостаточно денег для полной оплаты заказа


Система не может закрыть чек, так как система видит дисбаланс валюты. 

Необходимо изменить правило округления валюты в настройках r_keeper. Для этого:

  1. Перейдите в меню r_keeper Деньги > Валюты
  2. Выберите валюту, которой пытались оплатить заказ и откройте ее свойства
  3. Раскройте раздел Основное и найдите поле Правило округления. Поставьте значение 1.00 и сохраните изменения
  4. Вернитесь в Интерфейс заведения и оплатите заказ.

Оплату заказа также можно произвести без изменения правил округления. Для этого:

  1. Откройте кассовое приложение и нажмите на кнопку Редактирование заказа
  2. Выберите нужный заказ и подтвердите, что хотите его отредактировать
  3. Закончите оплату заказа
  4. Вернитесь в Интерфейс заведения и доведите заказ до статуса Выполнено.

WsaOrderError RkInternal: Caannot lock orderПопытка принять оплату за заказ, оплата которого уже была принята в кассовом приложении. Так как заказ оплатили с помощью кассового приложения, оплачивать заказ в Интерфейсе заведения не нужно. Заказ можно перевести в статус Выполнено.

WsaOrderError RkInternal: Заказ закрытПопытка изменить состав заказа после его оплаты.

Если необходимо уменьшить количество порций или удалить блюдо из заказа, то отмените заказ и создайте новый.

Если нужно что-то добавить — создайте новый заказ.

WsaOrderError. RkInternal: У пользователя нет права Закрыть чекПопытка закрыть заказ без разрешения.

Необходимо дать права работнику, который работает в Интерфейсе заведения. Обычно это работник WSA. Для этого:

  1. Перейдите в меню r_keeper Персонал > Работники.
  2. Выберите нужного работника и перейдите в его свойства.
    Если вы настраивали все по умолчанию, то раскройте группу Центральный офис и выберите роль WSA. Выберите работника WSA и перейдите в его свойства.
  3. Раскройте раздел Кассовые ограничения и найдите поле Закрыть чек. Активируйте настройку.
  4. Сохраните изменения.
  5. Вернитесь в Интерфейс заведения и закройте заказ. 

WsaOrderError. RkInternal: Цена блюда отличается от цены в прейскурантеWhite Server Agent перестал верно передавать цены блюд, поэтому система видит расхождения. 

Проверьте, что WSA обрабатывает задачи без ошибок.
Для этого перейдите в административной панели White Server в свое заведение и откройте вкладку Задачи. Проверьте, что в столбце TaskTypeV2 есть задачи GetMenu и GeetMenuByParams и что они отвечают корректно: в столбце Task Status стоит зеленая галочка

Если в WSA ошибок нет, для исправления ошибки необходимо создать новое представление меню. 

WsaOrderError. RkInternal: Ошибки MidServ [2219] Не получается заблокировать. Заказ заблокирован другим ключом блокировки (станция Касса, оператор Админ).Попытка сделать изменения в заказе, который открыт на кассовой станции. Название кассовой станции и ФИО оператора указаны в скобках.Закройте заказ на кассовой станции.

Ошибка WS: Код ошибки: WsaOrderError. RkInternal: Касса [3813] Plazius (ПДС): Ошибка "Ошибка при обработке программы лояльности: unexpected" (-1)

"agentError":{ "code":"WsaOrderingPreferencesError", "desc":"WebException: Подключение не установлено, т.к. конечный компьютер отверг запрос на подключение..." }

WsaOrderingPreferencesError

Подключение не установлено, т.к. конечный компьютер отверг запрос на подключение..."

Не доступен сконфигурированный адрес сайта с формой подтверждения принятия заказа на кассе.

Обратите внимание на настройку OrderConfirmationHost

Ошибка означает, что у вас не правильно сконфигурирована форма принятия заказа на кассе.
Что можно сделать: перейдите в браузер на компьютере, где установлен агент.
откройте страницу с IP из настройки OrderConfirmationHost и портом из настройки Kestrel.EndPoints

Если страница не открылась, проверьте правильно ли указан IP и порт. Порт должен быть свободен.

"wsError": { "code": "Timeout", "desc": "Agent is offline or has been unresponsive" } }

wsError

Timeout. Agent is offline or has been unresponsive

Агент не запущен. Проверьте интернет соединение, если оно неисправно - для сервера WhiteServer агент находится ofline
"error": { "agentError": { "code": "WsaOrderError", "desc": "WsaOrderError: В R-Keeper не добавлены дополнительные свойства заказа" } }


WsaOrderError: В R-Keeper не добавлены дополнительные свойства заказа

При попытке совершить заказ, возникает ошибка.На точке раздайте право "Расширенные Свойства" для пользователя Xml-editing.
"error": {     "wsError": { "code": "License", "desc": "WsProduct"      } }

wsError code: License

При работе с доставкой возникает ошибка с лицензией.

Необходимо проверить, есть ли необходимые лицензии для связи WS и r_k Delivery и для связи WSA и r_keeper:

  • R-Keeper модуль Интерфейс к r_keeper Delivery 
  • R-Keeper модуль XML-интерфейс для WSA ПО — обратите внимание: данная лицензия должна быть в единственном экземпляре на объекте. Иначе возможно некорректная работа системы доставки.

Подробнее о лицензиях читайте в статьях Лицензирование и Лицензирование интеграций.

WsaOrderError Rknternal: Ошибки MidServ [2205] Order with guid"Заказ создан в колл- центре, отправлен в ресторан. При попытке перевести заказ в статус На кухне - ошибка: заказ заблокирован кассовым сервером, при повторной попытке перевести заказ - ошибка: Заказ уже существует.Обновите WSA агент до версии 2.7.3.26.

WsaOrderError RkInternal: Касса
[3140] Тип заказа "Доставка рестораном" не подходит выбранной категории заказа "Основная"		При попытке совершить заказ, возникает ошибка.

Необходимо добавить Тип заказа Доставка Рестораном в категорию Основная, для этого в настройках r_keeper:

  1. Зайдите в раздел Заказ, далее Категории заказа.
  2. Выберите категорию Основная
  3. В свойствах категории Основная, перейдите в раздел Исп. типов заказ
  4. Выставьте флаг напротив Доставка рестораном

Ошибки в логах WSA v2 и их расшифровка

БлокОписание
RKeeper.OrderCreationPreferencesнастройки для создания заказа в кассе и получения меню
RKeeper.RefServer.TcpConnetionподключение к ref серверу. Требуется для записи дополнительных свойств заказа, таких как телефон курьера и данных гостя
Kestrelотвечает за форму принятия заказа на кассе. По умолчанию настраивается на порт 5050. Хост прописывается в параметре OrderConfirmationHost блока RKeeper.OrderCreationPreferences