Bereid SAP S/4HANA On-Premise voor op de integratie

Diensten activeren

Configuratie in Cloud Connector

SAP-integratiesuiteconfiguratie

Integratiepakketconfiguratie

Deze stappen worden meestal uitgevoerd door een SAP-consultant of ontwikkelaar. Zij kunnen je helpen bij het voorbereiden van SAP S/4HANA voor de integratie met Pleo.


Stap 1: diensten activeren

Naam van dienst
Type

Beschrijving

Documentatie

JournalEntryCreateRequest

Confirmation_In



SOAP

Dienst voor synchroniseren van verwerking van logboekitems in S/4HANA



Logboekitem-API

API_CV_ATTACHMENT_SRV

ODATADienst voor documentbijlagebeheerBijlage-API

API_COMPANYCODE_SRV

ODATADienst voor het lezen van bedrijfsgegevensBedrijfscode-API
API_COSTCENTER_SRVODATADienst voor het lezen van kostencentraKostencentrum-API
API_PROJECT_V2 /
API_PROJECT_V3
ODATADienst voor het lezen van WBS-elementenAPI voor WBS-elementen



1. SOAP-diensten
  1. Voer transactie van soamanager uit
  2. Log in bij de web-wizard
  3. Klik op Configuratie van webservice
  4. Zoek naar:
    • Objecttype is Alles
    • Objectnaam is JOURNALENTRYCREATEREQUESTCONFI
  5. Selecteer de gevonden dienst
  6. Klik op Dienst maken
  7. Voeg de volgende gegevens toe:
    • Naam van dienst: JournalEntryPost
    • Nieuwe Bindingsnaam: JournalEntryPost
  8. Zorg voor Providersbeveiligingdoor de volgende opties te selecteren:
    • Beveiliging van transportniveau: geen (http)
    • Transportkanaalverificatie: gebruikers-ID/-wachtwoord
  9. In de SOAP-protocolfase houd je de standaardwaarde aan en klik je op Volgende
  10. Klik op Voltooien in Uitvoeringsinstellingen
  11. Zorg ervoor dat de Staat op het detailscherm Actief is



 2. OData-diensten 
  1. Documentbijlage
    1. Voer de transactie /n/IWFND/MAINT_SERVICE uit
    2. Filter op naam van externe dienst: API_CV_ATTACHMENT_SRV
    3. Zorg ervoor dat binnen ICF-opmerkingen de status Actiefis
      • Als de status niet actief is, klik je op ICF Node  en selecteer je Activeren
  2. Lees de bedrijfsgegevens
    1. Voer de transactie /n/IWFND/MAINT_SERVICE uit
    2. Klik op Dienst toevoegen
    3. Filter op technische servicenaam: API_COMPANYCODE_SRV
    4. Selecteer de rij met de dienst en klik op Geselecteerde diensten toevoegen
    5. Zorg ervoor dat Naam van technische dienst gelijk is aan API_COMPANYCODE_SRV 
    6. Klik onder Aanmaakgegevens op Lokaal object
    7. Voer de Pakkettoewijzing  in
    8. Sla de wijzigingen op
  3. Lees WBS-elementen V2 of V3
    1. Voer de transactie /n/IWFND/MAINT_SERVICE uit
    2. Filter op naam van externe dienst:
      • API_PROJECT_V2: als de versie van het systeem lager is dan 2021 fsp00 is
      • API_PROJECT_V3
    3. Zorg ervoor dat binnen ICF-opmerkingen de status Actiefis
      • Als de status niet actief is, klik je op ICF-node en selecteer jeActiveren
  4. Kostenplaats lezen
    1. Voer de transactie /n/IWFND/MAINT_SERVICE uit
    2. Filter op naam van externe dienst: API_COSTCENTER_SRV
    3. Zorg ervoor dat binnen ICF-opmerkingen de status Actief is
    4. Als de status niet actief is, klik je op ICF-node en selecteer jeActiveren


3. Authenticatie instellen 


  Voor basisauthenticatie: maak een technische gebruiker voor dienstenauthenticatie aan 
  1. Voer de /nsu01-transactie uit
  2. Voer de naam van de gebruiker in
  3. Klik op Technische gebruiker
  4. Selecteer Gebruikerstype: systeem
  5. Voer het wachtwoord in
  6. Klik op Bevestigen
  7. Voer PFCG-transactie uit
  8. Voer de naam van de functie in
  9. Klik op Enkele functie
  10. Ga naar het tabblad Menu
    1. Kies in Uit menu de optie Uit het SAP-menu, gevolgd door Lokaal
    2. Vink het Selectievakje voor accounting  aan
    3. Klik op Overschrijven 
    4. Sla de wijzigingen op
  11. Ga naar het tabblad Machtigingen
    1. Klik op Autorisatiegegevens wijzigen
    2. Klik op Handmatig
    3. Voer de volgende autorisatieobjecten in de lege velden in:
      • 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. Klik op Volledige autorisatie 
    5. Genereer een bijgewerkt gebruikersprofiel door te klikken op
  12. Ga naar het tabblad Functies
  13. Wijs de functie die in de vorige stap is gemaakt en SAP_BC_WEBSERVICE_CONSUMER toe aan deze technische gebruiker


  Voor klantcertificaat-verificatie: SSL-certificaat uploaden  
  1. Voer een STRUST-transactie uit
  2. Ga naar het tabblad SSL-standaardserver
  3. Klik op Certificaat importeren
  4. Kies het SLL-bestand en klik op Toevoegen aan certificaatlijst



Stap 2: configuratie in Cloud Connector

  1. Koppel het BTP-sub-account
    Gebruik de officiële SAP-documentatie:
  2. Maak koppelingen naar de S/4HANA
    1. Ga naar Cloud naar lokaal
    2. Voeg 2 rijen toe aan het systeem voor virtueel aan intern toewijzen binnen Toegangscontrole
      • HTTPS-protocol om toegang te krijgen tot SOAP- en OData-webservices 
      • RFC-protocol om toegang te krijgen tot BAPI's


Goed om te weten:

  • De poort en host moeten door je SAP-basisbeheerder worden verstrekt.
  • HTTPS-bronnen voor de DEV-omgeving kunnen worden gespecificeerd als /. 
  • Voor de productie moet dit beperkt worden tot de specifieke web service-trajecten.


Stap 3: configuratie van SAP-integratiesuite

 1. Gegevens beheren 
  1. CPI API-gegevens aanmaken
    1. Op het niveau van het SAP BTP-sub-account klik je op Services en navigeer je naar  Installaties en abonnementen 
    2. Klik op cf-api
    3. Klik met de rechtermuisknop op Gegevens bekijken 
    4. Kopieer de waarden voor clientid, clientsecret, takenurl en url
    5. Navigeer naar Beveiligingsmateriaal
    6. Klik op Aanmaken en kies OAuth2-klantgegevens in het keuzemenu
    7. Plak de eerder gekopieerde waarden in het pop-upvenster
    8. Klik op Implementeren
  2. Gegevens implementeren 
    1. Navigeer naar Beveiligingsmateriaal 
    2. Klik op Maken en kies Gebruikersgegevens
    3. Vul de benodigde gegevens in


 2. Integratiepakket 
  1. Installeer het integratiepakket
    1. Klik op Ontwerp en navigeer naar Integraties en API's 
    2. Klik op Importeren en kies de Pleo-integratie met het SAP S/4HANA-pakket


 3. Maak een bestemming voor BAPI-toegang 
  1. Klik op Verbinding en navigeer naar Bestemmingen
  2. Klik op Bestemming maken
  3. Verstrek de benodigde informatie:
    • Naam: BAPI_INTERNAL_ORDER_GETLOST
    • Type: RFC
    • Beschrijving: krijg een lijst van Interne Orders van S4H
    • Type proxy: lokaal
    • Gebruiker/wachtwoord: gegevens van de gebruiker zijn beschikbaar in S/4HANA
    • Autorisatietype: CONFIGURED_USER
    • Aanvullende eigenschappen: voeg 3 nieuwe waarden toe door op Nieuwe eigenschap te klikken
      • jco.client.ashost: virtuele host van Cloud-connector geconfigureerd in stap 2
      • jco.client.client: S/4HANA-klantnummer
      • jco.client.sysnr: S/4HANA-installatienummer


Stap 4: integratiepakketconfiguratie

1. Binnen de Pleo-integratie met SAP S/4HANA, navigeer je naar Artifacts 


2. Klik op het pictogram en kies Configureren voor  Parameter maken in Waardetoewijzing
  1. Voor Ontvanger, voer je de volgende gegevens in:
    • CPI_API_HOST: URL-waarde van stap 3.1
    • Referentienaam: naam van de OAuth2-klantgegevens ingezet in stap 3.1
  2. Klik op Implementeren


3. Klik op het pictogram en kies Configureren voor Bedrijfsinstellingen in Waardetoewijzing maken
  • Onder Ontvanger
    1. Voer voor ontvanger van R_CPI_API_Flowde volgende gegevens in 
      • CPI_API_HOST: URL-waarde van stap 3.1
      • Referentienaam: naam van de OAuth2-klantgegevens ingezet in stap 3.1
    2. Voor R_Pleo voer je de URL in voor de API-integratie van Pleo
  • Onder Meerverstrek je de benodigde bedrijfsinstellingen:
    • CompanyID_S4: bedrijfscode van S/4HANA
    • CompanyName: naam van bedrijf in Pleo
    • CreatedBy_S4: naam van technische gebruiker in S/4HANA die is geconfigureerd in stap 1.3
    • Token: API-token gegenereerd voor S/4HANA in de Pleo-accountinstellingen
  • Klik op Implementeren


4. Klik op het pictogram en kies Configureren voor Accountinstellingen in Waardetoewijzing maken
  1. Onder Ontvanger voor R_CPI_API, voer je de volgende gegevens in:
    • CPI_API_HOST: URL-waarde van stap 3.1
    • Referentienaam: naam van de OAuth2-klantgegevens ingezet in stap 3.1
  2. Onder Meerverstrek je de benodigde bedrijfsinstellingen:
    • Account_AccountsPayable: account voor leveranciersafstemming gebruikt in factuur en logboekitems van factuurbetalingen
    • Account_DefaultSupplier: standaardrekening-ID voor leverancier in SAP
    • Account_Pocket: grootboekrekening gebruikt voor zelf voorgeschoten uitgaven, kilometervergoedingen en dagvergoedingen van logboekitems
    • Account_Reimbursement: algemeen grootboekaccount gebruikt voor externe en directe logboekitems
    • Account_Wallet: algemeen grootboekaccount gebruikt voor logboekitems van kaartaankopen, terugbetalingen en terugboekingen
    • CompanyName: naam van het bedrijf in Pleo
    • Type_Atm_Withdrawal: type logboekitem in S4 voor geldopnames bij een geldautomaat
    • Type_Card_Invoice: type logboekitem in S4 voor kaartfactuur
    • Type_Card_Purchase: type logboekitem in S4 voor kaartaankopen
    • Type_Cashback: type logboekitem in S4 voor terugboekingen
    • Type_Chargeback: type logboekitem in S4 voor terugboekingen
    • Type_Direct_Reimbursement: type logboekitem in S4 voor directe declaraties
    • Type_External_Reimbursement: type logboekitem in S4 voor externe declaraties
    • Type_Invoice: type logboekitem in S4 voor facturen
    • Type_Invoice_Payment: type logboekitem in S4 voor factuurbetalingen
    • Type_Mileage: type logboekitem in S4 voor kilometervergoedingen
    • Type_Out_Of_Pocket: type logboekitem in S4 voor zelf voorgeschoten uitgaven
    • Type_Per_Diem: type logboekitem in S4 voor dagvergoedingen
    • Type_Refund: type logboekitem in S4 voor terugbetalingen
  3. Klik op Implementeren


5. Klik op het pictogram en kies Configureren voor Instellingen voor labelexports maken in Waarde toewijzen
  1. Onder Ontvanger voor R_CPI_API, voer je de volgende gegevens in:
    • CPI_API_HOST: URL-waarde van stap 3.1
    • Referentienaam: naam van de OAuth2-klantgegevens ingezet in stap 3.1
  2. Onder Meerverstrek je de benodigde bedrijfsinstellingen:
    • CompanyName: naam van bedrijf in Pleo
    • S4_CostCenter_Category: categoriecodes voor CostCenter gescheiden door ,
    • S4_InternalOrder_ControllingArea: code voor InternalOrder Controlling Area (slechts 1 waarde)
    • S4_InternalOrder_OrderType: code voor InternalOrder Ordertype (slechts 1 waarde)
    • S4_WBS_Project: filterwaarde voor projecttoewijzingen gescheiden door ,
  3. Klik op Implementeren


6. Klik op het pictogram en kies Configureren voor Labelgroep maken in Pleo
  1. Onder Ontvanger
    1. Voer voor ontvanger van R_CPI_API_Flowde volgende gegevens in 
      • CPI_API_HOST: URL-waarde van stap 3.1
      • Referentienaam: naam van de OAuth2-klantgegevens ingezet in stap 3.1
    2. Voor R_Pleo voer je de URL in voor de API-integratie van Pleo
  2. Onder Meerverstrek je de benodigde bedrijfsinstellingen:
    • CompanyName: naam van bedrijf in Pleo
    • TG_CostCenter: naam van labelgroep voor CostCenter in Pleo
    • TG_InternalOrder: naam van labelgroep voor InternalOrder in Pleo
    • TG_WBS: naam van labelgroep voor WBS-element in Pleo
  3. Klik op Implementeren


7. Klik op het pictogram en kies Configureren voor Uitgaven exporteren van Pleo naar S4
  1. Onder Ontvanger
    • Voor R_PLEO_JOBS_API voer je de URL naar de Pleo API-integratie in
    • Voor R_S4_CREATE_ENTRYvoer je de volgende details in:
      • Adres: URL-adres van SOAP-API: {Cloud_Connector URL}/{service path}/{service name}/{service binding}
        • Cloudconnector van stap 2.1
        • Dienstnaam van stap 1.1
        • Servicebinding van stap 1.1
      • Proxytype: lokaal / internet (afhankelijk van doelsysteem)
      • Locatie-ID: ID van de bijbehorende Cloud Connector uit stap 2.1
      • Authenticatie: basis / klantcertificaat
        • Voor basisreferentienaam: naam van gebruikersreferentie uit beveiligingsopslag uit stap 3.1
        • Voor klantcertificaat Privésleutelalias: naam van certificaatalias uit Keystore van stap 3.1
    • Voor R_S4_PING verstrek je de parameter S4_URL als een adres aan Cloud connector vanuit stap 2.1
  2. Klik op Implementeren


8. Klik op het pictogram en kies Configureren voor Labels exporteren van Pleo naar S4
  1. Onder Ontvanger
    1. Voor de R_PLEO API voer je de URL in voor de Pleo API-integratie
    2. Voor R_S4voer je de volgende gegevens in:
      • S4_Host: URL van Cloud Connect-configuratie stap 2.1
      • Proxytype: lokaal / internet (afhankelijk van doelsysteem)
      • Locatie-ID: ID van de bijbehorende Cloud Connector uit stap 2.1
      • Authenticatie: basis / klantcertificaat
        • Voor basisreferentienaam: naam van gebruikersreferentie uit beveiligingsopslag uit stap 3.1
        • Voor klantcertificaat Privésleutelalias: naam van certificaatalias uit Keystore van stap 3.1
  2. Onder Meerverstrek je de benodigde bedrijfsinstellingen:
    • DateTimeFormat_S4: waarde-indeling voor datum/tijd
    • WBSODataV2: waar (indicator dat S/4HANA-systeemversie minder is dan 2021 FPS01)
  3. Klik op Implementeren


9. Klik op het pictogram en kies Configureren voor Uitgaven exporteren van Pleo naar S4 inplannen
  1. Onder Ontvanger
    1. Voor de R_CPI_API-ontvanger voer je de volgende gegevens in 
      • CPI_API_HOST: URL-waarde van stap 3.1
      • Referentienaam: naam van de OAuth2-klantgegevens ingezet in stap 3.1
    2. Voor R_Pleo voer je de URL in voor de API-integratie van Pleo
  2. Onder Meerverstrek je de benodigde bedrijfsinstellingen:
    • BypassTransactionDate: waar / onwaar (indicator toont de vereiste om de transactiedatum bij te werken in S/4HANA)
    • UploadReceipts: waar / onwaar (indicator geeft aan of het noodzakelijk is om bijlagen naar S/4HANA te uploaden)
    • ClosingPeriodDay: specifieke dag van de maand (1-31) waarna eerdere uitgaven worden bijgewerkt
  3. Onder Timer selecteer je een reguliere uitvoering voor de export van uitgaven; standaard gebeurt dit alleen wanneer de planning is geïmplementeerd.
  4. Klik op Implementeren


10. Klik op het pictogram en kies Configureren voor Labels exporteren van Pleo naar S4 inplannen
  1. Onder Ontvanger
    1. Voor de R_CPI_API-ontvanger voer je de volgende gegevens in 
      • CPI_API_HOST: URL-waarde van stap 3.1
      • Referentienaam: naam van de OAuth2-klantgegevens ingezet in stap 3.1
  2. Onder Timer selecteer je een reguliere uitvoering voor de export van labels; standaard gebeurt dit alleen wanneer de planning is geïmplementeerd.
  3. Klik op Implementeren




Was dit artikel nuttig?

Dat is fantastisch!

Hartelijk dank voor uw beoordeling

Sorry dat we u niet konden helpen

Hartelijk dank voor uw beoordeling

Laat ons weten hoe we dit artikel kunnen verbeteren!

Selecteer tenminste een van de redenen
CAPTCHA-verificatie is vereist.

Feedback verzonden

We stellen uw moeite op prijs en zullen proberen het artikel te verbeteren