Installation

Installation

Téléchargement

Téléchargez le module depuis le DoliStore ou depuis votre espace client CAP-REL.

Installation du module

  1. Décompressez l'archive téléchargée

  2. Copiez le dossier smartpos dans le répertoire htdocs/custom/ de votre installation Dolibarr

  3. Installez les dépendances Composer :

     cd htdocs/custom/smartpos
 composer install --no-dev

Activation

  1. Connectez-vous en tant qu'administrateur Dolibarr
  2. Rendez-vous dans Accueil > Configuration > Modules/Applications
  3. Recherchez "SmartPOS" dans la liste
  4. Cliquez sur le bouton d'activation

Page d'activation du module SmartPOS dans la liste des modules Dolibarr

Le module crée automatiquement les tables nécessaires en base de données et les répertoires de travail.

Hôte virtuel pour l'application mobile

L'interface de vente SmartPOS est une application PWA (Progressive Web App) servie depuis le dossier mobile/dist/. Pour un fonctionnement optimal, créez un hôte virtuel Apache dédié :

<VirtualHost *:443>
    ServerName pos.votre-domaine.fr
    DocumentRoot /var/www/dolibarr/htdocs/custom/smartpos/mobile/dist

    <Directory /var/www/dolibarr/htdocs/custom/smartpos/mobile/dist>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Configurez ensuite la variable d'environnement VITE_API_URL pour pointer vers l'URL de l'API SmartPOS (par exemple https://erp.votre-domaine.fr/custom/smartpos/pwa/api.php/).

Premier paramétrage

Après activation, rendez-vous dans le menu SmartPOS qui apparaît dans la barre de navigation Dolibarr. L'onglet Paramètres vous permet de configurer :

  1. Le client par défaut -- Client Dolibarr utilisé quand aucun client n'est sélectionné sur le terminal. Ce paramètre est recommandé pour éviter les erreurs à la facturation.
  2. Le mode de déduction du stock -- Choisissez si le stock est déduit au moment de la commande ou au moment de la facturation.

Écran de paramétrage général SmartPOS avec le client par défaut et le mode de déduction du stock

Attribution des permissions

Rendez-vous dans Accueil > Utilisateurs et groupes pour attribuer les permissions SmartPOS à vos utilisateurs. Les permissions disponibles sont détaillées dans la page Configuration.

Mise à jour

  1. Remplacez le dossier smartpos par la nouvelle version
  2. Relancez composer install --no-dev
  3. Reconnectez-vous à Dolibarr : les mises à jour de base de données sont appliquées automatiquement
SmartPOS Configuration