Vendre en ligne
Une vitrine publique par boutique, un catalogue illustré, un panier et un compte client, accessibles depuis un simple téléphone.
Produit · KOBEHSTORE
La boutique en ligne, de la vitrine à la livraison.
KOBEHSTORE réunit dans un seul service la vitrine publique, la gestion des produits et des commandes, la caisse tactile et la livraison confiée à KOBEH-TRACK. Conçu pour les commerçants, artisans et distributeurs ivoiriens, il s'utilise depuis un navigateur, une application Android ou une application Windows.
En un coup d'œil
Une plateforme, quatre gestes quotidiens
KOBEHSTORE couvre le parcours complet du commerçant : présenter les produits, recevoir les commandes, encaisser et faire livrer.
Encaisser en boutique
Une caisse tactile plein écran pour les ventes comptoir, avec espèces, Mobile Money, carte, rendu de monnaie et reçu imprimable.
Livrer avec KOBEH
Les courses sont créées dans KOBEH-TRACK, suivies par webhook et reprises automatiquement en cas d'échec temporaire.
Piloter l'activité
Stock, ventes, clients, encaissements, dépenses, TVA et exports CSV réunis dans un espace partenaire unique.
Fonctionnalités
La vitrine et l'expérience d'achat
- Catalogue — produits groupés par catégorie, recherche texte, filtre par catégorie et filtre multi-tags ; les tags s'affichent sur une ligne avec défilement horizontal.
- Rayons horizontaux — chaque catégorie fait défiler ses produits au glissement tactile, à la molette ou par la barre de défilement, avec accroche aux cartes.
- Fiche produit — photos, galerie, tags colorés, prix, remise, composition, caractéristiques, poids et stock disponible.
- Panier — quantité modifiable, suppression ligne par ligne et vidage complet tant que la commande n'est pas validée.
- Adresse sur carte — recherche d'adresse, clic sur la carte ou position GPS du téléphone ; latitude et longitude sont remplies automatiquement.
- Compte client — inscription autonome, connexion, profil et adresse modifiables, changement de mot de passe et historique des commandes.
- Suivi de commande — par référence et téléphone pour un visiteur, ou directement dans le compte client ; statuts boutique et statuts de livraison KOBEH.
- Annulation client — possible tant que la course KOBEH n'est pas engagée ; le stock est alors restauré et la course annulée.
- Mobile et PWA — installation depuis le navigateur sur Android et Windows, avec manifeste, icônes et page hors ligne minimale.
Espace partenaire
Gérer la boutique, les produits et les clients
Chaque partenaire dispose de son propre espace, cloisonné par organisation et par boutique.
- Tableau de bord — indicateurs clés et renvois vers les sections Produits, Stock, Ventes, Clients, Tags, Comptabilité, Livraison, Paramètres et Utilisateurs.
- Produits — création et édition en fenêtre modale, photo principale, galerie par position, tags, prix, remise, stock, seuil d'alerte et poids.
- Suppression logique — un produit ou un client supprimé disparaît des listes et de la vitrine, mais l'historique des commandes est conservé.
- Stock — mouvements, seuil d'alerte et mise à jour à chaque commande ou vente en caisse ; les prix et le stock sont toujours relus côté serveur.
- Clients — recherche, fiche complète, adresse GPS, pièce légale, compte contribuable, segment, consentement marketing et export CSV.
- Commandes — lignes figées, totaux calculés côté serveur, idempotence, paiement à la livraison et historique des événements.
- Rôles et permissions — propriétaire, administrateur d'organisation, manager, vendeur, magasinier, comptable et lecteur ; contrôle serveur sur les sections sensibles.
- Audit — journalisation des créations, changements de rôle ou d'état et actions sensibles.
Caisse tactile (POS)
Vendre au comptoir, sans passer par la livraison
- Interface plein écran — recherche, catégories et tuiles produits larges avec photo, prix et stock, pensées pour un écran tactile.
- Panier tactile — boutons −, + et Supprimer, total en gros caractères.
- Encaissement — client facultatif, espèces, Mobile Money ou carte, montant reçu et rendu de monnaie calculé.
- Validation — vente marquée livrée et payée, stock décrémenté, paiement inscrit en comptabilité, aucune course KOBEH créée.
- Reçu — ticket thermique 80 mm ou 58 mm, total en gras, paiement, reçu, rendu et code-barres Code 128 du numéro de ticket.
- Scan — lecteur de codes-barres USB ou Bluetooth, scan direct avec confirmation visuelle et recherche texte en secours.
- Client de passage — créé automatiquement lorsqu'aucun téléphone n'est saisi, puis masqué de la base clients visible.
- Applications dédiées — coquilles Windows et Android qui ouvrent directement la caisse, sans navigation dans le reste de la plateforme.
Catalogue
SKU, codes-barres et étiquettes
Chaque produit reçoit une référence interne stable et un code-barres scannable, sans dépendre d'un tableur.
- Format numérique — 10 chiffres : année (4), mois (2), code catégorie (2) et série (2), par exemple 2026 10 01 01.
- Variantes de format — préfixe + numérique ou préfixe libre ; mode automatique ou manuel, séparateur et largeur de compteur réglables.
- Catégories — code SKU sur deux chiffres, attribution automatique des nouvelles catégories et séries mensuelles par catégorie.
- Codes-barres — Code 128, Code 39 ou EAN-13, aperçu dans les préférences, SVG sur la fiche produit et étiquette 60 × 40 mm imprimable.
- Produits externes — scan du code-barres fabricant à la création, catégorie Externe et aucun SKU interne généré.
- Unicité et complétion — unicité par boutique et bouton « Compléter les SKU manquants ».
- Impression — étiquette imprimée à 100 %, sans en-tête ni pied de page ; le pilote gère la coupe.
Comptabilité et pilotage
Savoir ce qui est encaissé, dépensé et reste dû
- Encaissements — paiements totaux ou partiels, rattachés aux commandes et aux ventes comptoir.
- Dépenses — saisie et suivi des dépenses d'exploitation de la boutique.
- Indicateurs — chiffre d'affaires, reste à encaisser, résultat estimé et TVA à 18 %.
- Exports — exports CSV des ventes, paiements et dépenses pour le comptable ou le tableur.
- Facturation plateforme — abonnements, factures, TVA configurable, échéance, impression A4, encaissements partiels, relances et annulation motivée.
- Périmètre actuel — pas d'API de paiement en ligne branchée, relances enregistrées mais non expédiées automatiquement, pas d'avoir ni d'export FEC, devise XOF.
Livraison
Les courses sont confiées à KOBEH-TRACK
La boutique reste indépendante : elle joint KOBEH-TRACK par une API partenaires dédiée, avec une clé propre à chaque boutique.
- Devis et création — calcul des frais, création de la course avec une clé d'idempotence égale à la référence de commande, puis enregistrement du statut.
- Suivi — webhooks signés en HMAC-SHA256 et polling de secours toutes les cinq minutes pour synchroniser les statuts.
- Reprise — en cas d'indisponibilité, la commande reste confirmée avec un statut d'erreur ; une tâche de fond retente huit fois et un bouton Relancer est disponible.
- Validation des commandes — une commande vitrine passe par un tampon de validation : date de livraison, créneau et note de préparation.
- Jour même ou différé — livraison future : la course est créée immédiatement avec la date planifiée ; livraison le jour même : la course est créée au moment où le colis est prêt.
- Statuts — commandes En attente, À confirmer, Confirmée, En préparation, Expédiée, Prête, Livrée, Annulée ou Remboursée ; livraison Créée, Affectée, En cours, Livrée, Échec ou Annulée.
- Annulation — la course KOBEH est annulée si elle existe et le stock est restauré.
Multi-organisations
Une plateforme, plusieurs commerces
KOBEHSTORE est conçu comme un service multi-organisations : chaque client dispose de ses données, de ses utilisateurs et de ses paramètres.
- Isolation — organisations, utilisateurs, appartenances, rôles et permissions ; toutes les tables métier portent un identifiant d'organisation.
- Sous-domaines — résolution par nom d'hôte pour servir chaque boutique sur son adresse ; les sous-domaines sont activés à la demande.
- Console plateforme — tableau de bord des organisations, utilisateurs, boutiques, commandes et chiffre d'affaires sur trente jours.
- Abonnements — plans Starter, Pro et Business, limites et tarifs modifiables, notes internes et suspension ou réactivation d'une organisation.
- Rôles plateforme — superviseur avec écriture, support et lecteur en lecture seule.
- Limites connues — l'isolation est applicative par organisation ; les quotas de plan et le paiement en ligne de la facturation ne sont pas encore appliqués.
Applications
Installer KOBEHSTORE sur le poste de vente
La plateforme fonctionne dans le navigateur. Des applications légères sont fournies pour l'installation sur Android et Windows.
- PWA — installation depuis Chrome ou Edge, sans magasin d'applications, avec icône et page hors ligne minimale.
- Windows portable — KOBEH-Boutique-Windows.zip : décompresser, lancer l'exécutable. Version non signée : Windows SmartScreen peut demander une confirmation.
- Android — kobeh-boutique.apk : coquille Capacitor, APK de test à installer hors magasin.
- Caisse Windows — KOBEH-Caisse-Windows.zip : ouverture directe sur la caisse.
- Caisse Android — kobeh-caisse.apk : même usage sur tablette ou terminal Android.
Les applications se connectent à kobehstore.ci en HTTPS. Pour une publication sur le Play Store, un APK ou AAB signé avec un keystore dédié reste nécessaire.
Documentation
Les guides d'exploitation
Les procédures ci-dessous accompagnent la mise en service et l'usage quotidien. Elles sont remises aux clients et maintenues à chaque évolution.
Déploiement et architecture
Un serveur et une base PostgreSQL dédiés, jamais partagés avec KOBEH-TRACK.
- Docker Compose : application, base et reverse proxy
- Cloudflare devant le service, TLS et HSTS
- Sauvegardes quotidiennes et restauration testée
- Mise à jour par image taguée et retour arrière
Multi-organisations et sous-domaines
Isolation des données, rôles et résolution par nom d'hôte.
- Organisations, utilisateurs, appartenances et rôles
- Permissions par organisation et audit
- Sous-domaines de boutique et console plateforme
- Plans, abonnements et facturation
Personnalisation de la vitrine
Logo et deux couleurs, sans intervention technique.
- Logo PNG, JPG, WebP ou GIF, 6 Mo maximum
- Couleur principale et secondaire en hexadécimal
- Palette rapide de 21 teintes
- Aperçu et retour aux couleurs KOBEH
SKU et codes-barres
Références stables, catégories codées et étiquettes scannables.
- Format numérique année-mois-catégorie-série
- Code 128, Code 39 ou EAN-13
- Étiquette 60 × 40 mm et scan en caisse
- Produits externes par code-barres fabricant
Ticket de caisse thermique
Un reçu lisible sur imprimante thermique 80 mm ou 58 mm.
- Largeur et pied de ticket réglables
- Police monospace et total en gras
- Code-barres du numéro de ticket
- Impression à 100 %, sans en-tête navigateur
Suivi des commandes et compte client
Le client retrouve ses commandes sans appeler la boutique.
- Consultation par référence et téléphone
- Historique et détail dans le compte client
- Statuts boutique et livraison KOBEH
- Annulation et restauration du stock
Validation des commandes et créneaux
La boutique confirme la date et le créneau avant la course.
- File À valider et compteur au tableau de bord
- Date, début et fin de créneau, note
- Course immédiate si la date est future
- Course créée à la finition le jour même
Sécurité et données personnelles
Les données clients et les clés techniques sont protégées.
- Mots de passe bcrypt et sessions HttpOnly
- Clés KOBEH chiffrées au repos
- Contrôle serveur des prix, du stock et des rôles
- Minimisation et consentement marketing
Périmètre actuel : le paiement en ligne, les variantes produit, les codes promotionnels, les retours et remboursements, ainsi que l'envoi automatique d'e-mails ou de SMS ne sont pas encore inclus. Les tarifs et les caractéristiques contractuelles sont précisés dans les conditions remises avec le service.
Passer à la pratique
Ouvrir une boutique ou reprendre une activité existante
Créez votre espace en quelques minutes, importez votre catalogue et encaissez dès le premier jour. Notre équipe accompagne la mise en service et la formation.