Интеграция с Мобильным кассиром SDK 1.1.1

Для интеграции с «Мобильным кассиром» используйте универсальную библиотеку RemoteCashierSDK для Android. Она позволяет производить продажу и возврат разными способами с помощью App-To-App взаимодействия стороннего приложения с приложением «Мобильный кассир». Пример интеграции вы можете посмотреть по этой ссылке.

RemoteCashierSDK 1.1.1 позволяет:

Что нового в SDK 1.1.1

Требования для работы с RemoteCashierSDK

Настройка интеграции

Шаг 1. Добавьте зависимость

Добавьте в проект зависимости от библиотеки RemoteCashierSDK. Для этого:

  1. в build.gradle app добавьте:
     dependencies {
       
       implementation 'com.github.EvotorInnTech:RemoteCashierSDK:1.1.1'
     }
    
  2. в build.gradle Project добавьте:
buildscript {
  
  repositories {
    
    maven { url "https://jitpack.io" }
  }
}

Шаг 2. Создайте объект Integration

  1. Импортируйте в проект интерфейс и реализующий его класс:
    • ru.evotor.integration.Integration — интерфейс;
    • ru.evotor.integration.IntegrationImpl — реализующий класс.
  2. Создайте объект Integration:
    private val integration: integration by lazy { IntegrationImpl() }
    

Описание доступных функций

Продажа

При вызове открывается экран продажи для заданного типа оплаты:

fun startSellV2(
  credentials: Credentials_V2,
  receipt:  Receipt_V2,
  device: Device_V2?,
  employee: Employee_V2?,
  resetAuthorization: Boolean
)

Где V2 - текущая версия компонентов библиотеки

Описание параметров функции:

Возврат

При вызове открывается экран возврата для заданного типа оплаты:

fun  startPaybackV2(
  credentials: Credentials_V2,
  receipt: Receipt_V2,
  sellReceiptUuid: String?,
  device: Device_V2?,
  employee: Employee_V2?,
  resetAuthorization: Boolean
)

Где:

Обработка ответа на совершённую операцию

fun handlePaymentResult(
  registry: ActivityResultRegistry,
  transactionResultHandler (TransactionResult) -> Unit)

В функцию передайте параметр с типом ActivityResultRegistry. Лямбда-выражение возвращает ответ с типом TransactionResult.

Описание полей класса TransactionResult:

Проверка переданных параметров

Тестирование интеграции

Для проверки интеграции мы рекомендуем использовать в «Мобильном кассире» режим без фискализации. Это позволит не использовать настоящие чеки при тестировании.

Для использования режима без фискализации на экране выбора терминала выберите виртуальную кассу. Или в функциях startSellV2, startPaybackV2 передайте deviceId виртуальной кассы.