X12 943 - SAP S/4 HANA

A search request is performed on SAP S/4Hana for any unprocessed customer return entity which are treated as warehouse stock transfer advice records. If a customer return record is found, the matching outbound route is searched. If there is a match, the SAP S/4Hana customer return record JSON is translated to a EDI 943 and sent to the trading partner.

This section explains how to configure the integration between SAP S/4HANA to retrieve the warehouse receipt records and transform them to an EDI X12 943 format for the Trading Partner integration.

Configure

1. Schedulers: The LaunchWhseStockTransferPS.sched runs every 1 hour. To adjust these settings, refer to the steps in  Creating and Defining Process Schedules.
2. SAP S/4Hana. If the warehouse receipt is supposed to be converted to EDI 943 and then sent to the third-party logistic partners from the available warehouse receipt in SAP S/4Hana, then you must configure the custom field CIC_STATUS with a Pending value.
3. Outbound Route. In the in the customer return source payload, the SoldToParty identifies the Trading Partner to whom the 943 is supposed to be sent. SoldToParty is used in the look-up against the table SAPHANA_PARTNERS to find the partner id. If the Trading Partner name does not match the tpname,  then you must update the Outbound Route to reflect the matching name in the spreadsheet.
4. EDI Enveloper. The X12 943 envelope details and the trading partner endpoint to which the X12 943 has to be sent should be configured on the partner profile in CIC Cockpit. (Partners>Transactions>Settings)

Run the Flow

1. Before proceeding, ensure that the following Projects have been deployed. If any of these Projects are already deployed and remain unmodified, there is no need to redeploy them. Similarly, if any of these Projects were not checked out to your Workspace, they can be skipped from the deployment process.

• com._customer_booster.cim.saphana
• com._customer_.cim.saphana
• com.cleo.customer.edi
• com.cleo.b2bcloud.core
• com.cleo.b2biaas.clarify
• com.cleo.cic.cim.cockpit.rulesets
• com.cleo.cic.cim.schemas
• com.cleo.cic.cockpit.core
• com.cleo.cic.connector.saphana
• com.cleo.cic.pt.api
• com.cleo.cic.pt.edi.schemas
• com.cleo.cic.util

2. Run the flow either manually or automatically:

• Manually run the Business Process flow by launching LaunchWhseStockTransferBPS.
• Automatically run the Scheduler LaunchWhseStockTransferPS.sched to execute the flow based on the specified interval.

3. Monitor the flow by using the following

• CIC Studio Auditor log entries
• CIC Cockpit views: Messages, Jobs, Dashboard>Charts

In case of errors: If any of the processing steps fail, a ticket is created with the details; the same is visible in the CIC Cockpit's Message and Job views with the Issue Flag.  

For Outbound EDI validation use cases, see Validation Rules in the Transformation Settings object for validation rules.

Customize

1. You can change how often Invoices are retrieved from SAP S/4HANA. The LaunchWhseStockTransferPS BP Scheduler (in com.customer.booster.cim.saphana package) retrieves invoices every 1 hour. You can change this to run more or less frequently. To adjust these settings, refer to the steps in Creating and Defining Process Schedules.
2. Add more details to the X12 943 from the SAP S/4HANA Warehouse Receipt.

• The values that are being mapped are documented in the Integration design spec template.
• Contact Cleo support if you need any assistance while adding additional rules.