Module Point of sale (TakePOS)

Point of sale (TakePOS)
Numero/ID of module	50150
User doc. of module	This page
Developer doc. of module	Module Point of sale TakePOS (developer)

Introduction

This module transforms your Dolibarr into a Point Of Sale (POS). It is an advanced Point of Sale with plenty of supported features like:

Parallel sales
Bar-code reader compatibility
Touch and Responsive interface
Multi-terminal
Multi-payment mode, multi-payment sessions
Auto order by customer from a QR code
Management of shops, bars or restaurant

Note that this module should be used to replace the older Module Point of sale (SimplePOS)

Installation

This module is included with the Dolibarr distribution, so there is no need to install it.

Configuration

To use this module, you must first enable it using an administrator account, via the menu option "Home - Setup - Modules".

Choose the tab where the module is listed. Then click on "Activate".

The module is now activated.

If a cog icon appears on module thumb or at end of the line of the module, click on it to access the setup page specific to the module.

Hardware compatibility

If you need to connect the TakePOS module with some external hardware, you may find information on some compatible hardware ont this page: https://takepos.com/hardware/

Example of hardware setup for receipt printers:

A) Using your browser print feature

This solution is the one available by default, it uses the standard "Print" feature of your browser.

If you can print from your local computer (from your browser) on your standard printer, you should be able to print TakePos receipts with no need of special setup. TakePos will open the receipt in a popup on your browser as well as the print option of your browser will also open so all you have to do will be to click on the Print button.

+--------+                +------------------------+             +-----------------+
|The     |     lan/wan    | Browser print system   |             | Dolibarr server |
|Printer |<----or usb ----| of your local computer |--internet-->| with TakePOS    |
+--------+                +------------------------+             +-----------------+

Limitation: This feature is not able to use serial ESC/POS printers but any common printers (wifi, lan, usb) are supported with no need for special setup. To use ESC/POS printer, prefer to use the next method.

B) Using the "Receipt Printer" module

If the printer can be reached by the Dolibarr server (Using network TCP/IP access or using a local LPT port or using a cups shared link), you can enable the Module Receipt Printer. Then setup the module.

+-----------------+             +-----------------+                    +-------------+
| Browser of your |             | Dolibarr server |   lan/wan          | The         |
| local computer  |--internet-->| with TakePOS    |---or usb or ltp--->| Printer     |
+-----------------+             +-----------------+   or serial        +-------------+

Limitation: The printer must be reachable by your server. If your server is in the Cloud and your printer is a network IP printer in your local network, you can use a network gateway (IP or Port translation) to reach your IP printer from the Cloud (be careful of securities questions), but if the printer is not a network printer or if you can't install a network gateway, you must use the last method (E).

Note: to test this method without having any printer, you can use the ESC/POS printer emulator here: https://github.com/dacduong/escpos-printer-simulator so you can launch a virtual printer on you local IP and port 9100.

C) Using the old "Java connector"

This method is now deprecated.

+--------+           +----------------+           +---------------------+             +---------------------------+
|The     |   serial  | Java connector |           | Your local computer |             | Dolibarr server           |
|printer |<--or usb--| on the printer |<--tcp/ip--| Browser             |--internet-->| with TakePOS              |
|        |           |                |           |                     |             | + module "Java connector" |
+--------+           +----------------+           +---------------------+             +---------------------------+

Video demo here: https://www.youtube.com/watch?v=VLZG9BZ0HLs

D) Using the "old Web" TakePOS connector

This method is now deprecated.

+--------+           +------------------+           +---------------------+             +--------------------------+
|The     |   serial  | Web server       |           | Your local computer |             | Dolibarr server          |
|printer |<--or usb--| with the         |<--tcp/ip--| Browser             |--internet-->| with TakePOS             |
|        |           | Web Takepos conn |           |                     |             | + module "New connector" |
+--------+           +------------------+           +---------------------+             +--------------------------+

Once the module "New connector.zip" on Dolibarr has been installed, you must choose the print method "TakePOS connector".

Video demo here: https://www.youtube.com/watch?v=AyQLOT0-SIY

E) Using the new Java "Hardware Bridge" server for WebApps and TakePOS connector 18+

The module "TakePOS connector 18+" for Dolibarr can be downloaded here: https://www.dolistore.com/en/modules/1889-TakePOS-Connector.html

+--------+           +-----------------+               +---------------------+             +----------------------------------+
|The     |   serial  | Java            |   tcp/ip      | Your local computer |             | Dolibarr server                  |
|printer |<--or usb--| hardware bridge |<--websocket-->| Browser             |--internet-->| with TakePOS                     |
|        |           | port 12212      |               |                     |             | + module TakePOS connector 18.0+ |
+--------+           +-----------------+               +---------------------+             +----------------------------------+

Setup of Dolibarr module

With TakePOS connector 18+, as soon as the module is activated, TakePOS will use the Java server "Hardware bridge" as a printer (see next point). To switch back to use the browser, you must disable the module. The Java server accept websocket from the browser of the local computer. So when the server is stopped or restarted, it can warm the browser with a popup. The local browser (The module TakePOS connector) is sending the print request by sending the Raw text content encoded in Base64.

Setup of the Java Hardware Bridge

This gateway run on Windows (or Linux but dev for Linux is not complete). You can download a release at https://github.com/imTigger/webapp-hardware-bridge/releases/. Click on a the version you want, so you will reach the list of files to download.

For a bridge on a Windows server: Download and execute the whb-x.y.0.exe and run it. This will install and run the server. Also, from the board of running application, you will find an icon that allow you tu run the Configuration. Run the configuration and select the POS serial printer.

If you don't have a POS serial printer, you can select "Fallback to default printer", then install a virtual POS driver (like the EMF Virtual Printer available at https://www.colorpilot.com/emfprinter_versions.html) and finally set this virtual Driver as the default printer on your Windows Printer setup.

For a bridge on a Linux server: You can download the zip file with the java server and run the java server by launching the jar file from the command line with: java -jar webapp-hardware-bridge.jar. However, it seems not possible to run the Configurator to select the printer to use with default java. So on Linux, this server may not work properly (note: some users reported it was possible using Amazon version of java by launching: javaw -cp webapp-hardware-bridge.jar tigerworkshop.webapphardwarebridge.Configurator