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

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