Estatísticas para Adquirência Fiserv

Dependendo da forma de integração contratada, será necessário enviar dados estatísticos do dispositivo e das transações para controle da Adquirência. Para realizar essa tarefa, a automação precisa ativar essa funcionalidade na CliSiTef. Este guia tem como objetivo ensinar como integrar e habilitar a coleta de estatísticas do dispositivo para adquirências Fiserv, utilizando a CliSiTef. A seguir, você encontrará informações sobre as permissões necessárias, as dependências requeridas e um exemplo de integração com a CliSiTef para ativar esse recurso.

Permissões necessárias

Antes de integrar a CliSiTef com estatísticas em seu aplicativo Android, é necessário adicionar as permissões adequadas ao manifesto do aplicativo. Essas permissões garantem que o aplicativo tenha acesso aos recursos necessários para coletar e analisar os dados do dispositivo. Lembre-se que se o aplicativo for instalado em um dispositivo com o Android 6.0 (API de nível 23) ou mais recente, será necessário solicitar as permissões "dangerous" no momento da execução seguindo as etapas do guia no portal do desenvolvedor Android (https://developer.android.com/training/permissions/requesting?hl=pt-br). As permissões necessárias para a integração da biblioteca são as seguintes:

<uses-permission android:name="android.permission.READ_PHONE_STATE"/> // Nível de proteção: Dangerous

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />// Nível de proteção: Dangerous

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />// Nível de proteção: Dangerous

Dependências

Certifique-se de que a biblioteca Android no formato .aar fornecida pela Fiserv esteja adicionada ao seu projeto. Você pode fazer isso seguindo as etapas abaixo:

• Copie o arquivo .aar da biblioteca para a pasta "libs" do seu projeto.
• Abra o arquivo build.gradle do módulo do aplicativo.
• Adicione a seguinte linha no bloco de dependências:

implementation files('libs/statisticsLibrary-release.aar') //nome do arquivo .aar pode variar de acordo a versão ou dispositivo alvo

Certifique-se de adicionar também as dependências da biblioteca no projeto.

implementation "androidx.room:room-runtime:2.4.3"

implementation "androidx.room:room-ktx:2.4.3"

implementation "io.insert-koin:koin-android:"3.2.0""

implementation "io.insert-koin:koin-android-compat:3.2.0"

implementation 'androidx.preference:preference:1.2.1'

implementation 'com.google.code.gson:gson:2.10.1'

implementation "androidx.work:work-runtime-ktx:2.7.1"

Importante: Certifique-se de adicionar as dependências da CliSiTef ao seu projeto, bem como as bibliotecas compartilhadas fornecidas pelo fabricante.

Essa biblioteca usa os recursos do USDK do fabricante para coletar dados do terminal e impressora, por tanto esses serviços ou bibliotecas do fabricante precisam ser inicializado previamente como no exemplo a seguir para DX8000. Geralmente são as mesma funções que a aplicação deve usar para possibilitar a impressão:

public class BaseApplication extends Application {

@Override

public void onCreate() {

super.onCreate();

//Solução para usar USDK da ingenico (DX8000) impressora e etc..

com.ingenico.lar.apos.DeviceHelper.me().init(getApplicationContext());

com.ingenico.lar.apos.DeviceHelper.me().bindService();

}

}

Exemplo de integração

Aqui está um exemplo de uso em Java para habilitar a biblioteca no projeto

import br.com.softwareexpress.sitef.android.CliSiTef;

import com.fiserv.statisticslibrarybin.model.BinAnalytics;

// ...

// Inicialização da biblioteca

BinAnalytics analytics = BinAnalytics.configure(context)

//Inicialize a CliSiTef e informe o analytics no construtor

CliSiTef cli = new CliSiTef(context, analytics);

Certifique-se de substituir context com o contexto da aplicação do seu aplicativo.

Neste exemplo, utilizamos o método configure para inicializar a biblioteca BinAnalytics e o construtor CliSiTef(context, analytics) para informar para a CliSiTef que deve coletar dados estatísticos da transação. Lembrando que a CliSiTef só deve ser inicializada uma única vez na aplicação, das próximas vezes deve ser utilizada o método getInstance() da CliSiTef.

Dispositivo e versão mínima da CliSiTef

Abaixo segue as versões mínimas requeridas para utilizar o envio dados estatísticos do dispositivo e das transações para controle da Adquirência.

Dispositivo	Versão Mínima da CliSiTef
DX8000	7.0.117.76.r2