installation and user manual · if you have to install the certificate from .pfx file, then you...

29
FRCS Free POS Installation and User Manual Android 5.1.1 +, phone and tablet Change log Author Description Version DTI Initial manual 1.0 v. 1.0

Upload: others

Post on 03-Oct-2020

5 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS

Installation and User Manual

Android 5.1.1 +, phone and tablet

Change log

Author Description Version

DTI Initial manual 1.0

v. 1.0

Page 2: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 1 of 28

Table of Contents

Introduction ............................................................................................................................................................ 2

How FRCS free POS can help you ....................................................................................................................... 2

How to install and configure FRCS free POS........................................................................................................... 3

Before you install ................................................................................................................................................ 3

Requirements ................................................................................................................................................. 3

Installation .......................................................................................................................................................... 3

App download and certificates....................................................................................................................... 3

Installing certificates....................................................................................................................................... 3

Configuring FRCS free POS ................................................................................................................................. 9

Connecting to V-SDC....................................................................................................................................... 9

Adding Taxes ................................................................................................................................................. 10

Adding Cashier .............................................................................................................................................. 11

Working with FRCS Free POS ................................................................................................................................ 13

Managing catalog items ................................................................................................................................... 13

Creating invoices .............................................................................................................................................. 14

Sharing Receipts ............................................................................................................................................... 17

Journal .................................................................................................................................................................. 19

Data Management ................................................................................................................................................ 19

Export and Import Catalog ............................................................................................................................... 19

Export Catalog .............................................................................................................................................. 20

Import Catalog .............................................................................................................................................. 23

Export and Import Invoices .............................................................................................................................. 24

Export Invoices ............................................................................................................................................. 24

Import Invoices ............................................................................................................................................. 28

Disclaimer ............................................................................................................................................................. 28

Page 3: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 2 of 28

Introduction

The FRCS Free POS system is an Android POS app for any small or medium-sized business. It offers the end

user a friendly interface which incorporates touch input while interfacing to the standard of POS needed in

the retail industry. The product was designed to resolve the need for a fully functional mobile POS solution

required in retail stores where the necessity to satisfy customer convenience is of the utmost importance,

while allowing a retailer to easily support and run the POS application without complex adjustments.

How FRCS free POS can help you

Expand Selling Space - FRCS Free POS app does not require any fixed area or additional space in the premises.

Freed up space can be used for expanding produce presentation.

Minimize Queueing – By using FRCS Free POS, your customers won’t have to wait in long lines at the POS. You

can check them out anytime and anywhere in the premises.

Highest Trading Periods - FRCS Free POS app comes in very handy for rush hours, special promotions and

outdoor sales.

Customer First - FRCS Free POS app allows you to walk your customer through the premises offering

assistance, eliminating the need for the customer to wait for service or check out. This kind of shopping offers

the most personal experiences and will bring new levels of customer satisfaction to your business.

Page 4: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 3 of 28

How to install and configure FRCS free POS

Before you install

Requirements

Before you can start using FRCS free POS app, make sure you have met several requirements:

• Functioning Android handheld device (phone or tablet) running on Android 5.1.1 +

• Available internet connectivity

• Functional built-in camera

• Active account on TAP portal (for more information on using TAP portal, please refer to User Manual for

Taxpayer Portal https://www.frcs.org.fj/our-services/vat-monitoring-system-vms/documentation-

manuals/)

Installation

App download and certificates

Before you can start issuing receipts, you need to download FRCS free POS app onto your handheld device

(phone or tablet) from the following URL on Google Play:

https://play.google.com/store/apps/details?id=fj.org.frcs.pos

Next, visit TAP portal at https://tap.staging.vms.frcs.org.fj/ or https://tap.vms.frcs.org.fj/ and request

certificate(s) issuing (for more information on how to request certificate(s) issuing, please refer to User

Manual for Taxpayer Portal, Request additional Certificates section)

Installing certificates

Once your request for certificate(s) issuing has been approved, you will receive an email with all necessary

files, credentials: UID(s), password(s) and POS Access Code (PAC), and activation URL(s).

HELP TIP: Since you will have to install the certificate(s) on your handheld device, we suggest you open the email and save the files directly from your device.

NOTE: Installing certificates applies only for accessing V-SDC, and it's not required for accessing E-SDC.

Page 5: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 4 of 28

Figure 1 Email with certificates and credentials (desktop)

Figure 2 Email with certificates and credentials (phone)

If not already installed, you can install ICA and RCA only once on the device and environment on which you

will use FRCS free POS.

Next, install Root Certificate to Trusted Root and issue Certificate to Intermediate Root.

Page 6: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 5 of 28

Figure 3 Browse for files

Figure 4 If necessary, unlock your device

Page 7: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 6 of 28

Figure 5 Name the certificate

Figure 6 ICA has been installed

If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you

along with the .pfx file(s). However, if you are downloading certificates via activation link, downloaded files

will have p12 extension.

Page 8: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 7 of 28

Figure 7 Browse for .pxf file

Figure 8 Enter valid password

Figure 9 Name the certificate

Figure 10 Installed certificate user credentials

Page 9: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 8 of 28

After the successful installation of the certificate(s) you can choose the one you need:

Figure 11 Trusted certificates

Figure 12 Choose certificate (.pfx or p12)

Page 10: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 9 of 28

Configuring FRCS free POS

Now that you have installed necessary certificate(s), it's time to configure the app prior to actual use.

You can do that by launching the app, and selecting a valid certificate, prior to issuing an invoice, by tapping

on .

Figure 13 Choose certificate

Here you will find a list of all installed certificates you want to use when signing invoices. NOTE: You can

choose only one certificate.

For additional configuration, tap on top left Menu icon , and select Settings .

Connecting to V-SDC

In order to configure the connection to V-SDC, select SDC location from Settings menu item:

Figure 14 Select SDC Location

Page 11: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 10 of 28

Once you access the dialog, enter name of the server, its URL, and tap on Update.

Active V-SDC servers:

Production: https://vsdc.vms.frcs.org.fj/

Staging: https://vsdc.staging.vms.frcs.org.fj/

Figure 15 Adding V-SDC connection

NOTE: Connection to E-SDCs via LAN will be available in the next release.

Adding Taxes

In order to access add new taxes dialog, from the Settings Menu, tap on Taxes:

Figure 16 Select Taxes

Page 12: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 11 of 28

Once you have accessed the listing, tap on top right icon to add a new tax. Add Tax label and tap Enter.

NOTE: Production and Staging environments have the same tax labels.

Valid tax labels:

• Tax Label A - VAT

• Tax Label E - STT

• Tax Label F - ECAL

• Tax Label P - Plastic Bag Levy

Figure 17 Enter tax label

Figure 18 Valid tax label listing

You can also delete taxes by tapping on icon (icon), because there is no option for editing already entered

taxes.

Adding Cashier

You can easily add one or more cashiers by tapping on Cashier TIN from Settings menu:

Figure 19 Add Cashier

Page 13: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 12 of 28

You can add all cashiers that will be using your POS app on that particular device by tapping icon,

however only one can be active. You can always swap between cashiers, depending on their working shifts, by

simply tapping on cashier's name or icon

Add new cashier by tapping and entering their Name and/or employee Tax Identification Number (TIN).

To edit existing cashiers, tap on their name and tap on icon.

Figure 20 Cashier list

To delete existing cashier, simply tap on icon .

Page 14: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 13 of 28

Working with FRCS Free POS

Now that you have met all necessary requirements, it's time to start using your FRCS free POS app.

Managing catalog items

Before you can start issuing invoices, you have to add your products / services to the Catalog. Tap on and

select Catalog.

Figure 21 Select catalog

In order to add items, tap on icon, and fill in all mandatory fields, Name and Unit price - in addition you

can add GTIN and Tax label (most items will have A label), which are optional.

Figure 22 Fill in product / service info

Figure 23 Product / service list

To browse the Catalog items, you can tap on icon and enter item's name or GTIN.

Page 15: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 14 of 28

To delete existing items, tap on icon

To edit existing item, tap on icon .

Creating invoices

When you have successfully added all your products / services to the Catalog, you are finally all set up for

issuing the invoices. Tap on icon and select .

You can add items by using one of three options on the top right .

Search by Name or GTIN , tap on to add a new item, or scan GTIN by tapping on and use your

device's camera.

When you have added all required items, tap on on the bottom of the screen.

Figure 24 Adding items

Page 16: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 15 of 28

Page 17: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 16 of 28

If necessary, you can edit quantity for each item by tapping on .

Figure 25 Change quantity

At this point you can enter Buyer TIN and Cost Center (if required), choose Invoice type and Transaction, and

Payment method.

NOTE: FRCS free POS supports all invoice types (Normal, Proforma, Training and Copy).

NOTE: If you choose invoice type Refund or Copy, a mandatory Ref.No field will appear on the invoice dialog).

If you want to delete a single item, tap on icon next to that item. You can delete all items from the

invoice by tapping on icon .

When you have added all required items and their quantities, simply tap on to finish.

NOTE: On the first launch, and each time the app has been relaunched, prior to finishing the receipt, you have to enter PAC. Also if you change the certificate, you will also have to enter a valid PAC.

Page 18: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 17 of 28

Figure 26 Finish the receipt

Figure 27 Receipt is ready

Sharing Receipts

Once you have finished the receipt, you can share it with your customer in several ways. You can print it to

Google Print, send it via Bluetooth, email it or save it as .pdf, etc... by tapping on top right.

Figure 28 Share the receipt via Gmail, bluetooth, Google Drive etc.

Example of saving receipt as .pdf file:

Page 19: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 18 of 28

Figure 29 Save as .pdf

Figure 30 PDF of the receipt

NOTE: The list of available apps for sharing / storing, will vary, based on the apps installed on your device.

Page 20: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 19 of 28

Journal

Here you can find the list of all issued invoices on your device.

Figure 31 List of all issued invoices

If you are looking for a specific invoice(s) tap on advanced search icon

Data Management

FRCS free POS enables you to import or export Catalog items and issued Receipts, and that can save you a lot

of time when configuring the app.

Export and Import Catalog

FRCS free POS app enables integration with other systems:

• Products/Services and prices are defined in company HQ

• List is exported in .json format and sent to travelling salesmen

• Travelling Salesman imports new catalog

• New products, services and prices are available on Free POS

Your company's products and/or services and prices, can be defined in advance in the company's HQ.

Page 21: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 20 of 28

In order to access Export / Import Catalog menu items, select item from the main Menu,

and tap on top right icon.

Export Catalog

Figure 32 Export/Import Catalog Menu

Figure 33 Enter the name of the Catalog

Once the menu opens, tap on Export catalog, and when a dialog opens, fill in the name and tap Enter.

Page 22: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 21 of 28

Figure 34 Save To

Figure 35 Selected location

Next, you will be prompted to choose the location for saving exported file, and it can be any location, whether

on your device or on an external source. After choosing the location, you will see the name and the file format

of the exported file (example: DemoCatalog.json), and then you can tap on Save.

Upon successful saving, you will get the message Catalog exported successfully.

This is how the contents of the exported DemoCatalog.json look like:

[

{

"barcode": "45632187",

"count": 1.0,

"countForShow": 1.0,

"discount": 0.0,

"isAdded": false,

"isSelected": false,

"name": "Chocolate",

"price": 5.0,

"priceShow": 5.0,

"tax": [

{

"code": "E",

"isChecked": false

},

{

"code": "F",

"isChecked": false

}

],

"type": "Catalog"

},

{

"barcode": "87456321",

"count": 1.0,

"countForShow": 1.0,

"discount": 0.0,

"isAdded": false,

"isSelected": false,

Page 23: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 22 of 28

"name": "Beer",

"price": 8.54,

"priceShow": 8.54,

"tax": [

{

"code": "A",

"isChecked": false

}

],

"type": "Catalog"

},

{

"barcode": "321654987",

"count": 1.0,

"countForShow": 1.0,

"discount": 0.0,

"isAdded": false,

"isSelected": false,

"name": "Coffee Espresso",

"price": 2.85,

"priceShow": 2.85,

"tax": [

{

"code": "E",

"isChecked": false

}

],

"type": "Catalog"

},

{

"barcode": "321654987",

"count": 1.0,

"countForShow": 1.0,

"discount": 0.0,

"isAdded": false,

"isSelected": false,

"name": "Plastic Bag",

"price": 0.1,

"priceShow": 0.1,

"tax": [

{

"code": "P",

"isChecked": false

}

],

"type": "Catalog"

},

{

"barcode": "043859587131",

"count": 1.0,

"countForShow": 1.0,

"discount": 0.0,

"isAdded": false,

"isSelected": false,

"name": "Cloth",

"price": 12.56,

"priceShow": 12.56,

"tax": [

{

"code": "A",

"isChecked": false

}

],

"type": "Catalog"

}

]

Page 24: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 23 of 28

Figure 36 Catalog exported successfully

Figure 37 Browse location

Import Catalog

Importing products / services Catalog operates in the same way as exporting, only in reverse.

Select Catalog from the main Menu tap on the icon and select Import Catalog.

Figure 37 Browse location shows browsing for import location from your device - it could be a local storage or

online service.

Page 25: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 24 of 28

Figure 38 Location of a .json file

Figure 39 Successful Import

Catalog file ready for import, should have .json extension. After you tap on the adequate .json file, Catalog

will be automatically populated with the predefined products / services.

Export and Import Invoices

FRCS free POS app enables integration with other systems:

• Travelling Salesman exports all receipts in .json format

• File is sent by email to backend system

• Backend system automatically imports new invoices

Whenever situation requires, you may either export all invoices from the Journal or import previously

exported list.

In order to access Export / Import Invoices menu items, select item from the main Menu,

and tap on top right icon.

Export Invoices

Once you select Export invoices, a dialog will open, where you can fill in a desired name for your Journal, and

tap Enter.

Page 26: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 25 of 28

Figure 40 Export invoices

Figure 41 Choose name for the file

Page 27: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 26 of 28

Figure 42 Choose destination location

Figure 43 Saving .json file

Next, you will be prompted to choose the location for saving exported file, and it can be any location, whether

on your device or on an external source. After choosing the location, you will see the name and the file format

of the exported file (example: DemoJournal.json), and then you can tap on Save.

Page 28: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 27 of 28

Upon successful saving, you will get the message Journal exported successfully.

Figure 44 Export successful

Figure 45 Browse import location

This is how the contents of the exported DemoJournal.json look like:

Figure 46 Exported Journal .json file

Page 29: Installation and User Manual · If you have to install the certificate from .pfx file, then you will have to enter a valid password emailed to you along with the .pfx file(s). However,

FRCS Free POS for Android

Page 28 of 28

Import Invoices

Importing invoices into Journal operates in the same way as exporting, only in reverse.

Select Journal from the main Menu tap on the icon and select Import Invoices.

Figure 45 Browse import location shows browsing for import location from your device - it could be a local

storage or an online service.

Figure 47 Location of a .json file

Figure 48 Successful import

Journal file ready for import, should have .json extension (example: DemoJournal.json). After you tap on the

adequate .json file, Journal will be automatically populated with the previously saved invoices.

Disclaimer

FRCS free POS is a free app, available for commercial use, therefore we are not responsible for the contents of

the imported / exported files, and we are not responsible for any lost data, corrupted or damaged imported /

exported files, so always make a back-up. We do not take responsibility for decisions taken and data entered

by the users of FRCS free POS based solely on the information provided in this app.