Aller au contenu

Système cible : SAP ​

Cette page indique ce que Save2ERP attend d'un système SAP, et les informations à transmettre à l'administrateur du serveur Save2ERP.

Identifier le système ​

Chaque système SAP est identifié par son système logique, par exemple P01CLNT100. Ce nom est :

  • écrit par SAP dans la propriété S2E_SystemKey des documents qu'il génère ;
  • utilisé par l'administrateur dans le nom des variables du serveur (SAP_P01CLNT100_…, voir Configurer le serveur).

Les deux doivent être identiques.

Serveur OAuth2 ​

Save2ERP utilise le serveur OAuth2 de SAP (transaction SOAUTH2), avec ces adresses, propres à chaque mandant :

ServiceAdresse
Autorisation/sap/bc/sec/oauth2/authorize?sap-client=<mandant>
Jeton/sap/bc/sec/oauth2/token?sap-client=<mandant>
Révocation (déconnexion)/sap/bc/sec/oauth2/revoke?sap-client=<mandant>

Dans SOAUTH2, déclarez un client OAuth2 pour Save2ERP :

  • flux « authorization code » ; Save2ERP utilise aussi PKCE et le jeton de rafraîchissement ;
  • adresse de retour : l'adresse publique du serveur Save2ERP suivie de /auth/callback, par exemple https://save2erp.mon-entreprise.ch/auth/callback, à l'identique de la variable OAUTH_CALLBACK_URI ;
  • scope : celui du service REST des pièces jointes ;
  • un identifiant et un secret, transmis à l'administrateur de Save2ERP par un canal sûr.

Lors de sa première connexion, l'utilisateur voit la page d'autorisation de SAP et accepte que Word enregistre des documents en son nom. Avec l'authentification unique (SSO), il n'a en général pas à saisir de mot de passe.

Services REST ​

Les trois services obligatoires du contrat d'API doivent être exposés par SAP, sous une adresse de base commune (APIBASE), par exemple https://sap.mon-entreprise.ch:44300/rest. Save2ERP ajoute à chaque appel le paramètre sap-client avec le mandant.

Pour proposer le mode concepteur, SAP expose aussi deux services facultatifs : les droits de l'utilisateur (/attachments/permissions) et le XML des modèles (/attachments/readTemplateXml).

Si vos chemins diffèrent des chemins par défaut (/attachments, /attachments/check, /attachments/healthcheck, /attachments/permissions, /attachments/readTemplateXml), indiquez-les à l'administrateur.

Si une passerelle devant SAP exige une clé d'API, indiquez le nom de l'en-tête HTTP et sa valeur : Save2ERP l'ajoute à chaque appel.

Informations à transmettre à l'administrateur ​

InformationVariable du serveur Save2ERP
Système logiquenom des variables : SAP_<système>_…
Environnement : SBX, DEV, QUAL ou PRODSAP_<système>_ENV
SIDSAP_<système>_SID
MandantSAP_<système>_MANDT
Adresse de base des services RESTSAP_<système>_APIBASE
Adresse du serveur OAuth2SAP_<système>_OAUTH_SERVER
Identifiant et secret du client OAuth2SAP_<système>_OAUTH_CLIENT_ID, SAP_<système>_OAUTH_CLIENT_SECRET
ScopeSAP_OAUTH_SCOPE (ou SAP_<système>_OAUTH_SCOPE)
Chemins des services, s'ils diffèrentSAP_<système>_ATTACHMENTS_PATH, _CHECK_PATH, _HEALTHCHECK_PATH, _PERMISSIONS_PATH, _TEMPLATE_PATH
Clé d'API d'une passerelle, si besoinSAP_<système>_APIKEYNAME, SAP_<système>_APIKEY

Si SAP utilise un certificat émis par une autorité interne, transmettez aussi le certificat de cette autorité : le serveur Save2ERP doit pouvoir le vérifier.

Messages ​

Les messages renvoyés par les services sont affichés tels quels dans Word : rédigez-les dans la langue de connexion SAP de l'utilisateur.