Points essentiels à retenir
- L’édition SAP, sa version et le scénario activé déterminent les interfaces réellement utilisables.
- Le mapping doit associer chaque événement à un maître, une transformation, un résultat métier et une règle de reprise.
- IDoc et API définissent des échanges ; le middleware peut les transporter, les transformer et les superviser.
- Repère Generix : aucun flux ne doit être accepté sans preuve du résultat métier dans SAP et dans le WMS, y compris après rejeu.
- La recette couvre les exceptions métier, les doublons, les indisponibilités et les responsabilités d’exploitation.
Commencez par désigner le système maître de chaque donnée
Le système maître est l’application autorisée à créer ou modifier une donnée pour une finalité définie ; une copie synchronisée n’acquiert pas cette autorité. L’intégration WMS SAP commence donc par une répartition explicite des responsabilités, et non par le choix d’un protocole.
Périmètre SAP : édition, version et scénario d’intégration réellement disponibles
Documentez votre environnement avant tout mapping : SAP ECC, SAP S/4HANA sur site, Cloud Private ou Cloud Public, version installée, périmètre activé et extensions existantes. Generix recommande de vérifier chaque interface dans cet environnement : une disponibilité documentée pour Cloud Public ne prouve pas sa disponibilité sur ECC, ni l’inverse.
Le scénario SAP 1ZQ d’intégration avec un entrepôt tiers, vérifié le 19 octobre 2026, décrit pour Cloud Public des échanges par API SOAP asynchrones. SAP y porte notamment les processus commerciaux et la gestion quantitative ; le WMS tiers exécute les mouvements physiques et logiques de l’entrepôt.
Responsabilités par donnée : référentiel, décisions de gestion et exécution physique
Attribuez un responsable aux articles, unités, lots, statuts qualité, documents et ajustements. Précisez qui décide, qui exécute et qui valide. Distinguez notamment emplacement physique, magasin SAP, quantité disponible et quantité valorisée : ces notions ne constituent pas un stock unique interchangeable.
Notre analyse des responsabilités respectives du WMS et de l’ERP complète ce cadrage sans remplacer la matrice du projet. Pour le vocabulaire général, consultez notre définition détaillée du WMS ; le présent guide traite le contrat d’échange et sa validation.
Cartographiez les flux SAP-WMS dans une matrice de mapping
Le mapping des flux SAP-WMS décrit la correspondance entre données sources et cibles, leurs transformations et les effets attendus. Generix recommande d’associer chaque ligne à une preuve métier et à une règle de reprise avant de développer ou paramétrer l’interface.
La matrice suivante est un modèle à compléter, pas un catalogue de connecteurs garantis. Les services d’entrepôt cités figurent dans le catalogue SAP Delivery Management, édition Cloud Public 2608, vérifié le 19 octobre 2026. Leur activation, leurs restrictions et leur couverture doivent être confirmées sur votre cible.
| Objet ou événement |
Maître et responsable de validation |
Source → cible |
Déclencheur et cadence |
Clés et champs à mapper |
Interface candidate avec édition SAP |
Résultat métier et accusé attendu |
Règle de rejet/reprise |
| Articles et unités |
SAP pour le référentiel retenu ; responsable données |
SAP → WMS |
Chargement initial, puis mises à jour selon mécanisme disponible |
Article, unité de base, conversions, attributs logistiques |
Cloud Public 2608 : lecture via Product (Version 2), selon entités ; ECC et autres éditions : interface à vérifier |
Article exploitable dans le WMS ; statut d’intégration et contrôle des conversions |
Rejet explicite des références incohérentes ; reprise après correction |
| Livraison sortante et confirmation |
SAP pour la livraison ; WMS pour l’exécution ; responsables expédition et SAP |
SAP → WMS → SAP |
Création ou libération selon scénario, puis événement d’exécution |
Livraison, poste, article, quantité, unité, lot, destination |
Cloud Public 1ZQ : Warehouse Shipping Order – Send to Warehouse (B2B) ; Warehouse Shipping Advice – Receive from Warehouse (B2B) |
Document exécutable dans le WMS ; livraison et mouvement attendus dans SAP ; résultat corrélé |
Contrôler l’état du document avant reprise ; aucune seconde comptabilisation |
| Livraison entrante ou attendu et réception |
SAP pour le document ; WMS pour le réalisé ; responsables réception et SAP |
SAP → WMS → SAP |
Distribution du document, puis réception selon scénario |
Livraison, poste, fournisseur, article, quantité, unité, lot, statut |
Cloud Public 1ZQ : Warehouse Stock Transfer Shipment Advice – Send to Warehouse (B2B) ; Warehouse Stock Transfer Receipt Advice – Receive from Warehouse (B2B) |
Attendu reconnu ; réception et entrée de marchandises rapprochées |
Gérer partiels et références absentes ; rejouer après vérification du réalisé |
| Mouvement affectant une dimension de stock SAP |
WMS pour l’événement physique ; SAP pour la comptabilisation ; responsable stocks |
WMS → SAP |
Événement pertinent ; cadence approuvée selon besoin et capacité |
Événement, article, quantité, unité, magasin, lot, catégorie de stock |
Cloud Public 2608 : API_MATERIAL_DOCUMENT, si adaptée et hors opération déjà comptabilisée par confirmation |
Document matériel attendu et référence retournée |
Bloquer le double circuit de comptabilisation ; rapprocher avant rejeu |
| Comptages et écarts |
WMS pour le comptage ; responsable inventaire pour validation ; SAP pour l’ajustement retenu |
WMS → SAP ; retour de décision |
Comptage terminé, puis validation autorisée |
Document, poste, exercice, article, lot, quantité, unité, motif |
Cloud Public 2608 : API_PHYSICAL_INVENTORY_DOC_SRV ; opérations à sélectionner séparément |
Comptage enregistré ; ajustement distinctement approuvé et traçable |
Distinguer comptage nul, absent et rejeté ; reprise selon état et habilitation |
Contrat de flux : champs obligatoires, transformations, fréquence et preuve d’intégration
Dans notre méthode, chaque ligne renvoie à une spécification versionnée : champs obligatoires, valeurs autorisées, conversions, arrondis, gestion des valeurs absentes, ordre des événements et compatibilité des versions. Fixez la cadence selon le besoin métier et la capacité réelle, sans imposer un « temps réel » uniforme. Si le scénario exécute des livraisons, ne transmettez pas systématiquement les commandes commerciales brutes.
Choisissez les messages standard et décidez où placer la médiation
Le choix d’une interface dépend de l’objet métier, du sens d’échange et de l’édition SAP. IDoc, API et middleware ne sont pas trois alternatives équivalentes : le middleware constitue une couche de médiation pouvant prendre en charge des échanges IDoc ou API.
IDoc et API : vérifier les fonctions couvertes, le sens et la version
Pour un IDoc, vérifiez le type de message, le type de base, les segments, les extensions et les statuts exploités. Pour une API, contrôlez les opérations, le sens entrant ou sortant du point de vue SAP, le protocole, le mode synchrone ou asynchrone et le statut de dépréciation. Generix recommande de conserver ces références dans le dossier d’architecture.
Le référentiel SAP des API produit, édition 2608, vérifié le 19 octobre 2026, recommande Product (Version 2), en OData V4, pour les entités autres que les textes explicitement conservés sur Product Master (A2X). Ne généralisez donc pas API_PRODUCT_SRV à tout le référentiel.
Dans 1ZQ, Warehouse Intermediate Update – Receive from Warehouse (B2B) est une mise à jour intermédiaire, pas une confirmation universelle de préparation. De même, le libellé Stock Transfer ne permet pas d’étendre un service à tous les déplacements internes.
Connexion directe ou middleware : comparer exploitation, transformations et évolutivité
- Connexion directe : pertinente si les contrats s’alignent et si les applications assurent les contrôles, journaux et reprises nécessaires ; les évolutions restent coordonnées entre elles.
- Médiation : utile pour centraliser conversions, routage et supervision ; elle ajoute une plateforme à exploiter et des responsabilités à attribuer.
Notre guide des échanges EDI et API prolonge cette distinction. Ne dupliquez pas les règles métier dans plusieurs couches.
Prévoyez les rejets et les reprises avant le premier échange
Une interface fiable doit distinguer transport réussi et traitement métier réussi. Un message accepté par une passerelle, livré au middleware ou reçu en HTTP ne prouve pas que la livraison, la réception ou le mouvement attendu existe dans SAP et dans le WMS.
Accusé technique, résultat métier et rapprochement des documents
Définissez pour chaque flux l’accusé disponible, le résultat métier à contrôler et la procédure de rapprochement. Reliez identifiant de message, événement, document et poste ; conservez les statuts, erreurs et horodatages. Generix recommande de qualifier les états « reçu », « en traitement », « rejeté » et « terminé » sans les confondre.
La documentation Material Documents — Read, Create, édition 2608 décrit API_MATERIAL_DOCUMENT pour lire, créer et annuler des documents matériels. Si une confirmation de livraison comptabilise déjà l’opération, interdisez son second enregistrement par ce service.
Idempotence, séquencement et reprise après indisponibilité
L’idempotence garantit qu’un même événement rejoué ne produit pas d’effet métier supplémentaire. Prévoyez une clé stable, la détection du résultat déjà enregistré et une trace des tentatives. La documentation SAP sur la qualité de service Exactly Once, vérifiée le 19 octobre 2026, explicite des conditions dépendant de l’émetteur, de la médiation et du récepteur : le middleware seul ne suffit pas.
Notre recommandation est de documenter l’ordre requis par document, la rétention des messages, l’autorité de rejeu et la reprise du retard. Si un accusé est perdu, recherchez d’abord le résultat métier. Pour les incidents déjà constatés en production, notre guide de diagnostic des écarts ERP-WMS traite l’investigation après incident.
Construisez une recette qui démontre les résultats dans les deux systèmes
La recette d’interface est une validation reproductible des échanges et de leurs effets métier, à partir de données, d’étapes et de résultats attendus définis. Elle doit prouver le fonctionnement nominal, les exceptions et la reprise, pas seulement la conformité du message.
Fiche de test réutilisable et jeux de données métier
Generix recommande d’utiliser la même fiche pour chaque scénario. Notre trame comprend les rubriques suivantes, à renseigner avant l’exécution :
- Identifiant et flux : référence du test, version du mapping et périmètre SAP-WMS.
- Préconditions et jeu de données : documents, statuts, références, unités et habilitations nécessaires.
- Étapes : actions métier, émission, traitement, panne simulée et reprise éventuelle.
- Message et corrélation : contenu pertinent, clé métier et identifiants techniques.
- Résultats et justificatifs : états attendus dans chaque système, documents, journaux et captures.
- Anomalie, responsable et décision : écart constaté, correction, contre-test et acceptation.
Exceptions fonctionnelles, pannes et critères d’acceptation
- Conversions d’unités et arrondis ; lots et fractionnement ; qualité et blocage.
- Réceptions ou expéditions partielles, reliquats, modification et annulation selon avancement.
- Comptage nul et écart : distinguer transmission du résultat et autorisation d’ajustement.
- Message doublonné ou désordonné, accusé perdu, indisponibilité et reprise.
- Charge, habilitations et non-régression après modification du mapping.
La documentation des opérations d’inventaire SAP, édition 2608 distingue notamment comptage et comptabilisation des différences. Faites approuver par le projet les seuils de délai, de charge et de résorption du retard, sans valeur standard inventée. L’acceptation exige un résultat métier prouvé, aucune double comptabilisation et des rejets maîtrisés.
Validez l’interface avec tous les acteurs de l’exécution
La mise en production de l’interface nécessite une acceptation conjointe métier et technique. Le contrat doit préciser comment un événement validé devient exploitable par les équipes ERP, entrepôt, transport, fournisseurs et prestataires logistiques, sans créer des versions contradictoires de la même opération.
Décision de mise en production et responsabilités d’exploitation
Generix recommande de joindre au procès-verbal d’acceptation la matrice approuvée, les fiches exécutées, les anomalies restantes et les procédures de reprise. Nommez les responsables SAP, WMS, intégration et exploitation : diagnostic, correction des données, autorisation de rejeu, surveillance et escalade doivent être attribués.
La décision concerne ici l’interface, pas toute la bascule du site. Vérifiez aussi les accès aux journaux, la conservation des preuves et la gestion des évolutions. Les scripts SAP 1ZQ demandent d’ajouter les étapes propres au projet : leur exécution seule ne couvre donc pas votre configuration complète.
Coordonner SAP, Generix WMS et les partenaires sans recréer des silos
Un événement partagé doit conserver sa référence, son statut et sa signification jusqu’aux destinataires autorisés. Notre article sur la coordination WMS-TMS développe ce prolongement vers le transport.
Notre WMS propose des API d’intégration et appartient à une gamme intégrée comprenant WMS, TMS et OMS. Cette option permet d’envisager une coordination de l’exécution autour de SAP, sans imposer son remplacement ni présumer la compatibilité de toutes ses versions. Si une médiation est nécessaire, nous pouvons également examiner le périmètre de notre plateforme TradeXpress Infinity pour l’intégration interapplications et interentreprises.
Vous préparez une interface entre SAP et votre entrepôt ? Présentez à nos équipes votre édition SAP, vos flux prioritaires et vos cas de recette via le formulaire de notre page Generix WMS pour cadrer le périmètre d’intégration, les paramétrages et les adaptations éventuelles.
En résumé
- La matrice devient le contrat commun entre responsables SAP, WMS, intégration et exploitation.
- Les interfaces candidates doivent être confirmées objet par objet sur la version SAP réellement déployée.
- Le rapprochement documentaire et l’idempotence sécurisent les reprises sans multiplier les effets métier.
- Chaque modification du mapping appelle des tests de non-régression et une conservation des preuves.
- Une exécution collaborative repose sur des événements validés, compris de façon cohérente par tous leurs destinataires.