mcp-wms-wiki/wiki/limagrain/06-erp-interface/mapping-erp-wms.md

---
title: "Mapping ERP-WMS — Changement article et propriétaire"
tags: [ERP, mapping, CHG, STR, article, propriétaire, custom]
status: draft
standard_ref: architecture/erp-integration.md
jira_refs: []
confluence_refs: []
sources: [FR-SW-04-07_LIMAGRAIN_Functional_Analysis_V1.5.docx, "CR CONSOLIDES REU ERP LIMAGRAIN V1 - CR.md"]
last_updated: 2026-05-06
author: Arthur
---

# Mapping ERP-WMS — Changement article et propriétaire

> **Résumé** : processus [CUSTOM] de changement d'article et de propriétaire
> en cours de vie du stock, via message CHG.

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

> Voir aussi : [Données principales et stock](donnees-principales.md) pour
> le mapping complet ITM, attributs logistiques et architecture article/lot.

## Contexte projet

Chez Limagrain, l'article (numéro, description et destination) et le
propriétaire peuvent être modifiés en cours de vie du stock. Ces changements
sont notifiés par un message CHG descendant de SAP vers EasyWMS.

Le message standard STR (Stock Transfer Request) est aussi utilisé pour
les demandes de changement de statut de stock.

## Message STR — Demande de Changement de Stock

### Cas d'usage

L'ERP envoie un STR pour :

- 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
  (ERR renvoyé à SAP)

### Interaction STV/GNA

L'ajustement de stock avec motif "STR" est filtré par le middleware GNA
(pas de retraitement STV pour éviter les doublons). Ce mécanisme devient
caduc si le STV est globalement désactivé (décision 30/04/2026).

### Monitoring

Limagrain mettra en place un **monitoring des erreurs** STR pour les cas
de refus. Les refus sont attendus en fonctionnement normal (palette en
cours de préparation au moment du STR).

## Message CHG — Changement article / propriétaire

### Contenu du message

| Champ | Description | Modifié si |
|-------|-------------|------------|
| Numéro de HU | Identifiant palette | Toujours présent |
| Lot Officiel | Lot de référence | Toujours présent |
| Code nouvel article | Nouveau code article | Changement article |
| Description nouvel article | Libellé | Changement article |
| Destination | Nouvelle destination | Changement article |
| Propriétaire Limagrain | Nouveau propriétaire | Changement propriétaire |

### Contrainte d'exécution

Le changement ne peut avoir lieu **que si le stock n'est pas assigné à
un processus** (picking, expédition, regroupement, etc.).

Si le stock est assigné → le message CHG génère un message **ERR** pour
informer SAP que le changement est impossible.

## Statut de stock

### Changement sur poste de travail

[CUSTOM] L'utilisateur peut changer le statut du stock sur le poste de
travail **uniquement** lors du processus de **retour commandes clients**,
pour appliquer :

- **F9** — Sacs sales
- **B6** — Non conforme

Un commentaire est associé au statut et remonté dans le message d'interface
(STC) pour informer l'ERP.

### Attributs du statut de stock

[CUSTOM] 3 attributs relatifs au statut de stock chez Limagrain :

1. **Statut de stock** : valeur du statut (ex : F9, B6)
2. **Commentaire** : raison du changement (liste déroulante contextuelle)
3. **Date de changement** : horodatage automatique

Les commentaires sont présentés sous une liste déroulante avec les
possibilités dépendant du statut sélectionné.

### Autonomie Limagrain

Limagrain peut créer ses propres statuts de stock :

- Menu « Données principales » → « Types de verrous » → « Statut de stock »
- Bouton « Nouveau » → remplir les champs requis

## Diagramme de séquence — Changement article

```mermaid
sequenceDiagram
    participant SAP
    participant WMS as EasyWMS

    SAP->>WMS: CHG (nouveau code article, description, destination)
    alt Stock non assigné
        WMS->>WMS: MAJ article sur les lignes de stock
        Note over WMS: Pas de confirmation retour
    else Stock assigné à un processus
        WMS->>SAP: ERR (changement impossible)
    end
```

## Diagramme de séquence — Changement statut (retour client)

```mermaid
sequenceDiagram
    participant OP as Opérateur
    participant WMS as EasyWMS
    participant SAP

    OP->>WMS: Changement statut (F9 ou B6) + commentaire
    WMS->>WMS: MAJ statut ligne de stock
    WMS->>SAP: STC (notification changement statut)
```

## Points d'attention

⚠️ Le CHG ne renvoie pas de confirmation positive — seule l'erreur (ERR)
est remontée si le changement échoue.

⚠️ Le changement de statut sur poste est limité au processus retour client
(pas en picking ni en regroupement).

⚠️ Le message STR (standard) est aussi utilisé pour des demandes de
changement de statut initiées par SAP.

## Questions ouvertes

- [ ] Liste exhaustive des statuts de stock Limagrain prévus au démarrage (@Justine)
- [ ] Liste des commentaires par statut — validée ? (@Justine)
- [ ] CHG envoie-t-il un acquittement positif ou juste ERR en cas d'échec ? (@Nicolas)

## Historique des modifications

| Date | Auteur | Modification |
|------|--------|--------------|
| 2026-05-05 | Arthur | Création initiale depuis AF V1.5 |
| 2026-05-06 | Arthur | Ajout section STR détaillée (CR consolidé ERP) |

## 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 | 23/02/2026 |