Arthur Ria
9.4 KiB
title, tags, status, standard_ref, jira_refs, confluence_refs, sources, last_updated, author
| title | tags | status | standard_ref | jira_refs | confluence_refs | sources | last_updated | author | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Données principales et stock — Mapping ITM et attributs |
|
draft | architecture/erp-integration.md |
|
|
2026-05-06 | Arthur |
Données principales et stock — Mapping ITM et attributs
Résumé : architecture retenue pour la gestion des articles et du stock dans EasyWMS chez Limagrain, mapping du message ITM, attributs logistiques, profils et gestion des poids.
Standard EasyWMS : → voir ERP Integration Ce qui suit documente les spécificités Limagrain par rapport au standard.
Contexte projet
Les décisions ci-dessous sont issues des ateliers d'interfaçage EasyWMS / SAP réalisés entre le 05/01/2026 et le 23/02/2026, consolidées le 27/02/2026.
Architecture retenue : Lot SAP = Article WMS
Le code article dans EasyWMS est le code lot SAP (et non le code produit SAP). L'option concaténation code produit + lot SAP a été étudiée et écartée.
Le code produit SAP est géré comme un attribut au niveau du stock (pas de la fiche article), car un même lot SAP peut correspondre à plusieurs produits différents (ex. : changement de destination).
| Relation | Type | Statut |
|---|---|---|
| Lot SAP ↔ Lot Officiel | 1 pour 1 | ✅ Validé par Limagrain |
| Code article WMS = Code lot SAP | — | ✅ Validé |
| Code produit SAP = Attribut logistique du stock | — | ✅ Validé |
Côté SAP
Il existe une base article avec des codes articles uniques. Les articles sont gérés au lot. Chaque article peut avoir plusieurs codes lots SAP. Chaque code lot SAP a un équivalent code lot OFFICIEL national (relation 1:1).
Côté EasyWMS
Chaque lot SAP est descendu via le fichier ITM. L'article SAP devient un attribut du lot SAP (et non l'inverse).
Code article WMS = code lot SAP
Unité de base selon le type d'article
| Type article | Description | Unité de base WMS |
|---|---|---|
| FERT | Produit fini | BAG (sac) |
| ZSIZ | Semi-fini calibré | KG |
L'unité de base dans le WMS est l'unité logistique (pas l'unité de base SAP). Un même produit peut exister en BAG et en KG = codes articles WMS différents.
Mapping fiche article (message ITM)
| Champ EasyWMS | Champ SAP | Remarque |
|---|---|---|
| ItemCode | Code lot SAP | Clé principale |
| Alias | Lot officiel | Relation 1:1, scannable |
| OwnerCode | — | Constante "MECALUX" (technique) |
| Description | Description longue | Affichage PC |
| AltDescription | Description courte (MAKTL) | Affichage mobile, < 65 car. |
| Type | FERT / ZSIZ / etc. | + description du type |
| Family | Traitement commercial | Ex : "20 : R - Cruiser OSR" — pas de séparation familles en préparation |
| BaseUoM | BAG ou KG | Selon type d'article |
| Weight | Poids brut du sac | Poids unitaire théorique |
| ContainerQty | Nb sacs par palette | Palette pleine standard (= Bag/Pal) |
| ContainerType | Palette | Un seul type de palette |
| CstAtt02 | Espèce | Ex : M = Maïs, S = Tournesol — pour ordonnancement picking |
| CstAtt03 | Génération | Génération article rattachée au lot SAP |
| CstAtt04 | Variété | Ex : "LG50465" |
| CstAtt05 | Big bag | True / False |
| CstAtt06 | GTIN | Ne peut être un alias car non unique |
| CstAtt07 | Semences essais | True / False |
| CstAtt08 | Size (calibre) | — |
| CstAtt09 | Field production area | — |
| CstAtt10 | Stage | ⚠️ À ajouter — requis pour étiquette échantillon |
| Conversion.Principale.CstAtt01 | Poids unitaire article | Poids théorique ERP |
Profils logistiques
| Type d'article | Profil | Description |
|---|---|---|
| Articles classiques | PROFIL_STANDARD | Gestion code produit + propriétaire + description + pays destination |
| Palettes bois vides | PROFIL_PALETTE | Gestion palette bois vide |
Attributs logistiques du stock
Décision du 11/02/2026 : les Custom Attributes au niveau du stock (CstAtt01–04) ont été supprimés au profit des attributs logistiques standards du WMS. Les modes de capture sont désactivés pour éviter la customisation de tous les écrans.
| Champ EasyWMS (balise API) | Libellé affiché WMS | Champ SAP | Remarque |
|---|---|---|---|
| Lot | Lot | Code produit SAP | Différencie les produits pour un même lot SAP |
| Color | Couleur | Code propriétaire SAP | ≠ "MECALUX" technique |
| Source | Source | Description courte SAP | Désignation courte |
| Size | Taille | Pays de destination | Peut changer en cours de vie du stock |
⚠️ Les noms de balises API (Color, Size…) ne correspondent pas aux données métier. Le renommage d'affichage est géré dans le WMS.
Point à tester : en réception, la création du stock via les attributs logistiques doit être validée (approche standard ou custom — à confirmer par les tests).
Gestion des codes clients / fournisseurs
La base client/fournisseur SAP n'est pas interfacée avec le WMS. Les codes sont gérés via des constantes + champ texte libre :
| Flux | Champ code | Champ Source |
|---|---|---|
| ROR Fournisseur | SupplierCode = "FOURNISSEUR" | Code fournisseur SAP + libellé |
| ROR Retour client | AccountCode = "CLIENT" | Code client SAP + libellé |
| SOR / RUT Client | AccountCode = "CLIENT" | Code client SAP + libellé |
| SOR Production | AccountCode = "PRODUCTION" | — |
Gestion des poids
| Situation | Comportement ERP |
|---|---|
| Article en BAG (UdM ≠ KG) | L'ERP ne s'intéresse qu'à la quantité de sacs — les écarts de poids sont ignorés |
| Article en KG | Seule la quantité en KG intéresse l'ERP — si le poids change (balance), le WMS modifie la quantité |
Le poids théorique de la ligne de stock (quantité × poids unitaire, hors
poids palette) est transmis via l'attribut logistique Weight.
Champs NON utilisés dans ITM
Les champs suivants sont explicitement exclus du mapping :
Stock Label, Classification ABC, Alertes stock (min/max), Image produit, Code danger (pas d'impact logistique), Températures min/max, Cross-docking, Gerbabilité (gérée via ordonnancement picking), Picking message, IsPacking.
Conversions
- Unité de base = BAG ou KG (pas de conversion supplémentaire identifiée)
- Pas de gestion financière ni de découpage dans les sacs
- Le nombre de sacs par palette pleine est géré dans la conversion container
(champ
ContainerQty)
Types de supports
| Type | Usage | Statut |
|---|---|---|
| EWM-PAL00 / PALETTE_US | Palette standard (un seul type) | ✅ Confirmé |
| BIGBAG | Attribut de la HU (pas type séparé) | ✅ Validé |
| Octobin | Hors périmètre phase 1 | ❌ |
La création de types de supports est techniquement lourde (nécessite passage par support Mecalux, impact design entrepôt). Les BigBag sont déclarés par l'opérateur au poste de réception. Le WMS ajuste le calcul de poids (+2 kg environ).
Z-Bags (sacs vides)
Stockés dans le magasin automatique (SRS) uniquement pour livraison aux clients, pas pour l'approvisionnement production. Doivent respecter les mêmes formats et règles que les palettes produits. → À valider fonctionnellement.
Paramètres généraux de l'interface
| Paramètre | Valeur |
|---|---|
| Format | JSON |
| Opération par défaut | 3 = Upsert |
| Mode de mise à jour | Complete = true (fiche complète à chaque envoi) |
| OwnerCode (technique) | "MECALUX" |
| Site | WF02 |
Points d'attention
⚠️ Le CstAtt10 (Stage) est à ajouter — il est requis pour l'étiquette d'échantillonnage.
⚠️ Les noms de balises API stock (Color, Size, Source) sont détournés de leur usage standard — ne pas confondre avec les concepts habituels.
⚠️ Les CstAtt au niveau du stock ont été supprimés (décision 11/02/2026) au profit des attributs logistiques standards — vérifier l'impact sur les développements en cours.
⚠️ Le mode Complete = true signifie que chaque ITM contient la fiche complète (pas de delta) — attention à la volumétrie.
⚠️ La base client/fournisseur n'est pas interfacée : le code est descendu dans chaque message ROR/SOR/RUT, pas maintenu en master data.
Questions ouvertes
- CstAtt10 Stage — quand sera-t-il ajouté au mapping ITM ? (@Nicolas)
- Création stock via attributs logistiques en réception — standard ou custom ? À valider par tests (@Fabien)
- Impact suppression CstAtt stock sur les développements existants (@Nicolas)
Historique des modifications
| Date | Auteur | Modification |
|---|---|---|
| 2026-05-05 | Arthur | Création initiale depuis page Confluence DEV |
| 2026-05-06 | Arthur | Ajout champs non utilisés, conversions, types supports, Z-Bags (CR consolidé) |
Références
| Source | Type | Date |
|---|---|---|
| Données principales + stock - LIMAGRAIN - DEV | Page Confluence | 27/02/2026 |
| Ateliers interfaçage EasyWMS/SAP | Ateliers | 05/01 → 23/02/2026 |
| Notes complémentaires 11/02/2026 | Note | 11/02/2026 |
| CR CONSOLIDES REU ERP LIMAGRAIN V1 | CR ateliers | 23/02/2026 |