Commandes Web, Click & Collect, livraisons et tickets en attente

Réponse directe

Conseil technicien général

1. Nature des fonctions KWISATZ citées

Une fonction de consultation, de correction, financière, de périphérique ou de sélection n’a pas le même effet. Les fonctions citées ci-dessous restent limitées au comportement documenté.

2. 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.

3. 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.

4. Protection des données

5. Comprendre l’architecture

Site e-commerce
      │
      ▼
WKW_MCOMM
      │
      ├─ Webservice natif
      ├─ Fichiers XML locaux
      └─ Fichiers XML distants via FTP/SFTP
      │
      ▼
Dossier d’échange / données de commande
      │
      ▼
Vente directe KWISATZ
      │
      ├─ 169 : intégration manuelle
      └─ 202 : mise en attente automatique
      │
      ▼
Ticket en attente
      │
      ├─ préparation
      ├─ retrait en magasin
      └─ livraison à domicile
      │
      ▼
Ticket final et règlements

Trois méthodes documentées

6. Prérequis

• WKW_MCOMM est installé et correctement sérialisé ;
• la plateforme e-commerce est configurée ;
• la méthode de lecture des commandes est définie ;
• le dossier XML ou le webservice est accessible ;
• les articles Web correspondent à des articles KWISATZ ;
• les TVA, prix et unités sont cohérents ;
• les frais de livraison disposent d’un traitement défini ;
• les clients peuvent être identifiés ou créés selon la procédure ;
• les fonctions 121, 122, 168 et 169 sont accessibles ;
• la fonction 202 est utilisée seulement après recette ;
• les imprimantes de ticket, production ou cuisine sont testées ;
• une procédure d’annulation et de remboursement existe ;
• les sauvegardes et journaux sont disponibles.

7. Configurer la réception dans WKW_MCOMM

Méthode de lecture

Dans la section relative aux bons de commande ou commandes, sélectionnez la méthode utilisée :

1. webservice natif ;
2. lecture de fichiers XML locaux ;
3. lecture de fichiers XML distants via FTP ou SFTP.

Fichiers XML locaux

• utiliser le format XML attendu par l’interface générique ;
• définir un répertoire exclusivement réservé aux commandes ;
• accorder les droits en lecture, écriture, renommage et suppression ;
• éviter les dossiers synchronisés par plusieurs services concurrents ;
• contrôler l’encodage et les caractères spéciaux XML ;
• archiver les fichiers rejetés hors du dossier actif.

FTP / SFTP

Les zones documentées comprennent notamment : adresse, utilisateur, mot de passe, mode passif, chemin racine et utilisation de SSH/SFTP.

Intégrer sous forme de

8. Configurer KWISATZ pour les ECommandes

Accès : Outils > Préférences > Divers > Vente directe > Gestion des ECommandes.

Détection

Les versions historiques surveillaient le dossier à intervalles réguliers, signalaient l’arrivée d’une commande par un son et mettaient à jour le compteur de la fonction 169.

Son d’arrivée

Le fichier Son_Commande_Web.Wav a été utilisé dans les développements documentés. Vérifiez sa présence et la sortie audio du poste si le compteur augmente sans alerte sonore.

9. Fonction 169 — Lecture commande Web

La fonction 169 :

• affiche sur son bouton le nombre de commandes Web en attente ;
• récupère une commande dans le ticket en cours ;
• traite les commandes une par une ;
• reprend généralement la plus ancienne commande disponible ;
• alimente les articles et informations associées ;
• permet ensuite la mise en attente ou la finalisation.

Procédure manuelle

1. Vérifiez que le ticket en cours est vide.
2. Notez le compteur affiché sur la touche 169.
3. Appuyez une seule fois sur la touche.
4. Attendez le chargement complet.
5. Contrôlez le numéro Web et le client.
6. Contrôlez les lignes, commentaires et options.
7. Contrôlez la livraison et le paiement.
8. Mettez le ticket en attente pour préparation ou finalisez-le.
9. Vérifiez que le compteur diminue.

10. Fonction 202 — Mode automatique

202 — Lecture commande Web, mode automatique (On/Off) fonctionne comme une bascule.

Avantages

• aucune intervention nécessaire à chaque arrivée ;
• préparation plus rapide ;
• commandes disponibles dans la liste des tickets en attente ;
• réduction du risque d’oubli lorsque l’activité est forte.

Risques

• commandes intégrées avant correction d’un mauvais paramétrage ;
• multiplication rapide des doublons ;
• impressions de préparation inutiles ;
• erreurs de prix ou TVA propagées sans contrôle ;
• tickets en attente difficiles à identifier si les commentaires sont insuffisants.

11. Comprendre les tickets en attente

Un ticket en attente conserve les ventes sans produire encore le ticket de caisse définitif. Il peut être préparé puis rappelé.

Mode simple ou multiple

Compteur

Depuis les versions documentées de 2023, le bouton associé à la fonction 121 peut afficher le nombre de tickets en attente. Sur un réseau, les tickets des autres postes sont actualisés périodiquement.

Insertion dans un ticket déjà ouvert

Le centre d’encaissement peut proposer :

• Jamais ;
• Toujours avec demande de confirmation ;

Réaffectation au vendeur actif

Le centre peut également proposer :

• Jamais ;
• Toujours avec avertissement ;
• Toujours sans avertissement.

12. Fonction 121 — Rappel ticket en attente

La fonction 121 affiche la liste des tickets en attente.

Paramètre livreur

121 -LI[CODE_LIVREUR]

Le paramètre -LI limite la liste aux tickets affectés au livreur indiqué.

Méthodes de sélection

• choix dans la liste ;
• recherche par commentaire ou colonne visible ;
• filtre livreur ;
• lecture d’un code-barres de rappel selon la configuration ;
• numéro de caisse et de ticket pour les environnements multi-postes.

Contrôles avant rappel

1. Comparer le numéro Web.
2. Comparer le nom du client.
3. Comparer le mode retrait ou livraison.
4. Comparer la date et l’heure prévues.
5. Comparer le montant total.
6. Vérifier le statut prépayé.
7. Vérifier que la commande n’a pas déjà été remise.

13. Fonction 122 — Mettre un ticket en attente

Commentaire recommandé

Utilisez un format court et stable :

WEB 54821 | DUPONT | RETRAIT 17:30
WEB 54822 | MARTIN | LIVRAISON | LVR03

N’inscrivez pas de mot de passe, numéro de carte ou information inutile dans ce commentaire.

Impression

L’impression à la mise en attente peut servir de bon de préparation. Contrôlez toutefois que les cuisines, ateliers ou rayons ne reçoivent pas plusieurs impressions lors des rappels et corrections.

14. Fonction 168 — Informations de livraison

La fonction 168 — Saisie des informations de livraison ouvre une fenêtre contenant notamment :

• le livreur ;
• le client ;
• la date prévue ;
• l’heure prévue ;
• le mode de retrait ou livraison.

Modes documentés

Indicateur technique

Le champ documenté TICKET_ENTETE.RESA_LIVRAISON distingue notamment :

• 0 : retrait en magasin, valeur par défaut ;
• 1 : livraison à domicile.

Livreurs

Les livreurs sont gérés dans la table des vendeurs avec l’indicateur Livreur. Le ticket mémorise le code du livreur affecté.

15. Préparer la commande

Bon de préparation

Le ticket en attente ou les tickets de production peuvent présenter :

• le numéro de e-commande ;
• le client ;
• la date et l’heure ;
• le type de retrait ;
• le livreur ;
• les articles et quantités ;
• les composants de menus ;
• les suppléments et commentaires ;
• le statut déjà payé ou non réglé ;
• les frais de livraison.

Imprimantes

Les articles peuvent être dirigés vers des imprimantes de production ou de cuisine. Testez particulièrement :

• les articles de type menu ;
• les composants ;
• les suppléments payants ;
• les commentaires ;
• les quantités négatives ou annulations ;
• les reprises après coupure.

Organisation physique

1. Attribuez un numéro ou un emplacement de préparation.
2. Associez le ticket imprimé au colis.
3. Vérifiez les produits sensibles, frais ou pesés.
4. Marquez la commande prête dans le processus interne.
5. Rangez-la dans une zone contrôlée.
6. Ne validez pas fiscalement le ticket avant le moment prévu par la procédure.

16. Commandes prépayées et reste à payer

Les versions récentes renseignent dans le ticket des informations spécifiques à la commande Web :

Contrôle

Reste à encaisser
= Total KWISATZ validé
- Montant Web déjà payé
- Autres règlements ou acomptes repris

Cas usuels

• commande entièrement payée : ne pas redemander le total ;
• commande partiellement payée : encaisser uniquement le reste ;
• paiement annoncé mais non confirmé : vérifier la plateforme avant validation ;
• prix modifié en magasin : appliquer la procédure d’écart ou remboursement ;
• commande annulée après paiement : traiter le remboursement sur la plateforme et dans KWISATZ de façon cohérente.

17. Frais de livraison et TVA

Le format Click & Collect documenté peut transmettre :

Contrôles

• le total transmis correspond au site ;
• le produit de frais existe et est vendable ;
• le code TVA est valide ;
• le HT, la TVA et le TTC sont cohérents ;
• les frais ne sont pas ajoutés deux fois ;
• le remboursement d’une commande traite aussi les frais selon la politique applicable.

18. Finaliser un retrait en magasin

1. Demandez le numéro de commande ou l’identité du client.
2. Utilisez la fonction 121 ou scannez le code de rappel.
3. Comparez le numéro Web et le nom.
4. Vérifiez que le colis correspond au ticket.
5. Contrôlez le statut prépayé et le reste dû.
6. Ajoutez les modifications autorisées si nécessaire.
7. Encaissez uniquement le solde.
8. Validez et imprimez le ticket final.
9. Remettez la commande.
10. Classez ou détruisez le bon de préparation selon la procédure.

Pièce d’identité

Ne demandez une pièce d’identité que si la procédure, la valeur ou la nature du retrait le justifie. Ne copiez pas le document sans nécessité et base légale.

19. Finaliser une livraison à domicile

Avant départ

• adresse et téléphone contrôlés ;
• date et créneau confirmés ;
• livreur affecté ;
• commande complète ;
• statut payé ou montant à encaisser connu ;
• moyen de paiement mobile disponible si nécessaire ;
• produits frais ou réglementés préparés selon la procédure.

Fonction 121 filtrée

Une touche 121 -LI[CODE_LIVREUR] peut afficher uniquement les tickets affectés à un livreur.

À la remise

1. Vérifiez le destinataire.
2. Remettez les produits.
3. Encaissez le solde réel si nécessaire.
4. Conservez la preuve de livraison prévue par l’entreprise.
5. Finalisez le ticket selon l’organisation du site.
6. Signalez immédiatement un refus, une absence ou un paiement impossible.

20. Annuler, modifier ou rembourser une commande Web

Avant intégration en caisse

Annulez ou corrigez de préférence dans la plateforme, puis vérifiez que la commande ne sera pas transmise.

Après mise en attente

1. Retrouvez le ticket exact.
2. Vérifiez s’il est prépayé.
3. Annulez le ticket en attente selon la procédure.
4. Rangez le fichier ou statut Web en cohérence.
5. Remboursez le paiement en ligne si nécessaire.
6. Annulez les impressions ou la préparation.
7. Contrôlez les stocks réservés ou préparés.

Après validation du ticket final

Utilisez les procédures normales de retour, remboursement ou contre-passation. Ne supprimez pas le ticket validé.

Historique des fichiers

Certaines interfaces historiques renommaient temporairement un XML en .SAV, l’effaçaient après solde ou le déplaçaient dans un dossier Annulation. Le comportement actuel doit être vérifié dans l’interface installée.

21. Prévenir les doubles intégrations

Clé de contrôle

Utilisez en priorité le numéro de e-commande, complété par la plateforme, le magasin et la date.

Avant une relance manuelle

1. Rechercher le numéro dans les tickets en attente.
2. Rechercher le numéro dans les tickets validés.
3. Rechercher un bon de commande ou une facture importée.
4. Contrôler le journal MCOMM.
5. Contrôler le statut sur la plateforme.
6. Conserver une copie du fichier avant toute manipulation.

Balise de débogage

La balise non documentée WKW_MCOMM_COMMANDES_FORCER_LECTURE=1 force la lecture des commandes sans tenir compte du statut KWISATZ_OK et ne modifie pas ce statut après lecture.

Autres causes de doublon

• deux instances MCOMM sur le même compte ;
• webservice et XML actifs simultanément ;
• fichier recopié dans le dossier actif après traitement ;
• restauration d’une sauvegarde sans nettoyage du dossier d’échange ;
• commande intégrée en document puis en ticket ;
• statut plateforme non mis à jour après coupure ;
• lecture automatique laissée active pendant les tests.

22. Données techniques utiles au diagnostic

23. Sécurité, données clients et disponibilité

• limiter les droits du compte MCOMM ;
• utiliser HTTPS, SFTP ou VPN selon l’architecture ;
• protéger les identifiants d’API et de transfert ;
• restreindre les droits NTFS du dossier XML ;
• ne pas exposer le partage Windows sur Internet ;
• journaliser les récupérations et erreurs ;
• séparer les dossiers Production et Test ;
• protéger les exports contenant les coordonnées clients ;
• prévoir une procédure lors d’une panne Internet ;
• sauvegarder les données et conserver temporairement les fichiers rejetés.

Données personnelles

Une commande peut contenir nom, adresse, email, téléphone, commentaire de livraison et historique d’achat. N’imprimez et ne transmettez que les informations nécessaires.

24. Suivi opérationnel conseillé

Revue quotidienne

1. Comparer les commandes du site et les commandes reçues.
2. Examiner les tickets en attente anciens.
3. Contrôler les commandes prépayées non finalisées.
4. Contrôler les livraisons non remises.
5. Traiter les fichiers rejetés.
6. Rapprocher les paiements Web.
7. Archiver les anomalies et décisions.

25. Recette avant mise en production

1. Créer une commande simple d’un article.
2. Créer une commande de plusieurs lignes.
3. Tester un menu avec composants et suppléments.
4. Tester un commentaire article et un commentaire de commande.
5. Tester un client existant.
6. Tester un nouveau client.
7. Tester le retrait en magasin.
8. Tester la livraison à domicile.
9. Tester l’affectation d’un livreur.
10. Tester une commande non payée.
11. Tester une commande entièrement prépayée.
12. Tester une commande partiellement payée.
13. Tester les frais de livraison et leur TVA.
14. Intégrer manuellement avec la fonction 169.
15. Vérifier le compteur avant et après lecture.
16. Mettre en attente avec commentaire.
17. Rappeler avec la fonction 121.
18. Rappeler avec un filtre livreur.
19. Tester le code-barres de rappel.
20. Tester le mode automatique 202.
21. Tester l’insertion dans un ticket déjà ouvert.
22. Tester la réaffectation au vendeur actif.
23. Annuler avant intégration.
24. Annuler après mise en attente.
25. Retourner une commande déjà finalisée.
26. Simuler une coupure Internet ou FTP.
27. Remettre le même XML et vérifier l’anti-doublon.
28. Comparer stocks, TVA, règlements et plateforme.

26. Diagnostic rapide

27. Actions à éviter

• activer le mode automatique avant la recette manuelle ;
• utiliser deux méthodes de lecture pour les mêmes commandes ;
• forcer la lecture sans rechercher les numéros déjà intégrés ;
• relire un XML copié depuis les archives ;
• intégrer une commande dans un ticket non vide ;
• réencaisser une commande Web prépayée ;
• corriger le statut directement en base ;
• laisser FTP non chiffré ou un partage Windows exposé ;
• mettre les identifiants API dans un commentaire ;
• annuler seulement dans un des deux systèmes ;
• valider une commande livrée avant la preuve réelle de remise ;
• supprimer les fichiers rejetés avant analyse.

28. Liste de contrôle

• La plateforme et le magasin cible sont identifiés.
• Une seule méthode récupère chaque commande.
• Le dossier XML ou webservice est opérationnel.
• La fonction 169 affiche un compteur cohérent.
• Le mode 202 a été testé avant activation.
• Les commandes sont identifiées par leur numéro Web.
• Les tickets en attente portent un commentaire utile.
• L’insertion et la réaffectation vendeur sont maîtrisées.
• Le retrait et la livraison sont distingués.
• Le livreur, la date et l’heure sont renseignés.
• Les menus, suppléments et commentaires sont imprimés.
• Les frais de livraison et TVA sont contrôlés.
• Le statut prépayé et le montant payé sont contrôlés.
• Le client ne règle que le reste dû.
• Les annulations sont répercutées dans les deux systèmes.
• Les doublons sont recherchés avant toute relecture.
• Les journaux et fichiers rejetés sont conservés temporairement.
• Les données clients et identifiants techniques sont protégés.

29. Évolutions KWISATZ documentées

30. Sources documentaires

• MENUS_KWISATZ — fonctions 121, 122, 168, 169 et 202.
• MENUS_KWISATZ — préférences Vente directe, Gestion des ECommandes.
• LesFonctionsDeCaisses — paramètres des tickets en attente, livreurs et commandes Web.
• Tutoriels KWISATZ — configuration Click & Collect et gestion des informations de livraison.
• Suivi de développement KWISATZ — méthodes MCOMM, XML, FTP/SFTP, prépaiements, frais, compteurs, codes-barres et corrections.
• Base de connaissance support — diagnostic des interfaces MCOMM, fichiers et communications.