Préparez SAP S/4HANA sur site pour l’intégration

Activer les services

Configuration dans le Connecteur Cloud

Configuration de la suite d’intégration SAP

Configuration du package d’intégration

Ces étapes sont généralement effectuées par un consultant SAP ou un développeur ; ils pourront vous aider à préparer SAP S/4HANA pour l’intégration avec Pleo.


Étape 1 : Activer les services

Nom du service
Type

Description

Documentation

JournalEntryCreateRequest

Confirmation_In



SOAP

Service pour le traitement des entrées de journal synchrones dans S/4HANA



API d’entrée de journal

API_CV_ATTACHMENT_SRV

ODATAService de gestion des pièces jointesAPI des pièces jointes

API_COMPANYCODE_SRV

ODATAService de lecture des données d’entrepriseAPI du code entreprise
API_COSTCENTER_SRVODATAService de lecture des Centres de CoûtsAPI de Centre de Coûts
API_PROJECT_V2 /
API_PROJECT_V3
ODATAService de lecture des éléments WBSAPI des éléments de la structure WBS



1. Services SOAP
  1. Exécutez la transaction soamanager
  2. Connectez-vous à l’assistant Web
  3. Cliquez sur Configuration du Service Web
  4. Rechercher :
    • Le Type d’objet est Tout
    • Le Nom de l’objet est JOURNALENTRYCREATEREQUESTCONFI
  5. Sélectionnez le service trouvé
  6. Cliquez sur Créer un service
  7. Ajoutez les informations suivantes :
    • Nom du Service : JournalEntryPost
    • Nouveau Nom de Liaison : JournalEntryPost
  8. Maintenez la Sécurité du Fournisseuren sélectionnant les options suivantes :
    • Sécurité au niveau du transport : Aucun (http)
    • Authentification du canal de transport : ID utilisateur/mot de passe
  9. À l’étape du protocole SOAP, conservez la valeur par défaut et cliquez sur Suivant
  10. Cliquez sur Terminer dans Paramètres de l’opération
  11. Assurez-vous que l’État sur l’écran des informations est Actif



 2. Services OData 
  1. Document joint
    1. Exécutez la transaction /n/IWFND/MAINT_SERVICE
    2. Filtrez par nom du service externe : API_CV_ATTACHMENT_SRV
    3. Dans les commentaires ICF, assurez-vous que le statut est Actif
      • Si le statut n’est pas actif, cliquez sur Nœud ICF  et sélectionnez Activer
  2. Lisez les informations sur l’entreprise
    1. Exécutez la transaction /n/IWFND/MAINT_SERVICE
    2. Cliquez sur Ajouter un service
    3. Filtrer par nom du service technique : API_COMPANYCODE_SRV
    4. Sélectionnez la ligne avec le service et cliquez sur Ajouter les services sélectionnés
    5. Assurez-vous que le Nom du service technique est égal à API_COMPANYCODE_SRV 
    6. Sous Informations de création, cliquez sur Objet local
    7. Saisissez l’Attribution du Package 
    8. Enregistrez les modifications
  3. Lisez les éléments de la structure WBS V2 ou V3
    1. Exécutez la transaction /n/IWFND/MAINT_SERVICE
    2. Filtrer par Nom du service externe:
      • API_PROJECT_V2 : si la version du système est inférieure à 2021 fsp00
      • API_PROJECT_V3
    3. Dans les commentaires ICF, assurez-vous que le statut est Actif
      • Si le statut n’est pas actif, cliquez sur Nœud ICF et sélectionnez Activer
  4. Lisez le Centre de Coûts
    1. Exécutez la transaction /n/IWFND/MAINT_SERVICE
    2. Filtrez par nom du service externe : API_COSTCENTER_SRV
    3. Dans les commentaires ICF, assurez-vous que le statut est Actif
    4. Si le statut n’est pas actif, cliquez sur Nœud ICF et sélectionnez Activer


3. Configurer l’authentification 


  Pour l’authentification de base : Créez un utilisateur technique pour l’authentification des services 
  1. Exécutez la transaction /nsu01
  2. Saisissez le nom de l’utilisateur
  3. Cliquez sur Utilisateur technique
  4. Sélectionnez Type d’utilisateur : Système
  5. Saisissez le mot de passe
  6. Cliquez sur Confirmer
  7. Exécutez la transaction PFCG
  8. Saisissez le nom du rôle
  9. Cliquez sur Rôle Unique
  10. Accédez à l’onglet Menu
    1. Sous Depuis le menu, sélectionnez Depuis le menu SAP suivi de Local
    2. Cochez la case Compte 
    3. Cliquez sur Transfert 
    4. Enregistrez les modifications
  11. Passez à l’onglet Autorisations
    1. Cliquez sur Modifier les données d’autorisation
    2. Cliquez sur Manuellement
    3. Saisissez les objets d’autorisation suivants dans les champs vides :
      • C_PROJ_KOK
      • C_PRPS_KOK
      • F_BKPF_BED
      • F_CLM_BAM
      • F_FAGL_LDR
      • F_KNA1_BED
      • F_KNA1_GEN
      • F_LFA1_BEK
      • F_SKA1_BUK
      • M_MATE_MAN
      • V_VBAK_AAT
      • F_BKPF_BUP
    4. Cliquez sur Autorisation complète 
    5. Créez un profil d’utilisateur actualisé en cliquant sur
  12. Passer à l’onglet Rôles
  13. Attribuez le rôle créé à l’étape précédente ainsi que SAP_BC_WEBSERVICE_CONSUMER à cet utilisateur technique


  Pour l’authentification par certificat client : Télécharger le certificat SSL 
  1. Exécutez la transaction STRUST
  2. Accédez à l’onglet Serveur Standard SSL
  3. Cliquez sur Importer le certificat
  4. Choisissez le fichier SLL et cliquez sur Ajouter à la liste des certificats



Étape 2 : Configuration dans le Connecteur Cloud

  1. Connectez-vous au sous-compte BTP
    Utilisez la documentation officielle de SAP :
  2. Créez des correspondances vers S/4HANA
    1. Accédez à de Cloud vers Sur site
    2. Ajoutez deux lignes à Mappage du système virtuel sur le système interne sous Contrôle d’accès
      • Protocole HTTPS pour accéder aux services Web SOAP et OData 
      • Protocole RFC pour accéder aux BAPI


Bon à savoir :

  • Le port et l’hôte doivent être fournis par votre administrateur SAP Basis.
  • Les ressources HTTPS pour l’environnement DEV peuvent être indiquées comme /. 
  • Pour la production, cela devrait être limité aux chemins spécifiques des services Web.


Étape 3 : Configuration de la suite d’intégration SAP

 1. Maintenir les identifiants 
  1. Créer des identifiants d’API ICP
    1. Au niveau du sous-compte SAP BTP, cliquez sur Services et allez à  Instances et Abonnements 
    2. Cliquez sur cf-api
    3. Cliquez avec le bouton droit sur Voir les identifiants 
    4. Copiez les valeurs pour clientid, clientsecret, takenurl et url
    5. Accédez à Matériel de sécurité
    6. Cliquez sur Créer et choisissez Identifiants Client OAuth2 dans le menu déroulant
    7. Collez les valeurs précédemment copiées dans la fenêtre contextuelle
    8. Cliquez sur Déployer
  2. Déployer les identifiants 
    1. Accédez à Matériel de sécurité 
    2. Cliquez sur Créer et choisissez Identifiants utilisateur
    3. Renseignez les informations nécessaires


 2. Package d’intégration 
  1. Installez le package d’intégration
    1. Cliquez sur Conception et accédez à Intégrations et API 
    2. Cliquez sur Importer et choisissez le package d’intégration Pleo avec SAP S/4HANA


 3. Créer une destination pour l’accès BAPI 
  1. Cliquez sur Connectivité et accédez à Destinations
  2. Cliquez sur Créer une destination
  3. Fournissez les informations nécessaires :
    • Nom : BAPI_INTERNAL_ORDER_GETLOST
    • Type : RFC
    • Description : Obtenez la liste des Ordres internes de S4H
    • Type de proxy : Sur site
    • Utilisateur/Mot de passe : Identifiants de l’utilisateur disponibles dans S/4HANA
    • Type d’Autorisation : CONFIGURED_USER
    • Propriétés supplémentaires: Ajoutez trois nouvelles valeurs en cliquant sur Nouvelle propriété
      • jco.client.ashost : Hôte virtuel du Connecteur Cloud configuré à l’étape 2
      • jco.client.client : Numéro de client S/4HANA
      • jco.client.sysnr : Numéro d’instance S/4HANA


Étape 4 : Configuration du package d’intégration

1. Au sein de l’intégration de Pleo avec SAP S/4HANA, naviguez vers Objets 


2. Cliquez sur l’icône et choisissez configurer pour Créer un paramètre dans le mappage de valeurs
  1. Pour Récepteur, saisissez les informations suivantes :
    • CPI_API_HOST : Valeur de l’URL de l’étape 3.1
    • Nom de l’identifiant : Nom des identifiants du client OAuth2 déployés à l’étape 3.1
  2. Cliquez sur Déployer


3. Cliquez sur l’icône et choisissez configurer pour Créer des Paramètres d’entreprise dans le mappage de valeurs
  • Sous Récepteur
    1. Pour le récepteur R_CPI_API_Flow, saisissez les informations suivantes 
      • CPI_API_HOST : Valeur de l’URL de l’étape 3.1
      • Nom de l’identifiant : Nom des identifiants du client OAuth2 déployés à l’étape 3.1
    2. Pour R_Pleo, saisissez l’URL dans l’intégration de l’API Pleo
  • Sous Plus, fournissez les Paramètres nécessaires de l’entreprise :
    • CompanyID_S4 : Code de l’entreprise dans S/4HANA
    • CompanyName : Nom de l’entreprise dans Pleo
    • CreatedBy_S4 : Nom de l’utilisateur technique dans S/4HANA configuré à l’étape 1.3
    • Jeton : Jeton API généré pour S/4HANA dans les Paramètres du compte Pleo
  • Cliquez sur Déployer


4. Cliquez sur l’icône et choisissez configurer pour Créer des Paramètres de compte dans le mappage de valeurs
  1. Sous Récepteur, pour R_CPI_API, saisissez les informations suivantes :
    • CPI_API_HOST : Valeur de l’URL de l’étape 3.1
    • Nom de l’identifiant : Nom des identifiants du client OAuth2 déployés à l’étape 3.1
  2. Sous Plus, fournissez les Paramètres nécessaires de l’entreprise :
    • Account_AccountsPayable : Compte de rapprochement fournisseur utilisé dans les écritures du journal de facture et de paiement de facture
    • Account_DefaultSupplier : Identifiant de compte par défaut pour le fournisseur dans SAP
    • Account_Pocket : Compte général utilisé pour les écritures de journal des avances de frais, des frais kilométriques et des indemnités journalières
    • Account_Reimbursement : Compte général utilisé pour les écritures de journal de remboursement externe et direct
    • Account_Wallet : Compte général utilisé pour les écritures de journal des achats par carte, des restitutions de fonds et des rétrofacturations
    • CompanyName : Nom de l’entreprise dans Pleo
    • Type_Atm_Withdrawal : Type d’entrée de journal dans S4 pour les retraits aux distributeurs automatiques
    • Type_Card_Invoicefacture: Type d’entrée de journal dans S4 pour les factures de carte
    • Type_Card_Purchase : Type d’entrée de journal dans S4 pour les achats par carte
    • Type_Cashback : Type d’entrée de journal dans S4 pour les cashbacks
    • Type_Chargeback : Type d’entrée de journal dans S4 pour les rétrofacturations
    • Type_Direct_Reimbursement : Type d’entrée de journal dans S4 pour les remboursements directs
    • Type_External_Reimbursement : Type d’entrée de journal dans S4 pour les remboursements externes
    • Type_Invoice : Type d’entrée de journal dans S4 pour les factures
    • Type_Invoice_Payment : Type d’entrée de journal dans S4 pour les paiements de factures
    • Type_Mileage : Type d’entrée de journal dans S4 pour les demandes de frais kilométriques
    • Type_Out_Of_Pocket : Type d’entrée de journal dans S4 pour les notes de frais
    • Type_Per_Diem : Type d’entrée de journal dans S4 pour les indemnités journalières
    • Type_Refund : Type d’entrée de journal dans S4 pour les restitutions de fonds
  3. Cliquez sur Déployer


5. Cliquez sur l’icône et choisissez configurer pour Créer des Paramètres d’exportation de tags dans le mappage de valeurs
  1. Sous Récepteur, pour R_CPI_API, saisissez les informations suivantes :
    • CPI_API_HOST : Valeur de l’URL de l’étape 3.1
    • Nom de l’identifiant : Nom des identifiants du client OAuth2 déployés à l’étape 3.1
  2. Sous Plus, fournissez les Paramètres nécessaires de l’entreprise :
    • CompanyName : Nom de l’entreprise dans Pleo
    • S4_CostCenter_Category : Codes de catégorie pour le Centre de coûts séparés par ,
    • S4_InternalOrder_ControllingArea : Code pour la zone de contrôle d’ordre interne (1 seule valeur)
    • S4_InternalOrder_OrderType : Code pour le type de commande d’ordre interne (1 seule valeur)
    • S4_WBS_Project : Valeur de filtre pour les attributions de projet séparées par ,
  3. Cliquez sur Déployer


6. Cliquez sur l’icône et choisissez configurer pour Créer un groupe de tags dans Pleo
  1. Sous Récepteur
    1. Pour le récepteur R_CPI_API_Flow, saisissez les informations suivantes 
      • CPI_API_HOST : Valeur de l’URL de l’étape 3.1
      • Nom de l’identifiant : Nom des identifiants du client OAuth2 déployés à l’étape 3.1
    2. Pour R_Pleo, saisissez l’URL dans l’intégration de l’API Pleo
  2. Sous Plus, fournissez les Paramètres nécessaires de l’entreprise :
    • CompanyName : Nom de l’entreprise dans Pleo
    • TG_CostCenter : Nom du groupe de tags pour le Centre de coûts dans Pleo
    • TG_InternalOrder : Nom du groupe de tags pour l’Ordre interne dans Pleo
    • TG_WBS : Nom du groupe de tags pour l’élément WBS dans Pleo
  3. Cliquez sur Déployer


7. Cliquez sur l’icône et choisissez configurer pour Exporter les dépenses de Pleo vers S4
  1. Sous Récepteur
    • Pour R_PLEO_JOBS_API, saisissez l’URL de l’intégration de l’API Pleo
    • Pour R_S4_CREATE_ENTRY, saisissez les informations suivantes :
      • Adresse : Adresse URL de l’API SOAP – {Cloud_Connector URL}/{service path}/{service name}/{service binding}
        • Connecteur cloud de l’étape 2.1
        • Nom du service de l’étape 1.1
        • Liaison de service de l’étape 1.1
      • Type de proxy : Sur site/Internet (selon le système cible)
      • ID de l’emplacement : ID du Connecteur Cloud associé à partir de l’étape 2.1
      • Authentification: Basique/Certificat client
        • Pour le Nom d’Identifiant basique : Nom de l’Identifiant de l’utilisateur depuis le magasin de sécurité de l’étape 3.1
        • Pour le certificat client Alias de la clé privée : Nom de l’alias du certificat du Keystore de l’étape 3.1
    • Pour R_S4_PING, fournissez le paramètre S4_URL comme adresse vers le connecteur Cloud depuis l’étape 2.1
  2. Cliquez sur Déployer


8. Cliquez sur l’icône et choisissez configurer pour Exporter les tags de Pleo vers S4
  1. Sous Récepteur
    1. Pour R_PLEO API, saisissez l’URL vers l’intégration de l’API Pleo
    2. Pour R_S4, saisissez les informations suivantes :
      • S4_Host : URL de l’étape 2.1 de la configuration de Cloud Connect
      • Type de proxy : Sur site/Internet (selon le système cible)
      • ID de l’emplacement: ID du Connecteur Cloud associé de l’étape 2.1
      • Authentification: Basique/Certificat client
        • Pour le Nom d’Identifiant basique : Nom de l’Identifiant de l’utilisateur depuis le magasin de sécurité de l’étape 3.1
        • Pour le certificat client Alias de la clé privée : Nom de l’alias du certificat du Keystore de l’étape 3.1
  2. Sous Plus, fournissez les Paramètres nécessaires de l’entreprise :
    • DateTimeFormat_S4 : valeur du format de date/heure
    • WBSODataV2 : Vrai (indicateur montrant que la version du système S/4HANA est antérieure à la version 2021 FPS01)
  3. Cliquez sur Déployer


9. Cliquez sur l’icône et choisissez configurer pour Planifier l’exportation des dépenses de Pleo vers S4
  1. Sous Récepteur
    1. Pour le récepteur R_CPI_API, saisissez les informations suivantes 
      • CPI_API_HOST : Valeur de l’URL de l’étape 3.1
      • Nom de l’identifiant : Nom des identifiants du client OAuth2 déployés à l’étape 3.1
    2. Pour R_Pleo, saisissez l’URL dans l’intégration de l’API Pleo
  2. Sous Plus, fournissez les Paramètres nécessaires de l’entreprise :
    • BypassTransactionDate : Vrai/Faux (Indicateur montrant la nécessité de mettre à jour la date de transaction dans S/4HANA)
    • UploadReceipts : Vrai/Faux (Indicateur montrant la nécessité de télécharger des pièces jointes dans S/4HANA)
    • ClosingPeriodDay : Jour spécifique du mois (1-31) après lequel les dépenses passées seront mises à jour
  3. Sous Minuterie, sélectionnez une exécution régulière pour l’exportation des dépenses ; par défaut, cela n’est fait que lorsque le calendrier est déployé.
  4. Cliquez sur Déployer


10. Cliquez sur l’icône et choisissez configurer pour Planifier l’Exportation de Tags de Pleo vers S4
  1. Sous Récepteur
    1. Pour le récepteur R_CPI_API, saisissez les informations suivantes 
      • CPI_API_HOST : Valeur de l’URL de l’étape 3.1
      • Nom de l’identifiant : Nom des identifiants du client OAuth2 déployés à l’étape 3.1
  2. Sous Minuterie, sélectionnez une exécution régulière pour l’exportation des tags ; par défaut, cela n’est fait que lorsque le calendrier est déployé.
  3. Cliquez sur Déployer




Cet article a-t-il été utile ?

C'est super !

Merci pour votre commentaire

Désolé ! Nous n'avons pas pu vous être utile

Merci pour votre commentaire

Dites-nous comment nous pouvons améliorer cet article !

Sélectionner au moins l'une des raisons
La vérification CAPTCHA est requise.

Commentaires envoyés

Nous apprécions vos efforts et nous allons corriger l'article