Module Point de vente (TakePOS): Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
mNo edit summary
Tag: 2017 source edit
Tag: 2017 source edit
 
(40 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 -->


[[Category:Point de vente]]
[[Category:Point de vente]]
{{TemplateDocUtil}}
{{TemplateDocUtil}}
{{TemplateModFR}}
{{TemplateModFR}}
{{BasculeDevUser|
{{BasculeDevUserFr|
nom=Point de vente (TakePOS)|
nom=Point de vente (TakePOS)|
num=50150|
num=50150|
Line 26: Line 15:
userdoc=This page|}}
userdoc=This page|}}


= Introduction =
=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 :
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
*Ventes parallèles
* Interface tactile et réactive
*Compatibilité lecteur code-barres
* Multi-terminal
*Interface tactile et réactive
* Mode multi-paiement, sessions multi-paiement
*Multi-terminal
* Commande automatique par client à partir d'un code QR
*Mode multi-paiement, sessions multi-paiement
* Gestion de boutiques, bars ou restaurants
*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)]]
Notez que ce module doit être utilisé pour remplacer l'ancien [[Module_Caisse_enregistreuse_(SimplePOS)]]


= Installation =
=Installation=
{{NoInstallModuleFr}}
{{NoInstallModuleFr}}


= Configuration =
=Configuration=
{{ActivationModuleFr}}
{{ActivationModuleFr}}




= Compatibilité matérielle =
=Compatibilité matérielle=
Si vous devez connecter le module TakePOS à 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.




Exemple de configuration matérielle pour les imprimantes de reçus :
==Configuration matérielle pour les imprimantes==


== 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.
===A) Utilisation de la fonction d'impression 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.
Cette solution est celle disponible par défaut, elle utilise la fonctionnalité standard "Imprimer" de votre navigateur pour imprimer sur une imprimante Laser, Jet d'encre ou toute étiqueteuse thermique.
 
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 et la popup d'impression de votre navigateur s'ouvrira également, il vous suffira donc de cliquer sur le bouton Imprimer.


<pre>
<pre>
+--------+                +------------------------+            +-----------------+
+--------+                +--------------------------+            +-----------------+
|The    |    lan/wan    | Browser print system   |            | Dolibarr server |
|The    |    lan/wan    | Your local computer or   |            | Dolibarr server |
|Printer |<----or usb ----| of your local computer |--internet-->| with TakePOS    |
|Printer |<----or usb ----| its browser print system |--internet-->| with TakePOS    |
+--------+                +------------------------+            +-----------------+
+--------+                +--------------------------+            +-----------------+
</pre>
</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.
Limitation : Cette fonctionnalité ne permet pas d'utiliser les vieilles imprimantes ESC/POS série, mais toutes les imprimantes courantes (wifi, LAN, USB) sont prises en charge sans nécessiter de configuration spéciale dès lors que l'imprimante est branchée sur le poste utilisateur, ou dans le réseau (ou pool Cups) du poste utilisateur.
 
Si il y a besoin d'impression au format ticket (impression sur Papier Rouleau, avec coupe automatique), vous pouvez vous tourner vers une imprimante étiqueteuse du type de la '''Brother TD2020A'''.
 
===B) Utilisation du module "Imprimante de tickets" pour impression ESC/POS===
 
L'usage d'imprimante de ticket utilisant l'ancien protocol ESC/POS peut être assez complexe car nécessite un paramètre évolués pour les faire fonctionner.
 
[[File:warning.png]] Ce type d'imprimante n'est plus supportée par le module TakePOS qui n'accepte que les imprimantes standards. Aussi, pour faire des impressions tickets en flux continue, avec coupe automatique du ticket, avec le module TakePOS, il est recommandé d'utiliser la méthode A qui nécessite juste une imprimante traditionnelle jet d'encre ou laser ou imprimante thermique de ticket qui se comporte comme une imprimante jet d'encre/laser de bureau, voir solution A.  


== B) Utilisation de l'ancien "connecteur Java" ==
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'''<span> </span>: L'imprimante doit être accessible par votre serveur, ce qui peut nécessiter un paramétrage réseau adéquat. 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, il se sera pas possible d'utiliser l'imprimante (les 2 autres méthodes suivantes étant obsolètes).
 
'''Remarque'''<span> </span>: pour tester cette méthode sans avoir d'imprimante, vous pouvez utiliser l'émulateur d'imprimante ESC/POS ici<span> </span>: 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.
[[File:warning.png]] Cette méthode est désormais obsolète.
Line 75: Line 88:
|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" |
|        |          |                |          |                    |            | ou module "New connector" |
+--------+          +----------------+          +---------------------+            +---------------------------+
+--------+          +----------------+          +---------------------+            +---------------------------+
</pre>
</pre>


Démo vidéo ici : https://www.youtube.com/watch?v=VLZG9BZ0HLs
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"


== C) Utilisation du connecteur TakePOS "ancien Web" ==
===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.
[[File:warning.png]] Cette méthode est désormais obsolète.


<pre>
Le module Connecteur TakePOS 18+ pour Dolibarr peut être téléchargé ici<span> </span>: 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>
 
Une fois le module « Nouveau connecteur.zip » sur Dolibarr installé, vous devez choisir la méthode d'impression « Connecteur TakePOS ».
 
Démo vidéo ici : https://www.youtube.com/watch?v=AyQLOT0-SIY
 
== D) Utilisation du nouveau serveur Java "Hardware Bridge" pour WebApps et connecteur TakePOS 18+ ==
 
Le module pour Dolibarr peut être téléchargé ici : https://www.dolistore.com/en/modules/1889-TakePOS-Connector.html


<pre>
<pre>
Line 108: Line 110:
</pre>
</pre>


=== Configuration du module Dolibarr ===
===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 d'impression. Pour revenir à l'utilisation du navigateur, vous devez désactiver le module.
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 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 (le module connecteur TakePOS) envoie la demande d'impression en envoyant le contenu du texte brut encodé en Base64.
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 ===
===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.
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 Windows<span> </span>:''' 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'''
'''Pour un pont sous Linux<span> </span>:''' 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<span> </span>:''' java -jar webapp-hardware-bridge. pot'''
Cependant, il ne semble pas possible de lancer le Configurator pour sélectionner l'imprimante à utiliser. Ainsi, sous Linux, ce serveur risque de ne pas fonctionner correctement.
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 18:35, 26 May 2026

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 Cog circle.svg 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

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 pour imprimer sur une imprimante Laser, Jet d'encre ou toute étiqueteuse thermique.

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 et la popup d'impression de votre navigateur s'ouvrira également, il vous suffira donc de cliquer sur le bouton Imprimer.

+--------+                +--------------------------+             +-----------------+
|The     |     lan/wan    | Your local computer or   |             | Dolibarr server |
|Printer |<----or usb ----| its browser print system |--internet-->| with TakePOS    |
+--------+                +--------------------------+             +-----------------+

Limitation : Cette fonctionnalité ne permet pas d'utiliser les vieilles imprimantes ESC/POS série, mais toutes les imprimantes courantes (wifi, LAN, USB) sont prises en charge sans nécessiter de configuration spéciale dès lors que l'imprimante est branchée sur le poste utilisateur, ou dans le réseau (ou pool Cups) du poste utilisateur.

Si il y a besoin d'impression au format ticket (impression sur Papier Rouleau, avec coupe automatique), vous pouvez vous tourner vers une imprimante étiqueteuse du type de la Brother TD2020A.

B) Utilisation du module "Imprimante de tickets" pour impression ESC/POS

L'usage d'imprimante de ticket utilisant l'ancien protocol ESC/POS peut être assez complexe car nécessite un paramètre évolués pour les faire fonctionner.

Warning.png Ce type d'imprimante n'est plus supportée par le module TakePOS qui n'accepte que les imprimantes standards. Aussi, pour faire des impressions tickets en flux continue, avec coupe automatique du ticket, avec le module TakePOS, il est recommandé d'utiliser la méthode A qui nécessite juste une imprimante traditionnelle jet d'encre ou laser ou imprimante thermique de ticket qui se comporte comme une imprimante jet d'encre/laser de bureau, voir solution A.

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, ce qui peut nécessiter un paramétrage réseau adéquat. 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, il se sera pas possible d'utiliser l'imprimante (les 2 autres méthodes suivantes étant obsolètes).

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"

Warning.png 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+

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

+--------+           +-----------------+               +---------------------+             +----------------------------------+
|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