High- Level Specification
| Implementing System | S/4 Hana |
|---|---|
| Invoked by/Invokes | |
| Business Process Reference | 03.04.05.02. Manage Service Entry Sheets |
Functional Overview
Service Entry Sheets (SES) created by the Supplier in Suppliers Account of the Business Network against the previously created Service POs. Service Entry Sheet can contain planned service or unplanned service, with or without the hierarchy.
SES is send from Business Network as cXML document to CIG, where it's translated into SOAP message to be received in the S/4 Hana system.
Scope and Objectives
This document describes S/4 Hana inbound interface for receiving Service Entry Sheets from Business Network and the basic configuration needed in all the components in order for this interface to be operational.
Process Flow Diagram
Step | Description | Comment |
|---|---|---|
Supplier Creates Service Entry Sheet against Service PO received from S/4 Hana in the Suppliers Account of the Business Network | ||
Service Entry Sheet is routed to the Buyers Account in the Business Network | ||
Buyers Account sets To Credential on the Service Entry Sheet to the source of origin of the Purchase Order against which the Order Confirmation is created | ||
Service Entry Sheet is sent to the CIG | ||
CIG translates it to the SOAP message and sends it to the respective S/4 Instance - trough the Cloud Connector, based on the System ID set in the cXML Document. System ID is identical with the System ID of the original Purchase Order | ||
S/4 System receives the SOAP message and creates Service Entry Sheet agains the Purchase Order |
Assumptions
Service sheets with up to five levels of hierarchy (one parent item and four child line items) created against purchase orders containing service type line items from SAP Business Network are supported. Suppliers must create service sheets containing only one parent line item from a purchase order with multiple service type line items. Service sheets against the purchase order with service type line items can have both planned and unplanned line items. The service sheet must contain at least one-level service child line item in the hierarchical structure.
Dependencies
- CIG Addon installed in S/4 Hana
- Cloud Connector installed in Syensqo landscape
- Initial setup of CIG Addon is done already as described in ERP-92, section Configuration Requirements.CIG Configuration.
- Connectivity from CIG Addon to CIG is established, as described in ERP-92
- SAP note 1832628 must be applied
Security, Integrity and Controls
The following are the Security and Authorization considerations for this interface:
- Message exchange between S/4 and CIG is encrypted over https.
- Access to interface parameters in CIG Addon is only available to the person with access to the SPRO authorization.
- Access to the CIG is restricted to the integration administrators within Ariba Guided Buying or Ariba Business Network
Configuration Requirements
CIG Configuration
Project setup is required in CIG to cover product type Ariba Network. One project is required per system ID of the backend S/4 system - Global, US and China. Additional Settings are needed for ServiceEntrySheet Document Type
| Parameter Name | Value |
|---|---|
| Line TextID SES Request | F01 |
| DefaultLang | en |
| Header TextID SES Request | F01 |
CIG Routing
Each Soap message sent from S/4 Hana contains System ID reference. No additional routing is needed in the CIG Addon - any subsequential message related to the Purchase Order sent from the S/4 Hana will use the System ID of the Purchase Order as the system id of the follow up document from S/4 Hana
CIG Addon Configuration
Connection settings are identical with the previously specified interfaces - please refer to the ERP 854. On top of this, following setup is needed in SPRO :
- SAP Business Network Integration.Application Specific Settings.Service Sheet
- Maintain Parameters for Order Confirmation: set ENTRYSHEET_CREATE parameter with value 20, as described in the official documentation
Special Requirements
Not Applicable
Design Rationale
Not Applicable
API Use
Not Applicable
Data Structure
Standard mappings are a subject to change and are not linked in this documentation, latest excel sheet can be downloaded from CIG → Resources → Implementation Guides → Mapping Specs → Ariba Network
- ServiceSheetExportRequest
Mapping contains basic field mapping from the IDOC message into the cXML target structure with a basic logic explained in the pseudo code
Processing Logic
Processing within Source
Service Entry Sheet is submitted against the Purchase Order by the Supplier in the Suppliers account of the Business Network. Its routed to the Buyers Account of the Business Network and is routed to the source of of origin of the Original Purchase Order
Processing within Middleware
At this moment, standard transformation as referenced above is in place. In a case of any custom field is needed, custom field will be mapped in the CIG to the predefined custom field structure in the SAP
Processing within Target
SOAP message is processed by the Class CL_ARBCIG_SERVICE_ENTRY_SHEET (transaction SE24 to debug). Message can be retrieved in SRT_MONI transaction
Delta or Full Load Requirements
Interface Alert & Monitoring
Language Requirements
User Interface Requirements
Sequencing
Volumetrics
Performance Consideration
Error Handling
Testing
How to Test
Test Conditions and Expected Results
| ID | Condition | Expected Results |
|---|---|---|
Test Considerations/Dependencies
Other Information
Development Details
Package
| Package Name | Parent Package |
|---|---|
Other Development Objects
| Object Type | Object Name | Purpose/High Level Logic | Design Rationale Reference |
|---|---|---|---|