Connecter SAP S/4HANA : recevoir les commandes de vente et les clients

Saisissez l’URL de base OData de S/4HANA, ajoutez un jeu complet d’identifiants (utilisateur de communication Basic ou trio OAuth2), puis testez, mappez et activez pour recevoir commandes de vente et clients.

Le connecteur SAP S/4HANA importe les commandes de vente et les clients de votre système S/4HANA dans Integration via ses services OData. Deux modes d’authentification : un utilisateur de communication Basic ou des identifiants client OAuth2 ; remplissez un seul jeu complet, pas les deux. Cette connexion ne synchronise pas le stock : le stock de S/4HANA n’est ni importé ni renvoyé par elle.

Prérequis#

• Un système SAP S/4HANA, cloud ou sur site, avec lequel vous avez le droit de vous intégrer.
• Le soutien de votre équipe Basis ou d’administration SAP : elle vous donnera l’URL de base OData et préparera l’utilisateur de communication ou le client OAuth2.
• Le service OData des commandes de vente (API_SALES_ORDER_SRV) activé dans votre système S/4HANA. Sinon, votre administrateur SAP peut l’activer avec /IWFND/MAINT_SERVICE.
• Décidez de la méthode d’accès : Basic (utilisateur + mot de passe) ou OAuth2 (Client ID + Client Secret + Token URL). Un seul jeu complet suffit.

Obtenir les identifiants#

1. URL de base : demandez à votre équipe Basis l’adresse de base OData de votre système S/4HANA, ou prenez-la dans votre destination BTP si vous en utilisez une. Elle ressemble à https://s4hana.example.com:44300. Il n’existe pas de valeur universelle : les adresses cloud et sur site diffèrent, ne copiez jamais l’adresse d’un autre système.
2. Jeu Basic (option A) : demandez à votre administrateur SAP de créer ou confirmer un utilisateur de communication dans S/4HANA, et notez son nom d’utilisateur et son mot de passe. L’utilisateur de communication est le compte que S/4HANA réserve à l’accès entre systèmes ; n’utilisez pas un utilisateur personnel.
3. Jeu OAuth2 (option B), cloud : récupérez Client ID, Client Secret et Token URL dans la clé de service de votre instance d’intégration dans SAP BTP.
4. Jeu OAuth2 (option B), sur site : récupérez Client ID et Client Secret dans votre configuration de client OAuth, et prenez la Token URL dans cette même configuration. La Token URL n’a pas de valeur standard devinable : copiez-la toujours depuis votre propre système ou votre clé de service.
5. Client SAP : si votre système utilise un numéro de client SAP (par exemple 100), notez-le aussi. Il est envoyé avec chaque requête comme paramètre sap-client. Si votre équipe Basis dit qu’il n’est pas nécessaire, vous pouvez le laisser vide.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → SAP S/4HANA → Nouvelle connexion.
2. base_url (obligatoire) : l’adresse de base OData de votre système S/4HANA, par exemple https://s4hana.example.com:44300. C’est le seul champ toujours obligatoire.
3. sap_client (optionnel) : votre numéro de client SAP, par exemple 100. Laissez vide si votre système n’en utilise pas.
4. username (jeu Basic) : le nom d’utilisateur de l’utilisateur de communication dans S/4HANA. À remplir uniquement si vous avez choisi le jeu Basic, et toujours avec password.
5. password (jeu Basic) : le mot de passe de cet utilisateur de communication. Il est stocké chiffré et jamais réaffiché.
6. client_id (jeu OAuth2) : le Client ID OAuth2, depuis la clé de service BTP en cloud ou votre configuration de client OAuth sur site ; il commence généralement par sb-. À remplir uniquement si vous avez choisi le jeu OAuth2, avec client_secret et token_url.
7. client_secret (jeu OAuth2) : le Client Secret OAuth2 correspondant à ce Client ID. Il est stocké chiffré et jamais réaffiché.
8. token_url (jeu OAuth2) : la Token URL OAuth2, de la forme https://…/oauth/token. Copiez-la depuis votre clé de service BTP (cloud) ou votre configuration de client OAuth (sur site) ; ne la saisissez pas de mémoire.

Tester la connexion#

Le test vérifie d’abord que base_url est rempli et qu’exactement un jeu d’identifiants est complet ; un jeu incomplet échoue aussitôt, et l’erreur liste les deux combinaisons valides (username + password, ou client_id + client_secret + token_url). Avec le jeu OAuth2, le test échange d’abord vos identifiants contre un token d’accès auprès de token_url ; avec le jeu Basic, il se connecte directement. Il lit ensuite la description du service OData des commandes de vente : GET {base_url}/sap/opu/odata/sap/API_SALES_ORDER_SRV/$metadata, avec le paramètre sap-client si vous avez rempli sap_client. Un résultat OK dans la limite de 12 secondes signifie que l’adresse, la connexion et le service fonctionnent. Chaque échec a son propre code et sa prochaine étape : voir la FAQ.

Mapping / choisir un modèle#

Choisissez le modèle standard SAP S/4HANA pour les commandes de vente. Avant d’activer, utilisez l’aperçu avec une commande de vente réelle et vérifiez que le numéro de commande, le client et les lignes tombent dans les bons champs standard. Les clients importés de S/4HANA conservent les identifiants de votre système SAP, donc chaque commande peut être rattachée à son client. Si un champ important tombe au mauvais endroit, ajustez le mapping et prévisualisez à nouveau ; n’activez pas un mapping non vérifié.

Activer#

Après activation, Integration récupère les commandes de vente et les clients nouveaux ou modifiés depuis S/4HANA selon la fréquence définie. Rien n’est renvoyé dans S/4HANA par cette connexion, et le stock n’est synchronisé dans aucun sens : continuez à le gérer comme aujourd’hui. Surveillez les premières commandes dans Runs / Logs et vérifiez que chacune correspond à sa commande de vente dans S/4HANA avant de laisser la connexion sans surveillance.

FAQ#

Le test échoue avec 404 — SERVICE_NOT_ACTIVATED

Ici, un 404 ne signifie pas que l’adresse est fausse. Il signifie que le service OData des commandes de vente (API_SALES_ORDER_SRV) n’est pas encore activé dans votre système S/4HANA, donc rien ne répond à cette adresse de service.

Demandez à votre administrateur SAP d’activer le service API_SALES_ORDER_SRV dans S/4HANA avec /IWFND/MAINT_SERVICE, puis relancez le test. Ne modifiez pas base_url pour cette erreur.

Le test échoue avec 401 — INVALID_CREDENTIALS

S/4HANA a refusé la connexion : le nom d’utilisateur ou le mot de passe de l’utilisateur de communication est incorrect, ou le Client ID / Client Secret OAuth2 ne correspond pas, ou l’échange de token auprès de token_url les a refusés.

Recopiez les identifiants du jeu choisi depuis leur source (l’utilisateur de communication dans S/4HANA, ou la clé de service BTP / la configuration du client OAuth), en surveillant les espaces au début ou à la fin, puis testez à nouveau.

Le test échoue avec 403 — MISSING_SCOPE

La connexion a fonctionné, mais le compte n’est pas autorisé à utiliser le service des commandes de vente : l’utilisateur de communication n’a pas les droits nécessaires, ou le scénario de communication de cette intégration n’est pas configuré dans S/4HANA.

Demandez à votre administrateur SAP de vérifier les droits de l’utilisateur de communication et la configuration du scénario de communication pour le service des commandes de vente, puis testez à nouveau. Changer le mot de passe ne corrige pas un 403.

Le test indique des identifiants incomplets

Seule une partie d’un jeu est remplie : par exemple username sans password, ou client_id et client_secret sans token_url. Le test exige un jeu complet et s’arrête avant même de tenter la connexion.

Choisissez un jeu et remplissez tous ses champs : username + password pour Basic, ou client_id + client_secret + token_url pour OAuth2. Videz les champs de l’autre jeu pour ne rien laisser à moitié rempli.

Cette connexion peut-elle synchroniser le stock avec S/4HANA ?

Non. Cette connexion importe uniquement les commandes de vente et les clients : le stock de S/4HANA n’est pas importé et les variations de stock ne sont pas renvoyées. Continuez à gérer le stock dans vos systèmes actuels et ne fondez pas les niveaux de stock dans OMS sur cette connexion.

Seuls deux types d’enregistrements circulent par cette connexion : les commandes de vente et les clients. Les fiches produits ne circulent pas non plus ; gardez votre catalogue produits et vos chiffres de stock entretenus comme aujourd’hui.