Line 1:
Line 1:
−
<!-- BEGIN interlang links -->
+
<!-- BEGIN origin interlang links -->
−
<!-- Do NOT edit this section
+
<!-- You can edit this section but do NOT remove these comments
−
Links below are automatically managed by PolyglotBot
+
Links below will be automatically replicated on translated pages by PolyglotBot -->
−
You can edit links on the English source page : Module_Point_de_vente_(TakePOS) -->
[[fr:Module_Point_de_vente_(TakePOS)]]
[[fr:Module_Point_de_vente_(TakePOS)]]
−
[[es:Módulo_Caja_registradora (TakePOS)]]
−
[[de:Modul_Kasse (TakePOS)]]
<!-- END interlang links -->
<!-- END interlang links -->
+
[[Category:Point of sale]]
[[Category:Point of sale]]
Line 37:
Line 35:
= Hardware compatibility =
= 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/
+
If you need to connect the TakePOS module with some external hardware, you may find information related to different common use cases.
−
Example of hardware setup for receipt printers:
+
==Hardware setup for receipt printers==
−
== A) Using your browser print feature ==
+
=== A) Using your browser print feature ===
This solution is the one available by default, it uses the standard "Print" feature of your browser.
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.
+
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.
<pre>
<pre>
Line 55:
Line 53:
</pre>
</pre>
−
Limitation: This feature is no able to use serial POS printers but any common printers (wifi, lan, usb) are supported with no need for special setup.
+
'''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 old "Java connector" ==
+
=== 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.
+
+
<pre>
+
+-----------------+ +-----------------+ +-------------+
+
| Browser of your | | Dolibarr server | lan/wan | The |
+
| local computer |--internet-->| with TakePOS |---or usb or ltp--->| Printer |
+
+-----------------+ +-----------------+ or serial +-------------+
+
</pre>
+
+
'''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" ===
[[File:warning.png]] This method is now deprecated.
[[File:warning.png]] This method is now deprecated.
Line 66:
Line 80:
|printer |<--or usb--| on the printer |<--tcp/ip--| Browser |--internet-->| with TakePOS |
|printer |<--or usb--| on the printer |<--tcp/ip--| Browser |--internet-->| with TakePOS |
| | | | | | | + module "Java connector" |
| | | | | | | + module "Java connector" |
+
| | | | | | | or module "New connector" |
+--------+ +----------------+ +---------------------+ +---------------------------+
+--------+ +----------------+ +---------------------+ +---------------------------+
</pre>
</pre>
−
Video demo here: https://www.youtube.com/watch?v=VLZG9BZ0HLs
+
Video demo here: https://www.youtube.com/watch?v=VLZG9BZ0HLs if module "Java connector"
+
Video demo here: https://www.youtube.com/watch?v=AyQLOT0-SIY if module "New connector"
−
== C) Using the "old Web" TakePOS connector ==
+
+
=== D) Using the Java "Hardware Bridge" server for WebApps and TakePOS connector 18+ ===
[[File:warning.png]] This method is now deprecated.
[[File:warning.png]] This method is now deprecated.
−
<pre>
+
The module "TakePOS connector 18+" for Dolibarr can be downloaded here: https://www.dolistore.com/en/modules/1889-TakePOS-Connector.html
−
+--------+ +------------------+ +---------------------+ +--------------------------+
−
|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" |
−
+--------+ +------------------+ +---------------------+ +--------------------------+
−
</pre>
−
−
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
−
−
== D) Using the new Java "Hardware Bridge" server for WebApps and TakePOS connector 18+ ==
−
−
Module for Dolibarr can be downloaded here: https://www.dolistore.com/en/modules/1889-TakePOS-Connector.html
<pre>
<pre>
Line 99:
Line 102:
</pre>
</pre>
−
=== Setup of Dolibarr module ===
+
==== Setup of Dolibarr module ====
−
With TakePOS connector 18+, as soon as the module is activated, TakePOS will use the Java server "Hardware bridge" as print method. To switch back to use the browser, you must disable the 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 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.
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.
−
=== Setup of the Java hardware Bridge ===
+
'''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.
−
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 Windows:''' 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.
+
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 Linux:''' 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'''
+
'''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. So on Linux, this server may not work properly.
+
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'''
= Related videos =
= Related videos =
<youtube width="200" height="120">I7ZNzj6uzHc</youtube>
<youtube width="200" height="120">I7ZNzj6uzHc</youtube>