FAQ

Installation et prérequis

Quelles versions de Dolibarr sont compatibles avec CapFullPOS ?

CapFullPOS nécessite Dolibarr 16.0 ou supérieur et PHP 7.4 ou supérieur.

Faut-il un serveur dédié pour l'application mobile ?

Non. L'application mobile est une PWA (Progressive Web App) constituée de fichiers statiques (HTML, CSS, JavaScript) servis depuis le dossier mobile/dist/. Un hôte virtuel Apache pointant vers ce dossier suffit. Aucun serveur Node.js n'est nécessaire en production.

CapFullPOS fonctionne-t-il avec le multi-entité Dolibarr ?

Oui. Toutes les données CapFullPOS (terminaux, commandes, tables, imprimantes) sont isolées par entité. Chaque entité dispose de sa propre configuration.

Matériel

Quels appareils sont compatibles avec l'interface de vente ?

L'interface de vente fonctionne sur tout appareil disposant d'un navigateur web moderne : smartphones et tablettes Android, iPhone et iPad, PC Windows/Mac/Linux, écrans tactiles. L'application est optimisée pour le tactile et adapte automatiquement sa disposition aux petits écrans : sur smartphone, la navigation passe dans une barre d'onglets en bas et le panier s'ouvre en plein écran (voir Utilisation sur smartphone).

Quelles imprimantes de tickets sont supportées ?

CapFullPOS supporte les imprimantes ESC/POS en connexion USB (via WebUSB), en connexion réseau (IP:port TCP) et l'impression par le navigateur. Les formats de papier 58mm et 80mm sont pris en charge.

Peut-on scanner les codes-barres avec la caméra ?

Oui. La caméra de l'appareil (téléphone, tablette, webcam) peut servir de lecteur de codes-barres, en plus des douchettes USB. Activez l'option dans les réglages de l'application (Scanner de codes-barres > Activer la caméra pour scanner les codes-barres) : un bouton caméra apparaît alors à côté de la recherche. Le produit reconnu est ajouté automatiquement au panier, y compris hors-ligne. L'accès à la caméra nécessite que l'application soit servie en HTTPS.

Quel matériel utiliser pour l'écran client ?

Tout appareil avec un navigateur web peut servir d'écran client : tablette, second moniteur, écran tactile dédié. L'écran client se connecte au terminal via un code d'appairage à 6 chiffres.

Utilisation

Pourquoi l'application me demande un code d'enrôlement ?

Chaque appareil doit être associé à une caisse avant de vendre : c'est l'enrôlement. Si votre appareil n'est encore lié à aucune caisse, l'écran d'enrôlement s'affiche à la connexion. Demandez à votre administrateur de générer un code d'enrôlement à 6 chiffres (onglet Terminaux POS), saisissez-le, puis validez avec Associer la caisse. L'appareil reste ensuite associé à cette caisse. Voir Enrôlement des caisses.

Quelle est la différence entre une commande et une facture dans CapFullPOS ?

CapFullPOS fonctionne en mode Commande puis Facture. Vous ajoutez d'abord les articles à une commande. La commande peut être modifiée, complétée ou annulée librement tant qu'elle est en brouillon. La facture Dolibarr est générée automatiquement au moment du paiement.

Peut-on utiliser plusieurs moyens de paiement pour une même commande ?

Oui. Le paiement mixte permet de combiner plusieurs moyens de paiement (espèces + carte, ticket restaurant + espèces, etc.). Chaque paiement partiel est enregistré individuellement.

Comment fonctionne le mode hors-ligne ?

L'application stocke les données localement (catalogue, commandes) grâce à IndexedDB. Lorsque la connexion internet est interrompue, les commandes sont enregistrées localement. Elles sont synchronisées automatiquement quand la connexion revient. Un indicateur visuel dans la barre de navigation signale le statut en temps réel.

Comment configurer le rendu monnaie ?

Le rendu monnaie est calculé automatiquement lors du paiement en espèces. Saisissez le montant remis par le client et CapFullPOS affiche le montant à rendre avec une suggestion des pièces et billets.

Peut-on encaisser une commande plus tard ?

Oui. Cochez l'option Paiement différé sur l'écran d'encaissement : la facture Dolibarr est créée mais reste ouverte et non réglée. Vous l'encaissez ensuite quand le client paie. Vous pouvez aussi mettre une commande en attente (en brouillon, sans facture) et la reprendre plus tard pour libérer la caisse.

À quoi sert le plafond par titre restaurant ?

Le plafond, défini dans les paramètres généraux, correspond au montant maximal toléré pour un titre restaurant unitaire. Lors d'un paiement par titre restaurant, si le montant saisi dépasse ce plafond, CapFullPOS demande une confirmation au caissier avant de valider.

Comment personnaliser le ticket de vente ?

L'onglet Configuration du ticket permet d'afficher ou masquer le logo, les prix HT, le détail de la TVA, les notes produits, un message de pied de page et un QR code de téléchargement du ticket.

Mode restauration

Peut-on utiliser CapFullPOS sans le mode restauration ?

Oui. Le mode restauration (zones, tables, services, envoi cuisine) est optionnel. Pour un commerce classique, configurez uniquement les terminaux et les moyens de paiement. L'interface de vente fonctionne sans plan de salle.

Comment fonctionne la commande par QR code ?

Chaque table peut avoir un QR code unique. Le client scanne le code depuis son téléphone, consulte le menu et passe commande. La commande apparaît sur le terminal du serveur qui la valide avant de l'envoyer en cuisine.

Peut-on envoyer les articles en cuisine par étapes ?

Oui. Vous pouvez sélectionner les articles à envoyer à chaque étape (entrées, puis plats, puis desserts). Chaque envoi génère un bon de commande cuisine séparé.

Administration

Comment ajouter un nouveau moyen de paiement ?

Rendez-vous dans l'onglet Moyens de paiement de la configuration CapFullPOS. Cliquez sur Créer, renseignez le code, le libellé, l'icône et la couleur, puis enregistrez.

Comment attribuer les permissions CapFullPOS ?

Les permissions sont attribuées depuis Accueil > Utilisateurs et groupes dans Dolibarr. Sélectionnez un utilisateur ou un groupe, puis cochez les permissions CapFullPOS souhaitées. Consultez la section Permissions pour le détail de chaque permission.

Comment enrôler un appareil sur une caisse (ou désactiver l'enrôlement) ?

Dans l'onglet Terminaux POS, la colonne Enrôlement montre l'état de chaque caisse (Libre / Occupée) et sa génération. Cliquez sur Générer un code d'enrôlement pour obtenir un code à 6 chiffres (valable 5 minutes) à saisir sur l'appareil ; utilisez Libérer la caisse pour détacher l'appareil actuel. Pour une démonstration ou un poste unique, vous pouvez désactiver complètement l'obligation d'enrôlement via Paramètres généraux > Désactiver l'enrôlement des caisses (mode démonstration) ; l'invariant "un appareil par caisse" n'est alors plus garanti (à réserver aux démos). Voir Enrôlement des caisses.

Comment supprimer un terminal ?

Un terminal ne peut être supprimé que s'il n'a pas d'imprimantes, de zones ou de commandes liées. Supprimez d'abord les éléments rattachés, puis supprimez le terminal depuis l'onglet Terminaux POS.

Où sont stockées les données CapFullPOS dans Dolibarr ?

Les données sont stockées dans des tables SQL préfixées llx_capfullpos_ dans la base de données Dolibarr. Les commandes CapFullPOS génèrent des factures Dolibarr standard, consultables depuis le menu Facturation de Dolibarr.