Guide Synchronisation¶

La synchronisation est le mécanisme central de Caisse-Connect : elle importe les produits depuis votre caisse, met à jour les prix et les stocks, et exporte les commandes vers la caisse.

Deux modes de synchronisation¶

Synchronisation automatique¶

Caisse-Connect synchronise automatiquement vos données à intervalles réguliers, sans aucune intervention de votre part. La synchronisation automatique est déclenchée par le module installé sur le poste de caisse (mis en place par votre administrateur) : c'est le poste de caisse qui appelle régulièrement votre site, pas l'inverse. Si le poste est éteint, la synchronisation ne tourne pas — c'est ce que surveille l'alerte « plus de synchro » (voir plus bas).

À chaque synchronisation automatique, Caisse-Connect enchaîne les étapes suivantes :

Vérification de la connexion à la caisse
Mise à jour des catégories
Synchronisation des produits
Export des commandes vers la caisse
Récupération et appariement des factures

Interruptions

Si une synchronisation automatique est interrompue (l'hébergeur limite la durée d'un traitement à quelques minutes), elle s'arrête proprement. Le bandeau de statut passe alors au rouge avec la date et l'heure de l'interruption ; la synchronisation suivante reprend le travail, et vous pouvez relancer une synchronisation manuelle à tout moment.

Collisions de codes

Si plusieurs produits de la caisse partagent le même code (SKU), la synchronisation continue mais un email récapitulatif signale les collisions détectées (au plus toutes les 8 heures), pour correction dans la caisse.

Synchronisation manuelle¶

La synchronisation manuelle se lance depuis le bandeau de statut (bouton vert en haut de chaque page Caisse-Connect) ou depuis le tableau de bord.

Une fenêtre affiche la progression en 7 étapes :

Étape	Description
1. Vérification connexion	Test de communication avec la caisse
2. Synchronisation TVA	Mise à jour des taux de TVA depuis la caisse
3. Initialisation session	Préparation de la session de synchronisation
4. Traitement par paquets	Import des produits par lots (barre de progression)
5. Statistiques finales	Bilan de la synchronisation (créés, mis à jour, archivés)
6. Libération verrou	Finalisation de la synchronisation
7. Terminé	Résumé final

La taille des paquets est configurable (défaut : 50 produits par lot).

Vérification de connexion et surveillance¶

Un test périodique vérifie que la caisse est joignable. La fréquence est configurable de 5 à 60 minutes (ou « Jamais »).

Résultat	Comportement
Connexion OK	Bandeau de statut vert, synchronisations possibles
Connexion KO	Bandeau rouge, email d'alerte envoyé (avec limitation à 1 par heure pour éviter le spam), synchronisations bloquées

Le test peut aussi être relancé manuellement en cliquant sur le bouton de statut dans le bandeau.

Alerte « plus de synchro » (surveillance du poste de caisse)¶

La connexion peut être bonne alors que le poste de caisse ne déclenche plus la synchronisation (poste éteint, tâche planifiée désactivée, clé de sécurité incorrecte). Un délai d'alerte configurable surveille ce silence : au-delà, le bandeau le signale et un email précise la cause à corriger. Réglage dans Configuration > Caisse, carte « Contrôle des connexions avec la caisse ».

Suspendre les échanges¶

Deux interrupteurs (Configuration > Caisse) permettent de suspendre volontairement les échanges :

Suspendre toute connexion avec la caisse : coupe la synchronisation automatique et le test périodique de connexion (posé automatiquement à la toute première installation, à lever après configuration) ;
Désactiver la synchronisation des produits : gèle uniquement la remontée des produits, commandes et factures — le test de connexion reste actif.

Dans les deux cas, la synchronisation manuelle reste possible.

Verrou de synchronisation¶

Le verrou empêche que deux synchronisations s'exécutent en même temps, ce qui pourrait fausser les données.

Type de synchronisation	Durée maximale
Synchronisation automatique	15 minutes
Synchronisation manuelle	45 minutes
Mise à jour des catégories	10 minutes

Si une synchronisation est déjà en cours, toute nouvelle tentative est refusée avec un message explicatif.

Le verrou est automatiquement libéré :

À la fin normale de la synchronisation
En cas d'interruption de la synchronisation
Automatiquement après la durée maximale indiquée ci-dessus (par sécurité)
Manuellement via le bouton dans la fenêtre de synchronisation

Libération manuelle

Ne libérez le verrou manuellement que si vous êtes certain qu'aucune synchronisation n'est réellement en cours. Une libération prématurée pourrait provoquer un conflit si la synchronisation précédente n'est pas terminée.

Alerte de blocages consécutifs¶

Si la synchronisation automatique est bloquée 3 fois de suite par un verrou déjà actif (par exemple une synchronisation manuelle très longue ou un verrou non libéré), un email d'alerte est envoyé à l'administrateur. Ce mécanisme permet de détecter les situations où le verrou resterait bloqué de manière prolongée.

Le compteur de blocages consécutifs se réinitialise automatiquement dès qu'une synchronisation réussit à acquérir le verrou, ou après 6 heures d'inactivité.

Priorités caisse / site¶

Pour chaque type d'information, vous définissez qui a la priorité lors de la synchronisation :

Champ	Priorité caisse	Priorité site
Nom	Le nom caisse écrase le nom site	Le nom modifié dans CC est conservé
Prix	Le prix caisse écrase le prix site	Le prix modifié dans CC est conservé
Prix promo	La promo caisse écrase la promo site	La promo modifiée dans CC est conservée
Poids	Le poids caisse écrase le poids site	Le poids modifié dans CC est conservé
Stock	Le stock caisse écrase le stock site	Le stock modifié dans CC est conservé
Description courte	La description courte caisse écrase celle du site	La description courte modifiée dans CC est conservée
Description longue	La description longue caisse écrase celle du site	La description longue modifiée dans CC est conservée
Fournisseur	Le fournisseur caisse écrase celui du site	Le nom de fournisseur modifié dans CC est conservé
Marque	La marque caisse écrase celle du site	Le nom de marque modifié dans CC est conservé

Stratégie recommandée

Pour la plupart des commerçants, il est recommandé de laisser la priorité caisse pour le nom, le prix et le stock (qui sont gérés dans la caisse), et de passer en priorité site pour les descriptions (enrichies par l'IA ou manuellement dans CC).

La configuration des priorités se fait dans Paramètres > Synchronisation.

Unité et quantité par article

L'unité de mesure et la quantité par article ne font pas partie des priorités : ce sont des données toujours pilotées par la caisse, jamais modifiables depuis le site.

Stock en ligne : comptage physique et ventes en cours¶

Le stock affiché en ligne n'est pas la copie brute du stock de la caisse : Caisse-Connect y applique deux corrections automatiques.

L'écart de comptage physique. Beaucoup de stocks de caisse dérivent avec le temps (réapprovisionnements non saisis, inventaires espacés). Quand vous saisissez un comptage physique dans la fenêtre stock de l'éditeur mobile, Caisse-Connect mémorise l'écart entre votre comptage et le stock de la caisse, et réapplique cet écart à chaque synchronisation. Le stock en ligne reste juste même si la caisse ne l'est pas ; l'écart n'évolue qu'au comptage suivant.
Les ventes web en cours. Entre le paiement d'une commande en ligne et sa facturation par la caisse, la caisse n'a pas encore décompté les articles vendus. Ces quantités « en transit » sont déduites du stock en ligne pour éviter de revendre des articles déjà partis.

En résumé : stock en ligne = stock caisse + écart de comptage − ventes web en cours.

Produits gérés au poids (vendus par unité en ligne)¶

Certains produits sont gérés au poids dans la caisse (vrac, fromage à la coupe…) mais vendus par unité sur le site (un sachet, une part). Caisse-Connect fait la conversion automatiquement :

Le conditionnement web (réglé dans la fiche produit mobile) indique le poids d'une unité vendue en ligne — par exemple 0,5 kg pour un sachet.
À chaque synchronisation, le stock de la caisse (en kilos) est converti en unités entières pour le site : stock en ligne = stock caisse ÷ conditionnement, arrondi à l'unité inférieure.
Le prix affiché sur le site est celui de l'unité vendue, et non le prix au kilo de la caisse : pour un sachet de 0,5 kg à partir d'un produit à 6,00 €/kg, le client voit 3,00 € l'unité. Le prix suit automatiquement le conditionnement.
Le comptage physique dans la fenêtre stock de l'éditeur mobile se saisit toujours au poids (comme vous comptez en rayon) ; la conversion en unités est affichée pendant la saisie.
Lors d'une commande, la caisse reçoit le poids réel vendu (quantité × conditionnement), pour que son stock reste juste et que le montant corresponde exactement à celui payé par le client.

Si le conditionnement change, le prix et le stock en ligne sont recalculés immédiatement.

Seuil de rupture de stock¶

Le seuil de rupture est une marge de sécurité : quand le stock en ligne d'un produit descend au niveau (ou en dessous) de son seuil, le produit est retiré de la vente en ligne, même s'il reste des unités. Il revient en vente dès que son stock repasse au-dessus.

Le seuil s'exprime en unités vendues en ligne et se règle à trois niveaux qui s'héritent (du plus spécifique au plus général) :

Par produit — fenêtre stock de l'éditeur mobile, ou action groupée du tableau des produits
Par catégorie — fenêtre d'édition d'une catégorie (s'applique aussi aux sous-catégories)
Global — carte « Seuil de rupture de stock » de Paramètres > Synchronisation

La valeur 0 posée sur un produit ou une catégorie signifie « pas de seuil » et neutralise le niveau supérieur. Détails dans Paramètres > Synchronisation.

Produits composés (agrégats et packs)¶

Caisse-Connect détecte automatiquement les produits composés depuis la caisse et les importe avec leurs composants.

Types de produits composés¶

Type	Description	Exemple
Pack	Un seul produit unitaire en quantité multiple	Carton de 6 bouteilles de vin
Agrégat	Plusieurs produits différents assemblés	Coffret gourmand (confiture + miel + biscuits)

Stock¶

Le stock d'un produit composé est calculé automatiquement à chaque synchronisation. Il correspond au minimum de stock réalisable avec les composants disponibles :

Stock = min(stock_composant / quantite_composant) pour chaque composant.

Par exemple, pour un coffret contenant 2 confitures et 1 miel :

Confitures en stock : 10 → 10 / 2 = 5 coffrets
Miel en stock : 3 → 3 / 1 = 3 coffrets
Stock du coffret = 3

Stock non modifiable

Le stock d'un produit composé ne peut pas être modifié manuellement (ni depuis l'interface mobile, ni depuis les actions groupées). Il est recalculé à chaque synchronisation.

Stock des composants lors des commandes¶

Lorsqu'un client achète un produit composé, le stock de chaque composant est automatiquement décrémenté au moment du paiement :

Pour un coffret contenant 2 confitures et 1 miel, si le client en achète 3 : 6 confitures et 3 miels sont débités du stock.
En cas d'annulation de la commande, le stock des composants est intégralement restauré.
En cas de remboursement partiel (par exemple 1 coffret sur 3), le stock des composants est restauré proportionnellement.

Ce mécanisme fonctionne en coordination avec la synchronisation : les quantités en transit (commandées mais pas encore facturées par la caisse) sont prises en compte pour éviter que la synchro écrase les mouvements de stock.

Poids¶

Le poids d'un produit composé est déterminé dans cet ordre :

Poids fourni par la caisse (s'il est renseigné et > 0)
Calcul depuis les composants : somme des poids de chaque composant × sa quantité

Expédition¶

Un produit composé est marqué comme expédiable uniquement si :

Le produit composé lui-même a une classe d'expédition et un poids
Tous ses composants sont eux-mêmes expédiables

Au moment du calcul des colis (packing), les produits composés sont éclatés en leurs composants individuels, sauf si la classe du produit est marquée auto-emballée (coffret pré-emballé expédié dans son emballage d'origine).

Restriction : pas de composés imbriqués¶

Un produit composé ne peut pas contenir un composant qui est lui-même un produit composé. Si c'est le cas, le produit parent est automatiquement bloqué en publication (il apparaît dans l'onglet Impubliables). Cette restriction garantit la cohérence du calcul de stock et du packing.

Cycle de vie d'un produit¶

Un produit passe par différents états au fil de sa vie dans Caisse-Connect :

Creation (1ere synchro)
    |
    v
Impubliable (si fiche incomplete)
    |
    v
En vente (fiche complete, criteres remplis)
    |
    v
Mise a jour periodique (synchros suivantes)
    |
    +---> En sommeil (retrait temporaire)
    |
    +---> Exclu (exclusion volontaire de la vente web)
    |
    +---> Archive (categorie supprimee ou reorganisee)

Création : le produit est importé lors de la première synchronisation. Il reste impubliable (en attente, invisible des clients) tant que sa fiche n'est pas complète
En vente : le produit est publié sur le site quand tous les critères obligatoires de complétude sont remplis
Mise à jour : à chaque synchronisation, les informations sont mises à jour selon les priorités définies
En sommeil : le produit est temporairement retiré (il reste en base mais n'est plus visible)
Exclu : le produit est volontairement exclu de la vente en ligne
Archivé : le produit est archivé suite à un changement de taxonomie qui a supprimé sa catégorie

Configuration¶

Réglage	Emplacement
Priorités caisse/site	Paramètres > Synchronisation
Critères de complétude	Paramètres > Synchronisation
Seuil de rupture global	Paramètres > Synchronisation
Taille des paquets, fréquences, contrôle des connexions	Configuration (rôle Configurateur)