Wanda POS Administrator's Guide
Wanda POS Administrator's Guide
Wanda POS Administrator's Guide
Wanda POS
ADMINISTRATOR’S GUIDE
Fonyuy T. Isidore
Administrator’s
Guide
Wanda POS
Administrator’s Guide
By Fonyuy T. Isidore
Developer
IT Kamer Company Ltd.
[email protected]
Tuesday, 23rd September 2014
Table of Contents
Minimum system requirements ............................................................................................................... 8
Recommended requirements ................................................................................................................... 8
Downloading the Software ....................................................................................................................... 8
1. GENERAL INFORMATION .................................................................................................................... 10
a. System Overview............................................................................................................................. 11
b. Product References......................................................................................................................... 11
c. Authorized Use Permission ............................................................................................................. 11
d. Points of Contact............................................................................................................................. 11
i. Help Desk .................................................................................................................................... 11
ii. Coordination ............................................................................................................................... 12
e. Acronyms and Abbreviations .......................................................................................................... 12
f. Document Conventions .................................................................................................................. 12
New chapter................................................................................................................................................ 13
Main heading .......................................................................................................................................... 13
Sub – heading...................................................................................................................................... 13
g. Buttons and Icons ........................................................................................................................... 13
h. Wanda Documentation................................................................................................................... 14
2. GETTING STARTED............................................................................................................................... 15
Logging On .............................................................................................................................................. 16
User Access Levels .................................................................................................................................. 16
Guest:.......................................................................................................................................... 16
Employee: ................................................................................................................................... 16
Manager:..................................................................................................................................... 16
Administrator:............................................................................................................................. 16
Changing User ID and Password ............................................................................................................. 17
Exit System .............................................................................................................................................. 17
3. USING THE SYSTEM ............................................................................................................................. 18
Quick Tour............................................................................................................................................... 19
............................................................................................................................................................19
............................................................................................................................................................19
............................................................................................................................................................19
................................................................................................................................................................ 19
Viewing customer information ........................................................................................................... 20
Closing Cash ........................................................................................................................................ 20
Using the clock ........................................................................................................................................ 21
Viewing Closed Cash ........................................................................................................................... 21
Adding New Customers....................................................................................................................... 22
Adding Stock ........................................................................................................................................... 24
Adding Product Categories ................................................................................................................. 24
Customer Tax Categories .................................................................................................................... 25
Tax Categories..................................................................................................................................... 26
Taxes ................................................................................................................................................... 26
Adding a new category ....................................................................................................................... 27
Adding a new product......................................................................................................................... 27
Adding attributes to products............................................................................................................. 28
Inventory................................................................................................................................................. 31
Managing Stock Diary ......................................................................................................................... 31
4. REPORTING ......................................................................................................................................... 33
Customer Reports ................................................................................................................................... 34
Reports for all customers.................................................................................................................... 34
Reports for a particular customer....................................................................................................... 34
Customer Debtors............................................................................................................................... 36
Customers Dairy.................................................................................................................................. 36
Stock Reports .......................................................................................................................................... 37
Products reports ................................................................................................................................. 37
Current Inventory................................................................................................................................ 38
Sales Reports........................................................................................................................................... 39
Category Sales..................................................................................................................................... 39
Product Sales....................................................................................................................................... 40
5. DRAWING CHARTS .............................................................................................................................. 41
Product sales charts ............................................................................................................................42
Sales charts ......................................................................................................................................... 43
Product time series charts .................................................................................................................. 44
Top 10 sales charts.............................................................................................................................. 46
6. POS INTEGRATION .............................................................................................................................. 48
Administrator’s Guide Authorization
Memorandum
I have carefully assessed the Administrator’s Guide for Wanda POS. This document has been completed
in accordance with the appropriate requirements.
X X
Redhuan D. Oon Dr. Ing Stanley Mungwe
Project Guru Project Leader / Manager
Revision sheet
Recommended requirements
Java Runtime Environment [JRE 1.8 or higher]
iDempiere
Visit the Wanda POS source forge page by clicking on the link below.
b. Product References
Wanda POS Site For users who want to visit the http://www.wandaapos.com
Wanda POS website
Wanda POS wiki For those who want to meet http://sourceforge.net/p/wandaposd
the real gurus behind the apos/wiki/Home/
success of Wanda POS
d. Points of Contact
i. Help Desk
ii. Coordination
This is a point of sale. Hence, Wanda POS on its own not perform any accounting operation. To
get this ability to perform various accounting tasks [such as tracking profits and losses and providing
business/managerial advice and predictions] Wanda POS works hand-in-glove with iDempiere.
IDempiere is an ERP system which Wanda POS uses to be able to perform accounting operations.
FOSS – Free and Open Source Software Software that you can obtain free of charge and
also have unlimited access to its source code.
Governed by the GNU public license. E.g. iDempiere,
OpenBravo POS, Wanda POS, VLC etc.
f. Document Conventions
Convention Explanation
Bold Buttons and links that appear the same as shown
in the demo
[This is a comment ] Any text that appears within square bracket is an
aside, a comment or an explanation of the
preceding concept.
This is the font for all new chapters.
New chapter
This is a main heading.
Main heading
This is a sub-heading.
Sub – heading
This is an example.
Example
Aside
This is an aside.
h. Wanda Documentation
The documentation of Wanda POS comprises the documents listed below
With subsequent launches your screen will be similar to the one shown below.
Guest: Any user in this category is able to place an order by raising a new ticket.
Employee: Added to the abilities of a Guest user, any user in this category is able to Edit sales
and make/record payments. They can also change their password.
Manager: Added to the abilities of an Employee, any user in this category is able to manage
customers, close cash, view closed cash, manage stock and manage sales.
Administrator: Added to the abilities of a Manager, any user in this category is able to do
maintenance, configurations and printer settings.
NB: When you log in your information is displayed on the bottom right corner of the screen
Changing User ID and Password
To change passwords a user must login to their account. On the system panel [left side of the screen],
click on .
Exit System
Click on to get back to the welcome screen. It’s in the System panel on the left side of the
screen. Click on to exit the system. It’s at the bottom right corner of the window.
3.USING THE SYSTEM
Quick Tour
them to filter out the particular customer you’re looking for, then click on
From the list select the customer’s name and click on .
Click on to list all customers, select Izzy from the list and click on OR
On the pop up window type i in the text field labeled Search key and click on ,
Closing Cash
To the cash over a specified period of time proceed as shown below.
Click on [located at the bottom left corner of your window], then click on
.
Example: Closing Cash
Let’s say we want to close the cash from August 20th, 2014 to October 20th, 2014. Follow the guidelines
below to do this
*1
Check below
Click on located on the Main panel to the left of the display. *1
for details on
how to use
Click on [located at the bottom right corner of your window], then click on the clock
Click on the clock button near the text field labeled Start date.
Click on the number on the calendar on the left side of the pop up window.
Use the Previous Month and Next Month buttons to select the appropriate
month.
If we’re in a month before April [i.e. January, February or March] click on the Next
Month button till you get to April.
If we’re in a month after April [i.e. May, June, July, August, September, October,
November or December] click on the Previous Month button till you get to April
If we’re in April, then we’re good. Just skip this step.
Use the Previous Year button and Next Year button buttons to select the
appropriate year.
Click on the Previous Year button till you get to the year 2000.
If we were in a year before 2000 you would use the Next Year button instead. *2
In the design
If we were in the year 2000 you would have to skip this step because you wouldn’t have
of Wanda
to worry. POS, for
consistency
Use the buttons to the right of the clock on the right side of this pop up window to locate the reasons and
to avoid
time. Next Hour adds an hour, Next Quarter adds a quarter of an hour [15 unnecessary
arguments, it
is assumed
that 12:00 AM
is at mid-night
minutes] and Next Minute adds a minute, while Previous Minute reduces a
minute, Previous Quarter reduces a quarter of an hour [15 minutes] and Previous
Hour reduces an hour from the current time on the clock. For this demo I will assume
that the time displayed on the clock is 12:00 AM [mid-night *2] and we want to set the start time
to 09:47 AM.
To get there from mid-night we have to go up. Click on Next Hour till the clock shows *3
If you are using
9:00 AM. Wanda POS
uses offline it
Click on Next Quarter till the clock shows 9:45 AM. uses the
timestamp
Then click on Next Minute till the clock shows 9:47 AM. from your
computer as
the current
That’s our start time. Click on to set this as the start time. time. On a
network
[online] Wanda
Click on the clock button near the text field labeled End date.
POS uses the
time from the
Click on to select the current time *3 as the end date, then click on . server.
Click on to display all cash closed within the specified time frame.
Click on in the Register panel, and then click on the New Customer button
button at the top left corner of your window. OR
Click on in the Administration panel on the left side of your window and then
New button to clear the screen and start creating a new customer.
Provide a Search key, Name and Max debt for the customer, then fill in the rest of the
information.
If your business allows the use of cards you can provide a card number for the customer by
clicking on Create Key beside the text field labeled card. If you want to, you can remove
The new window displayed contains a list of all customers currently on the system. Click on the
New button to clear the screen and start creating a new customer.
Provide a Tax ID for the user e.g. Malaysia619.
We want it to be possible for someone to search r and find this user. In the text field labeled
Search key put in the letter r.
In the text field labeled Name put in the name Red1.
Click on the Edit button beside the text field labeled card.
A confirmation dialog box pops up.
Select to change the card value. If you want to remove the card value click on clear key
open source advocate. Then click on the Save button to the save the changes.
Adding Stock
Adding Product Categories
To add a new category,
picture and click on . Use Zoom Out [to add] and Zoom In [to reduce] to
adjust the size of the picture to your satisfaction. In case you don’t want the picture anymore
you can remove it by clicking on Remove Picture .
Click on to allow the category to be displayed on the catalog when queried OR
Tax Categories
Taxes
To add a new tax,
Example: Taxes
Let’s add a new tax and call it VAT which we intend to make a Standard tax and Global tax effective 4
hours from now.
Click on in the Administration panel.
Drinks
Frozen
Hush up let’s make the necessary entries. First we’ll create a category called drinks, which will comprise
3 sub-categories; Wine, Guinness and Booster. We’ll create the attributes and finish by creating the
products placing them in the categories and giving them the attributes.
To add the attributes we’ll start by creating attribute sets. Click on in the
Click on the New button to clear the screen for a new entry.
In the text field labeled Name type in the word Red wine [this will be the name of the attribute
we shall attach to Red wine], then click on the Save button to save.
Repeat the process to add attribute sets for white wine, Guinness smooth, big guinness, small
guinness, whisky cola and pina colada.
Now we’ll add product attributes to each of these. To add the attributes we’ll start by creating
.
Click on the drop down menu labeled Product attribute and select red wine from the drop down
list, then click on the New button to clear the screen for a new entry.
In the text field labeled Value type in the words Red wine [this will be one of the attributes Red
when they make their order. To do this, click on in the Administration panel,
then click on .
Click on the New button to clear the screen for a new entry.
In the text field labeled Name type in the word Red wine - Cold [this will be the name of the
attribute we shall attach to Red wine], then click on the Save button to save.
Do the same for the hot and frozen tastes of red wine. Then, select a different product attribute
[Guinness smooth, Small Guinness, Djino cocktail etc.] and add their own attribute values until
you’ve gone through for all of them.
Now let’s attach these attribute values to our products. To do this, click on in the
Click on the New button to clear the screen for a new entry.
In the text field labeled Order type in a number e.g. 1, click on the drop down menu labeled
Product attribute and select an attribute. then click on the Save button to save.
Click on the New button to clear the screen for another new entry. Enter a different
number for Order and select a different Product attribute.
Repeat the process till you have exhausted all product attributes. Then select a different
attributes set and do the same for all its attributes, till all product attributes of all product sets
are exhausted.
Click on the New button to clear the screen for new input.
To go through with this transaction you have to search for the product. You can do this by using
the product id, barcode or product name. (NB: for this example we’ll be using the product
name.)
Click on the search button (Search Product List) to the right of the greyed-out text field
labeled Product.
On the product list window that pops up click on the drop-down menu labeled Category and
select Drinks from the drop-down list.
Click on to display the list of all products within this category [Drinks].
the system] click on the Product Attributes button and select the particular flavor you just
added to your stock.
Click on the customer list button to the right of the text field labeled Customer.
Use the pop window to pick out the particular customer you’re searching for.
Click on , select the customer’s name, then click on .
Then click on .
Click on the customer list button to the right of the text field labeled Customer.
Enter the customer’s TaxID, Search key, Name or a combination of them. In our case I’ll just
enter p for the search key.
Click on . [This filters out all customers with a search key that starts with p].
Click on the customer’s name [in our case I’ve clicked on Pauline].
Then click on to single out the customer.
Then click on Execute report to display a report on this particular customer [Pauline].
NB: Use the tools in the toolbar to customize the view or size of the display. You can also print of export
to a specific document format.
Customer Debtors
Every now and then customers will fail to meet their payment deadlines. It’s very easy to know who has
and who hasn’t met their deadlines. You must not go through every customer report to know who
hasn’t.
Click on . A list of all customers is displayed alongside their account ID, address
and current debt.
Customers Dairy
At time we just want to look at the general picture. In-flow and out-flow of cash, payments, tickets etc.
Customers diary is the place for this.
Click on the calendar to the right of the text field named Start date.
Set the date to September 7, 2014 and the time to 12:47, then click on .
Click on the calendar to the right of the text field labeled End date.
Click on , then click on .
Stock Reports
Products reports
At times you want to know exactly what products you have and in what amounts, or what products
satisfy a certain constraint or set of constraints. This is how to go about it.
date to September 20, 2014 and time to 1:00 PM *5. Check above for
details on how to
Click on the calendar to the right of the text field labeled End Date, click on and then click use the clock.
on .
In the section just below the clock [the section labeled ‘By Form’]. Click on the drop down menu
labeled Category and select Drinks from the drop down list. Select Distinct from the drop down
list labeled Name.
Select Greater or equal from the drop down list labeled Sell Price. Click on the text field below it
and type in the amount 500.
date to September 20, 2014 and time to 1:00 PM *5. Check above for
details on how to
Click on the calendar to the right of the text field labeled End Date, click on and then click use the clock.
on .
date to September 20, 2014 and time to 1:00 PM *5. Check above for
details on how to
Click on the calendar to the right of the text field labeled End Date, click on and then click use the clock.
on .
In the section just below the clock [the section labeled ‘By Form’]. Click on the drop down menu
labeled Category and select Drinks from the drop down list. Select Distinct from the drop down
list labeled Name.
Select Greater or equal from the drop down list labeled Sell Price. Click on the text field below it
and type in the amount 500.
on .
NB: For more information on using iDempiere [best ERP system in the world], visit …
When you first start, as you see, there are no messages sent to ActiveMQ.
Now we switch to iDempiere where we have the POS Integration plugin installed already. Open up the
menu tree “External POS Integration.” It contains all the processes and windows necessary for
synchronization with Wanda POS.
For the purpose of this demo we’ve added a new product on iDempiere ERP, with product info shown
below.
NB: The 12 units of this product we have are in the HQ stock. So when we synchronize with Wanda POS,
we’ll only be able to do so with the Wanda POS station for which POS Locator Name is “HQ.”
On the ‘External POS Synchronization’ tree, click on the process named “Export Data To Queue.” The
window shown below pops up.
We’ll use this to provide the necessary information that will enable us synchronize with the particular
Wanda POS station we’re targeting [in our case, “HQ”].
Host: localhost
~ The host to which ActiveMQ is currently listening. We’re doing this demo on our local
*5
machine, so we’ve set the host to “localhost.” Your case may be different if you’re no The value must be the
testing on a local machine. t
same as the value in
Port: 61616 the file
wandapos.properties.
~ The port to which the ActiveMQ server listens.
Products Queue Name: Products
~ This is the queue name in ActiveMQ to which the process will send the products during
synchronization *5.
Customers Queue Name: Products
~ This is the queue name in ActiveMQ to which the process will send customers during
synchronization *5.
Username: admin
~ This is the username for the ActiveMQ server.
Password: *******
~ This is the password for the ActiveMQ server.
Product Category: Standard
~ This is the product category for the product we want to synchronize.
Customer Category: “Standard Customers”
~ This is the customer category for the product we want to synchronize.
Price List: “Standard 2003”
~ This is the price list for the product we want to synchronize.
NB: This process exports products per POS Locator Name (Organisation / Station). i.e. if you are
exporting 20 products for 5 different Wanda POS stations, they will be exported in 5 different queues
(each indicating the number of products exported for that particular station) in ActiveMQ.
When all information is correctly entered, click on start. After synchronization you’ll see a confirmation
window similar to the one shown below.
Once you see the window shown above, switch to the ActiveMQ server. You’ll see a new message sent.
All products in all stations are sent to ActiveMQ, but only the Wanda POS station you targeted (i.e. pos =
HQ) can synchronize products and customers in the queues targetted. In our case, it’s “HQ.”
Note: The key used to identify each Wanda POS station is “POS Name Locator” (pos key in
wandapos.properties file)
Customers and Products Queue Names must be the same in both Wanda POS and iDempiere.
POS Name (<entry key="pos">HQ</entry> in wandapos.properties) must match one
organization in iDempiere ERP.
Now it’s time to lunch Wanda POS. When you lunch Wanda POS for the first time, as you can see below,
there is only one category: “Category Standard” which has one product.
Click on Maintenance in the Administration panel on the left side of the window, then click on
. Scroll down and select the resource named wandapos.properties. You have to modify
this file according to the ActiveMQ server configuration, queue name (Products and Customers) you set
when exporting the data from iDempiere.
Go back to the Maintenance menu [in the Administration panel on the left side of the window] and click
on . The database manager responds after a few seconds and we have a pop up
window displaying information about the imported data.
Go back to the Maintenance menu and click on Products. [Remember that initially we had just one
category: “Category Standard”, with one product]. After synchronization we see extra categories and
products which have been imported as a result of the synchronization.
Click on the Sales button on the Main panel. Make an order or a couple of orders [we’ll use this as a
demo for synchronizing orders back to iDempiere] as shown in the User’s Guide. Once you’re done
making the order(s) click once again on the Maintenance button in the Administration panel on the left
side of your window. Then click on . A few seconds later you’ll get a confirmation
similar to the one below.
Back in iDempiere ERP, click on the process “Import Orders from POS”. You’ll see a screen like the one
below.
Fill in the appropriate information and click on Start.
After a few seconds you should get a confirmation similar to the one in the screen shot below.
In the External POS Synchronization tree click on the process named “Process Imported Orders.” You’ll
see a pop up similar to that shown below. Click on the drop down arrow in the toolbar. Notice that there
orders information has changed as a result of the import from Wanda POS.
Special thanks to Redhuan D. Oon for his original idea about integrating aDempiere with OpenBravo
POS.