1. Introduction

SamaBoutique est une application de gestion pour petits commerçants, boutiques et vendeurs. Elle permet de gérer le stock, les ventes, les clients, les livraisons et les commandes en ligne via WhatsApp.

Avec SamaBoutique, vous pouvez :

Gérer vos produits et votre stock en temps réel
Vendre en boutique avec un panier et une caisse simples
Générer des factures PDF automatiquement
Suivre vos clients et leurs points de fidélité
Recevoir des commandes et réservations via WhatsApp
Gérer les livraisons et les fournisseurs
Créer des promotions et des codes promo
Consulter des statistiques de vente

💡 Astuce : SamaBoutique fonctionne dans un navigateur web (Chrome, Firefox, Edge). Aucune installation sur votre téléphone n'est nécessaire.

2. Connexion et rôles

2.1 Se connecter

Ouvrez votre navigateur et allez sur l'adresse de votre boutique.
Cliquez sur la page de connexion.
Entrez votre email et votre mot de passe.
Cliquez sur « Se connecter ».

2.2 Les rôles

SamaBoutique propose trois rôles :

Rôle	Qui ?	Ce qu'il peut faire
Super Admin	Propriétaire de la plateforme	Créer des boutiques, gérer tous les accès
Admin	Gérant de la boutique	Tout gérer dans sa boutique : stock, ventes, employés, promotions...
Vendeur	Employé de la boutique	Passer des ventes, consulter les clients et les réservations

⚠️ Important : Ne partagez jamais votre mot de passe. Chaque employé doit avoir son propre compte.

3. Tableau de bord

Le tableau de bord s'affiche après la connexion. Il donne un aperçu rapide de votre activité :

Ventes du jour : nombre de ventes et montant total
Stock faible : produits à réapprovisionner
Réservations en attente : commandes clients à traiter
Top produits : articles les plus vendus

💡 Astuce : Cliquez sur une carte du tableau de bord pour aller vers la section correspondante.

4. Gestion du stock

4.1 Ajouter un produit

Allez dans le menu « Stock ».
Cliquez sur « Ajouter un produit ».
Remplissez le nom, la catégorie, le prix, la quantité et le seuil d'alerte.
Ajoutez une description si nécessaire.
Cliquez sur « Enregistrer le produit ».

4.2 Réapprovisionner un produit

Dans la liste des produits, cliquez sur « Réapprovisionner ».
Indiquez la quantité à ajouter.
Ajoutez une note (fournisseur, numéro de lot, etc.).
Cliquez sur « Ajouter au stock ».

💡 Astuce : Le seuil d'alerte vous prévient quand un produit est presque en rupture. Par défaut, il est de 5 unités.

5. Inventaire

Le module Inventaire permet de compter le stock réel, corriger les écarts, consulter les sessions passées et télécharger un fichier Excel récapitulatif.

5.1 Démarrer et faire un inventaire

Allez dans le menu « Inventaire », puis l'onglet « Comptage ».
Cliquez sur « Démarrer un inventaire complet ».
Recherchez un produit ou filtrez par catégorie.
Dans la colonne « Stock physique », entrez la quantité réellement constatée.
Vérifiez l'écart : quantité physique moins stock système.
Cliquez sur « Valider » : le stock est immédiatement mis à jour pour ce produit.
Comptez tous les produits de la boutique ; la session ne peut être clôturée qu'une fois le comptage terminé.
Cliquez sur « Clôturer et télécharger Excel ». Le fichier peut ensuite être retéléchargé dans l'onglet « Historique ».

5.2 Historique des sessions

L'onglet « Historique » conserve les sessions clôturées et permet de télécharger de nouveau leur fichier Excel. L'historique des comptages affiche la date, le produit, le stock système, la quantité comptée, l'écart, la session et le gérant qui a effectué le comptage.

5.3 Valorisation et marges

Les cartes de synthèse distinguent la valeur au prix d'achat et la valeur au prix de vente. L'onglet « Valorisation » présente les montants par catégorie ; l'onglet « Marges » compare le prix d'achat et le prix de vente. Les calculs de coût et de marge nécessitent un prix d'achat renseigné dans « Stock ».

💡 Astuce : Faites un inventaire régulier, par exemple une fois par mois, pour garder votre stock à jour.

6. Caisse et ventes

6.1 Passer une vente

Allez dans le menu « Ventes ».
Cliquez sur les produits à gauche pour les ajouter au panier.
Modifiez les quantités avec les boutons + et -.
Sélectionnez un client existant ou laissez « Client de passage ».
Choisissez le mode de paiement : Espèces, Orange Money ou Wave.
Cliquez sur « Valider la vente et facturer ».

6.2 Appliquer une promotion

Dans le panier, choisissez une promotion dans la liste déroulante.
La remise se calcule automatiquement sur le total.
Validez la vente.

6.3 Paiement mobile (Orange Money / Wave)

Le paiement mobile en ligne (Orange Money / Wave) n'est pas encore activé : il nécessite un compte marchand et une configuration. Pour l'instant, encaissez en espèces, par QR code marchand, ou à la livraison.

⚠️ Important : si le paiement mobile en ligne est refusé, c'est qu'il n'est pas encore configuré pour votre boutique. Utilisez un autre mode de paiement.

6.4 Historique des ventes

Cliquez sur l'onglet « Historique » dans la page Ventes pour voir toutes les ventes passées. Vous pouvez vérifier le statut d'un paiement mobile en attente.

7. Clients et fidélité

7.1 Ajouter un client

Allez dans le menu « Clients ».
Cliquez sur « Ajouter un client ».
Remplissez le nom, le téléphone, l'email et l'adresse.
Ajoutez une date de naissance et des notes si besoin.
Cliquez sur « Enregistrer le client ».

7.2 Voir le détail d'un client

Cliquez sur « Voir détails » pour afficher :

Le total dépensé par le client
Le nombre d'achats
Les points de fidélité
L'historique des achats
Les réservations du client

💡 Astuce : Vous pouvez modifier les points de fidélité et les notes d'un client depuis sa fiche détail.

8. Réservations et commandes

Les clients peuvent réserver des produits depuis votre catalogue en ligne. Les réservations apparaissent dans le menu « Réservations ».

Allez dans le menu « Réservations ».
Filtrez par statut : En attente, Confirmées, Annulées.
Cliquez sur « Confirmer » ou « Annuler » selon la disponibilité du produit.
Contactez le client par WhatsApp ou téléphone pour finaliser.

💡 Astuce : Une réservation confirmée ne retire pas automatiquement le produit du stock. Pensez à passer une vente officielle ensuite.

9. Livraisons

9.1 Créer une livraison

Allez dans le menu « Livraisons ».
Cliquez sur « Nouvelle livraison ».
Choisissez une vente existante avec un client.
Remplissez l'adresse, le téléphone et les notes.
Cliquez sur « Créer la livraison ».

9.2 Suivre une livraison

Pour chaque livraison, vous pouvez changer le statut : En attente → En préparation → Expédiée → Livrée → Annulée.

10. Promotions

10.1 Créer une promotion

Allez dans le menu « Promotions ».
Cliquez sur « Nouvelle promotion ».
Donnez un nom et un code promo (optionnel).
Choisissez le type : Pourcentage ou Montant fixe.
Indiquez la valeur de la remise.
Définissez un montant minimum d'achat si nécessaire.
Choisissez les dates de début et de fin.
Cliquez sur « Créer la promotion ».

💡 Astuce : Vous pouvez activer ou désactiver une promotion à tout moment avec le bouton de bascule.

11. Fournisseurs

11.1 Ajouter un fournisseur

Allez dans le menu « Fournisseurs ».
Cliquez sur « Fournisseur ».
Remplissez le nom, le téléphone, l'email et l'adresse.
Cliquez sur « Enregistrer le fournisseur ».

11.2 Passer une commande fournisseur

Cliquez sur « Commande ».
Choisissez le fournisseur.
Ajoutez les articles à commander.
Indiquez les quantités et les prix unitaires.
Cliquez sur « Créer la commande ».

11.3 Réceptionner une commande

Quand vous recevez la marchandise, cliquez sur « Reçue ». Le stock de chaque produit est automatiquement mis à jour.

12. Employés

Cette section est réservée aux admins.

Allez dans le menu « Employés ».
Cliquez sur « Ajouter un employé ».
Remplissez le nom, l'email et le mot de passe.
Choisissez le rôle : Vendeur ou Admin.
Cliquez sur « Enregistrer l'employé ».

⚠️ Important : Un vendeur ne peut pas créer de nouveaux employés ni modifier les promotions. Seul un admin a tous les droits.

13. Statistiques

Le menu « Statistiques » affiche des graphiques de votre activité :

Chiffre d'affaires total
Nombre de ventes
Panier moyen
Évolution des ventes sur 7 jours, 30 jours ou 12 mois
Top produits par chiffre d'affaires
Répartition des statuts de paiement

💡 Astuce : Changez la période avec les boutons en haut de la page pour voir les tendances à court ou long terme.

14. Catalogue en ligne et WhatsApp

Chaque boutique a un catalogue public accessible par un lien unique.

14.1 Trouver le lien de votre catalogue

Connectez-vous à votre compte.
Dans la barre latérale, cliquez sur « Mon catalogue ».
Le lien s'ouvre dans un nouvel onglet.

14.2 Partager le catalogue

Partagez le lien de votre catalogue sur WhatsApp, Instagram, Facebook ou par SMS. Vos clients verront vos produits avec leurs prix et pourront :

Commander via WhatsApp
Acheter maintenant avec Orange Money ou Wave (simulé en test)
Réserver un produit

💡 Astuce : Votre numéro WhatsApp doit être renseigné dans votre profil boutique pour que les commandes WhatsApp fonctionnent.

15. Abonnements mensuels / annuels et parrainage

Cette section résume les nouvelles règles d'abonnement et le système de parrainage de SamaBoutique.

15.1 Choisir un abonnement annuel ou mensuel

Lors de l'inscription, chaque boutique choisit un intervalle de facturation :

Mensuel : tarif de base, échéance fixée au 5 du mois suivant.
Annuel : tarif de base × 12 moins la réduction globale (ex: 10% de remise). L'échéance est reculée d'un an.

💡 Astuce : L'intervalle de facturation d'une boutique est modifiable à tout moment.

15.2 Système de parrainage

Chaque boutique dispose d'un code de parrainage unique. Le lien de parrainage est de la forme :

https://votre-domaine.com/register?ref=CODE_DU_PARRAIN
Dans votre espace, consultez la colonne « Parrainage » pour voir le code, le nombre de filleuls et les récompenses reçues.
Cliquez sur « Copier le lien » pour partager le lien d'inscription d'une boutique.
Quand un nouveau client s'inscrit avec ce lien et choisit un abonnement annuel, son parrain reçoit automatiquement 1 mois gratuit.
Le nombre de mois gratuits est configurable dans les paramètres globaux.

⚠️ Important : La récompense de parrainage n'est accordée que si le nouveau client s'abonne en annuel.

15.3 Depuis la page d'inscription

Un nouveau client peut s'inscrire avec un code de parrainage pré-rempli depuis l'URL. Il choisit son intervalle de facturation et, s'il opte pour l'annuel, le parrain reçoit la récompense.

💡 Astuce : Partagez votre lien de parrainage sur WhatsApp, Instagram ou par SMS pour recruter de nouvelles boutiques.

16. FAQ et dépannage

Je ne reçois pas les commandes WhatsApp

Vérifiez que votre numéro WhatsApp est bien renseigné dans votre profil boutique. Le catalogue utilise ce numéro pour envoyer les messages.

Mon compte est bloqué

Votre abonnement est peut-être en retard, ou votre boutique a été suspendue. Contactez le support pour régulariser la situation et débloquer votre compte.

Le paiement Orange Money / Wave ne marche pas

Le paiement mobile en ligne nécessite un compte marchand (Wave Business ou Orange Money Marchand) et une configuration. Tant qu'il n'est pas activé, utilisez les espèces, le QR code marchand ou le paiement à la livraison.

Un produit n'apparaît pas dans le catalogue

Vérifiez que le produit est bien créé et que sa quantité en stock est supérieure à 0.

Ces menus sont réservés aux admins. Si vous êtes vendeur, demandez à votre gérant de vous donner le rôle admin.

J'ai oublié mon mot de passe

Contactez l'admin de votre boutique pour qu'il réinitialise votre mot de passe.

L'application est lente

Vérifiez votre connexion internet. Si le problème persiste, rechargez la page ou contactez le support.

💡 Astuce : Pour toute question supplémentaire, contactez le support de SamaBoutique.

SamaBoutique — Votre boutique, simplifiée.