Caisse-Connect v1.0.0 -- Documentation¶
Presentation¶
Caisse-Connect est un plugin WordPress/WooCommerce qui synchronise les produits entre un logiciel de caisse (POS) et une boutique en ligne WooCommerce.
Le plugin prend en charge la synchronisation bidirectionnelle : les produits, les prix et les stocks sont importes depuis la caisse vers le site, et les commandes passees en ligne sont exportees vers la caisse. Il integre egalement un module d'enrichissement par intelligence artificielle (photos, textes, categorisation, detourage, OCR), un module d'expedition complet (emballages, cotations, tracking, notifications) et la generation automatique de pages legales.
Caisse-Connect est actuellement compatible avec le systeme de caisse Kwisatz. Son architecture extensible permet l'ajout de nouveaux systemes de caisse.
A qui s'adresse cette documentation ?¶
Cette documentation couvre trois profils d'utilisateurs :
Le commercant -- Vous utilisez Caisse-Connect au quotidien pour gerer vos produits et suivre vos commandes en ligne. Les sections Tableau de bord, Produits, Commandes et Mobile vous concernent en priorite.
Le responsable -- Vous supervisez la configuration du plugin et parametrez les modules (expedition, enrichissement, categories, pages legales). Les sections Preferences, Parametres et Expedition vous guideront dans la mise en place.
Fonctionnalites principales¶
- Synchronisation automatique des produits -- Les produits sont importes depuis votre caisse et mis a jour automatiquement (prix, stock, descriptions, poids, promotions).
- Gestion des commandes web -- Les commandes passees sur votre boutique en ligne sont exportees vers votre caisse pour un traitement unifie. Controle automatique des factures avec appariement caisse/commandes.
- Module mobile -- Editez les fiches produits et gerez les photos directement depuis votre telephone, en magasin. Scanner de codes-barres integre.
- Intelligence artificielle -- Categorisation automatique des produits (Mistral), enrichissement des fiches (composition, description, conseils), recherche de photos (Anthropic, Brave, Grok), detourage d'images (Replicate) et OCR (Mistral).
- Coefficient prix -- Appliquez un multiplicateur au prix caisse pour obtenir le prix de vente en ligne, avec arrondi configurable (centime, 5 centimes, 10 centimes, unite).
- Gestion de la taxonomie -- Organisez les categories de votre site a partir d'un fichier CSV personnalise ou directement depuis la taxonomie de votre caisse (jusqu'a 3 niveaux).
- Module d'expedition -- Definissez les emballages et classes d'expedition, activez un transporteur (Boxtal), obtenez des cotations en temps reel au checkout, creez des expeditions avec etiquettes, tracking et notifications de suivi par email.
- Pages legales auto-generees -- Mentions legales, CGV, politique de confidentialite et politique cookies generees automatiquement a partir de vos informations.
- Systeme de droits d'acces -- Controlez finement qui peut acceder aux differentes sections d'administration du plugin.
- Alertes email configurables -- Recevez des notifications en cas de probleme de connexion a la caisse, d'anomalies de synchronisation, de commandes en attente de facturation ou d'autres evenements critiques.
- Controle factures -- Appariement automatique entre les factures de la caisse et les commandes web, avec detection d'anomalies et actions correctives (detacher, rattacher, transfert).
Prerequis¶
Pour installer et utiliser Caisse-Connect, vous devez disposer de :
| Element | Version minimale | Remarque |
|---|---|---|
| WordPress | 5.0+ | |
| WooCommerce | Plugin installe et actif | Obligatoire |
| PHP | 7.4+ | |
| Systeme de caisse | Kwisatz | Seul systeme compatible a ce jour |
| Block Checkout WooCommerce | Actif | Obligatoire pour le module d'expedition |
Acces serveur et cles API
L'integrateur technique aura besoin d'un acces FTP ou SSH au serveur pour configurer les fichiers de cles API. Ces fichiers sont stockes dans dirname(ABSPATH)/Caisse-Connect/Secrets/, un repertoire situe hors du webroot pour des raisons de securite.
Sans cles API d'intelligence artificielle, le plugin fonctionne normalement pour la synchronisation des produits et la gestion des commandes. Les fonctionnalites d'enrichissement IA, de categorisation, de detourage et d'OCR ne seront simplement pas disponibles.
Les cles du transporteur (Boxtal) sont egalement stockees dans ce repertoire et sont necessaires pour activer le module d'expedition.
Plan de la documentation¶
| Section | Description |
|---|---|
| Tableau de bord | Page d'accueil du plugin, bandeau de statut, statistiques produits et dernieres commandes |
| Produits | |
| Vue d'ensemble | Interface de gestion des produits, recherche et filtres |
| En vente | Produits publies sur le site |
| Produits exclus | Produits exclus de la vente web |
| Produits en sommeil | Produits temporairement retires |
| Produits impubliables | Produits dont la fiche est incomplete |
| Produits archives | Produits archives |
| Journal de synchronisation | Historique des synchronisations |
| Historique enrichissements | Journal des enrichissements IA |
| Commandes | Gestion des commandes, factures, controle Kwisatz et export vers la caisse |
| Expedition | |
| Vue d'ensemble | Presentation du module d'expedition |
| Emballages | Configuration des emballages (poids, dimensions, capacite) |
| Classes d'expedition | Regroupement des produits par contraintes d'expedition |
| Notifications de suivi | Emails de suivi colis envoyes aux clients |
| Configuration | Parametrage du transporteur actif |
| Creer une expedition | Workflow de creation d'une expedition (colisage, depot, etiquettes) |
| Preferences | |
| Vue d'ensemble | Presentation des preferences |
| Categories | Gestion de la taxonomie (CSV ou caisse) |
| Validations automatiques | Regles de publication automatique des produits |
| Affichage site public | Personnalisation de l'affichage sur le site (presentations, infos boutique) |
| Etiquettes | Gestion des tags produits |
| Parametres | |
| Vue d'ensemble | Presentation des parametres |
| Synchronisation | Configuration de la synchronisation automatique |
| Infos boutique | Informations du point de vente (adresse, horaires, contact) |
| Informations legales | Saisie des infos legales et generation des pages |
| Emails | Configuration des comptes email (IMAP) |
| Images | Parametres de traitement des images produits |
| Mobile | |
| Vue d'ensemble | Presentation de l'interface mobile |
| Scanner un produit | Utilisation du scanner de codes-barres |
| Editer un produit | Edition des fiches depuis le telephone |
| Gestion des photos | Prise de photos et gestion des images |
| Installation | |
| Installer le plugin | Procedure d'installation |
| Assistant d'installation | Configuration guidee etape par etape |
| Guides | |
| Synchronisation | Guide complet de la synchronisation |
| Intelligence artificielle | Guide de l'enrichissement IA |
| Expedition | Guide complet du module d'expedition |
| Votre site vu par les clients | Ce que voient vos clients sur le site |
| FAQ | Questions frequemment posees |
| Glossaire | Definitions des termes utilises dans Caisse-Connect |