Repository files navigation

TailPOS

TailPOS an Offline First Open Source POS for ERPNext

o Two-way Sync to ERPNextTwo-way syncing to an ERPNext instance for a full suite of back-office functionalities.

o Offline-first ApproachContinue to make sales and keep running the business even no internet or unstable.

o Mobile POSUses the tablet for a lightweight setup. Built-in rear camera of the tablet can be used as a barcode scanner. Any bluetooth barcode scanner is compatible withtailpos

o Print receiptsPrint sales receipts for customers using any ESC/POS receipt printer.

o Multiple payment modesCan process credit card,mobile payments and cash.

o Discounts ProgramCan apply discount to an invoice or on specific items.

o Inventory ManagementKeep track of stock levels easily. Easy-to-use menu for item maintenance such as creating and updating item information.

o Sales ReportsCan generate X and Z readings and attendant shift sales totals.

This project is released under the GPLv3 license, for more details, take a look at the LICENSE file in the source.

A quick demo of syncing thetailpos to a Frappe/Erpnext server

https://docs.tailpos.com/tailpos/syncing-to-frappe-erpnext

server: https://demo.tailerp.comusername: demo@example.compassword: @Bailabs

• Go ToItem List.
• Make a newItem.
• Select your newItemto see its properties.

• SelectItem Price underPricing.Make sure theIn TailPOS checkbox is checked.

• Don't forget to save your Item.

• Go toSettings > Sync
• Fill the following

ERPNext Server: demo.tailerp.comUsername: demo@example.comPassword: @BailabsDevice ID: <>

• Go toDevice list.
• Create a newDevice
• Input theDevice Name andPOS Profile
• Fill out information need in thePOS profile

Name: <>Series: ACC-SINV-.YYYY.-AccountingWrite Off Accounting: Write Off – DWrite Off Cost Center: Main – D

• Select your newDevice.
• Device ID is displayed at the top-right corner near theSave button.
  

• Once your done, save yourSync Settings.
• PressForce Sync.
• OnceForce Sync is successful, go to yourSales tab and fill up a sample transaction.
• Confirm the transaction by looking at yourReceipts tab.
• Now go back to yourSettings >Sync andForce Sync the receipt data to the server.
• Verify by going toReceipts List in ERPNext and check the receipts if they are generated.

If you are interested contributing thetailpos, the following guide will give you instructions in compiling thetailpos.

First, you'll neednodejs andnpm:

sudo apt install curlcurl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -sudo apt-get install -y nodejsnodejs -vv8.4.0

Install development tools to build native addons:

sudo apt-get install gcc g++ make

Install theyarn package manager, run:

curl -sL https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.listsudo apt-get update && sudo apt-get install yarn

Then you can installreact-native-cli usingnpm

sudo npm install -g react-native-cli

Now you need to install Java and Android

sudo apt-get install default-jresudo apt-get install default-jdksudo add-apt-repository ppa:webupd8team/javasudo apt-get updatesudo apt-get install oracle-java8-installer

• Install Android
• Install Android SDK requirements

cd ~mkdir android-sdkcd android-sdkwget https://dl.google.com/android/repository/sdk-tools-linux-3859397.zipsudo apt-get install unzipunzip sdk-tools-linux-3859397.zip

We add the path of our Android SDK tools to.bashrc so that we have access to the Android tools.

cd ~nano .bashrc# Add these lines to the top of the fileexport ANDROID_HOME=$HOME/android-sdkexport PATH=$PATH:$ANDROID_HOME/toolsexport PATH=$PATH:$ANDROID_HOME/tools/binexport PATH=$PATH:$ANDROID_HOME/platform-tools# CTRL+O (uppcase o) to save# CTRL+X to exitsource ~/.bashrc

android update sdk --no-ui# Answer 'y' to all promptssdkmanager "platforms;android-23" "build-tools;23.0.1" "add-ons;addon-google_apis-google-23"

Installing TailPOS

cd ~mkdir Projectscd Projectsgit clone https://github.com/bailabs/tailpos.gitcd tailposyarn

Updatingreact-native-camera modules

• removebuildscript section

  buildscript {  repositories {    jcenter()    maven {      url 'https://maven.google.com'    }  }  dependencies {    classpath 'com.android.tools.build:gradle:3.0.0'  }}

• compileOnly toprovided
• implementation tocompile

cd ~nano Projects/tailpos/node_modules/react-native-camera/android/build.gradle

Updatingreact-native-maps modules

• compileOnly toprovided
• implementation tocompile

cd ~nano Projects/tailpos/node_modules/react-native-maps/lib/android/build.gradle

Updatingreact-native-bluetooth-serial modules

• remove@Override in line 23 (the second@Override)

cd ~nano Projects/tailpos/node_modules/react-native-bluetooth-serial/android/src/main/java/com/rusel/RCTBluetoothSerial/RCTBluetoothSerialPackage.java

Updatingreact-native-device-info withsupport-v4 fix

ERROR: In <declare-styleable> FontFamilyFont, unable to find attribute android:fontVariationSettingsERROR: In <declare-styleable> FontFamilyFont, unable to find attribute android:ttcIndex

Set the following underbuild.gradle underreact-native-device-info

android {  compileSdkVersion 26  buildToolsVersion "26.0.2"  ...}dependencies {  ...  compile "com.google.android.gms:play-services-gcm:12.0.1"  compile "com.android.support:support-v4:27.1.0"}

Updatereact-native-localization

• implementation tocompile

BuildingTailPOS

cd ~cd Projects/tailposreact-native run-android