# 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 |