Способы взаимодействия со смарт-терминалом

Для взаимодействия со смарт-терминалом, ваши приложения могут:

• обрабатывать события смарт-терминала, которые содержат данные о различных действиях пользователя и других приложений.
• отдавать устройству команды на выполнение определённых действий.
• обрабатывать широковещательные сообщения, о различных событиях на смарт-терминале: открытии карточки товара, открытии чека продажи и других.

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

События

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

Схема ниже показывает процесс распространения события в смарт-терминале.

После оповещения приложения, смарт-терминал ожидает результата обработки события. Для обработки событий требуется использовать соответствующие им процессоры. Например, для обработки события начисления скидки на чек, используйте процессор ReceiptDiscountEventProcessor.

Для получения события, в элементе <action> intent-фильтра соответствующей интеграционной службы вашего приложения требуется указать значение выбранной константы события.

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

<service
  android:name=".MyDiscountService"
  android:enabled="true"
  android:exported="true">
  <intent-filter>
    <action android:name="evo.v2.receipt.sell.receiptDiscount"/>
  </intent-filter>
</service>

Смарт-терминал распространяет следующие события:

• Изменение чека: BeforePositionsEditedEvent. О том как обрабатывать событие, читайте в разделе “Работа с позициями чека”.

  Когда ваше приложение реагирует на изменения, сделанные другими приложениями, возможно возникновение бесконечного цикла обработки события.
• Сканирование штрихкода: ReturnPositionsForBarcodeRequestedEvent. О том как обрабатывать событие, читайте в разделе “Обработка события сканирования штрихкода”.
• Разделение платежей в чеке продажи: PaymentSelectedEvent. О том как обрабатывать событие, читайте в разделе “Разделение чека”.
• Начисление скидки на чек: ReceiptDiscountEvent. О том как обрабатывать событие, читайте в разделе “Начисление скидок”.
• Разделение чека на печатные группы: PrintGroupRequiredEvent. О том как обрабатывать событие, читайте в разделе “Разделение чека”.
• Объединение позиций чека: PositionsMergeEvent.
• Передача оплаты чека продажи другому приложению (например, при выборе приложения “Комбооплата”): PaymentDelegatorEvent. О том как обрабатывать событие, читайте в разделе “Комбинированная оплата”.
• Печать в чеке произвольных данных: PrintExtraRequiredEvent. О том как обрабатывать событие, читайте в разделе “Печать внутри кассового чека”.

• Оплата различных чеков сторонними платёжными системами (в intent-фильтре указывайте значение константы родительского события PaymentSystemEvent):

  • Оплата чека продажи: PaymentSystemSellEvent.
  • Отмена оплаты чека продажи: PaymentSystemSellCancelEvent.
  • Оплата чека возврата: PaymentSystemPaybackEvent.
  • Отмена оплаты чека возврата: PaymentSystemPaybackCancelEvent.

  О том как обрабатывать события, читайте в разделе “Использование различных способов оплаты”.

Команды

Ваше приложение может отдавать смарт-терминалу команды, например, открыть чек или напечатать Z-отчёт. После обработки команды устройство возвращает соответствующий результат.

Команды вызываются в коде операции или службы, например, так:

//Команда открытия чека продажи и вызов метода process.
new OpenSellReceiptCommand(positionAddList, extra).process(context, callback);

Ваше приложение может отдавать смарт-терминалу следующие команды:

• Открыть чек:

  • Продажи: OpenSellReceiptCommand
  • Возврата: OpenPaybackReceiptCommand
  • Покупки: OpenBuyReceiptCommand
  • Возврата покупки: OpenBuybackReceiptCommand

• Напечатать чек:

  • Продажи: PrintSellReceiptCommand
  • Возврата: PrintPaybackReceiptCommand
  • Покупки: PrintBuyReceiptCommand
  • Возврата покупки: PrintBuybackReceiptCommand
  Команды печати чеков также используются для отправки чеков по СМС и электронной почте.

• Снять и напечатать Z-отчёт: PrintZReportCommand. Подробнее о снятии и печати Z-отчёта читайте в разделе “Печать Z-отчёта.”

Широковещательные сообщения

Смарт-терминал автоматически рассылает широковещательные сообщения при возникновении различных событий: открытии чека продажи, сканировании штрихкода, открытии карточки товара и других.

В отличие от событий смарт-терминал не ожидает обработки широковещательных сообщений.

Чтобы ваше приложение реагировало на такие события, подпишите его на получение соответствующих сообщений. Для этого используйте приёмники широковещательных сообщений (BroadcastReceiver).

О том, как подписывать приёмники на сообщения читайте в разделе “Использование приёмников широковещательных сообщений”.

В integration-library все широковещательные сообщения поделены на группы. Для каждой из групп есть свой приёмник, который содержит методы обработки соответствующих сообщений. Всего таких приёмников восемь:

• SellReceiptBroadcastReceiver – приёмник событий, связанных с чеком продажи.
• PaybackReceiptBroadcastReceiver – приёмник событий, связанных с чеком возврата.
• BuyReceiptBroadcastReceiver – приёмник событий, связанных с чеком покупки.
• BuybackReceiptBroadcastReceiver – приёмник событий, связанных с чеком возврата покупки.
• InventoryBroadcastReceiver – приёмник событий, связанных с товароучётом.
• CashDrawerBroadcastReceiver – приёмник событий, связанных с денежным ящиком.
• KktBroadcastReceiver – приёмник событий, связанных с денежными операциями.

• ScannerBroadcastReceiver – приёмник событий, связанных со сканером штрихкодов.

  Подробнее о работе со сканером штрихкодов читайте в разделе “Работа со сканером штрихкодов”.

См. также

• Использование приёмников широковещательных сообщений.