màj wiki avec retour MES lot-5 AD

2026-05-20 09:41:27 +02:00
commit 23eb3f3c84
4106 changed files with 469381 additions and 0 deletions
@@ -0,0 +1,133 @@
+# Les poids
+
+> Source : [Confluence EasyWMS France](https://easywmsfrance.atlassian.net/wiki/spaces/EF/pages/3001587367937)
+> Dernière mise à jour : 27/02/2026 (v3)
+
+---
+
+## 1. Vue d'ensemble
+
+Le WMS gère plusieurs types de poids au niveau du **support (conteneur)** et des **lignes de stock**, pour contrôler la cohérence des marchandises, détecter les écarts et piloter les processus de réception, stockage et expédition.
+
+---
+
+## 2. Les 5 champs de poids au niveau du support
+
+| Champ WMS | Nom FR | Définition | Quand mis à jour ? |
+|-----------|--------|------------|-------------------|
+| **Calculated Weight** | Poids calculé | Poids théorique (article) - ajustements (picking, etc.) | À chaque mouvement de stock |
+| **Scale Weight** | Poids balance | Poids mesuré physiquement au PIE | Au passage PIE uniquement |
+| **Theoretical Weight** | Poids théorique (article) | (Poids unitaire × quantité) + poids du support | À la création et à chaque ajustement |
+| **Real Weight** | Poids réel | `max(Calculated Weight, Theoretical Scale Weight)` | Recalculé automatiquement |
+| **Theoretical Scale Weight** | Poids théorique (balance) | Poids balance - ajustements | Après passage PIE puis à chaque ajustement |
+
+> ⚠️ **Attention traduction** : "Poids théorique" est ambigu en français :
+> - **Poids théorique (article)** = Theoretical Weight (basé sur la fiche article)
+> - **Poids théorique (balance)** = Theoretical Scale Weight (basé sur la balance - ajustements)
+
+### Formules de calcul
+
+- **Poids théorique (article)** = poids unitaire fiche article × quantité + poids du support (défini dans EasyS)
+- **Poids balance** = valeur brute de la pesée au PIE
+- **Poids calculé** = poids théorique (article) - ajustements (picking, transferts…)
+- **Poids théorique (balance)** = poids balance - ajustements
+- **Poids réel** = `max(poids calculé, poids théorique (balance))`
+
+---
+
+## 3. Les poids au niveau des lignes de stock
+
+| Champ | Description |
+|-------|-------------|
+| **Poids (kg)** | Poids réel de la ligne |
+| **Poids théorique (kg)** | Poids théorique basé sur la fiche article |
+
+Le poids des lignes est mis à jour lors des ajustements de stock, des pesées et des traitements custom **uniquement si l'article est géré en poids variable**.
+
+Le PIE ne met à jour que les poids du **support**, pas directement ceux des lignes de stock.
+
+---
+
+## 4. Comportement à la création du stock
+
+- Le **poids réel du stock** est à **0** à la création — alimenté uniquement au passage PIE, via StockAdjust, ou par custom
+- Le **poids théorique du stock** est calculé immédiatement depuis la fiche article
+- Le **poids du support** (type de palette) est **figé à la création** du conteneur → un changement ultérieur du poids dans EasyS n'a aucun effet sur les supports déjà créés
+
+---
+
+## 5. Le passage au PIE
+
+1. La balance mesure le poids brut du support (marchandises + palette)
+2. **Scale Weight** est mis à jour avec cette valeur
+3. **Theoretical Scale Weight** est calculé : poids balance - ajustements existants
+4. **Real Weight** est recalculé : `max(Calculated Weight, Theoretical Scale Weight)`
+
+> ⚠️ Le PIE n'affecte que les poids du **support**. Les lignes de stock sont mises à jour par répartition proportionnelle, pas directement par le PIE.
+
+---
+
+## 6. Poids variable et profil logistique
+
+### Activation
+
+Activer l'option **"Poids variable"** dans le **profil logistique** de l'article.
+
+Lorsque le poids variable est activé, il est **obligatoire** d'indiquer le poids à la création du stock.
+
+### Option "Poids moyen"
+
+Permet de renseigner le poids dès la réception en se basant sur le poids de la ligne de réception.
+
+Fonctionne si :
+- L'option **"poids moyen"** est activée dans le profil logistique
+- Le poids de la ligne de stock attendue est renseigné dans les **attributs logistiques** du ROR (ex. `"Weight": 20`)
+
+### Limitation — StockAdjust
+
+La commande **StockAdjust ne fonctionne pas** pour modifier le poids d'une ligne si l'article **n'est pas géré en poids variable** dans son profil logistique.
+
+---
+
+## 7. Vérification des poids à l'entrée en stock
+
+Le workflow **`Stock_CheckWeightToCreateStockInContainer_UI`** vérifie le poids du stock à l'entrée :
+- Compare avec la fiche article
+- Si l'article est en poids variable et que la tolérance n'est pas respectée → génération d'une **alerte TRF**
+
+---
+
+## 8. Exemple de parcours complet
+
+### Article standard (poids fixe) — support 25 kg, article 250 kg
+
+| Étape | Calculé | Balance | Théorique (art.) | Réel | Théorique (balance) |
+|-------|---------|---------|-----------------|------|---------------------|
+| Création | 275 | 0 | 275 | 275 | 0 |
+| Passage PIE (280 kg) | 280 | 280 | 275 | 275 | 280 |
+
+### Nouvelle palette (poids support EasyS modifié 25→24 kg)
+
+| Étape | Calculé | Balance | Théorique (art.) | Réel | Théorique (balance) |
+|-------|---------|---------|-----------------|------|---------------------|
+| Nouvelle palette | 280 | 280 | 274 | 274 | 280 |
+
+> Théorique (article) = 250 (stock) + 24 (nouveau poids palette) → confirme que le poids support est figé à la création.
+
+### Article en poids variable — 10 SAC, poids 100 kg
+
+| Étape | Calculé | Balance | Théorique (art.) | Réel | Théorique (balance) |
+|-------|---------|---------|-----------------|------|---------------------|
+| Création | 124 | 0 | 124 | 124 | 0 |
+| Passage PIE (107 kg) | 107 | 107 | 124 | 124 | 107 |
+
+> Le PIE met à jour Scale Weight et Calculated Weight, mais le poids des lignes de stock n'est pas directement affecté.
+
+---
+
+## 9. Points ouverts
+
+| # | Sujet | Statut |
+|---|-------|--------|
+| 1 | Workflow de rejet au PIE (similaire à `Stock_CheckWeightToCreateStockInContainer_UI` mais avec rejet plutôt qu'alerte TRF) | À confirmer |
+| 2 | Formule "poids pesé - poids théorique support (MCH)" → poids net estimé non stocké en tant que tel | À investiguer |