Documentation fonctionnelle KWISATZ
Gestion du module e-commerce
Le module WKW_MCOMM assure la communication entre KWISATZ et une plateforme e-commerce. Selon le connecteur installé, il permet de transmettre le catalogue, les images et les stocks, puis de récupérer les clients et les commandes Web.
Réponse directe
MCOMM doit rester lancé pour effectuer les traitements automatiques.
Pour une mise en service, configurez d’abord la plateforme, testez quelques produits
en transfert sélectif, vérifiez les stocks et les images,
puis passez une commande de test avant d’activer le catalogue complet.
Un export complet mal préparé peut créer, modifier ou écraser un grand nombre de fiches
sur le site. Effectuez une sauvegarde de la boutique et commencez toujours par un petit
périmètre de test.
Conseil technicien général
1. Licence et disponibilité
La dépendance de licence mentionnée dans ce document provient des sources. Sa disponibilité peut varier selon la version, la sérialisation, le partenaire ou l’installation ; faites-la valider techniquement avant de modifier l’environnement.
2. Distinguer KWISATZ des opérations externes
Un enregistrement dans KWISATZ ne prouve pas automatiquement qu’une opération a été exécutée dans un système externe : débit ou remboursement TPE, mouvement physique d’espèces, envoi de SMS ou d’e-mail, ou action réalisée sur une plateforme.
3. Protection des données
4. Principe de fonctionnement
MCOMM appelle périodiquement les services de la plateforme afin d’effectuer les échanges configurés.
- récupération des nouvelles commandes ;
- création ou actualisation des clients associés ;
- mise à jour des stocks disponibles sur le site ;
- export des produits et de leurs informations Web ;
- transfert des images ;
- échange des catégories, marques ou attributs selon la plateforme ;
- mise à disposition de commandes pour le Click & Collect.
Les fonctions disponibles et leurs libellés exacts dépendent du CMS,
de la version de MCOMM et du connecteur installé.
5. Identifier la plateforme et le périmètre
La base documentaire KWISATZ décrit des interfaces avec les plateformes suivantes :
| Plateforme | Principe général | Point de vigilance |
|---|---|---|
| PrestaShop | Interface via le connecteur et les services installés côté plateforme. | La compatibilité dépend de la version du CMS et des Web Services. |
| WooCommerce | Interface via une extension KWISATZ et l’API du site WordPress/WooCommerce. | Contrôler les UGS, EAN, taxes, extensions et performances de l’hébergement. |
| Magento | Interface via le connecteur MCOMM adapté à la version du site. | Contrôler la version, les catégories et les droits du service. |
| Shopify | Interface utilisant une application Shopify et des accès API. | La version de MCOMM doit correspondre à la méthode d’authentification utilisée. |
| Plateforme spécifique | Échanges par fichiers ou API à développer avec le prestataire Web. | Un développement côté site est généralement nécessaire. |
Une plateforme annoncée comme compatible ne signifie pas que toutes ses extensions,
tous ses champs et toutes ses règles commerciales sont couverts sans adaptation.
6. Distinguer le rôle de KWISATZ et celui du site
| KWISATZ / MCOMM | Plateforme ou prestataire Web |
|---|---|
| Catalogue produit et informations transmises | Thème, pages et présentation graphique |
| Prix, stocks et attributs configurés | Navigation, menus et expérience utilisateur |
| Export des images disponibles | Optimisation, recadrage ou mise en page des images |
| Récupération des commandes et clients | Paiement, livraison et extensions externes |
| Connexion au connecteur documenté | Hébergement, sécurité, sauvegarde et maintenance du CMS |
| Mapping des champs couverts | Développement de champs ou plugins non standards |
La création d’une boutique, de son thème et de ses pages n’appartient pas au périmètre
fonctionnel standard de MCOMM.
7. Prérequis avant configuration
- accès administrateur au site ou intervention du prestataire Web ;
- connecteur ou extension compatible avec la plateforme ;
- version de MCOMM adaptée ;
- accès Internet stable sur le poste ou serveur MCOMM ;
- droits API ou Web Services correctement définis ;
- sauvegarde récente de la boutique ;
- catalogue KWISATZ contrôlé ;
- règles de TVA, prix, livraison et paiement validées ;
- environnement de test ou petit périmètre de produits.
Ne communiquez pas les identifiants, secrets, jetons ou mots de passe dans une base
de connaissance publique. Leur configuration doit être réalisée dans un environnement sécurisé.
8. Ouvrir et configurer MCOMM
L’interface MCOMM comporte généralement :
- une commande pour démarrer ou arrêter la communication ;
- un accès à la configuration ;
- des commandes de traitement manuel ;
- une zone de journalisation ;
- une barre d’état.
- Arrêtez la communication MCOMM.
- Ouvrez la configuration.
- Vérifiez la plateforme sélectionnée.
- Contrôlez l’adresse du service et les accès.
- Réglez la fréquence des traitements automatiques.
- Vérifiez les options Désactiver l’import automatique des commandes et Désactiver l’export automatique des stocks.
- Enregistrez la configuration.
- Redémarrez la communication.
- Contrôlez les premières lignes du journal.
La configuration ne peut être ouverte que lorsque la communication est arrêtée
sur les versions documentées.
9. Préparer un produit pour le Web
La fiche produit comporte un onglet Infos Web. Les zones disponibles peuvent comprendre :
| Zone | Utilisation |
|---|---|
| Inclus dans la boutique Web | Autorise le produit à faire partie des transferts du catalogue. |
| Libellé langue principale | Nom Web du produit ; le libellé principal peut être utilisé si la zone est vide. |
| Description longue | Présentation détaillée du produit. |
| Description courte | Résumé affichable dans les listes ou fiches Web. |
| Image principale | Photo principale à associer au produit. |
| Vignette et galerie | Images supplémentaires, selon le connecteur. |
| Appartenance aux catégories | Association aux catégories récupérées depuis la plateforme. |
| Gestion du stock désactivée | Empêche la transmission du stock pour ce produit. |
| Gestion tarifaire désactivée | Empêche la transmission du tarif pour ce produit. |
| Attributs | Valeurs de tailles, coloris, bonnets ou listes, selon le paramétrage. |
Sur un catalogue existant, ne cochez pas massivement
Inclus dans la boutique Web avant d’avoir contrôlé la correspondance
entre les codes KWISATZ et les identifiants du site.
10. Contrôler les identifiants des produits
Le site et KWISATZ doivent partager une clé de correspondance stable. Selon la plateforme, il peut s’agir du code produit, du code interne, de l’UGS/SKU, de l’EAN ou d’un identifiant externe.
- ne modifiez pas le code produit KWISATZ pour corriger un site existant ;
- vérifiez les UGS/SKU avant d’activer la synchronisation des stocks ;
- ne confondez pas l’UGS avec l’EAN ;
- contrôlez les variations taille/couleur ;
- testez un produit existant et un nouveau produit ;
- documentez la clé utilisée pour chaque connecteur.
Une mauvaise correspondance peut créer des doublons ou envoyer le stock d’un article
sur la fiche d’un autre produit.
11. Gérer catégories, marques et attributs
MCOMM peut, selon la plateforme :
- récupérer les catégories existantes du site ;
- transmettre les rayons, familles ou lignes KWISATZ ;
- transmettre les marques comme catégorie ou attribut ;
- transmettre les tailles, coloris et bonnets ;
- alimenter certains champs de type liste déroulante.
Les attributs gérés par KWISATZ peuvent devenir la source principale des valeurs.
Vérifiez qu’un transfert ne va pas supprimer ou remplacer des attributs déjà créés
directement sur le site.
Cas Shopify : collection et taxonomie
Une collection Shopify sert généralement à organiser la navigation, tandis que la catégorie ou taxonomie produit peut avoir un rôle différent, notamment pour la classification et certaines règles fiscales.
Ne confondez pas une collection de navigation avec la taxonomie produit.
Testez le mapping sur quelques articles avant de lancer un transfert de classes.
12. Actualiser le catalogue des produits
Ouvrez Gestion du catalogue des produits > Actualisation des articles.
| Choix | Comportement |
|---|---|
| Transfert sélectif | Transmet uniquement les produits marqués comme créés ou modifiés. |
| Transfert complet | Transmet tous les produits inclus dans le Web. |
| Ne pas transférer les produits | N’envoie aucune fiche, mais peut servir à réinitialiser les indicateurs internes. |
| Transférer les photos liées | Ajoute le transfert des photos avec les produits, selon le connecteur. |
| Réinitialiser les indicateurs internes | Remet à zéro le statut interne d’actualisation après le traitement. |
Procédure de test
- Préparez deux ou trois produits représentatifs.
- Activez leur statut Web.
- Vérifiez leurs prix, TVA, catégories et images.
- Lancez un transfert sélectif.
- Contrôlez les produits sur le site.
- Vérifiez qu’aucun autre produit n’a été modifié.
- Corrigez le mapping si nécessaire.
- Élargissez progressivement le périmètre.
Réinitialiser les indicateurs ne signifie pas
mettre à jour les produits. Une mauvaise utilisation peut empêcher
certains produits d’être renvoyés lors du prochain transfert sélectif.
13. Transférer les images
Le transfert des images peut être déclenché avec l’actualisation des produits ou depuis l’option d’export des fichiers de photos/images.
- Vérifiez les fichiers présents dans le répertoire d’images du dossier.
- Contrôlez les noms et formats des fichiers.
- Lancez le transfert sur quelques produits.
- Contrôlez la présence des fichiers côté site.
- Actualisez ensuite les articles si l’association image/produit est réalisée pendant cette opération.
Sur Shopify, la documentation indique que les fichiers sont d’abord transférés,
puis associés aux fiches lors de l’actualisation des articles.
14. Actualiser les stocks
Ouvrez Gestion du catalogue des produits > Actualisation des stocks.
| Choix | Comportement |
|---|---|
| Transfert sélectif | Transmet uniquement les produits dont le stock a changé depuis la dernière actualisation. |
| Transfert complet | Transmet le stock de tous les produits concernés. |
| Ne pas transférer les produits | N’envoie aucun stock, mais permet de réinitialiser les indicateurs internes. |
| Réinitialiser les indicateurs | Réinitialise l’état de modification du stock après l’opération. |
Procédure de test
- Choisissez un produit de test correctement associé au site.
- Relevez son stock dans KWISATZ et sur la boutique.
- Effectuez un transfert sélectif.
- Contrôlez la nouvelle quantité côté site.
- Réalisez une vente ou une régularisation de test.
- Attendez le traitement automatique ou relancez le transfert sélectif.
- Vérifiez la nouvelle quantité.
N’activez pas l’export automatique des stocks sur un ancien catalogue
avant d’avoir validé les UGS/SKU et la correspondance des produits.
15. Récupérer les commandes Web
MCOMM peut récupérer automatiquement les commandes selon la fréquence configurée. Une lecture manuelle peut également être lancée pour une période précise.
- Vérifiez que MCOMM est lancé et que la communication est active.
- Contrôlez que l’import automatique des commandes n’est pas désactivé.
- Passez une commande de test sur le site.
- Vérifiez son état de paiement et son statut.
- Attendez le prochain cycle ou lancez Lecture des commandes.
- Sélectionnez une période couvrant la date de modification de la commande.
- Contrôlez la création ou l’identification du client.
- Contrôlez les articles, quantités, prix, TVA, frais et remises.
- Contrôlez le code vendeur, le magasin et le type de document si ces valeurs sont configurées.
- Vérifiez qu’une seconde lecture ne crée pas de doublon.
Les commandes Web proviennent d’un système externe.
En cas de doute sur leur authenticité ou leur paiement, contrôlez la commande
directement sur la plateforme d’origine.
16. Récupérer les clients Web
La fonction Lecture des clients permet de récupérer les clients créés ou modifiés sur une période déterminée.
- Choisissez une période ou un nombre de jours.
- Lancez la lecture.
- Contrôlez les fiches créées ou actualisées.
- Vérifiez les doublons sur l’e-mail, le téléphone ou l’identifiant externe.
- Contrôlez la famille client appliquée.
- Vérifiez les adresses de facturation et de livraison.
Les règles de création et de fusion des clients doivent être définies avant la mise en production,
afin d’éviter plusieurs fiches pour une même personne.
17. Configurer le Click & Collect
- Configurez d’abord l’interface MCOMM.
- Ouvrez Outils > Préférences > Divers > Vente directe.
- Activez la lecture des commandes Web.
- Renseignez l’emplacement des fichiers de commandes à intégrer.
- Ajoutez la fonction 169 — Lecture commande Web au clavier tactile.
- Contrôlez le compteur des commandes en attente.
- Ouvrez la liste puis sélectionnez la commande.
- Vérifiez son contenu avant intégration dans le ticket.
Une commande en attente peut être signalée par un compteur directement sur la touche
Lecture commande Web.
Les réglages de débogage forçant la relecture de commandes sont réservés aux techniciens.
Ils ne sont pas publiés dans cette fiche afin d’éviter les doublons.
18. Gérer les traitements automatiques
La fréquence se règle dans la section Web services avec l’élément Fréquence des traitements automatiques.
- MCOMM doit rester en exécution.
- La communication doit être démarrée.
- L’ordinateur doit rester connecté à Internet.
- Les options désactivant les commandes ou les stocks doivent être vérifiées.
- Le journal doit être contrôlé régulièrement.
Si MCOMM est arrêté, les échanges automatiques cessent.
Les traitements pourront généralement être relancés manuellement après le rétablissement,
en sélectionnant une période suffisamment large pour les commandes.
19. Contrôler les journaux et erreurs
MCOMM affiche un journal des événements. Des traces supplémentaires peuvent être enregistrées dans le répertoire de logs du dossier, notamment lors des erreurs de Web Service ou de l’import des commandes.
Pour un diagnostic :
- notez la date et l’heure de l’opération ;
- identifiez le produit ou la commande concernée ;
- copiez le message complet ;
- conservez les fichiers de réponse générés ;
- comparez un élément en erreur avec un élément fonctionnel ;
- transmettez les traces au support ou au prestataire Web.
Un message renvoyé dans MCOMM peut provenir du site, du connecteur,
d’une extension ou de la base de données du CMS. Il ne prouve pas à lui seul
que MCOMM est la cause de l’incident.
20. Spécificités et limites fréquentes
WooCommerce
- contrôler l’UGS/SKU et l’EAN séparément ;
- vérifier les classes de TVA ;
- vérifier la version de l’extension KWISATZ ;
- faire intervenir le webmaster en cas de lenteur, boucle ou erreur d’administration ;
- ne pas écraser les descriptions, catégories ou attributs déjà gérés côté site sans validation.
PrestaShop
- la version du CMS et du Web Service doit être compatible ;
- certains champs KWISATZ nécessitent un développement ou module spécifique côté site ;
- la gestion de l’écotaxe présente des limites documentées et doit être testée séparément.
Shopify
- vérifier la version de MCOMM et la méthode d’authentification ;
- installer et autoriser correctement l’application Shopify ;
- ne pas saisir l’adresse de connexion à partir d’un exemple d’une autre plateforme ;
- contrôler les collections, la taxonomie et les canaux de diffusion ;
- tester les produits, images, stocks et commandes avant le catalogue complet.
Champs métier supplémentaires
La présence d’un champ dans KWISATZ ne garantit pas son affichage natif sur le site. Le CMS doit disposer du champ correspondant ou d’un plugin capable de le recevoir.
21. Diagnostic rapide
Les commandes ne remontent plus
Vérifiez que MCOMM est lancé, que la communication est démarrée,
que l’import automatique n’est pas désactivé et que le site répond.
Lancez une lecture manuelle sur une période couvrant la coupure.
Les stocks ne se mettent plus à jour
Vérifiez l’export automatique, la correspondance des produits, l’option
Gestion du stock désactivée et le journal MCOMM. Testez ensuite un transfert sélectif.
Un produit nouveau n’apparaît pas sur le site
Vérifiez la case Inclus dans la boutique Web, les identifiants, les catégories,
les indicateurs internes et le résultat d’un transfert sélectif.
Un produit existant est dupliqué
Vérifiez la clé de correspondance, l’UGS/SKU, l’EAN et l’identifiant externe.
Ne lancez pas d’autres exports avant d’avoir identifié la fiche maître.
Les images sont transférées mais non associées
Vérifiez le nom des fichiers, le transfert des images et l’actualisation
des fiches produits qui réalise l’association sur certaines plateformes.
Le site renvoie une erreur de création d’UGS/SKU
Testez la création manuelle avec la même UGS, activez les traces du connecteur
avec le prestataire Web et recherchez une incohérence ou un doublon côté CMS.
Une commande est importée avec une TVA incorrecte
Vérifiez les classes de TVA du site, les taux du dossier KWISATZ,
le pays du client et la configuration B2C ou B2B.
Les cas de TVA européennes spécifiques doivent être traités par un technicien.
Le client attend que KWISATZ crée tout le site
Expliquez que MCOMM assure les flux de données.
La création du thème, des pages, des règles de livraison et des extensions
relève du CMS et d’un prestataire Web.
22. Liste de contrôle avant mise en production
- La plateforme et la version du connecteur sont validées.
- Une sauvegarde du site est disponible.
- Les identifiants sont stockés de manière sécurisée.
- Les UGS/SKU et EAN sont contrôlés.
- Les TVA, tarifs et frais ont été testés.
- Les catégories et attributs ne risquent pas d’être écrasés.
- Quelques produits ont été envoyés en transfert sélectif.
- Les images ont été contrôlées.
- Un stock a été modifié et resynchronisé.
- Une commande de test a été récupérée sans doublon.
- Le client Web a été créé ou rapproché correctement.
- Le journal MCOMM ne contient pas d’erreur persistante.
- Le prestataire Web a validé le résultat côté site.
23. Résultat attendu
Le catalogue et les stocks sont synchronisés selon le périmètre prévu,
les commandes et clients Web sont intégrés sans doublon, et les traitements
automatiques fonctionnent avec des journaux contrôlables.
24. Sources documentaires
- Manuel et tutoriels KWISATZ — fonctionnement de WKW_MCOMM.
- Tutoriels KWISATZ — actualisation des articles et des stocks.
- Tutoriels KWISATZ — onglet Infos Web et Click & Collect.
- Suivi de développement KWISATZ — traitements automatiques et interfaces e-commerce.
- Base support KWISATZ — diagnostics PrestaShop, WooCommerce et Shopify.