Когда пользователь сканирует штрихкод (EAN-13, QR-код, DataMatrix или любой другой), смарт-терминал рассылает событие ReturnPositionsForBarcodeRequestedEvent.
Обрабатывая данные, содержащиеся в событии сканирования штрихкода, приложения могут добавлять позиции в чек продажи и/или создавать новые товары.
Событие сканирования штрихкода обрабатывается с помощью службы SellIntegrationService.
Для работы с этой службой, в манифесте приложения необходимо указать следующее разрешение:
<uses-permission android:name="ru.evotor.permission.SELL_INTEGRATION_SERVICE" />
Создайте службу, которая будет обрабатывать событие, например, BarcodeEventHandlerService.
В манифесте приложения, в разделе службы, укажите разрешение, а в intent-фильтре службы, укажите событие сканирования чека:
<service
android:name=".BarcodeEventHandlerService"
android:enabled="true"
android:exported="true"
android:permission="ru.evotor.permission.SELL_INTEGRATION_SERVICE">
<!-- служба использует объявленное разрешение -->
<intent-filter>
<!-- событие сканирования штрихкода -->
<action android:name="ru.evotor.event.sell.BARCODE_RECEIVED" />
<category android:name="android.intent.category.EVOTOR" />
</intent-filter>
</service>
После сканирования штрихкода, служба получит событие ReturnPositionsForBarcodeRequestedEvent, которое содержит полученные о сканера данные (barcode) и параметр creatingNewProduct со значением false. С помощью параметра creatingNewProduct смарт-терминал сообщает приложениям о необходимости создания нового товара.
Получив событие, служба BarcodeEventHandlerService может добавить существующий товар в чек продажи или запустить процесс создания нового товара.
Чтобы обработать событие сканирования штрихкода:
BarcodeEventHandlerService от класса SellIntegrationService.Переопределите метод handleEvent() и передайте в него событие сканирования штрихкода ReturnPositionsForBarcodeRequestedEvent.
В методе следует реализовать логику поиска товаров по данным из события и наполнения списка позиций, который будет добавлен в чек продажи.
Верните результат ReturnPositionsForBarcodeRequestedEvent.Result().
В результате приложение может вернуть одну или несколько позиций, которые будут добавлены в чек продажи. Кроме списка позиций, в результате необходимо вернуть параметр iCanCreateNewProduct. Параметр принимает значения true или false и указывает на то, может приложение создать новый товар или нет.
Если приложение не нашло необходимый товар, но готово создать новый (результат обработки события содержит параметр iCanCreateNewProduct == true), смарт-терминал передаст приложению событие ReturnPositionsForBarcodeRequestedEvent с параметром creatingNewProduct == true. В ответ на это событие метод handleEvent() должен вернуть null.
После создания товара приложение должно вернуть одну или несколько позиций, которые будут добавлены в чек продажи. Рекомендуется возвращать одну позицию, которая ссылается на созданный товар.
NavigationApi.Если ни одно из приложений не готово создать новый товар, смарт-терминал самостоятельно запустит процесс создания нового товара.
Если служба не может найти необходимый товар, она запускает операцию создания нового товара.
open class BarcodeEventHandlerService : SellIntegrationService() {
override fun handleEvent(
/*
ReturnPositionsForBarcodeRequestedEvent(
val barcode: String, – строка данных, полученных от сканера штрихкодов.
val creatingNewProduct: Boolean – указывает на необходимость создать новый товар. Сразу после сканирования штрихкода всегда содержит false.
)
*/
event: ReturnPositionsForBarcodeRequestedEvent
):
/*
ReturnPositionsForBarcodeRequestedEvent.Result(
val positions: List<Position>, – список позиций, которые будут добавлены в чек.
val iCanCreateNewProduct: Boolean – указывает, будет приложение создавать товар на основе отсканированного штрихкода или нет
)
*/
ReturnPositionsForBarcodeRequestedEvent.Result?
{
// Создаём список позиций, который будет возвращён в результате и добавлен в чек продажи
val positions = mutableListOf<Position>()
// Запускаем операцию CreateProductActivity для создания нового товара, если creatingNewProduct == true.
if (event.creatingNewProduct) {
startIntegrationActivity(Intent(this, CreateProductActivity::class.java).apply {
putExtra("SCANNED_BARCODE", event.barcode)
})
return null
} else {
// Наполняем список позиций positions
}
// Возвращаем позиции и сообщаем о намерении создать новый товар
return ReturnPositionsForBarcodeRequestedEvent.Result(positions, iCanCreateNewProduct = true)
}
}
class CreateProductActivity : Activity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// Ключ штрихкода, присвоенный в службе BarcodeEventHandlerService
val scannedBarcode = intent.getStringExtra("SCANNED_BARCODE")
val parsedBarcode: String
// Выделяем необходимый штрихкод из отсканированных данных и помещаем его в переменную parsedBarcode
// Открываем окно создания нового товара с пердзаполненным полем штрихкода
startActivityForResult(NavigationApi.createIntentForNewProduct(NavigationApi.NewProductIntentBuilder()
.setBarcode(parsedBarcode)
), 5555)
}
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {//Параметр data содержит идентификатор созданного товара
super.onActivityResult(requestCode, resultCode, data)
if (requestCode == 5555) {
// Ищем созданный товар по идентификатору
val prodItem = data?.getStringExtra("productUuid")?.let { InventoryApi.getProductByUuid(this, it) }
if (pi == null) {
finish()
return
}
val p = prodItem as ProductItem.Product
val b = intent.getBundleExtra(KEY_INTENT_DATA)
val r = b.getParcelable<IntegrationResponse>(KEY_INTEGRATION_RESPONSE)
r?.onResult(Bundle().apply {
putBundle(IntegrationManager.KEY_DATA,
// Возвращаем результат со списком позиций и сообщаем смарт-терминалу, что создавать новый товар не требуется (iCanCreateNewProduct == false)
ReturnPositionsForBarcodeRequestedEvent.Result(listOf(
Position(
// Указываем параметры позиции
)
), false).toBundle())
})
finish()
}
}
}