Configuration
La configuration de SmartPOS est accessible depuis le menu SmartPOS dans la barre de navigation Dolibarr. Elle est organisée en plusieurs onglets.

Paramètres généraux
L'onglet Paramètres contient les réglages globaux du module.
| Paramètre | Description |
|---|---|
| Client par défaut | Client Dolibarr utilisé quand aucun client n'est sélectionné sur le terminal. Sélectionnez un tiers de type "Client". |
| Mode de déduction du stock | À la commande : le stock est réservé dès la création de la commande. À la facturation : le stock est déduit au moment de la génération de la facture. |
Terminaux
L'onglet Terminaux POS permet de gérer vos caisses. Chaque terminal dispose de sa propre configuration.
Créer un terminal
Cliquez sur Créer et renseignez les champs suivants :
| Champ | Obligatoire | Description |
|---|---|---|
| Code terminal | Oui | Identifiant unique du terminal. Lettres majuscules, chiffres et tirets uniquement. 30 caractères maximum. |
| Libellé | Non | Nom descriptif du terminal (ex : "Caisse 1", "Terrasse"). |
| Entrepôt | Non | Entrepôt Dolibarr utilisé pour la déduction du stock sur ce terminal. |
| Client par défaut | Non | Client spécifique à ce terminal. Remplace le client par défaut global si renseigné. |
| Catégorie racine | Non | Catégorie de produits affichée comme point d'entrée du catalogue sur ce terminal. Seuls les produits de cette catégorie et de ses sous-catégories apparaissent. |
| Tri des articles | Non | Ordre d'affichage des produits dans le catalogue : par libellé, référence, prix, date de création ou date de modification. |
| Regrouper les lignes | Non | Si coché, les ajouts successifs du même produit incrémentent la quantité au lieu de créer une nouvelle ligne. |
| Affichage prix | Non | Choisissez entre l'affichage des prix HT ou TTC dans l'interface de vente. |

Gérer les terminaux
La liste des terminaux affiche le code, le libellé, l'entrepôt, le mode d'affichage des prix et le statut. Pour chaque terminal, vous pouvez :
- Modifier les paramètres (icône crayon)
- Activer/Désactiver le terminal (interrupteur)
- Supprimer le terminal (icône corbeille)
Attention : Un terminal ne peut pas être supprimé s'il possède des imprimantes, des zones ou des commandes liées.
Moyens de paiement
L'onglet Moyens de paiement permet de configurer les modes de paiement disponibles sur vos terminaux.
Créer un moyen de paiement
| Champ | Obligatoire | Description |
|---|---|---|
| Code | Oui | Identifiant unique. Lettres majuscules, chiffres et underscores uniquement. 30 caractères maximum. Exemples : CB, ESPECES, CHEQUE, TR. |
| Libellé | Non | Nom affiché sur l'écran de paiement (ex : "Carte bancaire", "Espèces"). |
| Icône | Non | Nom de l'icône Font Awesome 6 à afficher (ex : fa-credit-card, fa-money-bill). |
| Couleur | Non | Couleur du bouton de paiement dans l'interface (sélecteur de couleur). |
| Ordre | Non | Position d'affichage du moyen de paiement (tri croissant). |
| Configuration | Non | Paramètres avancés au format JSON. Réservé aux intégrations spécifiques. |

Exemples de configuration
| Code | Libellé | Icône | Ordre |
|---|---|---|---|
ESPECES |
Espèces | fa-money-bill |
1 |
CB |
Carte bancaire | fa-credit-card |
2 |
CHEQUE |
Chèque | fa-money-check |
3 |
TR |
Ticket restaurant | fa-utensils |
4 |
Zones / Salles
L'onglet Zones / Salles permet de définir les espaces de votre établissement (salle, terrasse, bar, etc.). Les zones sont utilisées en mode restauration pour organiser le plan de salle.
Créer une zone
| Champ | Obligatoire | Description |
|---|---|---|
| Terminal | Oui | Terminal auquel la zone est rattachée. |
| Nom de la zone | Oui | Nom descriptif (ex : "Salle principale", "Terrasse", "Bar"). |
| Ordre d'affichage | Non | Position de la zone dans la liste (tri croissant). |
Attention : La suppression d'une zone entraîne la suppression de toutes les tables qui lui sont associées.
Tables
L'onglet Tables permet de gérer les tables de votre établissement. Chaque table est rattachée à une zone.
Créer une table
| Champ | Obligatoire | Description |
|---|---|---|
| Zone | Oui | Zone à laquelle la table appartient. |
| Numéro de table | Oui | Identifiant de la table (ex : "1", "T12", "Terrasse 3"). |
| Capacité (couverts) | Non | Nombre maximum de couverts. Valeur par défaut : 4. |
| Code QR | Non | Code QR unique associé à la table. Permet aux clients de consulter le menu ou de passer commande en scannant le code. |
| Ordre d'affichage | Non | Position de la table dans la liste (tri croissant). |
| Note | Non | Informations complémentaires sur la table (emplacement, particularités). |
États des tables
Chaque table possède un état qui reflète son utilisation en cours :
| État | Description |
|---|---|
| Libre | La table est disponible. |
| Occupée | Une commande est en cours sur cette table. |
| À nettoyer | Le client est parti, la table doit être nettoyée. |
| Réservée | La table est réservée pour un client à venir. |
Attention : Une table ne peut pas être supprimée si elle possède des sessions actives.
Imprimantes
L'onglet Imprimantes permet de configurer les imprimantes de tickets associées à chaque terminal.
Créer une imprimante
| Champ | Obligatoire | Description |
|---|---|---|
| Terminal | Oui | Terminal auquel l'imprimante est rattachée. |
| Nom | Oui | Nom descriptif de l'imprimante (ex : "Caisse 1", "Cuisine"). |
| Type | Oui | Vente : impression du ticket client. Cuisine : impression du bon de commande cuisine. |
| Protocole | Oui | USB : connexion directe via WebUSB. Réseau : connexion IP/port TCP. Navigateur : impression via la fonction d'impression du navigateur. |
| Connexion | Non | Adresse IP et port pour les imprimantes réseau (ex : 192.168.1.100:9100). Non applicable pour les protocoles USB et Navigateur. |
| Largeur papier | Oui | 58mm : petit format. 80mm : format standard. |

Écran client
L'onglet Écran client permet de configurer le diaporama affiché sur le second écran orienté vers le client lorsqu'aucune transaction n'est en cours.
Fonctionnement
- Sélectionnez un terminal dans la liste déroulante
- Ajoutez des diapositives pour ce terminal
Créer une diapositive
| Champ | Obligatoire | Description |
|---|---|---|
| Type | Oui | Texte : affiche un message textuel. Image : affiche une image (URL). |
| Contenu | Oui | Texte du message ou URL de l'image selon le type choisi. |
| Durée | Non | Durée d'affichage de la diapositive en secondes. Valeur par défaut : 5 secondes. Plage : 1 à 120 secondes. |
| Ordre | Non | Position de la diapositive dans la rotation (tri croissant). |
| Actif | Non | Permet d'activer ou désactiver une diapositive sans la supprimer. |
Appairage de l'écran client
L'écran client se connecte au terminal via un code d'appairage à 6 chiffres :
- Sur le terminal principal, générez un code d'appairage
- Sur l'appareil servant d'écran client, ouvrez l'application et saisissez le code
- L'écran client se synchronise automatiquement avec le terminal
Le token d'appairage expire après 7 jours. Passé ce délai, un nouvel appairage est nécessaire.
SmartMaker
L'onglet SmartMaker permet de configurer la visibilité des champs complémentaires (extrafields) Dolibarr dans l'application mobile. Pour chaque champ complémentaire, vous pouvez définir s'il est :
- Visible (RO) : affiché en lecture seule dans l'application
- Éditable (RW) : modifiable depuis l'application
Permissions
SmartPOS définit 13 permissions que vous attribuez à vos utilisateurs ou groupes depuis Accueil > Utilisateurs et groupes.
Permissions sur les terminaux
| Permission | Description |
|---|---|
| Lire les terminaux | Consulter la liste et les détails des terminaux. |
| Créer/Modifier les terminaux | Ajouter ou modifier des terminaux. |
| Supprimer les terminaux | Supprimer des terminaux existants. |
Permissions sur les commandes
| Permission | Description |
|---|---|
| Lire les commandes | Consulter les commandes POS. |
| Créer/Modifier les commandes | Créer des commandes et modifier les commandes en brouillon. |
| Supprimer les commandes | Supprimer des commandes. |
Permissions générales
| Permission | Description |
|---|---|
| Utiliser l'interface POS | Accéder à l'interface de vente sur le terminal. |
| Administration SmartPOS | Accéder à la configuration du module (onglets d'administration). |
| Appliquer des remises | Appliquer des remises sur les lignes de commande. |
| Annuler des commandes validées | Annuler une commande qui a déjà été validée. |
| Effectuer des remboursements | Générer des avoirs et traiter les remboursements. |
| Ouvrir le tiroir-caisse | Déclencher l'ouverture du tiroir-caisse. |
| Consulter les rapports POS | Accéder aux rapports et statistiques du point de vente. |