Setup in SAP for Invoices

Follow the following steps to setup your SAP Business ByDesign (by your IT partner or by us) to be able to use Yokoy Connect for Yokoy Invoices.

1 User roles and permissions
2 Integration Settings

User roles and permissions

Before creating a business user, a service agent is needed. The service agent can be created by starting the New Service Agent common task, which belongs to the Business Partner Data, Project Management, or Supplier Base work center (loading... | SAP Help Portal). Please use the following data:

First Name: DATAUNIT
Last Name: Support User

After creating and saving the service agent you need to create a business User. To trigger the creation of the business user you need to click on the Button Request User.

Setting the right attributes and permissions

The new business user can be found under Application and User Management > User and Access Management > Business Users. There you search for the business user “DATA UNIT” and edit its attributes as follows:

Field	Content

Field	Content
User ID	DUYOK
Password	****** Save the initial password you set and provide it to the Integration provider.

After you saved it you can edit the access rights. The DUYOK business user needs the following access rights:

Work Center	View Assignment ID

Work Center	View Assignment ID

Work Center	View Assignment ID

Work Center	View Assignment ID
Application and User Management	`MESSAGE_BASED_COMMUNICATION_AR` `CERTIFICATE_ASSIGNMENT_WCVIEW` `ITS_COMMUNICATIONSCENARIOS` `COMMUNICATION_SYSTEM_WC_VIEW` `DATA EXTRACTION OVERVIEW` `EVENTNOTIFICATIONS_WCVIEW` `EVENTNOTIFICATIONSMONITORING_W` `ODATA_BYD_WOC_VIEW` `IAM_BUSINESSUSERS` `ITS_SERVICE_EXPLORER` `ITS_WEBSERVICEMESSAGEMONITOR`
Business Configuration	`BC_FINANCIALANDMGMTACCNTNG` `BC_GENERALBUSINESSDATA` `BC_BUSINESSAREAPURCHASING` `BC_DATAMIGRATION`
Business Partner Data	`BPM_SUPPLIERSCENTRAL` If you have not scoped the Personnel Administration WoC, please add the view below to the access rights. `BPM_EMPLOYEES`
Personnel Administration	If you have scoped the Personnel Administration WoC, please add the view below to the access rights. `HCM_PA_EMPLOYEES`
Supplier Base	`BPM_SUPPLIERS`
Supplier Invoicing	`SRM_WORK` `SRM_INVOICEENTRY` `SRM_INVOICESANDCREDITMEMOS` `SRM_RECURRINGINVOICES`
Payables	`BPM_SUPPLIERSFIN` `FIN_SUPPLIERACCOUNTS` `FIN_PAYMENTCLEARINGAP` `FIN_BALANCECONFIRMATIONAP`

Integration Settings

This page provides a description of the steps that have to be taken to set up the basic configuration in a SAP Business ByDesign and Yokoy to be able to connect both systems.

1. Communication System

In order to use the integration a communication scenario is needed. This scenario is very easy to create and needs to be named Yokoy. The communication system must be Internet. After saving click on Actions > Set to Active.

2. Communication Scenario

The communication scenarios are created to meet the needs of the integration. For each technology used a different communication scenario must be used.

Communication Scenario for OData

The communication scenario for the usage of OData services is already created by SAP. Therefore, nothing must be created in this case. The communication scenario is called OData Services for Business Objects . In the communication arrangement you can then add the services needed.

Communication Scenario for SOAP

Contrary to OData an own communication scenario for SOAP must be created. Please create a new communication scenario called SOAP Services for Business Objects or similar, if the name is already in use. In this communication scenario you can add the needed SOAP operations listed in the table below.

3. Communication Arrangement

The communication arrangement defines which services can be used to exchange business documents and data electronically with external systems.

Communication Arrangement for OData

When creating a ODATA communication arrangement you need to choose the communication system and scenario created before. Choose the authentication method User ID and Password. Define a password for the user and save it somewhere safe. Then you can choose the OData services, that can be used with this arrangement.

OData Service	Business Object	OData	Internal Documentation

OData Service	Business Object	Internal Documentation
`supplier`	Supplier
`supplierinvoices`	Supplier Invoices
`costcenter`	Cost Centre	https://dataunitag.atlassian.net/wiki/spaces/DUIN/pages/3665952769/Cost+Center#GET-CostCenter-(OData)

Communication Arrangement for SOAP

When creating a SOAP communication arrangement you only need to choose the communication system and scenario created before. Here again, you can choose the authentication method to User ID and Password. Please set the password of the user identical to the communication arrangement for OData.

4. Event Notification

Event Notifications are used to get a notification when an object is created, updated or deleted.

Event Notification	Business Object	Subscription	Internal Documentation

Event Notification	Business Object	Subscription	Internal Documentation
Yokoy_CostCenter	Cost Centre	Create, Updated	https://dataunitag.atlassian.net/wiki/spaces/DUIN/pages/3665952769/Cost+Center#Event-Notification-Employees%3A-YOKOY_CostCenter
Yokoy_Supplier	Supplier	Create, Updated, Delete	https://dataunitag.atlassian.net/wiki/spaces/YOKBYD/pages/3672637444/Supplier#Event-Notification-Suppliers%3A-YOKOY_Supplier