SAP S/4HANA On-Premise für die Schnittstelle vorbereiten

Dienste aktivieren

In Cloud Connector einrichten

Konfiguration der SAP Integration Suite

Konfiguration des Schnittstellenpakets

Diese Schritte werden in der Regel von einem:einer SAP-Berater:SAP-Beraterin oder einem:einerEntwickler:Entwicklerin durchgeführt. Er:Sie kann Ihnen dabei helfen, SAP S/4HANA für die Schnittstelle mit Pleo vorzubereiten.


Schritt 1: Dienste aktivieren

Dienstname
Typ

Beschreibung

Dokumentation

JournalEntryCreateRequest

Confirmation_In



SOAP

Dienst zum synchronen Verarbeiten von Journal-Einträgen in S/4HANA



Journal-Eintrags-API

API_CV_ATTACHMENT_SRV

ODATADienst zum Verwalten von DokumentenanhängenAnhangs-API

API_COMPANYCODE_SRV

ODATADienst zum Lesen von UnternehmensdatenUnternehmenscode-API
API_COSTCENTER_SRVODATADienst zum Lesen von KostenstellenKostenstellen-API
API_PROJECT_V2 /
API_PROJECT_V3
ODATADienst zum Lesen von WBS-ElementenWBS-Elemente API



1. SOAP-Dienste
  1. Führen Sie die Transaktion soamanager aus
  2. Loggen Sie sich im Web-Assistenten ein
  3. Klicken Sie auf Web Service Configuration
  4. Suchen Sie nach:
    • Object type ist „All“
    • Object name ist JOURNALENTRYCREATEREQUESTCONFI
  5. Wählen Sie den gefundenen Dienst
  6. Klicken Sie auf Create Service
  7. Fügen Sie die folgenden Details hinzu:
    • Service Name: JournalEntryPost
    • New Binding Name: JournalEntryPost
  8. Gewährleisten Sie die Provider Security, indem Sie die folgenden Optionen wählen:
    • Transport Level Security: None (http)
    • Transport Channel Authentication: User ID/Password
  9. Behalten Sie im SOAP protocol stage den Standardwert bei und klicken Sie auf Next
  10. Klicken Sie in den Operation settings auf Finish
  11. Stellen Sie sicher, dass der State auf dem Detailbildschirm Active ist



 2. OData-Dienste 
  1. Dokumentenanhang
    1. Führen Sie die Transaktion /n/IWFND/MAINT_SERVICE aus
    2. Filtern Sie nach External Service name: API_CV_ATTACHMENT_SRV
    3. Stellen Sie innerhalb der ICF notes sicher, dass der Status Activeist
      • Wenn der Status nicht aktiv ist, klicken Sie auf ICF Node  und wählen Sie Activate
  2. Unternehmensinformationen lesen
    1. Führen Sie die Transaktion /n/IWFND/MAINT_SERVICE aus
    2. Klicken Sie auf Add Service
    3. Filtern Sie nach Technical Service name: API_COMPANYCODE_SRV
    4. Wählen Sie die Zeile mit dem Dienst und klicken Sie auf Add Selected Services
    5. Stellen Sie sicher, dass der Technical Service name API_COMPANYCODE_SRV lautet  
    6. Klicken Sie unter Creation information auf Local Object
    7. Geben Sie die Package Assignment ein
    8. Speichern Sie die Änderungen
  3. WBS-Elemente V2 oder V3 lesen
    1. Führen Sie die Transaktion /n/IWFND/MAINT_SERVICE aus
    2. Filtern Sie nach External Service name:
      • API_PROJECT_V2, wenn die Systemversion niedriger als 2021 fsp00 ist
      • API_PROJECT_V3
    3. Stellen Sie innerhalb der ICF notes sicher, dass der Status Activeist
      • Wenn der Status nicht aktiv ist, klicken Sie auf ICF Node und wählen Sie Activate
  4. Kostenstelle lesen
    1. Führen Sie die Transaktion /n/IWFND/MAINT_SERVICE aus
    2. Filtern Sie nach External Service name: API_COSTCENTER_SRV
    3. Stellen Sie innerhalb der ICF notes sicher, dass der Status Active ist
    4. Wenn der Status nicht aktiv ist, klicken Sie auf ICF Node und wählen Sie Activate


3. Authentifizierung einrichten 


  Für die Basisauthentifizierung: Erstellen Sie eine:n technische:n Nutzer:in für die Dienste-Authentifizierung 
  1. Führen Sie die Transaktion /nsu01 aus
  2. Geben Sie den Namen des:der Nutzers:Nutzerin ein
  3. Klicken Sie auf Technical User
  4. Wählen Sie User type: System
  5. Geben Sie das Passwort ein
  6. Klicken Sie auf Confirm
  7. Führen Sie die Transaktion PFCG aus
  8. Geben Sie den Namen der Rolle ein
  9. Klicken Sie auf Single Role
  10. Gehen Sie zum Tab Menu
    1. Wählen in From Menu From the SAP Menu und dann Local
    2. Markieren Sie das Kontrollkästchen für Accounting 
    3. Klicken Sie auf Transfer 
    4. Speichern Sie die Änderungen
  11. Wechseln Sie zum Tab Authorisations
    1. Klicken Sie auf Change Authorization Data
    2. Klicken Sie auf Manually
    3. Geben Sie die folgenden Autorisierungsobjekte in die leeren Felder ein:
      • 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. Klicken Sie auf Full authorisation 
    5. Erstellen Sie ein aktualisiertes Nutzer:innenprofil durch Klicken auf
  12. Wechseln Sie zum Tab Roles
  13. Weisen Sie die im vorherigen Schritt erstellte Rolle und SAP_BC_WEBSERVICE_CONSUMER diesem:r technischen Nutzer:in zu


  Für die Mandant:innenzertifikatsauthentifizierung: Laden Sie das SSL-Zertifikat hoch 
  1. Führen Sie die Transaktion STRUST aus
  2. Gehen Sie zum Tab SSL Standard Server
  3. Klicken Sie auf Import certificate
  4. Wählen Sie die SLL-Datei aus und klicken Sie auf Add to certificate list



Schritt 2: In Cloud Connector einrichten

  1. Verbinden Sie sich mit dem BTP-Unterkonto
    Verwenden Sie die offizielle SAP-Dokumentation:
  2. Zuordnungen zu S/4HANA erstellen
    1. Gehen Sie zu Cloud to On-Premise
    2. Fügen Sie 2 Zeilen zu Mapping Virtual to Internal System unter Access controlhinzu
      • HTTPS-Protokoll, um auf SOAP- und OData-Webdienste zuzugreifen 
      • RFC-Protokoll, um auf BAPIs zuzugreifen


Gut zu wissen:

  • Port und Host sollten von Ihrem SAP Basis Administrator bereitgestellt werden.
  • HTTPS-Ressourcen für die DEV-Umgebung können angegeben werden als /. 
  • Für die Produktion sollten sie auf die spezifischen Webdienstpfade beschränkt werden.


Schritt 3:Konfiguration der SAP Integration Suite

 1. Zugangsdaten verwalten 
  1. CPI-API-Zugangsdaten erstellen
    1. Klicken Sie auf der Ebene des SAP-BTP-Unterkontos auf Services und navigieren zu  Instances and Subscriptions 
    2. Klicken Sie auf cf-api
    3. Klicken Sie mit der rechten Maustaste auf View Credentials 
    4. Kopieren Sie die Werte für clientid, clientsecret, takenurl und url
    5. Navigieren Sie zu Security Material
    6. Klicken Sie auf Create und wählen Sie im Dropdown-Menü OAuth2 Client Credentials
    7. Fügen Sie die zuvor im Pop-up-Fenster kopierten Werte ein
    8. Klicken Sie auf Deploy
  2. Zugangsdaten bereitstellen 
    1. Navigieren Sie zu Security Material 
    2. Klicken Sie auf Create und wählen Sie User credentials
    3. Tragen Sie die benötigten Informationen ein


 2. Schnittstellenpaket 
  1. Installieren Sie das Schnittstellenpaket
    1. Klicken Sie auf Design und navigieren Sie zu Integrations and APIs 
    2. Klicken Sie auf Import und wählen Sie das Pleo-Paket für die Schnittstelle mit SAP S/4HANA


 3. Ziel für den BAPI-Zugriff erstellen 
  1. Klicken Sie auf Connectivity und navigieren Sie zu Destinations
  2. Klicken Sie auf Create destination
  3. Geben Sie die erforderlichen Informationen an:
    • Name: BAPI_INTERNAL_ORDER_GETLOST
    • Type: RFC
    • Description: Liste der internen Aufträge aus S4H abrufen
    • Proxy Type: On-Premise
    • User/Password: in S/4HANA verfügbares Nutzer:innenzertifikat
    • Authorisation Type: CONFIGURED_USER
    • Additional properties– Fügen Sie 3 neue Werte hinzu, indem Sie auf „New Property“ klicken
      • jco.client.ashost: Virtueller Host des in Schritt 2 konfigurierten Cloud-Konnektor
      • jco.client.client: S/4HANA-Mandant:innennummer
      • jco.client.sysnr: S/4HANA-Instanznummer


Schritt 4: Konfiguration des Schnittstellenpakets

1. Navigieren Sie in der Pleo-Integration mit SAP S/4HANA zu Artifacts 


2. Klicken Sie auf das Symbol und wählen Sie configure für Create Parameter in Value mapping
  1. Geben Sie für Receiverdie folgenden Details ein:
    • CPI_API_HOST: URL-Wert aus Schritt 3.1
    • Credential Name: Name der OAuth2-Mandant:innen-Zugangsdaten, die in Schritt 3.1 bereitgestellt wurden
  2. Klicken Sie auf Deploy


3. Klicken Sie auf das Symbol und wählen Sie configurefür Create Company settings in Value mapping
  • Unter Receiver
    1. Geben Sie für den:die Empfänger:inR_CPI_API_Flowdie folgenden Details ein 
      • CPI_API_HOST: URL-Wert aus Schritt 3.1
      • Credential Name: Name der OAuth2-Mandant:innen-Zugangsdaten, die in Schritt 3.1 bereitgestellt wurden
    2. Geben Sie für R_Pleo die URL zur Pleo-API-Schnittstelle ein
  • Geben Sie unter Moredie erforderlichen Unternehmenseinstellungen an:
    • CompanyID_S4: Unternehmenscode aus S/4HANA
    • CompanyName: Name des Unternehmens in Pleo
    • CreatedBy_S4: Name des:der in Schritt 1.3 konfigurierten technischen Nutzers:in in S/4HANA
    • Token: API-Token, der in den Pleo-Kontoeinstellungen für S/4HANA generiert wurde
  • Klicken Sie auf Deploy


4. Klicken Sie auf das Symbol und wählen Sie configure für Create Account Settings in Value mapping
  1. Geben Sie unter Receiver für R_CPI_APIdie folgenden Details ein:
    • CPI_API_HOST: URL-Wert aus Schritt 3.1
    • Credential Name: Name der OAuth2-Mandant:innen-Zugangsdaten, die in Schritt 3.1 bereitgestellt wurden
  2. Geben Sie unter Moredie erforderlichen Unternehmenseinstellungen an:
    • Account_AccountsPayable: Verrechnungskonto für Händler:innen, das für Journaleinträge für Rechnungen und Zahlungen verwendet wird
    • Account_DefaultSupplier: Standardkonto-ID für Lieferant:innen in SAP
    • Account_Pocket: Hauptbuchkonto, das für Journaleinträge für Auslagen, Kilometerpauschalen und Verpflegungspauschalen verwendet wird
    • Account_Reimbursement: Hauptbuchkonto, das für Journaleinträge für Rückerstattungen außerhalb Pleos und direkte Rückerstattungen verwendet wird
    • Account_Wallet: Hauptbuchkonto, das für Journaleinträge für Kartenkäufe, Gutschriften und Rückbuchungen verwendet wird
    • CompanyName: Name des Unternehmens in Pleo
    • Type_Atm_Withdrawal: Art des Journaleintrags in S4 für Geldautomatenabhebungen
    • Type_Card_Invoice: Art des Journaleintrags in S4 für Kartenrechnungen
    • Type_Card_Purchase: Art des Journaleintrags in S4 für Kartenkäufe
    • Type_Cashback: Art des Journaleintrags in S4 für Cashbacks
    • Type_Chargeback: Art des Journaleintrags in S4 für Rückbuchungen
    • Type_Direct_Reimbursement: Art des Journaleintrags in S4 für In-App-Rückerstattungen
    • Type_External_Reimbursement: Art des Journaleintrags in S4 für Erstattungen außerhalb Pleos
    • Type_Invoice: Art des Journaleintrags in S4 für Rechnungen
    • Type_Invoice_Payment: Art des Journaleintrags in S4 für Rechnungszahlungen
    • Type_Mileage: Art des Journaleintrags in S4 für Kilometerpauschalen
    • Type_Out_Of_Pocket: Art des Journaleintrags in S4 für Privatauslagen
    • Type_Per_Diem: Art des Journaleintrags in S4 für Verpflegungspauschalen
    • Type_Refund: Art des Journaleintrags in S4 für Gutschriften
  3. Klicken Sie auf Deploy


5. Klicken Sie auf das Symbol und wählen Sie configure für Create Tag Export Settings in Value mapping
  1. Geben Sie unter Receiver für R_CPI_APIdie folgenden Details ein:
    • CPI_API_HOST: URL-Wert aus Schritt 3.1
    • Credential Name: Name der OAuth2-Mandant:innen-Zugangsdaten, die in Schritt 3.1 bereitgestellt wurden
  2. Geben Sie unter Moredie erforderlichen Unternehmenseinstellungen an:
    • CompanyName: Name des Unternehmens in Pleo
    • S4_CostCenter_Category: Kategorie-Codes für CostCenter, getrennt durch ,
    • S4_InternalOrder_ControllingArea: Code für InternalOrder im Controlling-Bereich (nur 1 Wert)
    • S4_InternalOrder_OrderType: Code für den Typ InternalOrder (nur 1 Wert)
    • S4_WBS_Project: Filterwert für Projektzuweisungen, getrennt durch ,
  3. Klicken Sie auf Deploy


6. Klicken Sie auf das Symbol und wählen Sie configure für Create Tag Group in Pleo
  1. Unter Receiver
    1. Geben Sie für den:die Empfänger:inR_CPI_API_Flowdie folgenden Details ein 
      • CPI_API_HOST: URL-Wert aus Schritt 3.1
      • Credential Name: Name der OAuth2-Mandant:innen-Zugangsdaten, die in Schritt 3.1 bereitgestellt wurden
    2. Geben Sie für R_Pleo die URL zur Pleo-API-Schnittstelle ein
  2. Geben Sie unter Moredie erforderlichen Unternehmenseinstellungen an:
    • CompanyName: Name des Unternehmens in Pleo
    • TG_CostCenter: Name der Tag-Gruppe für CostCenter in Pleo
    • TG_InternalOrder: Name der Tag-Gruppe für InternalOrder in Pleo
    • TG_WBS: Name der Tag-Gruppe für WBS-Element in Pleo
  3. Klicken Sie auf Deploy


7. Klicken Sie auf das Symbol und wählen Sie configure für Export Expenses from Pleo to S4
  1. Unter Receiver
    • Geben Sie für R_PLEO_JOBS_API die URL zur Pleo-API-Schnittstelle ein
    • Geben Sie für R_S4_CREATE_ENTRYdie folgenden Details ein:
      • Address: URL-Adresse der SOAP-API – {Cloud_Connector URL}/{service path}/{service name}/{service binding}
        • Cloud-Konnektor aus Schritt 2.1
        • Dienstname aus Schritt 1.1
        • Dienstbindung aus Schritt 1.1
      • Proxy Type: On-Premise/Internet (abhängig vom Zielsystem)
      • Location ID: ID des zugeordneten Cloud Connectors aus Schritt 2.1
      • Authentication:Basic/Client Certificate
        • Für Basic Certificate Credential Name: Name des Nutzer:innenzertifikats aus dem Security Store aus Schritt 3.1
        • Für Client Certificate Private key alias: Name des Zertifikat-Alias aus dem Keystore aus Schritt 3.1
    • Für R_S4_PING, geben Sie den S4_URL-Parameter als Adresse zum Cloud-Konnektor aus Schritt 2.1 an
  2. Klicken Sie auf Deploy


8. Klicken Sie auf das Symbol und wählen Sie configure für Export Tags from Pleo to S4
  1. Unter Receiver
    1. Geben Sie für die R_PLEO API die URL zur Pleo-API-Schnittstelle ein
    2. Geben Sie für R_S4die folgenden Details ein:
      • S4_Host: URL der Cloud Connect-Einrichtung aus Schritt 2.1
      • Proxy Type: On-Premise/Internet (abhängig vom Zielsystem)
      • Location ID: ID des zugehörigen Cloud Connectors aus Schritt 2.1
      • Authentication:Basic/Client Certificate
        • Für Basic Certificate Credential Name: Name des Nutzer:innenzertifikats aus dem Security Store aus Schritt 3.1
        • Für Client Certificate Private key alias: Name des Zertifikat-Alias aus dem Keystore aus Schritt 3.1
  2. Geben Sie unter Moredie erforderlichen Unternehmenseinstellungen an:
    • DateTimeFormat_S4: Wert für das Datums-/Zeitformat
    • WBSODataV2: True (Indikator dafür, dass die S/4HANA-Systemversion niedriger als 2021 FPS01 ist)
  3. Klicken Sie auf Deploy


9. Klicken Sie auf das Symbol und wählen Sie configure für Schedule Expenses Export from Pleo to S4
  1. Unter Receiver
    1. Geben Sie für den:die Empfänger:in R_CPI_APIdie folgenden Details ein 
      • CPI_API_HOST: URL-Wert aus Schritt 3.1
      • Credential Name: Name der OAuth2-Mandant:innen-Zugangsdaten, die in Schritt 3.1 bereitgestellt wurden
    2. Geben Sie für R_Pleo die URL zur Pleo-API-Schnittstelle ein
  2. Geben Sie unter Moredie erforderlichen Unternehmenseinstellungen an:
    • BypassTransactionDate: True/False (Indikator zeigt an, dass das Transaktionsdatum in S/4HANA aktualisiert werden muss)
    • UploadReceipts: True/False (Indikator zeigt an, dass Anhänge auf S/4HANA hochgeladen werden müssen)
    • ClosingPeriodDay: Bestimmter Tag des Monats (1–31), nach dem vergangene Ausgaben aktualisiert werden
  3. Wählen Sie unter Timer eine regelmäßige Ausführung für den Export von Ausgaben. Standardmäßig wird dieser nur durchgeführt, wenn der Zeitplan bereitgestellt wird.
  4. Klicken Sie auf Deploy


10. Klicken Sie auf das Symbol und wählen Sie configure für Schedule Tags Export from Pleo to S4
  1. Unter Receiver
    1. For R_CPI_APIreceiver, Enter the following details 
      • Geben Sie für den:die Empfänger:in R_CPI_API die folgenden Details ein 
      • Credential Name: Name der OAuth2-Mandant:innen-Zugangsdaten, die in Schritt 3.1 bereitgestellt wurden
  2. Wählen Sie unter Timer eine regelmäßige Ausführung für den Export von Tags. Standardmäßig wird dieser nur durchgeführt, wenn der Zeitplan bereitgestellt wird.
  3. Klicken Sie auf Deploy




War dieser Artikel hilfreich?

Das ist großartig!

Vielen Dank für das Feedback

Leider konnten wir nicht helfen

Vielen Dank für das Feedback

Wie können wir diesen Artikel verbessern?

Wählen Sie wenigstens einen der Gründe aus
CAPTCHA-Verifikation ist erforderlich.

Feedback gesendet

Wir wissen Ihre Bemühungen zu schätzen und werden versuchen, den Artikel zu korrigieren