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,226 @@
+---
+title: "Flux ERP outbound — Messages expédition"
+tags: [outbound, ERP, SOR, RUT, SOF, LOF, PCK, MOV, interface]
+status: draft
+standard_ref: architecture/erp-integration.md
+jira_refs: []
+confluence_refs: []
+sources: [FR-SW-04-07_LIMAGRAIN_Functional_Analysis_V1.5.docx, "Expédition - LIMAGRAIN - DEV - Confluence.md", "CR CONSOLIDES REU ERP LIMAGRAIN V1 - CR.md"]
+last_updated: 2026-05-06
+author: Arthur
+---
+
+# Flux ERP outbound — Messages expédition
+
+> **Résumé** : catalogue des messages ERP liés aux processus d'expédition
+> chez Limagrain, avec direction, déclencheur et contenu principal.
+
+> **Standard EasyWMS** : → voir [ERP Integration](../../architecture/erp-integration.md)
+> Ce qui suit documente les **spécificités Limagrain** par rapport au standard.
+
+## Contexte projet
+
+La communication ERP expédition utilise XML + Webservice (SAP EWM ↔ GNA).
+Pour les messages de réception, voir
+[Flux ERP inbound](../01-inbound/flux-erp-inbound.md).
+
+## Messages entrants (SAP → EasyWMS)
+
+### RUT — Route
+
+| Champ | Description |
+|-------|-------------|
+| Direction | ERP → WMS |
+| Déclencheur | Planification expédition camion |
+| Contenu | Image camion (tournée), 1+ ordres de sortie (SOR), date/heure libération, n° stops |
+| Types | « Client » (commandes client + messagerie palette), « Messagerie » (messagerie carton) |
+
+### SOR — Shipping Order Request
+
+| Champ | Description |
+|-------|-------------|
+| Direction | ERP → WMS |
+| Déclencheur | Création commande de sortie dans SAP |
+| Contenu | Lignes de stock (article/lot SAP, propriétaire Limagrain, statut de stock, quantité), priorité, date/heure libération |
+| Types | « Production » (consommation OF hors recert), « Recert » (consommation OF avec recert) |
+
+## Messages sortants (EasyWMS → SAP)
+
+### SOF — Shipping Order Fulfilled
+
+| Champ | Description |
+|-------|-------------|
+| Direction | WMS → ERP |
+| Déclencheur | Automatiquement (commande préparée à 100%) ou manuellement (clic opérateur). Envoi multiple possible en cas d'expédition partielle |
+| Statut | 🟡 Phase 2 possible. Démarrage possible sans SOF, activation ultérieure. Utile potentiellement pour déclencher la création de HU dans MII |
+| Contenu clé | SorCode, Status (Closed/Cancelled), LneContCode (HU), LneItemCode, ShippedQuantity, attributs logistiques |
+
+**Statuts SOF** :
+
+- **Closed** = stock réellement expédié, supprimé du WMS
+- **Cancelled** = commande annulée, ShippedQuantity = 0 sur les lignes non
+  expédiées
+
+### LOF — Load Order Fulfilled
+
+| Champ | Description |
+|-------|-------------|
+| Direction | WMS → ERP |
+| Déclencheur | Chargement camion terminé |
+| Contenu | État des lieux du chargement réel. Ne contient **que les HU effectivement chargées** (pas de ligne à 0 ni d'alerte pour les non chargées). Peut regrouper plusieurs SOR/commandes |
+
+**Articulation LOF / SOF** :
+
+| Message | Contenu | Granularité |
+|---------|---------|-------------|
+| SOF | Ce qui a été expédié par commande | Par ordre de sortie |
+| LOF | HU réellement chargées dans un camion | Par chargement |
+
+**Structure des conteneurs dans le LOF** : arborescence imbriquée :
+Palette support (IsSlave=TRUE) → Palette fille (IsSlave=FALSE) → Lignes
+de stock avec attributs logistiques. Cas des supports remontés M2I :
+Palette US (IsSlave=TRUE) → Séparateur 1 → Séparateur 2.
+
+### [CUSTOM] PCK — Passage Conteneur Client
+
+| Champ | Description |
+|-------|-------------|
+| Direction | WMS → ERP |
+| Déclencheur | Stock préparé — passage en conteneur client EasyWMS |
+| Contenu | Information passage conteneur client |
+| Envoyé pour | Commande client, consommation OF hors recert, messagerie carton |
+
+### ~~[CUSTOM] MOV — Movement~~ ANNULÉ
+
+> **ANNULÉ** — décision réunion client, jugé inutile.
+
+| Champ | Description |
+|-------|-------------|
+| Direction | WMS → ERP |
+| Déclencheur | ~~Déplacement de stock entre palettes (picking, regroupement)~~ |
+| Contenu | ~~Palette d'origine, palette de destination, nouvelle palette (Oui/Non), quantité + caractéristiques~~ |
+
+## Communication ERP : LOC — Détails
+
+### Principe retenu
+
+Un fichier JSON unique envoyé **toutes les 5 minutes** contenant toutes
+les palettes ayant eu un mouvement, les palettes nouvellement créées, et
+les palettes supprimées.
+
+### Structure du message
+
+Chaque palette inclut :
+
+- **Flag de type** : Mouvement / Création / Suppression
+- **Nouvelle position** (zone de stockage)
+- **Quantité** actuelle
+- **Code** de la palette
+- **Client flag** true / false
+
+Le delta de 5 minutes se base sur le **dernier mouvement** pour détecter
+les mouvements (et non une autre date).
+
+> **Usage outbound** : le passage en conteneur client est visible dans le
+> LOC (client flag = true), ce qui remplace le besoin d'un message dédié
+> à chaque passage.
+
+## Synthèse des communications ERP outbound
+
+| Événement | Mode de communication |
+|-----------|----------------------|
+| Passage en conteneur client | LOC (toutes les 5 min) |
+| ~~Déplacement stock picking~~ | ~~MOV~~ **ANNULÉ** |
+| Clôture ordre de sortie | SOF |
+| Chargement camion terminé | LOF |
+| Réception palette re-certifiée | ASN (depuis MII) |
+
+## Diagramme de séquence — Expédition client complète
+
+```mermaid
+sequenceDiagram
+    participant SAP
+    participant WMS as EasyWMS
+    participant PK as Poste travail
+    participant GAL as Galileo
+    participant QUAI as Quai/Poumon
+
+    SAP->>WMS: RUT (image camion + SOR)
+    WMS->>WMS: Libération auto (date atteinte)
+    WMS->>WMS: Assignation stock
+    Note over WMS: Palettes complètes → défrag
+    Note over WMS: Palettes picking → attente poste
+
+    WMS->>PK: Assignation poste + palettes picking
+    PK->>WMS: Picking terminé
+    Note over WMS: LOC toutes les 5 min (client flag)
+
+    WMS->>GAL: Tâches défrag → zone client
+    WMS->>WMS: Assignation poumon
+    WMS->>GAL: Tâches sortie + CstData étiqueteuse
+    GAL->>QUAI: Palettes déposées (ordre STOP)
+    QUAI->>WMS: Scan étiquette (chargement)
+    WMS->>SAP: SOF (OS clôturé)
+    WMS->>SAP: LOF (camion chargé)
+```
+
+## Diagramme de séquence — Consommation OF avec recertification
+
+```mermaid
+sequenceDiagram
+    participant SAP
+    participant WMS as EasyWMS
+    participant PK as Poste travail
+
+    SAP->>WMS: SOR (type Recert)
+    WMS->>WMS: Libération + assignation
+    WMS->>PK: Palette au poste
+    PK->>WMS: HU supprimée
+    WMS->>SAP: SOF
+    Note over SAP: Nouvelle HU créée hors WMS
+    SAP->>WMS: ASN (nouvelle palette)
+    WMS->>WMS: Réception + stockage
+```
+
+## Tableau récapitulatif des messages
+
+| Message | Direction | Standard/Custom | Processus | Statut |
+|---------|-----------|-----------------|-----------|--------|
+| RUT | ERP → WMS | Standard | Expédition client, messagerie | ✅ Actif |
+| SOR | ERP → WMS | Standard | Consommation OF, recert | ✅ Actif |
+| SOF | WMS → ERP | Standard | Tous (clôture OS) | 🟡 Phase 2 |
+| LOF | WMS → ERP | Standard | Chargement terminé | ✅ Actif |
+| LOC | WMS → ERP | [CUSTOM] | Toutes les 5 min (mouvements, créations, suppressions) | ✅ Actif |
+| PCK | WMS → ERP | [CUSTOM] | Client, OF hors recert, messagerie | ⚠️ **REMPLACÉ** par LOC |
+| MOV | WMS → ERP | [CUSTOM] | ~~Picking, regroupement~~ | ⚠️ **ANNULÉ** |
+
+## Points d'attention
+
+⚠️ Le message MOV est **ANNULÉ** (décision réunion client — jugé inutile).
+
+⚠️ Le SOF est automatique quand tous les conteneurs sont chargés.
+En cas d'expédition partielle, la clôture (et le SOF) est manuelle.
+Les lignes sans quantité expédiée n'apparaissent pas dans le SOF.
+
+⚠️ Pour la recertification, le SOF est envoyé **avant** la réception
+de la nouvelle HU (séquence SOF → ASN).
+
+⚠️ Le LOC est envoyé toutes les 5 minutes avec un delta basé sur le
+dernier mouvement. Le passage en conteneur client y est visible via
+le flag « client ».
+
+## Historique des modifications
+
+| Date | Auteur | Modification |
+|------|--------|--------------|
+| 2026-05-05 | Arthur | Création initiale depuis AF V1.5 |
+| 2026-05-05 | Arthur | MOV annulé, LOC détaillé (5 min, delta, structure), synthèse communications |
+| 2026-05-06 | Arthur | Enrichissement SOF (phase 2, statuts, contenu), LOF (structure conteneurs, articulation SOF/LOF), PCK remplacé par LOC — depuis CR consolidé |
+
+## Références
+
+| Source | Type | Date |
+|--------|------|------|
+| FR-SW-04-07_LIMAGRAIN_Functional_Analysis_V1.5 | Analyse fonctionnelle | 28/11/2025 |
+| Expédition - LIMAGRAIN - DEV - Confluence | Page ateliers DEV | 2026 |
+| CR CONSOLIDES REU ERP LIMAGRAIN V1 | CR ateliers interfaçage | 23/02/2026 |