Всем привет! Сегодня мы хотим поделиться нашим опытом работы с периферийными устройствами на платформе Android.
Представим себе…
Вы пришли в горнолыжный прокат за лыжами и вам нужно рассчитаться картой и получить договор-оферту об оказании услуги и чек. Казалось бы, что может быть проще?
- Делаем раз. Выбрали инвентарь (лыжи, палки, ботинки, шлем и маску).
- Сотрудник ловко достает смартфон и сканирует им баркоды на инвентаре.
- Тут же достает считыватель пластиковых карт, снимает денежные средства и замораживает залог.
- А вот чек и договор-оферта, которые напечатал принтер, прикрепленный на пояс.
Эх, мечты-мечты…
В реальности все куда дольше, и вы сами прекрасно знаете почему.
В одном месте вы выбираете инвентарь, потом идете в кассу, куда стекаются все со всех стоек проката, там оплачиваете, возвращаетесь к прокатчику, получаете у него инвентарь и, наконец-то готовы ко встрече с горой!
А в часы пиковых нагрузок эта история неминуемо превращается в сущий ад.
- Отстояли длиннющую очередь к прокатчику, выбрали инвентарь.
- Теперь постоим в общей очереди на кассу.
- Потом вернемся к прокатчику за законно оплаченным. И снова отстоим очередь. Вам ведь только спросить (забрать)? Да кого это волнует.
Вот так скорость обслуживания из полутора минут растянулась на все 20, а в это время утренний вельвет снежного склона уже кто-то режет лыжами!
Кто виноват, и что делать?
Почему бы прокату не обустроить каждую стойку кассой?
Да потому, что такая проблема не постоянна. Пиковые нагрузки случаются регулярно, но по большому счету не так часто – утро выходных и праздников, и это только если погода катальная. Поэтому инвестировать в кассовое оборудование с точки зрения владельцев явно затраты не супер оправданные.
Эту задачу решает появление дополнительного мобильного сотрудника который раз, два, и помог очереди рассосаться.
В кейсе с горнолыжкой достаточно было бы купить коробочное решение для интеграции смартфона с кассовым принтером и картридером, коих на рынке хватает. Ими пользуются и курьеры, которые доставляют заказы, и девушки, которые продают билеты на аэроэкспресс.
Мы бы тоже могли ввести сумму и получить оплату,
но у нас не прокат инвентаря!
В системе заказчика с которой работали мы, буква закона требовала выдачи клиенту не просто чека на энную сумму, но еще и квитанции с подробным описанием услуги и уникальным присвоенным ей номером. То есть мы должны провести оплату, зарегистрировать это на сервере, получить уникальный номер транзакции, и затем распечатать чек, в котором отображается этот номер, полное описание услуги и баркод с закодированной информацией.
Задача поставлена, переходим к реализации.
Реализация
1. Выбираем принтер и картридер
Для начала определились, что надо использовать комплекс со смартфоном, который позволяет пользователю настраивать параметры услуги и взаимодействовать с сервером. Вопрос о выборе смартфонов для системы решился сам собой. Заказчик выбрал «рабочих лошадок» — смартфоны на базе Android. Ими оказались Huawei Honor 5C. Удобные недорогие устройства от китайского производителя. Главное, что Bluetooth есть и работает. А вот дальше надо было решить задачи посложнее. Чтобы все операции с продажей услуг проводились законно, нам был нужен фискальный регистратор. Это принтер с памятью, в которую записывается история операций по проведенным продажам.
Мобильные фискальные принтеры (а мы помним, что наше решение должно быть мобильным!) выпускаются рядом российских компаний «Атол», «Инкотекс», «Счетмаш», «Штрих-М». Мы изучили их предложения, но в нашем решении принтер должен был печатать на широкой ленте (3” вместо 2”), поскольку нам нужно было разместить на чеке подробные данные об оказанной услуге. Широкая лента нашлась только у одного включенного в государственный реестр мобильного фискального принтера ШТРИХ-MOBILE-ПТК.
С клиентов нам необходимо брать не только наличные платежи, но и списывать деньги с карты. А значит нужны картридер и провайдер такого решения, чтобы проводить оплаты и учитывать все проводимые таким способом средства. И таких решений на нашем рынке достаточно. Различаются они, пожалуй, типами моделей устройств для считывания, процентом комиссии за проведение эквайринга и… интеграциями с фискальными принтерами! Тут-то нам и попалось решение от iBox Pro, использующее картридер модели chip-n-pin с клавиатурой, а также, по счастью, интегрированное с мобильным фискальным регистратором ШТРИХ-MOBILE-ПТК.
Компания предоставила нам тестовые устройства, и мы принялись за работу…
2. Снимаем деньги
С платежной системой iBox Pro мобильное приложение можно интегрировать простым (через intent-вызов) и сложным способом (через SDK). Мы выбрали сложный путь, но вовсе не потому, что нам нравится преодолевать трудности. А по другой важной причине. Тут понадобится лирическое отступление.
В случае intent-вызова алгоритм такой:
Наш алгоритм выглядит иначе. Мы не можем просто взять, вбить сумму за услугу и распечатать чек. Нам нужно отправить данные на сервер, получить стоимость услуги, затем получить оплату от клиента, и после этого обратиться к серверу и получить уникальный код и затем обязательно отразить этот код в чеке.
Поэтому мы разработали такой алгоритм:
В итоге с помощью SDK iBox (свежую версию их эволюционирующего SDK можно скачать с GitHUB) мы встроили вызовы к iBox в наше мобильное приложение. Бонусом получили более удобный для пользователя единый интерфейс – на этапе оплаты человеку не приходится переключаться на сторонний интерфейс iBox, все процессы происходят только в рамках нашего мобильного приложения.
// С помощью вызовов методов PaymentController-а происходит передача команд устройству: // Устанавливаем однофакторную авторизацию. PaymentController.getInstance().setSingleStepEMV(true); // Задаем логин и пароль кассира через которого будет проводиться оплата PaymentController.getInstance().setCredentials(loginInfo.userName, loginInfo.userPassword); // Среди сопряженных с телефоном устройств находим то, // которое было указано в качестве картридера. // Индекс этого устройства передаем PaymentCotroller-у. ReaderBluetoothInfo readerBluetoothInfo = settingsService.getReaderBluetoothInfo(); List<BluetoothDevice> devices = PaymentController.getInstance().getBluetoothDevices(getView().getContext()); for (int i = 0; i < devices.size(); ++i) { if (devices.get(i).getAddress().equals(readerBluetoothInfo.readerAddres) && devices.get(i).getName().equals(readerBluetoothInfo.readerName)) { PaymentController.getInstance().setReaderType( getView().getContext(), PaymentController.ReaderType.WISEPAD, i, null); } } } ... PaymentDialog paymentDialog = new PaymentDialog(); // Перед непосредственным проведением платежа: // Передаем в контроллер листенер, на который будут приходить статусы и результат платежей от ibox. В нашем случае это диалог, который отображает статус оплаты. PaymentController.getInstance().setPaymentControllerListener(paymentDialog); PaymentController.getInstance().enable(); // Запускаем платеж по карте PaymentController.getInstance().startPayment(getContext(), mPaymentContext); ... // Метод который вызывает PaymentController во время проведения оплаты. public void onReaderEvent(PaymentController.ReaderEvent event) { switch (event) { case CONNECTED : case START_INIT : lblState.setText(R.string.reader_state_init); break; case DISCONNECTED : stopProgress(); lblState.setText(R.string.reader_state_disconnected); break; case SWIPE_CARD : case TRANSACTION_STARTED : startProgress(); break; ... case EJECT_CARD : stopProgress(); lblState.setText(R.string.reader_state_eject); break; case BAD_SWIPE : Toast.makeText(mActivity, R.string.reader_bad_swipe, Toast.LENGTH_LONG).show(); break; case LOW_BATTERY : Toast.makeText(mActivity, R.string.reader_low_battery, Toast.LENGTH_LONG).show(); break; default : break; } }
3. Печатаем документы
После фиксации факта продажи необходимо выдать клиенту чек, а иногда и дополнительные документы – договор-оферту, бланк заказа или гарантийное письмо. Вопрос “на чем будем печатать?” — если у пользователя на поясе висит мобильный принтер — пусть печатается на нём. Поэтому, мы заставили принтер печатать помимо фискальных чеков и другие документы.
С принтером мы работаем через небольшую библиотеку от Штрих-М, которую они создали для удобства работы с JPOS.
Осторожно, грабельный лес!
При печати документов на мобильном принтере мы столкнулись с двумя случаями, когда матрица давала сбой:
-
В сочетании с некоторыми смартфонами, которые мы использовали для тестирования, скорость работы принтера падала катастрофически. Нас это очень тревожило, так как по стандарту обслуживания заказчик требовал от нас уложиться в 1,5 минуты со всем процессом от оформления услуги до выдачи чека. По счастью, целевой девайс печатал по Bluetooth без проблем, и эту загадку мы решили оставить неразгаданной.
- На боевом тестировании абсолютно одинаковые фискальные принтеры вели себя по-разному: из-за внутренних настроек некоторые из них при печати баркода сдвигали баркод на документе вправо, отрезая часть информации. Решить удалось только применив волшебный workaround 🙂 – уменьшили некоторые элементы чека и баркода без потери качества считывания сканером.
ShtrihFiscalPrinter printer = new ShtrihFiscalPrinter(new FiscalPrinter()); PrinterBarcode printerBarcode = new PrinterBarcode(); printerBarcode.setText(boardingPass.barcodeText); //Информация, зашифрованная в баркоде. printerBarcode.setLabel(""); // Устанавливаем ширину, что пропорционально меняет размер баркода. // Возможные значения параметра - см. документацию к принтеру. printerBarcode.setBarWidth(2); // 2 - small width printerBarcode.setType(PrinterBarcode.SM_BARCODE_PDF417); Map<EncodeHintType, Object> parameters = new HashMap<>(); // В качестве альтернативы вместо изменения размера элементов баркода можно уменьшить его по ширине и увеличить по высоте. // Поменять измерения баркода можно в строчке ниже. parameters.put(EncodeHintType.PDF417_DIMENSIONS, new Dimensions(5, 5, 2, 60)); printerBarcode.addParameter(parameters); printer.printBarcode(printerBarcode);
- Ещё одна странная проблема всплыла при работе с iBox. При работе с нашими смартфонами устройство могло войти в спящий режим и не выходило из него. Проявлялось только с Huawei и вылечилось с помощью установки последней версии прошивки картридера.
4. Печатаем фискальный чек
По умолчанию фискальный принтер выдает чек от платежной системы с минимумом информации. Нас это не устроило. Во-первых, нам нужен был красиво оформленный чек, который выглядел бы аналогично чекам, утвержденным в других системах заказчика. Во-вторых, нам нужно было совместить чек с квитанцией об оказании услуги и подробной информацией о ней. Итого – с помощью SDK принтера мы сделали красивый документ чек-квитанцию. А потом долго и мучительно на тестировании один за другим печатали чеки, меняя параметры, пока, наконец, реальная бумажка не стала выглядеть на всех принтерах одинаково и так, как нужно.
private void printTicket(PrinterInfo printerInfo, boolean isRefund, String agentId) throws Exception { ShtrihFiscalPrinter printer = new ShtrihFiscalPrinter(new FiscalPrinter()); //Здесь заполняется таблица налогов внутри принтера final String NO_TAX = "0"; final String TEN_PERCENT_TAX = "1000"; printer.setVatValue(1, NO_TAX); printer.setVatValue(2, TEN_PERCENT_TAX); //НДС 10% printer.setVatValue(3, NO_TAX); printer.setVatValue(4, NO_TAX); printer.setVatTable(); printer.setHeaderLine(1, StringTools.appendStrings("", "*", LINE_LENGTH), false); printer.setHeaderLine(2, getHeader("ООО \"Хорошая компания\""), false); printer.setHeaderLine(3, getHeader("Тридевятое государство"), false); printer.setHeaderLine(4, getHeader("улица Пушкина, \nДом колотушкина"), false); printer.setHeaderLine(5, getHeader("+7(XXX)XXX-XX-XX"), false); printer.setHeaderLine(6, StringTools.appendStrings("", "*", LINE_LENGTH), false); if (isRefund) { printer.setFiscalReceiptType(jpos.FiscalPrinterConst.FPTR_RT_REFUND); } else { printer.setFiscalReceiptType(jpos.FiscalPrinterConst.FPTR_RT_SALES); } printer.beginFiscalReceipt(true); printLine(); double priceSum = 0; //PrinterEmdData содержит информацию о купленной пассажиром услуге. for (PrinterEmdData printerEmdData : printerInfo.getPrinterEmdDatas()) { String description = getDescription(printerEmdData, printerInfo.isCashierFormat()); int tax = 0; final int TEN_PERCENT_NDS = 10; final int SECOND_TAX_SLOT = 2; if (printerEmdData.taxValue == TEN_PERCENT_TAX) { tax = SECOND_TAX_SLOT; // Здесь указываем, что нас интересует налог 10% (он у нас стоит во 2-ом слоте таблицы налогов) } priceSum += printerEmdData.price; if (isRefund) { printer.printRecItemRefund(description, 0, 0, tax, (long) printerEmdData.price, ""); } else { printer.printRecItem(description, 0, 0, tax, (long) printerEmdData.price, ""); } } printLine(); if (printerInfo.isCard()) { printer.printRecTotal((long) priceSum, (long) priceSum, "1"); } else { long cashIn = (long) priceSum; if (printerInfo.getCashIn() > 0) { cashIn = (long) printerInfo.getCashIn(); } printer.printRecTotal((long) priceSum, cashIn, ""); } printer.endFiscalReceipt(true); }
5. Обеспечиваем отказоустойчивость системы
Конечно, мало просто сделать интеграцию в системе, важно сделать эту систему надежной. Для нас важно было обеспечить механизмы отката назад с любого этапа. Например, платежный сервис подтвердил приложению снятие денег, приложение запросило у сервиса бронирования услуг уникальный номер услуги, и тут пропала связь с сервером. И вот на этом этапе нужно сделать Fallback-механизм, который позволит повторить запрос на сервер или вернуть деньги на карту.
Вариантов подобных ошибок оказалось множество: при снятии денег рано вытащили карту, неправильно ввели пин-код, при попытке распечатать чек закончилась кассовая лента, принтер разрядился и так далее. Границы необходимой отказоустойчивости на каждом этапе мы определяли в ходе тест-сессий с участием опытных кассиров. В результате для каждой ошибки были разработаны необходимые Fallback-механизмы.
Возможные ошибки в процессе приема денег и распечатки чека
Итого:
- Сделали отказоустойчивую интеграцию смартфон + картридер + фискальный принтер.
- Протестировали в боевых условиях и наладили еще раз все Fallback-механизмы.
- Решение внедрено, работает и радует пользователей приложения и их клиентов.
Мы на собственном примере убедились, что решить задачу приёма платежей с помощью мобильных устройств можно, даже если на стороне сервера необходимо вести строгий учёт каждой операции. Может быть, прочитав статью, кто-то увидит возможность избавить людей от потери времени в очередях и в какой то другой сфере.
Даешь больше комфорта клиентам, которыми можем оказаться и мы с вами!
ссылка на оригинал статьи https://habrahabr.ru/post/325950/
Добавить комментарий