Architecture des communications multi-sites

Réponse directe

Conseil technicien général

1. Repères de version

Les références de version ci-dessous sont conservées comme repères documentaires. Les menus, options et comportements doivent être contrôlés sur la version et la sérialisation réellement installées ; une évolution plus récente peut avoir modifié le fonctionnement.

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. Choisir l’architecture

Architecture classique

BACK-OFFICE CENTRAL
KWISATZ + interface de communication du back-office
        │
        ├──────── Internet / VPN ────────┐
        │                                │
FRONT-OFFICE A                    FRONT-OFFICE B
KWISATZ + interface de communication de la caisse               KWISATZ + interface de communication de la caisse
Base locale magasin A             Base locale magasin B

Chaque magasin encaisse sur sa propre base. Le siège prépare les mises à jour et consolide les informations reçues. Les échanges ne sont pas des accès directs à une base unique : ils sont exécutés par les modules de communication à intervalles réguliers.

Architecture hiérarchique

SUPER CONCENTRATEUR / SIÈGE
            │
       CONNEXION N°
            │
   CONCENTRATEUR INTERMÉDIAIRE
       interface de communication du back-office / interface de communication du back-office
        │              │
     interface de communication de la caisse A         interface de communication de la caisse B

Une architecture avec concentrateur intermédiaire peut être utilisée pour regrouper plusieurs sites, franchises ou régions. Le interface de communication du back-office intermédiaire utilise alors une connexion déterminée pour communiquer avec le concentrateur supérieur.

6. Rôle de chaque composant

7. Licences et identifiants uniques

• une licence centrale définie comme Back-Office ;
• une licence Front-Office par magasin ou caisse autonome selon le contrat ;
• les modules interfaces de communication multi-sites sérialisés pour le périmètre prévu ;
• un code de dossier cohérent sur chaque installation ;
• un code magasin unique par point de vente ;
• un numéro de caisse unique dans son périmètre ;
• un numéro de connexion unique au siège ;
• une version compatible entre les différents composants.

8. Configurer les préférences KWISATZ

Dans Outils > Préférences > Général, vérifiez les zones de communication multi-magasins.

9. Paramétrer les connexions

Chaque connexion représente une destination ou un magasin. Elle doit définir au minimum :

• numéro de connexion ;
• code et libellé du magasin ;
• dossier source et dossier destination ;
• adresse ou mode de transport ;
• périodicité des boucles ;
• données à exporter et importer ;
• filtres de produits ;
• options de conservation des valeurs locales ;
• état actif ou suspendu ;
• gestion du HeartBeat si utilisée.

Valeurs locales

Dans certaines configurations, un magasin doit conserver des informations locales au lieu de les écraser par le référentiel central. Les versions documentées proposent notamment des options de conservation pour :

• les données Dépôt/Vente ;
• les informations restauration ;
• les informations Web ou e-commerce ;
• d’autres groupes de champs selon la version.

10. Flux descendants : du siège vers les magasins

11. Flux remontants : des magasins vers le siège

• tickets de caisse et règlements ;
• mouvements de stock issus des ventes ;
• clients créés ou modifiés selon la politique ;
• documents de gestion autorisés ;
• inventaires ou résultats d’inventaire ;
• informations de fidélité prévues ;
• journaux techniques, accusés et états de traitement.

12. Actualisation des produits

Indicateur d’actualisation

La fiche produit contient un indicateur utilisé dans les configurations multi-magasins :

Chrono_MAJ

Le champ Article.Chrono_MAJ permet de sélectionner les produits modifiés sur une période précise, avec heure de modification. Il est utilisé par les exportations récentes et par l’automate -A1 -PARAM1=n.

KWISATZ.EXE -DDEMO -P1 -A1 -PARAM1=5

Cet exemple demande l’export des produits modifiés entre aujourd’hui et J-5.

Filtre par connexion

Depuis les versions récentes de la branche 3.57, le filtre ACTU_FILTRE_PRODUITS défini sur chaque connexion est réellement appliqué lors de la génération des mises à jour. Il permet de limiter les produits transmis selon le magasin ciblé.

Réduire la volumétrie

Les photos, libellés étendus et libellés catalogue sont responsables de ralentissements importants. Les modules proposent des options pour désactiver leur export lorsque ces données ne sont pas nécessaires.

13. Tickets de caisse et intégrité fiscale

Les tickets sont créés, sécurisés et chronologisés sur la caisse d’origine. La copie reçue au Back-Office est un ticket distant.

Règles essentielles

• la caisse d’origine est la source fiscale ;
• les corrections doivent être effectuées sur cette caisse ;
• la contre-passation directe d’un ticket distant est interdite dans les versions récentes ;
• la modification administrative à distance est fortement limitée ;
• la retransmission ne doit pas créer une deuxième copie logique ;
• la séquence doit être contrôlée par caisse et période.

Contrôle des séquences

Accès : Outils > Recalculs/Contrôles > Contrôle des séquences de tickets, selon la version.

1. Choisissez tickets distants.
2. Renseignez la période.
3. Renseignez le numéro de caisse.
4. Lancez le contrôle.
5. Enregistrez la liste des ruptures.
6. Vérifiez que les tickets existent sur le site source.
7. Demandez leur réexpédition.
8. Refaites le contrôle après intégration.

Demande de réexpédition

Accès : Outils > Transfert de données > Demande de réexpédition des tickets. Renseignez la connexion et la période à retransmettre.

14. Documents commerciaux et inventaires

Le tableau de bord des connexions permet d’envoyer un ordre au module pour exporter :

• les grilles ;
• les clients ;
• les fournisseurs ;
• les tickets de caisse ;
• les documents commerciaux ;
• les historiques clients ;
• les inventaires en préparation.

Export des documents

L’automate -A30 déclenche l’export des documents de gestion. La version interactive permet de sélectionner les types et la période. L’option -SA sélectionne selon la date de modification plutôt que la date de valeur.

KWISATZ.EXE -DDOSSIER -P99 -A30 -J1 -SA

15. Automates utiles

16. Surveillance des modules

Depuis KWISATZ

Dans les préférences, la section Module d’actualisation interfaces de communication multi-sites propose :

• Lancement automatique : démarre le module à l’ouverture du dossier s’il est absent ;
• Activer la surveillance : contrôle périodiquement sa présence ;
• Fréquence en minutes : définit la fréquence du contrôle.

Tableau de bord des connexions

La fenêtre permet de visualiser l’état des connexions magasins et de demander les exports ou l’arrêt du module.

HeartBeat

Le HeartBeat permet aux interface de communication de la caisse de signaler leur présence au interface de communication du back-office. Le port documenté par défaut est 12007. Le tableau de bord du interface de communication du back-office affiche la date et l’heure du dernier signal reçu pour chaque module connecté.

Commandes locales

Certaines installations utilisent un port local dédié aux ordres envoyés par KWISATZ aux modules, historiquement documenté autour de 6202. Vérifiez la valeur réelle dans la configuration et n’ouvrez pas ce port sur Internet.

Veille et redémarrage

Les modules peuvent utiliser des tranches horaires de veille. Vérifiez qu’ils en sortent correctement. Les versions récentes ont reçu des ajustements pour les boucles longues, les commandes et le redémarrage automatique.

17. Réseau et sécurité

Recommandations

• utiliser un VPN site-à-site ou une solution de transport chiffrée ;
• attribuer des adresses stables aux équipements ;
• n’autoriser que les flux et destinations nécessaires ;
• ne jamais partager les dossiers de données moteur de données sur Internet ;
• protéger les comptes et mots de passe de communication ;
• journaliser les connexions et échecs ;
• séparer les ports d’administration des utilisateurs ordinaires ;
• mettre à jour Windows et tous les composants KWISATZ ;
• prévoir une connexion de secours pour le siège ;
• conserver des sauvegardes locales dans chaque site et au siège.

18. Sauvegardes et continuité

Chaque Front-Office

• sauvegarde quotidienne de la base locale ;
• contrôle de l’espace disque ;
• conservation des fichiers en attente ;
• procédure de reprise après panne du poste ;
• interdiction de réinstaller sans récupérer les tickets non transmis.

Back-Office

• sauvegarde de la base consolidée ;
• sauvegarde des paramètres interface de communication du back-office et connexions ;
• conservation des journaux et fichiers d’échange ;
• test de restauration sur un environnement séparé ;
• surveillance des files et séquences de tickets.

19. Recette avant mise en production

1. Créer une connexion pilote.
2. Vérifier le code magasin et le numéro de caisse.
3. Envoyer une grille nouvelle.
4. Envoyer un produit nouveau.
5. Modifier son prix et le réexporter.
6. Tester un article « jamais actualisé ».
7. Tester un filtre produit par connexion.
8. Envoyer un stock ciblé.
9. Créer et modifier un client.
10. Créer un ticket dans le magasin.
11. Contrôler sa remontée et son origine.
12. Créer plusieurs règlements sur le ticket.
13. Tester une coupure réseau pendant plusieurs ventes.
14. Rétablir la liaison et vérifier la reprise.
15. Demander la réexpédition d’une période.
16. Contrôler les séquences au siège.
17. Tester un document commercial.
18. Tester l’inventaire en préparation.
19. Contrôler le HeartBeat et le tableau de bord.
20. Tester l’arrêt et le redémarrage du module.

20. Diagnostic rapide

21. Actions à éviter

• attribuer le même code magasin à deux sites ;
• copier une base de caisse sans traiter les tickets non transmis ;
• modifier un ticket distant depuis le siège ;
• réimporter toute une période sans contrôle des doublons ;
• réinitialiser les indicateurs d’actualisation avant validation des magasins ;
• envoyer les produits avant leurs nouvelles grilles ;
• appliquer un filtre produit non testé à toutes les connexions ;
• confondre module ouvert et module opérationnel ;
• exposer les ports de communication sans VPN ni filtrage ;
• arrêter un module en cours de traitement sans conserver son journal ;
• supprimer manuellement un fichier d’attente sans identifier son contenu ;
• mettre à jour seulement interface de communication du back-office ou seulement interface de communication de la caisse sans recette de compatibilité.

22. Liste de contrôle

• Les rôles Back-Office et Front-Office sont définis.
• Chaque magasin et caisse possède un identifiant unique.
• Les numéros de connexion sont documentés.
• interfaces de communication multi-sites utilisent des versions compatibles.
• Les codes dossiers sont corrects.
• Le réseau est chiffré et filtré.
• Les grilles sont envoyées avant les produits.
• Les filtres produits sont testés par magasin.
• Les valeurs locales à conserver sont identifiées.
• Les tickets remontent avec la bonne caisse.
• Le contrôle des séquences est planifié.
• La réexpédition des tickets est testée.
• Le HeartBeat et la surveillance sont actifs.
• Les logs sont contrôlés quotidiennement.
• Les sauvegardes locales et centrales sont vérifiées.
• La procédure de coupure réseau est connue des magasins.

23. Évolutions documentées

24. Sources documentaires

• MENUS_KWISATZ — Préférences générales, types de connexion et magasin local.
• MENUS_KWISATZ — Tableau de bord des connexions et transfert de données.
• MENUS_KWISATZ — indicateurs d’actualisation des articles et contrôle des séquences de tickets.
• Liste des automates KWISATZ — A1, A2, A3, A9, A30, A40 et option VSS.
• Suivi de développement KWISATZ — Chrono_MAJ, filtres par connexion, HeartBeat, connexions jusqu’à 99 et protections des tickets distants.
• Suivi de développement KWISATZ — optimisations d’export, commandes, veille et redémarrage des modules.