Difference between revisions of "Module Point de vente (TakePOS)"

Tag: 2017 source edit
Tag: 2017 source edit
 
(39 intermediate revisions by the same user not shown)
Line 4: Line 4:
 
     You can edit links on the English source page : Module_Point_of_sale_(TakePOS) -->
 
     You can edit links on the English source page : Module_Point_of_sale_(TakePOS) -->
 
[[en:Module_Point_of_sale_(TakePOS)]]
 
[[en:Module_Point_of_sale_(TakePOS)]]
[[es:Módulo_Caja_registradora (TakePOS)]]
 
[[de:Modul_Kasse (TakePOS)]]
 
<!-- END interlang links -->
 
 
<!-- BEGIN origin interlang links -->
 
<!-- You can edit this section but do NOT remove these comments
 
    Links below will be automatically replicated on translated pages by PolyglotBot -->
 
[[en:Module_Point_of_sale_(TakePOS)]]
 
[[es:Módulo_Caja_registradora (TakePOS)]]
 
[[de:Modul_Kasse (TakePOS)]]
 
 
<!-- END interlang links -->
 
<!-- END interlang links -->
  
Line 19: Line 9:
 
{{TemplateDocUtil}}
 
{{TemplateDocUtil}}
 
{{TemplateModFR}}
 
{{TemplateModFR}}
{{BasculeDevUser|
+
{{BasculeDevUserFr|
 
nom=Point de vente (TakePOS)|
 
nom=Point de vente (TakePOS)|
 
num=50150|
 
num=50150|
Line 44: Line 34:
  
  
= Compatible Hardware =
+
= Compatibilité matérielle =
Si vous avez besoin de connecter le module TakePOS avec du matériel externe, vous pouvez trouver des informations sur certains matériels compatibles sur cette page : https://takepos.com/hardware/
+
Si vous devez connecter le module TakePOS à du matériel externe, vous pouvez trouver ici des informations en fonction de cas d'utilisations communs.
 +
 
 +
 
 +
== Configuration matérielle pour les imprimantes de tickets==
 +
 
 +
=== A) Utilisation de la fonction d'impression de votre navigateur ===
 +
 
 +
Cette solution est celle disponible par défaut, elle utilise la fonctionnalité standard "Imprimer" de votre navigateur.
 +
 
 +
Si vous pouvez imprimer depuis votre ordinateur local (depuis votre navigateur) sur votre imprimante standard, vous devriez pouvoir imprimer des reçus TakePos sans avoir besoin de configuration particulière. TakePos ouvrira le reçu dans une fenêtre contextuelle sur votre navigateur ainsi que l'option d'impression de votre navigateur s'ouvrira également, il vous suffira donc de cliquer sur le bouton Imprimer.
 +
 
 +
<pre>
 +
+--------+                +------------------------+            +-----------------+
 +
|The    |    lan/wan    | Browser print system  |            | Dolibarr server |
 +
|Printer |<----or usb ----| of your local computer |--internet-->| with TakePOS    |
 +
+--------+                +------------------------+            +-----------------+
 +
</pre>
 +
 
 +
Limitation : Cette fonctionnalité ne permet pas d'utiliser des imprimantes POS série, mais toutes les imprimantes courantes (wifi, LAN, USB) sont prises en charge sans nécessiter de configuration spéciale.
 +
 
 +
=== B) Utilisation du module "Imprimante de tickets" ===
 +
 
 +
Si l'imprimante est accessible par le serveur Dolibarr (Utilisation d'un accès réseau tcp/ip, utilisation d'un port lpt local, utilisation d'un lien partagé cups), vous pouvez activer le [[Module Imprimante Reçu]].
 +
Configurez ensuite le module.
 +
 
 +
<pre>
 +
+---------------------+            +------------------+                    +-----------+
 +
| Navigateur de votre |            | Serveur Dolibarr |  local/wan        |Imprimante |
 +
| ordinateur local    |--internet-->| avec TakePOS    |---ou usb ou ltp--->|          |
 +
+---------------------+            +------------------+  ou série        +-----------+
 +
</pre>
 +
 
 +
'''Limitation''' : L'imprimante doit être accessible par votre serveur. Si votre serveur est dans le Cloud et que votre imprimante est une imprimante réseau IP, vous pouvez utiliser une passerelle réseau (Par exemple par translation IP ou port) pour accéder à votre imprimante IP depuis le Cloud, mais si l'imprimante n'est pas une imprimante réseau ou si vous ne pouvez pas installer de passerelle réseau, vous devez utiliser la dernière méthode (E).
 +
 
 +
'''Remarque''' : pour tester cette méthode sans avoir d'imprimante, vous pouvez utiliser l'émulateur d'imprimante ESC/POS ici : https://github.com/dacduong/escpos-printer-simulator afin de pouvoir lancer une imprimante virtuelle sur une IP locale et port 9100.
 +
 
 +
=== C) Utilisation de l'ancien "connecteur Java" ===
 +
 
 +
[[File:warning.png]] Cette méthode est désormais obsolète.
 +
 
 +
<pre>
 +
+--------+          +----------------+          +---------------------+            +---------------------------+
 +
|The    |  serial  | Java connector |          | Your local computer |            | Dolibarr server          |
 +
|printer |<--or usb--| on the printer |<--tcp/ip--| Browser            |--internet-->| with TakePOS              |
 +
|        |          |                |          |                    |            | + module "Java connector" |
 +
|        |          |                |          |                    |            | ou module "New connector" |
 +
+--------+          +----------------+          +---------------------+            +---------------------------+
 +
</pre>
 +
 
 +
Démo vidéo ici : https://www.youtube.com/watch?v=VLZG9BZ0HLs si utilisation de "Java connector"
 +
 
 +
Démo vidéo ici:  https://www.youtube.com/watch?v=AyQLOT0-SIY si utilisation de "New connector"
 +
 
 +
=== D) Utilisation du serveur Java "Hardware Bridge" pour WebApps et le Connecteur TakePOS 18+ ===
 +
 
 +
[[File:warning.png]] Cette méthode est désormais obsolète.
 +
 
 +
Le module Connecteur TakePOS 18+ pour Dolibarr peut être téléchargé ici : https://www.dolistore.com/en/modules/1889-TakePOS-Connector.html
 +
 
 +
<pre>
 +
+--------+          +-----------------+              +---------------------+            +----------------------------------+
 +
|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+ |
 +
+--------+          +-----------------+              +---------------------+            +----------------------------------+
 +
</pre>
 +
 
 +
=== Configuration du module Dolibarr ===
 +
Avec le Connecteur TakePOS 18+, dès que le module sera activé, TakePOS utilisera le serveur Java "Hardware bridge" comme méthode imprimante (voir point suivant). Pour revenir à l'utilisation du navigateur, vous devez désactiver le module.
 +
Le serveur Java accepte le websocket du navigateur de l'ordinateur local. Ainsi, lorsque le serveur est arrêté ou redémarré, il peut réchauffer le navigateur avec une popup.
 +
Le navigateur local (via du code javascript amené par le module connecteur TakePOS) envoie la demande d'impression en envoyant le contenu du texte brut encodé en Base64du navigateur au serveur bridge.
 +
 
 +
=== Configuration du Hardware Bridge Java ===
 +
Cette passerelle fonctionne sous Windows (ou Linux mais le développement pour Linux n'est pas terminé). Vous pouvez télécharger une version sur https://github.com/imTigger/webapp-hardware-bridge/releases/. Cliquez sur la version souhaitée pour accéder à la liste des fichiers à télécharger.
 +
 
 +
'''Pour un pont sous Windows :''' Téléchargez et exécutez le '''whb-x.y.0.exe''' et exécutez-le. Cela installera et exécutera le serveur. De plus, depuis le tableau d'affichage de l'application en cours d'exécution, vous trouverez une icône qui vous permettra d'exécuter la configuration. Exécutez la configuration et sélectionnez l’imprimante série POS. Si vous n'avez pas d'imprimante série POS, vous pouvez sélectionner « Revenir à l'imprimante par défaut », puis installer un pilote POS virtuel (comme l'imprimante virtuelle EMF disponible sur https://www.colorpilot.com/emfprinter_versions.html) et enfin, définissez ce pilote virtuel comme imprimante par défaut dans la configuration de votre imprimante Windows.
  
= Cycle de vie / Règles de gestion =
+
'''Pour un pont sous Linux :''' Vous pouvez télécharger le fichier zip avec le serveur java et exécuter le serveur java en lançant le fichier jar depuis la ligne de commande avec :''' java -jar webapp-hardware-bridge. pot'''
{{ToComplete}}
+
Cependant, il ne semble pas possible de lancer le Configurator avec le java par défaut des Linux, pour sélectionner l'imprimante à utiliser. Ainsi, sous Linux, ce serveur risque de ne pas fonctionner correctement (Certains utilisateurs ont toutefois rapportés qu'il était possible de lancer ce configurator avec la version Java d'Amazon en lançant: '''javaw -cp webapp-hardware-bridge.jar tigerworkshop.webapphardwarebridge.Configurator''')
  
 
= Videos sur le sujet =
 
= Videos sur le sujet =
 
<youtube width="200" height="120">I7ZNzj6uzHc</youtube>
 
<youtube width="200" height="120">I7ZNzj6uzHc</youtube>

Latest revision as of 00:51, 13 June 2025

Point de vente (TakePOS)
Numéro/ID du module 50150
Doc utilisateur du module This page
Doc développeur du module Module Point de vente TakePOS (developer)

Introduction

Ce module consiste à transformer votre Dolibarr en Point de vente (PdV). Il s'agit d'un point de vente avancé avec de nombreuses fonctionnalités prises en charge telles que :

  • Ventes parallèles
  • Compatibilité lecteur code-barres
  • Interface tactile et réactive
  • Multi-terminal
  • Mode multi-paiement, sessions multi-paiement
  • Commande automatique par client à partir d'un code QR
  • Gestion de boutiques, bars ou restaurants

Notez que ce module doit être utilisé pour remplacer l'ancien Module_Caisse_enregistreuse_(SimplePOS)

Installation

Ce module est livré en standard avec la distribution de Dolibarr, aussi il est déjà installé.

Configuration

Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, aller sur la page "Accueil - Configuration - Modules".

Choisissez l'onglet dans lequel apparaît le module puis cliquez sur "Activer".

Le module est alors activé.

Si un pictogramme   apparaît sur la vignette ou à la fin de la ligne du module, cliquez dessus pour accéder à la page de paramétrage spécifique à ce module.


Compatibilité matérielle

Si vous devez connecter le module TakePOS à du matériel externe, vous pouvez trouver ici des informations en fonction de cas d'utilisations communs.


Configuration matérielle pour les imprimantes de tickets

A) Utilisation de la fonction d'impression de votre navigateur

Cette solution est celle disponible par défaut, elle utilise la fonctionnalité standard "Imprimer" de votre navigateur.

Si vous pouvez imprimer depuis votre ordinateur local (depuis votre navigateur) sur votre imprimante standard, vous devriez pouvoir imprimer des reçus TakePos sans avoir besoin de configuration particulière. TakePos ouvrira le reçu dans une fenêtre contextuelle sur votre navigateur ainsi que l'option d'impression de votre navigateur s'ouvrira également, il vous suffira donc de cliquer sur le bouton Imprimer.

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

Limitation : Cette fonctionnalité ne permet pas d'utiliser des imprimantes POS série, mais toutes les imprimantes courantes (wifi, LAN, USB) sont prises en charge sans nécessiter de configuration spéciale.

B) Utilisation du module "Imprimante de tickets"

Si l'imprimante est accessible par le serveur Dolibarr (Utilisation d'un accès réseau tcp/ip, utilisation d'un port lpt local, utilisation d'un lien partagé cups), vous pouvez activer le Module Imprimante Reçu. Configurez ensuite le module.

+---------------------+             +------------------+                    +-----------+
| Navigateur de votre |             | Serveur Dolibarr |   local/wan        |Imprimante |
| ordinateur local    |--internet-->| avec TakePOS     |---ou usb ou ltp--->|           |
+---------------------+             +------------------+   ou série         +-----------+

Limitation : L'imprimante doit être accessible par votre serveur. Si votre serveur est dans le Cloud et que votre imprimante est une imprimante réseau IP, vous pouvez utiliser une passerelle réseau (Par exemple par translation IP ou port) pour accéder à votre imprimante IP depuis le Cloud, mais si l'imprimante n'est pas une imprimante réseau ou si vous ne pouvez pas installer de passerelle réseau, vous devez utiliser la dernière méthode (E).

Remarque : pour tester cette méthode sans avoir d'imprimante, vous pouvez utiliser l'émulateur d'imprimante ESC/POS ici : https://github.com/dacduong/escpos-printer-simulator afin de pouvoir lancer une imprimante virtuelle sur une IP locale et port 9100.

C) Utilisation de l'ancien "connecteur Java"

  Cette méthode est désormais obsolète.

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

Démo vidéo ici : https://www.youtube.com/watch?v=VLZG9BZ0HLs si utilisation de "Java connector"

Démo vidéo ici: https://www.youtube.com/watch?v=AyQLOT0-SIY si utilisation de "New connector"

D) Utilisation du serveur Java "Hardware Bridge" pour WebApps et le Connecteur TakePOS 18+

  Cette méthode est désormais obsolète.

Le module Connecteur TakePOS 18+ pour Dolibarr peut être téléchargé ici : 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+ |
+--------+           +-----------------+               +---------------------+             +----------------------------------+

Configuration du module Dolibarr

Avec le Connecteur TakePOS 18+, dès que le module sera activé, TakePOS utilisera le serveur Java "Hardware bridge" comme méthode imprimante (voir point suivant). Pour revenir à l'utilisation du navigateur, vous devez désactiver le module. Le serveur Java accepte le websocket du navigateur de l'ordinateur local. Ainsi, lorsque le serveur est arrêté ou redémarré, il peut réchauffer le navigateur avec une popup. Le navigateur local (via du code javascript amené par le module connecteur TakePOS) envoie la demande d'impression en envoyant le contenu du texte brut encodé en Base64du navigateur au serveur bridge.

Configuration du Hardware Bridge Java

Cette passerelle fonctionne sous Windows (ou Linux mais le développement pour Linux n'est pas terminé). Vous pouvez télécharger une version sur https://github.com/imTigger/webapp-hardware-bridge/releases/. Cliquez sur la version souhaitée pour accéder à la liste des fichiers à télécharger.

Pour un pont sous Windows : Téléchargez et exécutez le whb-x.y.0.exe et exécutez-le. Cela installera et exécutera le serveur. De plus, depuis le tableau d'affichage de l'application en cours d'exécution, vous trouverez une icône qui vous permettra d'exécuter la configuration. Exécutez la configuration et sélectionnez l’imprimante série POS. Si vous n'avez pas d'imprimante série POS, vous pouvez sélectionner « Revenir à l'imprimante par défaut », puis installer un pilote POS virtuel (comme l'imprimante virtuelle EMF disponible sur https://www.colorpilot.com/emfprinter_versions.html) et enfin, définissez ce pilote virtuel comme imprimante par défaut dans la configuration de votre imprimante Windows.

Pour un pont sous Linux : Vous pouvez télécharger le fichier zip avec le serveur java et exécuter le serveur java en lançant le fichier jar depuis la ligne de commande avec : java -jar webapp-hardware-bridge. pot Cependant, il ne semble pas possible de lancer le Configurator avec le java par défaut des Linux, pour sélectionner l'imprimante à utiliser. Ainsi, sous Linux, ce serveur risque de ne pas fonctionner correctement (Certains utilisateurs ont toutefois rapportés qu'il était possible de lancer ce configurator avec la version Java d'Amazon en lançant: javaw -cp webapp-hardware-bridge.jar tigerworkshop.webapphardwarebridge.Configurator)

Videos sur le sujet