История страницы

Описание

Сервер заказов предназначен для промежуточного хранения заказов покупателей, подготовленных во внешних системах (интернет-магазин, служба доставки) перед началом их обработки на кассе УКМ 5.

Помимо этого, сервер заказов, совместно с API сервера заказов поддерживает работу с любым мобильным приложениемСборщик заказов, поддерживает процессы управляющим процессами сборки (включая взаимодействие с заказчиком) и доставки заказа.

Далее описан функционал сервера заказов для оплаты на кассах заказов, подготовленных во внешних системах (интернет-заказы).

...

- выдача на кассе заказа, по которому ранее была получена предоплата;

- выкуп на кассе ранее неоплаченного не оплаченного заказа;

- возврат денежных средств по заказам:

...

- в заказе могут быть позиции с одинаковыми товарами и ценами;

- для маркированных товаров на сервер заказов также передается их КиЗ, при этом:

   - если внешняя система заполняет значение КиЗ, то она должна заполнить его в точности так, как КиЗ нанесен на товар – при регистрации товара в ККТ касса будет регистрировать КиЗ так, как будто его содержание было прочитано сканером кассы. Соответственно, если информация о КиЗ в заказе будет отличаться от стандартной, то информация о маркировке товара либо совсем не будет зарегистрирована, либо может быть зарегистрирована с искажениями;

   - если внешняя система не загружает информацию о КиЗ, то в соответствующих запросах API item.kiz должен отсутствовать (не быть пустым – а именно отсутствовать).

Внешняя система может управлять правилами применения скидок (в том числе по карте покупателя). Для этого в заказе предназначен параметр discountPolicy (для каждой позиции в отдельности) со следующими возможными значениями:

...

Независимо от политики применения скидок, информация о карте покупателя, если она указана в заказе, будет передана в систему лояльности LOYA и будет обрабатываться в чеке так же, как будто она была введена в чек в процессе его оформления.

...

Чек выгружается во внешнюю систему (через API или XML-конвертер) с указанием заказа, на основании которого он был создан (доп. свойство properties. "id" : "ORDER_NUM"), к позициям чека привязывается доп. свойство с номером соответствующей позиции в заказе (properties. "id" : "ORDER_POSITION"). Кроме того, сохраняется значение статуса заказа, в котором он поступил на кассу (properties. "id" : "ORDER_ STATUS ").

...

В заказ, ожидающий предоплату, на кассе нельзя добавить никакие другие товары.

Примечание. Заказ совсем не обязательно должен проходить стадию приема предоплаты: внешняя система может просто выгрузить заказ для выкупа при получении или только для получения (если ранее по такому заказу уже была получена предоплата – например, во внешней системе). Более того, кассовая система никак не отслеживает связь заказа и получения предоплаты за него – предполагается, что контроль и управление статусами заказа происходит во внешней системе.

Выдача заказа

Когда придет время получать товары по заказу на кассе, то внешняя система должна выгрузить заказ со статусом 'WaitsPurchase' с тем же номером и тем же товарным составом, а также с пометкой, что для него была получена предоплата. Для этого в заказе должна быть заполнена секция Payment с суммой предоплаты и указанием, какими средствами был получен аванс – наличные/банковская карта.

...

Для управления правами на создание чеков на возврат (без ссылки на чек продажи), существует два дополнительных права: Возврат без чека на основании заказа и Возврат без чека не на основании заказа, благодаря использованию которых рядовые кассиры смогут создавать чеки на возврат на основании заказов, без риска создания «опасных» чеков на возврат.

...

Image RemovedImage Added

В конфигурационном файле return_by_receipt.conf (applications\return_by_receipt\return_by_receipt.conf) необходимо установить значение параметра isAllowedRefundReceiptForOrders:

...

4. В заказах обрабатываются карты покупателей только системы лояльности LOYA, поддержка прочих систем лояльности выполняется при необходимости.

...

Функционал кассы при оформлении заказов и возвратов по заказам подробно описан здесь.

Настройки

1. На кассовом сервере по адресу: Магазин – Типы касс нужно выбрать тип кассы и нажать кнопку Настройки:

Image Modified

В файле Для обеспечения возможности работы с интернет-заказами, в разделе bl файла sale.conf (applications\sale\sale.conf) в раздел bl добавить параметры сервера заказов:

orders: {

  url = "http://192.168.10.228:8080/api/v1.0/order"

  timeout = 5 seconds

}

2. На кассовом сервере по адресу: Оборудование – Шаблоны нужно выбрать шаблон оборудования и нажать кнопку Оборудование:

Image Removedнужно раскомментировать строку:

# include file("conf/applications/sale/order.conf").

2. В файле order.conf (applications\sale\order.conf) нужно указать актуальный URL сервера заказов, например:

Image Added

3. На кассовом сервере по адресу: Магазин – Кассы нужно выбрать необходимую кассу и нажать кнопку Оборудование:

Image Added

В появившемся иерархическом древе в конфигурационном файле keyboard_layout (hardware/keyboard_layout/keyboardLayout.conf) нужно посмотреть, какой тип клавиатуры используется (он должен быть раскомментирован в общем списке):

Image Added

В конфигурационный файл с актуальной раскладкой клавиатуры по адресу: hardware\keyboard_layout\файл актуальной раскладки необходимо добавить следующий фрагмент, после чего нажать кнопку Сохранить:

...

Примечание. Пункт будет доступен, только если в Init придет параметр useOrder=true, и если чек не открыт.

34. Также можно настроить горячую клавишу поиска заказа на клавиатуре кассы, добавив в конфигурационный файл с актуальной раскладкой клавиатуры по адресу: hardware\keyboard_layout\файл актуальной раскладки следующий фрагмент, после чего нажать кнопку Сохранить:

{

  code = 119 # F8

  type = "FindOrder"

  params = ""

}

45. Дальнейшие настройки осуществляются через API.5. Включить меню интернет-заказов в список функций на Рабочем столе кассы можно в конфигурационном файле mintukm.config (\mintukm.config) по адресу: Магазин – Типы касс на кассовом сервере.