Info | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
With The last released version with the POS available was R12.04.06. It's though still available in the R14.12 and 15.12 non released branches. It'll not be availble with the R16 release. All the documentation below is reliable and usable before revision 1754402 |
Table of Contents |
---|
OFBiz-POS (Point Of Sales)
OFBiz has it's own open source POS front end application. The interface utilises XUI whilst the business functionality is directly reusing the core OFBiz technology underneath. Thus the POS terminal gains all the benefits already built into the framework around products, pricing, promotions and facilities etc.
User documentation
OFBiz POS User Manual - version 9.11.pdf (POS functionalities did not change since)
Manuel du Point de vente OFBiz - version 9.11.pdf (Le point de vente n'a pas changé depuis)
See also attachments page for older version
System options
Those familiar with OFBiz will understand most of these options as they already exist in the main framework.
- Choice your Database
...
- as per OFBiz entity engine. Run one locally on the POS terminal, effectively standalone mode for resilience against network connection problems, or from another machine if you only want to maintain one database.
- Synchronise - It
...
- 's possible to synchronise the POS database with an upstream central (or mid tier) database. This allows for all product administration to be done at the upstream level and synchronised down to the POS terminals. This process works the other way for reporting of sales back and customer info into the central system from the POS terminals.
- Stock management - In simple terms the main database will have visibility on the stock levels and the POS terminals can feed updates. As always the real time argument comes into effect based on how often you synchronise and even then you will still fall foul to the customer who has picked it from a shelf but not processed through the till yet scenarios!
It would be nice to see development of a stock check against other facilities screen to ease customer enquires about other shops having it in stock. Think real time stock issues again though!
To Setup
Getting Started
POS Setup Process
Technical Production Setup Guide
Business Setup
...
For Windows setup of latest source version StartWinAdminSVN
In case of problems please look for StartWinAdminSVN at http://web.archive.org/web/20070714013447/ofbizwiki.go-integral.com/Wiki.jsp?page=PageIndex
or even begin by http://web.archive.org/web/*/http://ofbizwiki.go-integral.com/
To Run
To Run
The POS alone
Code Block |
---|
*nix and Mac: ./ant start-pos
Windows: ant start-pos |
The POS with also the web applications and eCommerce webstore
Code Block |
---|
*nix and Mac: ./ant start-both
Windows: ant start-both
|
The webPOS component can be seen in action via http://demo-trunk-ofbiz.apache.org/webpos/control/mainjava -jar ofbiz.jar -pos
Getting Started:
Login with userid "1" and password "1" (or 2/2 for a non manager person).
To use the "register" it must be opened, which basically involves telling the system how much cash you are starting with. It will then keep track of cash transactions so you can see if everything balances when you close the register.
To open the register click on the MGR button on the top and near the right, and then on the "Open" button on the right side of the screen near the top.
Using Load and Save Sale buttons, you can park customer transactions for later recall. If using a central store database it allows you to pick up again from any till.
Internationalisation (I18n)
Localisation (L10n) of POS application is straightforward. You only have to provide your locale properties files , look in \applications\pos\config\.
There are 2 kinds of labels.
Hints from:
- Those managed by OFBiz directly : in PosUiLabels.xml
- Those managed by XUI : in XuiLabels.properties (add your language if needed)
Info |
---|
You can use a plugin like RBE to edit XuiLabels.properties |
CRM
There is now (2009-11) a beginning of a CRM in the POS. At least you are able to search, create, modify and select a customer profile (full name, email address, phone number, card number). To allow a customer profile to be selected, it must have a card number. This card number must also correspond to an existing promotion code. Once a customer is selected, the card number is used as a promo code to give customised privileges. Also as the customer is known during the sales processing much more could be done with it...
See more about it in the Promotions chapter in the attached Till Manual.
Synchronization
Sync Setup Notes and Examplehttp://lists.ofbiz.org/pipermail/users/2005-February/thread.html Search for "pos "
Tried and Tested hardware:
You may find a more complete list here. To know more about JavaPOs in general
...
Manufacturer | Hardware/Model | OS | Comments |
---|---|---|---|
Epson | TM-T88III (World best seller) | Windows XP & Ubuntu 6.06 LTS | Works well but must be enabled before running POS else hang. I have added a message in the log, hope to add a message for user one of these days (Jacques Le Roux 24/5/62006-05-24) |
Zebex | Zebex 80 - USB Model | Windows XP & Ubuntu 6.06 LTS | Look for "Generic Keyboard Wedge Scanner Device" in jpos.xml. You may also have a look in ScannerKybService.java and, in Scanner.java, processScanData has also some informations. |
...
Some comments pulled from the mailing list and added since |
---|
I found STAR (serial) receipt printers to be the best; a cash drawer which plugs into the back of the printer works great. As for scanners, use a keyboard wedge scanner and a keyboard or USB MSR. The POS devices we used had MSR built in, not exactly sure how it was configured, but in the end it send the signal through the keyboard device. A term pole display will need to be implemented, as this is not currently supported. However, it shouldn't be very difficult which the base which is there today. Touch screen is configured on the OS level. ELO based devices work on Linux. |
The multiple drawers can be thru the serial. most are thru the parallel port. Gets tricky if you have a parallel device as well. Touch screens can use the keyboard wedge as well. |
The model we used for testing was a DigiCom iPOS435 with a side-mounted MSR. Our particular units had Celeron 850MHz processors and 512MB of RAM. Performance was adequate, but I don't think I could call it "fast". (OS - Gentoo, Fedora; DB - postgres). You may want to compare the ipos430 spec to whatever you're looking at currently. Aside from the speed, it is a very nice unit. For printers we used a basic Star Micronics thermal (model TSP600), which worked out just fine during testing, though I can't comment on long-term reliability. |
Beware with wedge scanners not self-powered. I had a problem with a Dell Dimension 4600 (too weak keyboard alimentation I think) and a Zebex 3080. No problem with the USB model. |
I've used Metrologic scanners (tabletop & handheld) almost exclusively for the past 5 years with a variety of Dell's and custom built machines. I've never had a problem with the keyboard wedge versions. They all had their own power source. |
Deployed OK on FC3-XFC4 with a Star TSP600 printer using serial, MetroLogic keyboard wedge scanner and MultiQ 156 serial touch screen using mutouch drivers. Cash draw linked into the printer and operates fine. No MSR requirements so not tested. |
How to use a MSR for CC payments. |
Mag Stripe Readers issue on Windows XP. |
How to setup the Epson JavaPOS ?
To find the last available Epson JavaPOS ADK use www.epson-pos.com
Here I want to explain a little about how to setup the Epson JavaPOS ADK for TM printer:
On WindowsXP, and I believe the process on Linux is similiar
- Install the JavaSE which version you like. I use jdk1.5.0_09;
- Then installed the "Epson JavaPOS ADK 1.82" (or 1.81, 1.80, any version suppor jpos18-control; and copy the "epsonJposService182.jar, epsonJposServiceCommon.jar" to /ofbiz/applications/pos/lib;
- Now modified the jpos.xml file, under /ofbiz/applications/pos/config; I post a sample here:
It uses a TM-U220D on COM1 port, please remember to keep the jpos182 or 180 same as the file you using under ./pos/lib;
<JposEntry logicalName="TM-U220D">
<creation factoryClass="jp.co.epson.jpos182.util.EpsonJposServiceInstanceFactory"
serviceClass="jp.co.epson.jpos182.ptr.U220D"/>
<vendor name="SEIKO EPSON" url="http://www.epson.co.jp"/>
<jpos category="POSPrinter" version="1.8"/>
<product description="EPSON TM-U220D Printer Device Service"
name="EPSON Services for JavaPOS(TM) Standard" url="http://www.epson.co.jp"/>
<!-Other non JavaPOS required property (mostly vendor properties and bus specific properties i.e. RS232 )->
<prop name="dataBits" type="String" value="8"/>
<prop name="Parity" type="String" value="0"/>
<prop name="portName" type="String" value="COM1"/>
<prop name="U375Compatible" type="String" value="0"/>
<prop name="deviceBus" type="String" value="RS232"/>
<prop name="DataLen" type="String" value="1"/>
<prop name="UsedJAI" type="String" value="0"/>
<prop name="TimeoutTime" type="String" value="5000"/>
<prop name="baudRate" type="String" value="9600"/>
<prop name="TwoColor" type="String" value="0"/>
<prop name="PortType" type="String" value="0"/>
<prop name="UsedNVRAM" type="String" value="0"/>
<prop name="StopBit" type="String" value="1"/>
<prop name="RetryTime" type="String" value="100"/>
<prop name="ErrorOption" type="String" value="1"/>
<prop name="ReverseEject" type="String" value="0"/>
<prop name="SerialPowerWaitTime" type="String" value="500"/>
<prop name="InputWait" type="String" value="1"/>
<prop name="AnalysisLevel" type="String" value="1"/>
<prop name="BufferSize" type="String" value="2"/>
<prop name="DeviceDesc" type="String" value="EPSON TM-U220D Printer"/>
<prop name="OutputLength" type="String" value="10"/>
<prop name="parity" type="String" value="None"/>
<prop name="stopBits" type="String" value="1"/>
<prop name="PortName" type="String" value="COM1"/> <!- Windows ->
<!-prop name="PortName" type="String" value="/dev/ttyS0"/> <!- Linux -->
<prop name="ReceiveTimeout" type="String" value="10"/>
<prop name="TwoByteCharacter" type="String" value="0"/>
<prop name="Page254UseCode" type="String" value="0"/>
<prop name="PhysicalDevice" type="String" value="TM-U220D"/>
<prop name="PaperSize" type="String" value="80"/>
<prop name="BaudRate" type="String" value="6"/>
<prop name="Page255UseCode" type="String" value="0"/>
<prop name="ServiceVersion" type="String" value="1.80"/>
<prop name="flowControl" type="String" value="None"/>
<prop name="FlowControl" type="String" value="1"/>
</JposEntry> - Install Java CommAPI 2.0, copy the comm.jar to j2se or j2re 's /lib/ext folder.
and copy the javax.comm.properties to j2se or j2re's /lib folder;
and copy the win32com.dll to /windows/system32. - Modifiy the pos-containers.xml, which under /framework/base/config:
to make the <property name="Receipt" value="TM-U220D" /> value same as you defined in jpos.xml file.
Now launch with java -jar ofbiz.jar -pos, and enjoy it!
Successful TCP / Ethernet Epson printer implementation
- First, replace the modules in back of the printer
- While the printer is unplugged from power, you must change the "reset" dip-switch (2-7) from off to on.
- Power on the printer, and plug it into the network.
- As per the "UB-E02 Technical Reference Guide." (get it, you'll need it) use the switch button on the Ethernet module to set the ROM back to factory defaults. This will also print a settings page afterward, and let you know the subnet / ip address that you'll need to know to configure the printer.
- Use the Epson TMNet WINconfig utility on a Windows box (sorry! there is NO linux utility!) Set the PC on the same subnet, and set your gateway as the default IP address of the printer.
- Change the settings of the printer (once connected) to suite your environment.
- Add the printer to Epson JavaPOS with SetupPOS.sh using the IP address and info that you set previously.
- Test with CheckHealth
- Add printer to pos-containers.
- start and test OFBIZ...You will receive the error at the bottom of the page. I think it's from something in the deviceloader that is able to check through serial and not though Ethernet! Nothing I wanted to fiddle with though, It works just fine and fast!
FYI....DO NOT use a passthrough drawer on Ethernet printers, or customer displays. It mentioned this several times in all of the technical guides.
***IF YOU HAVE A CASH DRAWER CONFIGURED, AND UNPLUGGED WHILE TESTING, YOU WILL RECEIVE THE FOLLOWING ERROR*** (although it doesn't affect anything, and the application still starts)
--- exception report ---------------------------------------------------------
Exception: jpos.JposException
Message: The power supply of the device is off.
--- stack trace --------------------------------------------------------------
jpos.JposException: The power supply of the device is off.
jp.co.epson.upos.pntr.init.AbstractPrinterInitialization.getRealtimeStatus(Unknown Source)
jp.co.epson.upos.pntr.init.AbstractPrinterInitialization.getPrinterStatus(Unknown Source)
jp.co.epson.upos.pntr.init.AbstractPrinterInitialization.getPrinterStatus(Unknown Source)
jp.co.epson.upos.pntr.init.AbstractPrinterInitialization.initializeCommon(Unknown Source)
jp.co.epson.upos.pntr.init.AbstractPrinterInitialization.initialize(Unknown Source)
jp.co.epson.upos.pntr.init.AbstractPrinterInitialization.initializeDevice(Unknown Source)
jp.co.epson.upos.drw.CashDrawerPortControl.initializePrinterInstance(Unknown Source)
jp.co.epson.upos.drw.CashDrawerPortControl.openPort(Unknown Source)
jp.co.epson.upos.drw.CommonCashDrawerService.setDeviceEnabled(Unknown Source)
jpos.BaseJposControl.setDeviceEnabled(Unknown Source)
org.ofbiz.pos.device.GenericDevice.enable(GenericDevice.java:71)
org.ofbiz.pos.device.GenericDevice.open(GenericDevice.java:46)
org.ofbiz.pos.device.DeviceLoader.load(DeviceLoader.java:165)
org.ofbiz.pos.container.JposDeviceContainer.start(JposDeviceContainer.java:50)
org.ofbiz.base.container.ContainerLoader.start(ContainerLoader.java:101)
org.ofbiz.base.start.Start.startStartLoaders(Start.java:263)
org.ofbiz.base.start.Start.startServer(Start.java:312)
org.ofbiz.base.start.Start.start(Start.java:316)
org.ofbiz.base.start.Start.main(Start.java:399)
--------------------------------------------------------------------------------
Epson JavaPOS ADK 1.82 support these product
DM-D110 DM-D210 DM-D500 DM-Z460/DM-Z461
TM-H5000II TM-H5200 TM-H6000 TM-H6000II TM-H6000II Photo ID TM-H6000II Validation
TM-H6000II with Scanner TM-H6000III TM-J2000/TM-J2100
TM-J7000/TM-J7100 TM-J7500/TM-J7600
TM-L90 TM-P60 TM-T88II TM-T88III TM-T88IIR TM-T90
TM-U210A TM-U220 w/Black Mark Sensor TM-U220A TM-U220B TM-U220D TM-U230 TM-U950
Advice
Never load/mix 2 instances of ADK (eg 1.8x and 1.92) on the same machineSetup the Epson JavaPOS
Areas for thought/investigation
For UK receipts the VAT needs to be shown as the amount made up in the gross price. The system can handle multiple VAT codes/values i.e. books have 0% VAT and books with tapes have 13% and pretty much everything else has 17.5%. The till functions correctly in applying the different amounts when the data is configured but need to look into the receipt reporting as we need a sub total listing the amounts for each VAT code separately. Plus if we store gross amounts then the VAT should not be added, just show how much it is!
How to run the POS terminal at the same time as an instance of OFBiz on the same machine? It's a real pain shutting down POS and starting OFBiz and vice-versa to make changes!
You must launch 2 instances with different port numbers. I did not did it yet but I think it's the only way. Jacques Le Roux 18/5/5
Success, just needed to turn off the BeanShell ports in the ofbiz-containers.xml file. I haven't tried but you might be able to overide this port on the command line, in which case you should be able to continue to run the BeanShell access on different ports. Ray Barlow 25/05/05There is even a better way to do that. Running it in 2 Java instances is fine but just not as efficient because (depending on your JVM) Java won't be able to share resources that are sharable, like jar file in memory and such. You can run both in the same instance. The easiest way to do this is to add the catalina section of ofbiz-containers.xml to the pos-container.xml Jacques Le Roux 28/8/5, thanks to David and Andy recommendations.
...
Individual stores require control of "their" product database in terms of store X can add and sell a product that store Y doesn't. Also store X should be able to add and sell a product that store Y might take on later, so the product data should also be transferable if desired. Again individual stores require control of pricing for a product although it will be standard for 95% of products. Ditto promotions!
...
Find products by code, name and or descriptions!
Can you park customer transactions for later recall? If yes and using a central store database it should allow you to pick up again from any till Just seen on the screen the save/restore buttons are ghosted so there is positive intent but time has not permitted completion yet. Note : This is now in the POS, I (Jacques Le Roux) add it, Ray (Barlow) sponsored it.
Unfortunately the keyword "POS" is often found in other words and this wiki search engine does not search by whole word so it is quite possible to get results about postgresSQL and proposed proposals etc rather than achieve the positive result for a "POS" keyword search. Many people postulate that only the apostles of higher beings can have a positive influence on search engines, but we all like to think we can achieve the impossible and challenge such statements as preposterous!
...
Ray Barlow 13/07/05 Attached is the document we have written for users of the POS system (Till Manual_V2.0). It may be a little bit specific to us in areas and it does have a little customisation i.e. we have added two functional buttons that we thought useful, you can see them on the screenshots.
1) DEL : If you are typing a number on screen and you make a typo this saves pulling the keyboard out to correct it.
2) - (minus) : We use this for quantity corrections, price mods etc.