mcp-wms-wiki/wiki_old_13-05-2026/limagrain/06-erp-interface/messages-reference.md

---
title: "Catalogue des messages ERP — Référence complète"
tags: [ERP, messages, interface, SAP, catalogue, ITM, ASN, ROR, ROF, REF, SOR, RUT, SOF, LOF, PCK, MOV, STV, STR, STC, SCR, WSC, COR, COF, LOC, ERR, CHG]
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
---

# Catalogue des messages ERP — Référence complète

> **Résumé** : tableau de référence de tous les messages d'interface entre
> SAP EWM et EasyWMS chez Limagrain, classés par domaine fonctionnel.

> **Standard EasyWMS** : → voir [ERP Integration](../../concepts/erp-interface.md)
> Ce qui suit documente les **spécificités Limagrain** par rapport au standard.

## Contexte projet

La communication entre SAP EWM et EasyWMS utilise XML + Webservice.
Le détail des champs est dans le document « Liste Interfaces LIMAGRAIN »
(fichier séparé). Cette page référence la typologie et le rôle de chaque
message.

## Tableau synthétique

### SAP → EasyWMS (flux entrants)

| Domaine | Message | Standard/Custom | Description | Statut |
|---------|---------|-----------------|-------------|--------|
| Master Data | ITM | Standard | Fiche article (Lot SAP) | ✅ Validé |
| Réception | ASN | Standard | Réception production (1 par palette) | ✅ Validé |
| Réception | ROR | Standard | Réceptions externes + retours clients | ✅ Validé |
| Expédition | SOR | Standard | Ordres de sortie (prod/recertif) | ✅ Validé |
| Expédition | RUT | Standard | Routes / tournées client | ✅ Validé |
| Stock | STR | Standard | Demande changement de stock (article, statut) | ✅ Validé |
| Inventaire | COR | Standard | Demande d'échantillonnage | ✅ Validé |
| Inventaire | SCR | Standard | Demande image de stock de l'entrepôt | ✅ Validé |

### EasyWMS → SAP (flux sortants)

| Domaine | Message | Standard/Custom | Description | Statut |
|---------|---------|-----------------|-------------|--------|
| Réception | REF | Standard | Finalisation de réception (+ zone stockage) | ✅ Validé |
| Réception | ROF | Standard | Clôture d'ordre d'entrée | ✅ Validé |
| Expédition | SOF | Standard | Finalisation ordre de sortie | 🟡 Phase 2 |
| Expédition | LOF | Standard | Finalisation de chargement | ✅ Validé |
| Stock | STV | Standard | Variation de stock | ⚠️ **DÉSACTIVÉ** (remplacé par LOC) |
| Stock | STC | Standard | Notification changement de statut | ⚠️ **DÉSACTIVÉ** (remplacé par LOC) |
| Stock | LOC | [CUSTOM] | Message périodique delta 5 min | ✅ Validé |
| Stock | WSC | Standard | Image de stock journalière | 🟡 Volumétrie à vérifier |
| Inventaire | COF | Standard | Confirmation d'échantillonnage | 🟡 Traitement à confirmer |
| Expédition | PCK | [CUSTOM] | Passage conteneur client | ⚠️ **REMPLACÉ** par LOC |
| Erreur | ERR | Standard | Erreur d'importation de message | ✅ Validé |

### Flux supprimés ou non retenus

| Message | Statut | Raison |
|---------|--------|--------|
| MOV | **Supprimé** | Redondant avec LOC + STR combinés |
| PCK | **Remplacé** par LOC | Le LOC périodique couvre le besoin |
| STV | **Désactivé** | Le LOC devient le seul canal stock (décision 30/04/2026) |
| STC | **Désactivé** | Statuts hors retour = B6 uniquement via LOC |
| ACC/SUP | **Non transmis** par l'ERP | Base client/fournisseur non interfacée |
| ROC | **Non utilisé** a priori | À confirmer côté Limagrain |

### Messages bidirectionnels / custom

| Domaine | Message | Direction | Standard/Custom | Description |
|---------|---------|-----------|-----------------|-------------|
| Réception | API Lot | WMS ↔ ERP | [CUSTOM] | Demande/réponse lot SAP pour retours clients |
| Stock | CHG | ERP → WMS | [CUSTOM] | Changement article et/ou propriétaire |

## Messages custom détaillés

### PCK — Passage Conteneur Client

- **Déclencheur** : stock préparé, passage en conteneur client EasyWMS
- **Contenu** : information passage conteneur client
- **Envoyé pour** : commande client, consommation OF hors recert, messagerie
- **Voir** : [Flux ERP outbound](../04-outbound/flux-erp-outbound.md)

### ~~MOV — Movement~~ ANNULÉ

> **ANNULÉ** — décision réunion client, jugé inutile.

- ~~**Déclencheur** : déplacement de stock entre palettes~~
- ~~**Contenu** : palette d'origine, palette de destination, quantité~~

### LOC — Message périodique (détaillé)

- **Déclencheur** : Job toutes les 5 min → WF → transaction `LOC.SEND` → GNA
  (script BOO) → POST SAP-CPI
- **Remplace** : PCK, MOVE, STV, STC
- **Actions** : B (déplacement), U/R (statut B6), S (suppression), T (transfert
  inter-HU), C (correction quantité), **P (assignation client)**
- **Quantités** : valeurs absolues (pas des écarts) sauf ACTION=S et T
- **Exclusion** : palettes dont la réception n'est pas fermée (pas de REF)
- **Approche technique** : fork du WSC avec filtre temporel sur CreationDate
- **Transport** : via GNA → SAP-CPI (OAuth 2.0 client_credentials) —
  code CPI : **ATH201**
- **Voir** : [Spécification complète LOC](loc-message-periodique.md),
  [Intégration GNA → SAP-CPI](gna-sap-cpi.md),
  [Flux ERP outbound](../04-outbound/flux-erp-outbound.md)

### STV — Variation de Stock (⚠️ DÉSACTIVÉ)

> ⚠️ **Décision 30/04/2026** : le STV est désactivé (post-processing coupé).
> Le LOC devient le seul canal de notification des mouvements de stock vers SAP.

- **Direction** : WMS → SAP
- **Rôle initial** : notifier les ajustements de quantités manuels (hors flux
  standards réception/expédition)
- **Mapping clé** :

| Balise | Utilisation |
|--------|-------------|
| Operation | C (positif) / D (négatif) |
| Site | WF02 |
| ItemCode | Code lot SAP |
| OwnerCode | MECALUX |
| ContainerCode | Numéro HU |
| FilterAttributes | Attributs du stock existant modifié |
| Attributes | Attributs du stock nouvellement créé |
| ReasonCode | AJUSTEMENT MANUEL |
| ERPReasonCode | ZSC1 |
| Comment | Facultatif (opérateur) |

- **Point ouvert** : Limagrain doit définir comment gérer côté ERP un STV de
  type "création de stock" (l'ERP n'autorise pas la création de stock par ce
  biais aujourd'hui)
- **Raison désactivation** : Limagrain préfère des quantités absolues (LOC)
  plutôt que des écarts +/- (STV) — si un message se perd, l'écart est
  définitivement perdu

### STR — Demande de Changement de Stock

- **Direction** : ERP → WMS
- **Cas d'usage** : changement de code article (produit SAP + description),
  changement de propriétaire, blocage/déblocage de lot
- **Règles d'acceptation** :
  - **Accepté** si la palette n'est pas assignée à une commande ou en cours
    de mouvement
  - **Refusé** si palette "client" ou en préparation (code erreur API explicite)
- **Interaction avec STV** : ajustement avec motif "STR" → le middleware (GNA)
  ne traite pas les STV avec ce motif pour éviter les doublons
- **Monitoring** : Limagrain mettra en place un monitoring des erreurs pour
  les cas de refus
- **Voir** : [Mapping ERP-WMS](mapping-erp-wms.md)

### COR — Demande d'Échantillonnage

- **Direction** : ERP → WMS
- **Usage** : **uniquement** pour les demandes d'échantillonnage (pas pour les
  inventaires physiques classiques, gérés dans EasyWMS en phase 1)
- **Mapping** :

| Balise | Valeur |
|--------|--------|
| Description | "ECHANTILLONNAGE" (en dur, discriminant WMS) |
| Code | Numéro du lot d'inspection SAP |
| Priority | 3 (basse) |
| ProductCode | Code lot SAP |
| LotCode | Code produit SAP |
| Color, Source, Size | Attributs logistiques standards |

- **Flux** : COR envoyé → WMS fait venir la palette sur un poste de travail →
  opérateur prélève → palette repart en stockage → COF envoyé
- **Règle** : un article en cours d'échantillonnage **n'est pas disponible**
  pour les ordres de sortie
- **Voir** : [Échantillonnage](../03-picking/echantillonnage.md)

### COF — Confirmation d'Échantillonnage

- **Direction** : WMS → ERP
- **Mapping** :

| Balise | Description |
|--------|-------------|
| CountCode | Numéro du lot d'inspection |
| Status | Closed (effectué) ou Cancelled (annulé) |
| UpdateDate | Date/heure de changement |

- **Point ouvert** : Limagrain doit confirmer si le COF sera traité côté ERP.
  Si non traité, risque de demandes en double.

### WSC — Image de Stock Journalière

- **Direction** : WMS → ERP
- **Rôle** : image de stock complète pour vérification de cohérence. Contient
  l'ensemble du stock : code OS, statut palette, toutes les informations
  disponibles
- **Démarrage** : export manuel EasyWMS + export SAP + comparaison.
  Automatisation possible ultérieurement (quotidien à heure fixe)
- **Point d'attention** : Limagrain doit vérifier sa capacité à traiter ce
  fichier (volumétrie potentiellement élevée pour CPI)
- **Déclenchement** : transaction `SCR.REQ` ou `STOCKSYNC.ASKED`

### STC — Notification Changement de Statut (⚠️ DÉSACTIVÉ)

> ⚠️ **Décision 30/04/2026** : le STC est désactivé. Les changements de statut
> hors retour sont limités au B6 (blocage logistique standard) et sont couverts
> par le LOC (action R/U). Les statuts des retours sont remontés dans le REF.

### CHG — Changement article / propriétaire

- **Déclencheur** : modification article ou propriétaire dans SAP
- **Contenu** : numéro de HU, lot officiel, code nouvel article, description,
  destination, propriétaire Limagrain
- **Contrainte** : le stock ne doit pas être assigné à un processus (sinon ERR)
- **Voir** : [Mapping ERP-WMS](mapping-erp-wms.md)

### API Lot SAP — Retours clients

- **Déclencheur** : lot officiel inconnu lors d'un retour client
- **Contenu (demande)** : lot officiel à vérifier
- **Contenu (réponse)** : lot SAP correspondant + attributs logistiques
- **Parallèle** : un ITM est descendu avec les infos article
- **Voir** : [Réception retour](../01-inbound/reception-retour.md)

## Flux par processus

### Réception production (ASN)

```
SAP → ASN → EasyWMS → (réception + stockage) → REF → SAP
                                              → ROF → SAP
                                              → LOC (delta 5 min) → SAP
```

### Réception extérieure / retour (ROR)

```
SAP → ROR → EasyWMS → (réception + contrôle) → REF → SAP
                                              → ROF → SAP
                                              → LOC (delta 5 min) → SAP
```

### Expédition client (RUT)

```
SAP → RUT → EasyWMS → (picking + chargement) → LOC (delta 5 min) → SAP
                                              → LOF → SAP
                                              → SOF → SAP (phase 2)
```

### Consommation OF (SOR)

```
SAP → SOR → EasyWMS → (sortie) → LOC (delta 5 min) → SAP
                               → SOF → SAP (phase 2)
```

### Échantillonnage

```
SAP → COR → EasyWMS → (prélèvement poste) → COF → SAP
```

### Image stock (vérification cohérence)

```
SAP → SCR → EasyWMS → WSC → SAP (image complète)
```

### Changement de stock

```
SAP → STR → EasyWMS → (MAJ stock) → LOC (delta 5 min) → SAP
                    OU → ERR → SAP (si stock assigné)
```

## Points d'attention

⚠️ **STV et STC désactivés** (décision 30/04/2026) — le LOC est le seul canal
de notification des mouvements de stock vers SAP.

⚠️ Le message CHG est rejeté (ERR) si le stock est assigné à un processus
en cours.

⚠️ MOV, PCK sont **supprimés/remplacés** — le LOC couvre tous ces besoins.

⚠️ L'ASN envoie 1 palette par message (pas d'agrégation — permet suppression
individuelle en cas d'annulation).

⚠️ Le STR est refusé si la palette est assignée "client" ou en préparation.
Le middleware GNA filtre les STV avec motif "STR" pour éviter les doublons
(caduc si STV globalement désactivé).

⚠️ Le COF n'est utile que si SAP le traite — sinon risque de demandes
d'échantillonnage en double.

## Questions ouvertes

- [ ] Détail champ par champ de chaque message — document séparé à intégrer (@Arthur)
- [ ] Format exact du message CHG (@Nicolas)
- [ ] Confirmer si le COF sera traité côté ERP (@Limagrain)
- [ ] Vérifier capacité de traitement du WSC quotidien — volumétrie (@Limagrain)
- [ ] Confirmer retour fournisseur : SOR simple ou RUT ? (@Limagrain)
- [ ] Effets de bord désactivation STV — lister toutes les transactions
  STK.ADJ et vérifier couverture LOC (@Mecalux)
- [ ] Effets de bord désactivation STC — idem pour CST.STK (@Mecalux)

## 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 JSON, flag client) |
| 2026-05-06 | Arthur | Enrichissement complet depuis CR consolidé ERP (STV, STR, COR/COF, WSC, flux supprimés, désactivation STV/STC) |

## Références

| Source | Type | Date |
|--------|------|------|
| FR-SW-04-07_LIMAGRAIN_Functional_Analysis_V1.5 | Analyse fonctionnelle | 28/11/2025 |
| CR CONSOLIDES REU ERP LIMAGRAIN V1 | CR ateliers interfaçage | 05/01 → 23/02/2026 |
| Expédition - LIMAGRAIN - DEV | Page ateliers DEV | 2026 |