/sales-sdk

jitpack integration

Primary LanguageJavaGNU Lesser General Public License v3.0LGPL-3.0

sales-sdk

The sales-sdk is used to connect an ECR (Electronic Cash Register) with an Android-based PoS Payment device.

The protocol is ZVT or alternatively nexoRetailer (alpha status/untested with certified terminals). ZVT protocol is already used in production.

Getting Started

Clone the project and load it into Android Studio.

  • salesSdk is SDK itself
  • saleTerminal is the demo app and documentation at the same time.

Prerequisites

You need an actual android-studio from "https://developer.android.com/studio". At least you need the android sdk and build with gradle only.

~/tmp λ git clone git@github.com:lavego/sales-sdk.git salesSdk
Cloning into 'salesSdk'...
remote: Enumerating objects: 1225, done.
remote: Counting objects: 100% (1225/1225), done.
remote: Compressing objects: 100% (866/866), done.
remote: Total 1225 (delta 334), reused 1215 (delta 334), pack-reused 0
Receiving objects: 100% (1225/1225), 837.48 KiB | 1.99 MiB/s, done.
Resolving deltas: 100% (334/334), done.

~/tmp λ cd salesSdk
~/tmp/salesSdk λ export ANDROID_SDK_ROOT=/Users/ah/Library/Android/sdk
~/tmp/salesSdk λ ./gradlew assemble

> Configure project :
...

Usage

Add it in your root build.gradle at the end of repositories:

allprojects {
  repositories {
    ...
    maven { url 'https://jitpack.io' }
  }
}

Step 2. Add the dependency

  dependencies {
    ...
    implementation 'com.github.lavego.sales-sdk:saleSdk:1.0' // the SDK package
    implementation 'com.github.lavego.sales-sdk:utils:1.0' // the utils package
  }

Contributing

TODO, write how to contribute...

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

  • Andre Heine/LAVEGO AG - Initial work - LAVEGO AG

License

This project is licensed under the GNU Lesser General Public License v3.0 - see the LICENSE.md file for details

Developing your ECR software

To get started quickly, take a look at the "saleTerminal" project.

In saleSdk the best entry is:

Acknowledgments