Professional Documents
Culture Documents
Setting Up Automated Purchase-To-Pay With SAP Ariba - Commerce Automation (J82)
Setting Up Automated Purchase-To-Pay With SAP Ariba - Commerce Automation (J82)
SAP S/4HANA
2020-09-17
1 Purpose. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2 Preparation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.1 How to Use this GuideHow to Use this Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.2 Installation Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
6 Application Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
6.1 Sub objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
INBOUND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
POLLING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
OUTBOUND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
EXTRACTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
6.2 Search in the Application Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
8 Manual SAP S/4HANA System Configuration for the Ariba Network Integration. . . . . . . . . . . . . .118
8.1 Define Basic Message Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
8.2 Schedule job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
8.3 Define Credentials and End Points for Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
8.4 Assign Network ID to Company Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
8.5 Map Company Code for Invoice Verification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
8.6 Map Tax Codes for Invoice Verification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
8.7 Map Tax Categories for CC Invoice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
8.8 Output Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
BRF+ Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
NAST Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
9 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
9.1 BAdI: Notification About Communications Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
9.2 Message Monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
This document describes the required technical configuration for the integration of SAP S/4HANA with the Ariba
Network. After the automated installation process is completed, you need to manually configure the settings
described in this guide. This document describes the setup of the:
● Direct connection between SAP S/4HANA and the Ariba Network (without using middleware)
● Connection via HCI
● Connection via PI
The chapter Direct connectivity setup is relevant to all systems, irrespective of the integration option (For example,
if you are going to use HCI or PI, you will also need to make the settings from chapter Direct connectivity setup).
Chapters "HCI settings" and "PI settings" are only relevant to systems with the respective integration option.
Once you completed this configuration guide, you will need to make some more settings in both, the SAP S/4HANA
system and the Ariba network buyer account that are described in the document “Ariba Network & Backend
Customizing”. For more information, see the Administration Guide for the Implementation of SAP S/4HANA, on
premise edition which is linked in the content library (included in the documentation package).
For more information about software product and version prerequisites, see the Product Availability Matrix .
For your convenience and to facilitate your work with this electronic document it has introduced several Text Form
Fields. These fields can be used to store your individual system landscape and scenario integration configuration
information details. This data is used in the following step-by-step descriptions automatically to enhance the
readability of this document.
Procedure
AN ID <ANXXXXXXXXXXX>
Host ldciqe4.wdf.sap.corp
PI Information
System ID <pi_system_id>
Client <pi_client>
Host pwdf6833.wdf.sap.corp
If you connect to Ariba Network via HCI or PI, you skip this chapter and do the SSL settings in the respective HCI/PI
chapters of this configuration guide.
When sending a cXML message to Ariba Network, the sender must authenticate itself. Ariba Network offers
different authentication methods (authentication with client certificate or Shared Secret password) that are also
supported by the add-on.
For direct connectivity, the SAP S/4HANA system always opens the connection by executing the following actions:
The on-premise component opens the connection to the Cloud, thus supporting the highest level of security. A
proxy or reverse proxy in the demilitarized zone (DMZ) is not required.
SAP S/4HANA system communicates with Ariba Network through the HTTPS protocol, encrypting transmitted
data.
1. If you opted for shared secret authentication, please continue with step 4. If you have opted for client
certificate authentication, you need to create a new identity. To create a new identify, on the Trust Manager
screen, choose Environment SSL Client Identities .(Information: You have to create a new Identify)
2. On the SSL Client Identities of System Overview change view, create the following settings:
Identity ARIBA
Proceed as follows:
1. Maintain the Shared Secret password in the Define Credentials for Ariba Network Customizing activity. For
more information, see Add-On Customizing.
The Shared Secret password is stored in the secure storage ABAP DB in SAP S/4HANA system.
The add-on supports a Shared Secret password for Ariba Network with a maximum length of 36 characters.
Note that for authentication with Shared Secret password, the Shared Secret password has to be provided in
the Sender element of the cXML payload.
According to security requirements, passwords must not be written to logs, protocols or traces. Therefore, the
Shared Secret password is not visible in transactions such as SXMB_MONI where the XML message
monitoring and tracing takes place since business users can also have authorization for message monitoring
transactions. However, when you activate an Internet Communication Framework (ICF) recording using
transaction SICF, the system logs the Shared Secret password in the corresponding ICF trace. This is
acceptable as far as security is concerned because the ICF recording is only for administrators and requires the
S_ADMI_FCD authorization.
2. In the profile of your account in the Ariba Network, select the Shared Secret authentication method in the
cXML setup.
If you opted for shared secret authentication, please skip this step.
Prerequisite
1. Get the client certificate from a Certification Authority (CA) which is trusted by Ariba.When you purchase a
signed digital certificate, it must refer to an organization that is trusted by Ariba Network. You can use a digital
certificate issued by any issuing organization, however it must reference a root certificate from a trusted
Certificate Authority.
2. Import the private key of the certificate into the SAP S/4HANA system by using Trust Manager (transaction
STRUST)
Only certificates in Personal Security Environment (PSE) format can be imported with Trust Manager.
Certificates in other formats must first be converted into PSE format. The conversion can be done using the
Procedure
Use
We recommend that you establish an SM59 connection to Ariba Network - just to be able to ping the network and
check technical reachability.
Before proceeding, it is important that you have uploaded the AN-Certificate (see chapter SSL Connection Setup
[page 8]
For HTTPS SSL encryption, you first have to get the server certificate from Ariba and then import it into the SAP S/
4HANA system using Trust Manager (transaction STRUST).
Procedure
SAP Menu Tools ALE ALE Administration Runtime Settings Maintain RFC
Destinations
2. On the Configuration of RFC Connections screen, select HTTP Connections to External Server and choose
Create.
3. On the RFC Destination screen, create the following settings:
Field Entry
4. Choose Enter.
5. Create the following settings on the respective tabs:
Technical Settings
Proxy User
Proxy PW Status
Logon with User Select the Do Not use a User radio button.
Logon with Ticket Select the Do Not Send Logon Ticket radio button.
Security Options
This section is only relevant if you opted for direct integration or HCI mediated Integration.
Procedure
Alternative approach:
If you do not have sufficient authorizations, a result can look like this:
No administration authorization
If you have all the necessary authorization, the result should be:
Log on to the Customizing Client, for example, client 100, and run the report SRT_ADMIN (without changing the
selection criteria).
You have to run this report in all clients with cXML exchange.
Use
Note
In this activity, you define a supervisor destination for the background RFC (bgRFC). Using the supervisor
destination, the system retrieves the configuration settings for the bgRFC scheduler and starts or stops the
schedulers as required on each application server.
With the supervisor destination, the system connects to the Ariba Network (AN) to find the right object and update
it.
Inbound destination refers to a destination within your system rather than an external system that is called. The
destination can be used later in the update report ARBERP_BUS2081_EXTRACT_STS_UPD (in the bgR F C Inbound
Destination field).
Prerequisite
Your IT administrator has defined an RFC destination (ABAP Connection) in transaction SM59, for example, with the
name BGRFC_SUPERVISOR.
● In client 000 of your SAP S/4HANA system, you have created a bgRFC supervisor user (with the user type
Service) in transaction User Maintenance (SU01), for example, user BGRFCSUPER. You have assigned the
Authorization Role for bgRFC Supervisor User (SAP_BC_BGRFC_SUPERVISOR) to the user BGRFCSUPER.
● In transaction Configur ation of RFC Connections (SM59), you have created a bgRFC supervisor destination, for
example, destination BGRFC_SUPERVISOR, with the following settings:
○ Connection type: 3 (ABAP Connections)
○ On the Technical Settings tab, you have left the Target Host field empty. This has the effect that the RFC
connection is used within the system where you have created it.
○ On the Special Options tab, you have specified the transfer protocol Classic with tRFC.
For more information, see SAP Help Portal at http://help.sap.com/nw70 Application Help Function-Oriented
View SAP NetWeaver by Key Capability Application Platform by Key Capability Platform-Wide Services
Procedure
IMG Menu Integration with Other SAP Components Integration Component for Ariba Network
Destination
2. On the bgRFC Configuration screen, navigate to the Define Inbound Dest. tab and create a new destination.
Choose any name, for example, ARBERP.
3. Choose Save.
4. Navigate to the Define Supervisor Dest. tab and specify the supervisor destination that you have created before
(SM59).
5. On the Scheduler: App. Server tab, enter all application servers that exist in your system landscape.
6. Save your entries.
Use transaction WSIDPADMIN, do not change selection criteria and schedule these jobs.
Procedure
Result
You receive a green status for all areas. Attention: This is essential.
This section is only relevant if you opted for direct integration. If you opted for HCI integration you need to make the
configuration described in chapter Define Outbound Services (Consumer Proxy) for Connection via SAP Cloud
Platform Integration (SCP) [page 25]
Procedure
IMG Menu Integration with Other SAP Components Integration Component for Ariba Network
Services
2. SOA Management (<Systemname;Client>) opens in a separate window. On the Service Administration tab,
choose the link to Web Service Configuration. All services have to be defined in this interface.
3. On the Web Service Configuration (<Systemname; Client>) view, click on the Design Time Object Search tab,
enter the following search criteria and choose Search to start the search:
The system brings up the outbound services. A configuration only has to be done for the services which exhibit
a direct communication with the AN.
Services communicating directly with the AN
4. Select service CO_ARBFND_PRX_GPDQ_OUT (Outbound Service from the Polling Client). Show and click Internal
Name).
5. Under Details of Consumer Proxy: CO_ARBFND_PRX_GPDQ_OUT, go to the Configurations tab and choose
Create - Manual Configuration .
6. In the guided configuration, you have to do several steps:
○ Step 1 Logical Port Name: Make the following entries and choose Next
○ Step 2 Consumer Security: Select the User ID/Password checkbox and choose Next
○ Step 3 HTTP Settings: In the Transport Binding Box, create the following settings:
Port Number of Proxy Host <Enter the Port Number of your Proxy Host>
In this Customizing activity, you can activate a set of Business Transaction Events (BTEs) to record changes made
to invoices in SAP S/4HANA system. A job that you schedule for report Extract Incoming Invoices relevant for
StatusUpdateRequest (ARBERP_BUS2081_EXTRACT_STS_UPD) sends the information about the changes to Ariba
Network in the Invoice Status Update cXML message.
If you select the Application Active checkbox, the system can process all alternative function modules assigned to
this Business Transaction Events (BTEs).
Procedure
IMG Menu Integration with Other SAP Components Integration Component for Ariba Network Application
Specific Settings Define Message Output Control
2. On the Select Activity View “Activate Business Transaction Event to Trigger Invoice Status Message”: Overview
screen, choose New Entries and create the following settings:
Use
SAP Application Interface Framework (SAP AIF) may be used to monitor the Ariba Network integration.
Test Mode
Check Views X
IMG Menu SAP Menu Tools Customizing Business Configuration SetsActivation of BC Sets
5. On the Business Configuration Sets: Activation screen, enter BC set "/AIF/BNARB_1610" and click "Activate BC
Set (F7)"
Use
In addition to activating the BC-Set you have to configure the Interface Determination in AIF.
IMG Menu Cross Application Components General Application Functions SAP Application Interface Frame
work System Configuration Interface Determination Interface Determination for Proxy Interfaces
2. On the Change View "Define Determination Key": Overview screen, choose New Entries and create the following
settings:
Intf.
Proxy Class Val.No Operator Value Namespace Intf. Name Vers
This chapter is only relevant if the connection to Ariba Network is made using SCP.
Before you configure the steps described in this section you need to finish the basic configurations described in
chapter Direct connectivity setup
4.1 Prerequisites
The purpose of this section is to describe how the connection between the application system SAP S/4HANA
system and the SCP tenant can be set up. A successful setup of this connection allows sending extracted data to
the SCP tenant, which will then replicate the data to Ariba Network.
This chapter is only relevant if you connect to Ariba Network via SCP!
Note
The steps described in this section must be performed only when the connection setup between the SAP S/
4HANA and the SCP Tenant does not exist. If such a connection has already been set up, you can skip this
section.
Client for example, 120 The client in the system-ID (SID) which
contains the source data
Note
This set of information is unique for every system (productive, test, development).
Field Data
Note
To get access to the tenant, an authorization via SCN user is needed, to develop and deploy the scenarios and
to deploy the keystore.
The detailed sequence of tasks depends on the desired communication security level and is explained in a separate
topic. In general, tasks are partitioned between the customer and SAP as follows:
SAP provides the requested tenants and tenant clusters for the customer.For each customer system connected to
SCP, separate resources (memory, CPU, and file system) are allocated in the SAP HANA Cloud. These resources
are referred to as tenants.
SAP configures the customer's tenants to support secure communication (as required for the chosen
authentication method).
Security configuration involves always tasks at the side of all connected communication partners, and, therefore,
different persons and roles are involved. The following figure shows the general setup when a tenant is connected
to a customer system (either a sender or a receiver).
As illustrated in the figure, the general set up is that one customer system (sender system) sends a message to the
tenant, and the tenant sends a message to another customer system (receiver system). To set up a secure
Let's assume that the tenant administrator would like to set up a secure connection to a receiver system based on
asymmetric (or: public) key technology (for example, using PKCS#7). In that case, the general pattern is that the
tenant administrator creates a key store with a key pair consisting of a private key (that always stays with the
tenant administrator) and a public key. The tenant administrator must hand over its public key to the related
communication partner - the receiver administrator. The way around, the receiver administrator hands over its
public key to the tenant administrator. The tenant administrator imports the public key of the receiver into the
tenant key store (and vice versa).
SCP services are either secured by certificates or by basic authentication. For the backend connection, a generic
certificate for the backend needs to be included into the build. The SAP S/4HANA system must be able to connect
to the Internet via https protocol as a prerequisite for communication from SAP S/4HANA to the Cloud Solution. A
certificate, which is signed by a valid Certification Authority is needed. This certificate needs to be imported via
transaction STRUST.
Note
For certificate-based authentication a certificate signed by one of the CA mentioned in the SCP, integration
service Operations Guide is mandatory. For a list of supported CAs see SAP Help Portal SAP HANA Cloud
Integration for process integration Designing and Operating Cloud Integration Content (for SCP) - PDF
Documentation Operating and Monitoring SCP Integration Load Balancer Root Certificates Supported by
SAP.
Procedure
Before you go on with the configuration in this section please ensure that you have completed the configurations in
chapter 3.
Procedure
IMG Menu Integration with Other SAP Components Integration Component for Ariba Network
Services
2. SOA Management (<Systemname;Client>) opens in a separate window. On the Service Administration tab,
choose the link to Web Service Configuration. All services have to be defined in this interface.
4. Consumer Security:
5. For Basic Authentication: Select the User ID/Password checkbox and choose Next
6. For Certificate Authentication: Select the X.509 SSL Client Certificate checkbox and choose Next
7. Messaging tab: In the field Message ID protocol, select Suppress ID Transfer
8. In the Transport Setting tab create the following settings.
Computer Name of Access URL SCP Worker Node URL. For example,
iflmapvb010v0082avtvlb-
v0082.intaas.hana.ondemand.com
Port Number of Proxy Host <Enter the Port Number of your Proxy Host>
9. Press Finish
10. To test the Ping Web services, under Details of consumer proxy: CO_ARBFND_PRX_GPDQ_OUT, choose Ping
Web Service or display this logical port and use the Icon in the header line Ping Web Service. A successful
message looks like this: “Web service ping failed (RC=403). Service Ping ERROR: Forbidden”.
4. Consumer Security:
1. For Basic Authentication: Select the User ID/Password checkbox and choose Next
2. For Certificate Authentication: Select the X.509 SSL Client Certificate checkbox and choose Next
5. Messaging tab: In the field Message ID protocol, select Suppress ID Transfer
6. In the Transport Setting tab create the following settings.
Computer Name of Access URL SCP Worker Node URL. For example,
iflmapvb010v0082avtvlb-
v0082.intaas.hana.ondemand.com
Port Number of Proxy Host <Enter the Port Number of your Proxy Host>
7. Press Finish
8. To test the Ping Web services, under Details of consumer proxy: CO_ARBFND_PRX_OADP_OUT choose Ping
Web Service or display this logical port and use the Icon in the header line Ping Web Service. A successful
message looks like this: “Web service ping failed (RC=403). Service Ping ERROR: Forbidden”.
The typical flow from SAP S/4HANA to ARIBA using SCP as middleware will be as follows:
SAP S/4HANA will call the outbound SOAP service to SCP using the settings in SOAMANGER.
SCP will receive the incoming message and without performing any mapping will call Ariba cXML gateway.
Ariba will send the response back, which will be routed back to SAP S/4HANA.
To connect with Ariba, you need to download the public certificate in order to make SSL Connection to Ariba:
1. For HTTPS SSL encryption, go to https:\\buyer.ariba.com and download the server certificate from Ariba
using your browser.
2. Add this certificate in your SCP tenant system.jks, by providing these certificates to Cloud operation team.
3. Following roles should be assigned to your SCN user, in SAP Cloud Platform Integration (SCP) tenant.
Address: /Ariba/Inbound
(This address has to be unique on SAP SCP, integration service Tenant. If this scenario
has to be deployed twice on same tenant, this address needs to be changed)
For certificate Authentication Choose Browse and select the certificate stored using step Export SAP S/4 Hana Public
Certificate.
5. Select the Receiver soap adapter, enter the following details in the Connection tab:
Address https://service.ariba.com/ANSapGateway.aw/ad/cxml
6. On the tenant menu choose Design. Click on your Integration package. Go to the artifacts tab.
7. Choose artifactS4_to_Ariba_Outbound, click on edit.
8. Select the sender soap adapter, enter the following details in the connection tab:
Address /Ariba/Outbound
(This address has to be unique on SAP SCP, integration service Tenant. If this scenario
has to be deployed twice on same tenant, this address needs to be changed)
For certificate Authentication Choose Browse and select the certificate stored using step Export SAP S/4 Hana Public
Certificate.
9. Select the Receiver soap adapter, enter the following details in the Connection tab:
Address https://service.ariba.com/ANSapGateway.aw/ad/cxml
This chapter is only relevant if the connection to Ariba Network is made using PI.
Use
You use the Software Update Manager to deploy the cXML adapter module on your SAP NetWeaver PI system.
Procedure
For more information see the appropriate SUM guide on Service Marketplace -> SAP NetWeaver -> SAPNetweaver
7.XX -> Upgrade -> Software Update Manager 1.0
After deployment check for the adapter version of adapter under System Information->Component info in PI
System Java server start page. It should be 1000.13.6.0.0.0.
Use
The validation engine uses the following files to resolve and identify the location of the DTDs related to the
exchanged cXML documents.
Note
In case you upgrade to a newer release of the Ariba Network Adapter for SAP NetWeaver PO, you have to update
the additional resources in your catalog directory to the latest catalog *.xml files.
Procedure
CanonicalCatalog.xml
Use
Procedure
1. Go to <SAP instance>\j2ee\console.
2. Run the textconsole.bat or textconsole.sh file. The Telnet console appears.
3. Log in with the relevant admin user.
4. Run the following at the telnet prompt:
on_prerequisite_error =stop
Note
If there is an offline undeployment, Telnet connection to host might be lost and the following message appears.
Use
Procedure
Note
To upgrade to the latest version of the Ariba Network Adapter for SAP NetWeaver, you must first undeploy the
existing adapter and then deploy the latest version that you have downloaded from connect.ariba.com.
The authentication of data exchange between Ariba Network and Ariba Network Adapter for SAP NetWeaver is
performed using either one of the following:
The following table illustrates the different credential modes for Ariba Network Adapter and its authentication
structures:
Credential
DUNS
DUNS Port
Key Password
Port
These settings are adjusted in the cXML Receiver and Sender Channels in Integration Directory.
The authentication of data exchange between Ariba Network and Ariba Network Adapter for SAP NetWeaver using
shared secret requires setting up shared secret credentials on both parties involved in the data transfer.
Procedure
1. Log in to your Ariba Network Buyer account and access the cXML Setup page.
Please consider this as template settings for a Shared Secret functionality in the Process Integration
Communication Channels that will be configured in Chapter 5.7
Procedure
2. In the PI Tools area, choose the link to open the SAP NetWeaver Integration Builder within the Integration
Directory area.
3. On the Objects tab of the Integration Builder, use the following navigation path:
4. Open the Communication Channel you want to create or change authentication settings.
Note
Both Receiver and Sender cXML communication channels require authentication accordingly.
Authentication
Shared secret
Credential Mode
Network Id / Network User Id / DUNS
Credential Domain
CNDJ6nn5us4RjIIAqgBLqQsCAAAACAAAAAYAAABhAG4AXwBpAGQAAAA=
Credential REF an_id \h \* MERGEFORMAT <ANXXXXXXXXXXX>
Shared Secret Password
<Shared Secret Password created in Ariba Buyer Account>
The authentication of data exchange between Ariba Network and Ariba Network Adapter for SAP NetWeaver is
performed using authentication keys and certificates that are part of the SAP NetWeaver Keystore.
SAP NetWeaver PI provides functionality to manage and administer authentication certificates and keystores. As
part of this functionality, you can create keys and certificates in SAP NetWeaver and store them in the SAP
NetWeaver Keystore. The keys and certificates that you create in SAP NetWeaver Keystore are grouped based on
views. Therefore, you first need to create a view and then create the required keys and certificates under that view.
After you have created the required certificates, you must get them signed by a trusted Certificate Authority (CA)
to enable Ariba Network to successfully establish the SSL connection.
For information on how to create views, keys, and certificates within the SAP NetWeaver Keystore, refer to the SAP
NetWeaver PI documentation on the SAP Help Portal at http://help.sap.com.
The authentication of data exchange between Ariba Network and Ariba Network Adapter for SAP NetWeaver using
certificates requires setting up certificate credentials on both parties involved in the data transfer.
Procedure
1. Log in to your Ariba Network Buyer Account and access the cXML Setup page.
Procedure
2. In the PI Tools area, choose the link to open the SAP NetWeaver Integration Builder within the Integration
Directory area.
3. On the Objects tab of the Integration Builder, use the following navigation path.
4. Open the Communication Channel you want to create or change authentication settings.
Note
Both Receiver and Sender cXML communication channels require authentication accordingly.
5. Switch to Edit mode.
6. Adjust Authentication details according to the following table:
Authentication
Shared secret
Credential Mode
Network Id / Network User Id / DUNS
Credential Domain
<Shared Secret Password created in Ariba Buyer Account>
Credential
Import the product and component definitions of Ariba products that will work with SAP NetWeaver PI, as a CIM
file.
Procedure
2. In the PI Tools area, choose the link to open the SAP NetWeaver System Landscape Directory (SLD) in
the System Landscape area. Alternatively, use the following link to navigate to the SLD:
4. Choose the Browse button to find the file location of files exported from the
AribaNetworkAdapterSAPNetweaver.SoftwareCatalog.zip under Archive\XI_Mapping_Services on your
client.
5. To import the file, choose the Import… button.
6. Check if the import was successful.
7. Product “ASN” with corresponding component “ARIBA_SUPPLIER_CONN_ADAPTER” is to be listed with
correct details in the Software Catalog (compare with the following table).
Version: NW04.1
Vendor: ariba.com
Version: CI6
Vendor: ariba.com
Result
The Integration Repository and Directoryhas recognized the Ariba Network Adapter for SAP NetWeaver.
Use
The System Landscape Directory is a central repository that captures information on the systems and software in
the customer environment. It consolidates the information about components actively available, and on which
machines, instances, and clients they are available. This solution package involves three different systems that
need to be maintained in SLD. Initially, the following tasks are required:
Note
This configuration step is optional if the system is already defined in your SLD. In this case, you are required to only
update product and software component associations for the technical and business systems.
We recommend using the SLD Data Supplier Function (RZ70) to schedule an automated SLD registration of the
technical system.
Procedure
ChooseTechnical Systems on the main SLD page to open the Technical System page.
In the Wizard, choose from the following system types to define the technical system according to your
requirements:
1. Third-Party as the technical system type to set up a third-party (non-SAP) application for NetWeaver PI File
System and Ariba Network
2. Specify the system details according to the following scheme.
NetWeaver PI File System
Host name
pwdf6833.wdf.sap.corp
Ariba Network
Host name
ariba
3. Choose Next.
4. Associate the ASC Connector product and component to the system. Scroll down the list to select the product
ASN NW04, defined earlier, and then choose Add.
You can also filter to select the product to associate.
5. Select the installed software component ARBA_SUPPLIER_ADDON_CONN_ADAPT of Versions CI6.
6. Choose Finish.
In the Wizard, choose from the following system types to define the technical system according to your
requirements. Select Third-Party as the technical system type to associate the business system with Ariba Network
System
System ASN
TS_ASN on ariba
Note
2. Enter the business system name corresponding to its technical system, for example:
System PI
BS_<pi_system_id>CLNT<pi_client>_File
System ASN
BS_ASN
3. Choose Next.
4. Specify the installed products. Select the products to be installed in the business system.
Caution
Make sure that the product ASN, NW04.1 and the related components ARBA_SUPPLIER_ADDON_CONN_ADAPT,
CI6 of ariba.com, installed on the technical system, are selected for the Ariba Network business system.
1. Choose Finish.
To enable communication between SAP NetWeaver PI and SAP S/4HANA using cXML documents, it is required to
configure the following parameters on the SAP NetWeaver PI ABAP stack:
Procedure
Description
Path Prefix
Logon & Security Provide Logon credentials for Logon Procedure (Basic Authentication)
Procedure
2. In the PI Tools area, choose the link to open the SAP NetWeaver Enterprise Service Builder in the Enterprise
Service Repository (ESR) area.
3. Select profile ESR Connectivity and start. (If this step is not applicable, continue with step 4.)
Note
When you start the ESR the first time, it might take several times to initialize the tool.
5. Select the downloaded *.tpz file after selecting Client as source system.
6. To import the AribaNetworkAdapterSAPNetweaver_SapAddOn.tpz file, choose the Import… button.
7. As a result, ESR objects appear under the software component ARBA_SUPPLIER_ADDON_CONN_ADAPT and
software component version ARBA_SUPPLIER_ADDON_CONN_ADAPT CI6 of ariba.com
The Integration Directory configuration of the Ariba Network Integration for SAP Business Suiterapid-deployment
solution uses the information on the technical and business systems from the SLD. You must assign the business
systems defined and involved in the integration setup.
Procedure
2. In the PI Tools area, choose the link to open the SAP NetWeaver Integration Builder in the Integration Directory
area.
3. On the Objects tab of the Integration Builder, use the following navigation path:
Eventually, activate the Object View to make the following paths visible.
4. In the context menu of Business System, choose Assign Business System to start the wizard.
5. Choose Continue.
6. Choose Business Systems. Select the following business systems you have created before:
○ BS_ASN
○ BS<S4 System ID>CLNT<S4 Client >
Note
In the case of Multi-ERP implementation, you must select all business systems representing your SAP
S/4HANA instances involved in the integration.
You need to configure the integration scenario for the Purchase Order transaction in the Integration Directory to be
able to run the transaction. It is important that all steps of a configuration scenario section have been completed.
Before running the next steps, you have to ensure that the Design package has been imported into your system and
is ready.
The following steps assume that the different business systems are defined in the SLD. For more information about
configuring the SLD, see the section Configure System Landscape Directory [page 38]
● Transfer the integration scenario from the Integration Repository to the Integration Directory
● Configure the communication channels
● Configure the integration scenario
● Activate the new configuration
The following figure illustrates the data flow of the Purchase Order transaction.
Use
The first step to configure the integration scenario for the Purchase Order transaction is to transfer it to the
Integration Directory. The integration scenario is loaded into the Integration Repository when the Design package is
imported.
2. In the PI Tools area, choose the link to open the SAP NetWeaver Integration Builder in the Integration Directory.
3. To start the Transfer Wizard, use the following navigation option:
4. In the first screen of the Transfer Model from ES Repository wizard, choose the Process Integration Scenario
option for Type of ES Repository Model.
5. In the Name field, choose the following Process Integration Scenario from the Enterprise Services Repository
using the value help:
Name AR_AddOn_PurchaseOrder_Receive
Namespace http://ariba.com/xi/ASN/AddOn/PurchaseOrder
6. Choose Apply.
7. Choose Continue.
8. Change the name of the configuration scenario to CS_PurchaseOrder_Receive .
9. Choose Finish.
When the transfer is complete, the Model Configurator window appears.
10. Close the Model Configurator.
Procedure
1. On the Objects tab of the Integration Builder, use the following navigation path:
2. In the context menu of Communication Channel, choose New to start the Create Object wizard.
3. Use the following settings. Verify the information that is automatically inserted.
4. Open the Communication Channel menu and select menu item Apply Template and search for the following
channel template:
Name CCT_AddOn_PurchaseOrder_cXML_Receiver
Namespace http://ariba.com/xi/ASN/AddOn/PurchaseOrder
Deployment Mode
Test
Mode
Credential Information
Network ID
Credential Domain
Ariba Buyer ID (AN****)
Credential
Authentication
TrustedCAs
Trust Store View
Client Certificate
Credential Mode
TrustedCAs
Keystore View
52300
Port
Note
2. For Shared Secret adjust Authentication details according to the following table:
Authentication
TrustedCAs
Trust Store View
Shared secret
Credential Mode
<Shared Secret Password created in Ariba Buyer
Shared Secret Password Account>
AN ID AN01000000001
Language en-US
Number 1
Procedure
Name AR_AddOn_PurchaseOrder_Receive
Namespace http://ariba.com/xi/ASN/AddOn/PurchaseOrder
Multi-ERP ImplementationsFor Multi-ERP implementation, add multiple business services defined for your multiple SAP S/
4HANA systems by repeating the steps 7 and 8.
Note
If no corresponding system is displayed in the list, change the value for Search Criteria from For Product
<Product> to All Business System Components.
9. Either use the Configure Connections button in the upper left toolbar or directly click the arrows connecting
different actions to switch between connections.
10. Once a connection is selected (color of both involved actions changes to red), you have to specify the
corresponding Communication Component on the lower Sender and Receiver Business Systems Components
tab.
11. Assign the following systems using the value help to open the Choose Communication Component dialog.
Proxy_Send cXML_Reveive
Compo BS_<S4
nent System
ID>CLNT<
Channel
S4 Client
>
Not re
quired
Compo BS_ASN
nent
CC_Pur
Channel chaseOr
der_cXML
_Receiver
12. To check your configured model, choose Check Configurability on the lower left toolbar. If errors are shown,
review the previous configuration steps.
13. If check is successful, choose Create Configuration Objects…
14. Select general option Generation. Leave standard options as displayed.
15. Choose Start and wait for the wizard to finish.
Procedure
You must configure the integration scenario for the Order Confirmation transaction in the Integration Directory to
be able to run the transaction. All the steps of a configuration scenario section must be completed to fully
configure a scenario.
Note
Ensure that the design is imported into your system and ready before you run these steps. The following steps
assume that the different business systems are defined in the SLD. For more information about configuring the
SLD, see the section Configure System Landscape Directory [page 38]
● Transfer the integration scenario from the Integration Repository to the Integration Directory
● Configure the communication channels
● Configure the integration scenario
● Activate the new configuration
The following figure illustrates the data flow of the order confirmation transaction.
Use
The first step to configure the integration scenario for the Order Confirmation transaction is to transfer it to the
Integration Directory. The integration scenario is loaded into the Integration Repository when the design is
imported.
Procedure
2. In the PI Tools area, choose the link to open SAP NetWeaver Integration Builder in the Integration Directory
area.
3. To start the Transfer Wizard, choose Tools Apply Model from ES Repository…
4. On the first screen of the Transfer Model from ES Repository wizard, select Process Integration Scenario option
for Type of ES Repository Model.
5. In the Name field, use the value help and select the following Process Integration Scenario from the Enterprise
Services Repository.
Name AR_Addon_OrderConfirmation_Send
Namespace http://ariba.com/xi/ASN/AddOn/OrderConfirmation
6. Choose Apply.
7. Choose Continue.
8. Change the naming for the configuration scenario to CS_OrderConfirmation_Send
9. Choose Finish.
Once the transfer is completed, the Model Configurator window appears.
Procedure
1. On the Objects tab of the Integration Builder, use the following navigation path.
2. In the context menu of Communication Channel, choose New to start the Create Object wizard.
3. Verify that the following information is correct. Some information is automatically inserted.
4. Open the Communication Channel menu and select menu item Apply Template and search for the following
channel template.
Name CCT_AddOn_OrderConfirmation_cXML_Sender
Namespace http://ariba.com/xi/ASN/AddOn/OrderConfirmation
Note
Deployment Mode
Test
Mode
Note
Deployment Mode is set to default value. Check whether this setting matches your requirements. For more
information about this parameter, see the following sections in the Appendix:
○ 5.8.1.1 Adapter Status
Credential Information
Network ID
Credential Domain
Ariba Byer ID (AN****)
Credential
Authentication
TrustedCAs
Trust Store View
Client Certificate
Credential Mode
TrustedCAs
Keystore View
52300
Port
Note
Credential Mode, Client Certificate are set to default values. Check whether these settings match your
requirements. For more information about this parameter, see the following sections in the Appendix:
○ 5.8.1.2 Authentication
○
Authentication
TrustedCAs
Trust Store View
Shared secret
Credential Mode
<Shared Secret Password created in Ariba Buyer
Shared Secret Password Account>
AN ID AN01000000001
Language en-US
Note
AN ID, User Agent, Language, GetProfile Interval, GetPending Interval, Max Documents in GetPending and
cXML Version are set to default values. Check whether these settings match your requirements. For more
information about this parameter, see the following sections in the Appendix:
○ 5.8.1.3 Common cXML Configuration
○ 5.8.2.1 Inbound cXML Configuration
Note
Proxy Server Configuration; Email Notifications, Certificate of SSL Server, Adapter Status are set to default
values. Check whether these settings match your requirements. For more information about this parameter,
see the following sections in the Appendix:
○ 5.8.5.1 Proxy Settings in cXML Configuration
○ 5.8.1.1 Adapter Status
○ 5.8.1.4 Email Notification
○ 5.8.1.5 Certificate of SSL Server
Number 1
Procedure
1. On the Objects tab of the Integration Builder, use the following navigation path.
2. In the context menu of Communication Channel, select New to start the Create Object wizard.
3. Verify that the following information is correct. Some information is automatically inserted.
Name XI
Namespace http://sap.com/xi/XI/System
Procedure
2. On the ES Repository Model tab, choose Process Integration Scenario option for Type of ES Repository Model.
3. Verify that the data for ES Repository Model Reference(s) match the following. If not, repeat the previous step.
Name AR_Addon_OrderConfirmation_Send
Namespace http://ariba.com/xi/ASN/AddOn/OrderConfirmation
Note
If no corresponding system is displayed in the list, change the value for Search Criteria from For Product
<Product> to All Business System Components.
8. Either use the Configure Connections button in the upper left toolbar or directly click the arrows connecting
different actions to switch between connections.
9. Once a connection is selected (color of both involved actions changes to red), you have to specify the
corresponding Communication Component on the lower Sender and Receiver Business Systems Components
tab.
10. Assign the following systems using the value help to open the Choose Communication Component dialog.
Compo BS_ASN
nent
CC_Order
Channel Confirma
tion_cXML
_Sender
Compo BS_<S4
nent System
ID>CLNT<
Channel
S4 Client
>
CC_Order
Confirma
tion_cXML
_Sender
Receiver
Multi-ERP ImplementationsFor Multi-ERP implementation, repeat the steps 2 and 3 for all the entries of
the business systems corresponding to your SAP S/4HANA instances.
11. To check your configured model, choose Check Configurability on the lower left toolbar button. If errors are
shown, review the previous configuration steps.
12. If check is successful, choose Create Configuration Objects…
13. Select General option Generation. Leave standard options as displayed.
14. Choose Start and wait for the wizard to finish.
This configuration is required only for Multi-ERP implementations. For Multi-ERP implementation, repeat steps 3 to
7 for all your SAP S/4HANA instances.
Procedure
1. On the Objects tab of the Integration Builder, use the following navigation path and open the Receiver
Determination.
Procedure
You must configure the integration scenario for theAdvance Ship Notice transaction in the Integration Directory to
be able to run the transaction. All the steps of a configuration scenario section must be completed to fully
configure a scenario.
Note
Ensure that the design is imported into your system and ready before you run these steps. The following steps
assume that the different business systems are defined in the SLD. For more information about configuring the
SLD, see the section Configure System Landscape Directory [page 38]
● Transfer the integration scenario from the Integration Repository to the Integration Directory
● Configure the communication channels
● Configure the integration scenario
● Activate the new configuration
The following figure illustrates the data flow of the Advance Ship Notice transaction. transaction.
Use
The first step to configure the integration scenario for the AdvanceShipNotice transaction is to transfer it to the
Integration Directory. The integration scenario is loaded into the Integration Repository when the design is
imported.
Procedure
2. In the PI Tools area, choose the link to open SAP NetWeaver Integration Builder in the Integration Directory
area.
3. To start the Transfer Wizard, choose Tools Apply Model from ES Repository…
4. On the first screen of the Transfer Model from ES Repository wizard, select Process Integration Scenario option
for Type of ES Repository Model.
5. In the Name field, use the value help and select the following Process Integration Scenario from the Enterprise
Services Repository.
Name AR_Addon_AdvanceShipNotice_Send
Namespace http://ariba.com/xi/ASN/AddOn/AdvanceShipNotice
6. Choose Apply.
7. Choose Continue.
8. Change the naming for the configuration scenario to CS_AdvanceShipNotice_Send
9. Choose Finish.
Once the transfer is completed, the Model Configurator window appears.
10. Cancel the wizard and save the configuration scenario.
Procedure
1. On the Objects tab of the Integration Builder, use the following navigation path.
2. In the context menu of Communication Channel, choose New to start the Create Object wizard.
3. Verify that the following information is correct. Some information is automatically inserted.
4. Open the Communication Channel menu and select menu item Apply Template and search for the following
channel template.
Name CCT_AddOn_AdvanceShipNotice_cXML_Sender
Namespace http://ariba.com/xi/ASN/AddOn/OrderConfirmation
Note
Deployment Mode
Test
Mode
Note
Deployment Mode is set to default value. Check whether this setting matches your requirements. For more
information about this parameter, see the following sections in the Appendix:
○ 5.8.1.1 Adapter Status
Credential Information
Network ID
Credential Domain
Ariba Byer ID (AN****)
Credential
Authentication
TrustedCAs
Trust Store View
Client Certificate
Credential Mode
TrustedCAs
Keystore View
52300
Port
Note
Credential Mode, Client Certificate are set to default values. Check whether these settings match your
requirements. For more information about this parameter, see the following sections in the Appendix:
○ 5.8.1.2 Authentication
○
Authentication
TrustedCAs
Trust Store View
Shared secret
Credential Mode
<Shared Secret Password created in Ariba Buyer
Shared Secret Password Account>
AN ID AN01000000001
Language en-US
Note
AN ID, User Agent, Language, GetProfile Interval, GetPending Interval, Max Documents in GetPending and
cXML Version are set to default values. Check whether these settings match your requirements. For more
information about this parameter, see the following sections in the Appendix:
○ 5.8.1.3 Common cXML Configuration
○ 5.8.2.1 Inbound cXML Configuration
Note
Proxy Server Configuration; Email Notifications, Certificate of SSL Server, Adapter Status are set to default
values. Check whether these settings match your requirements. For more information about this parameter,
see the following sections in the Appendix:
○ 5.8.5.1 Proxy Settings in cXML Configuration
○ 5.8.1.1 Adapter Status
○ 5.8.1.4 Email Notification
○ 5.8.1.5 Certificate of SSL Server
Number 1
Procedure
1. On the Objects tab of the Integration Builder, use the following navigation path.
2. In the context menu of Communication Channel, select New to start the Create Object wizard.
3. Verify that the following information is correct. Some information is automatically inserted.
Name XI
Namespace http://sap.com/xi/XI/System
Procedure
2. On the ES Repository Model tab, choose Process Integration Scenario option for Type of ES Repository Model.
3. Verify that the data for ES Repository Model Reference(s) match the following. If not, repeat the previous step.
Name AR_Addon_AdvanceShipNotice_Send
Namespace http://ariba.com/xi/ASN/AddOn/OrderConfirmation
Note
If no corresponding system is displayed in the list, change the value for Search Criteria from For Product
<Product> to All Business System Components.
8. Either use the Configure Connections button in the upper left toolbar or directly click the arrows connecting
different actions to switch between connections.
9. Once a connection is selected (color of both involved actions changes to red), you have to specify the
corresponding Communication Component on the lower Sender and Receiver Business Systems Components
tab.
10. Assign the following systems using the value help to open the Choose Communication Component dialog.
Compo BS_ASN
nent
CC_Ad
Channel vance
ShipNo
tice_cXML
_Sender
Compo BS_<S4
nent System
ID>CLNT<
Channel
S4 Client
>
CC_Ad
vance
ShipNo
tice_cXML
_Sender
Receiver
Multi-ERP Implementations. For Multi-ERP implementation, repeat the steps 2 and 3 for all the entries of
the business systems corresponding to your SAP S/4HANA instances.
11. To check your configured model, choose Check Configurability on the lower left toolbar button. If errors are
shown, review the previous configuration steps.
12. If check is successful, choose Create Configuration Objects…
13. Select General option Generation. Leave standard options as displayed.
This configuration is required only for Multi-ERP implementations. For Multi-ERP implementation, repeat steps 3 to
7 for all your SAP S/4HANA instances.
Procedure
1. On the Objects tab of the Integration Builder, use the following navigation path and open the Receiver
Determination.
Procedure
You must configure the integration scenario for theInvoice transaction in the Integration Directory to be able to run
the transaction. All the steps of a configuration scenario section must be completed to fully configure a scenario.
Note
Ensure that the design is imported into your system and ready before you run these steps. The following steps
assume that the different business systems are defined in the SLD. For more information about configuring the
SLD, see the section Configure System Landscape Directory [page 38]
● Transfer the integration scenario from the Integration Repository to the Integration Directory
● Configure the communication channels
● Configure the integration scenario
● Activate the new configuration
The following figure illustrates the data flow of the Invoice transaction..
Use
The first step to configure the integration scenario for the Invoice transaction is to transfer it to the Integration
Directory. The integration scenario is loaded into the Integration Repository when the design is imported.
Procedure
2. In the PI Tools area, choose the link to open SAP NetWeaver Integration Builder in the Integration Directory
area.
3. To start the Transfer Wizard, choose Tools Apply Model from ES Repository…
4. On the first screen of the Transfer Model from ES Repository wizard, select Process Integration Scenario option
for Type of ES Repository Model.
5. In the Name field, use the value help and select the following Process Integration Scenario from the Enterprise
Services Repository.
Name AR_Addon_Invoice_Send
Namespace http://ariba.com/xi/ASN/AddOn/Invoice
6. Choose Apply.
7. Choose Continue.
8. Change the naming for the configuration scenario to CS_Invoice_Send
9. Choose Finish.
Once the transfer is completed, the Model Configurator window appears.
10. Cancel the wizard and save the configuration scenario.
Procedure
1. On the Objects tab of the Integration Builder, use the following navigation path.
2. In the context menu of Communication Channel, choose New to start the Create Object wizard.
3. Verify that the following information is correct. Some information is automatically inserted.
4. Open the Communication Channel menu and select menu item Apply Template and search for the following
channel template.
Name CCT_AddOn_Invoice_cXML_Sender
Namespace http://ariba.com/xi/ASN/AddOn/OrderConfirmation
Deployment Mode
Test
Mode
Credential Information
Network ID
Credential Domain
Ariba Byer ID (AN****)
Credential
Authentication
TrustedCAs
Trust Store View
Client Certificate
Credential Mode
TrustedCAs
Keystore View
52300
Port
For Shared Secret adjust Authentication details according to the following table:
Authentication
TrustedCAs
Trust Store View
Shared secret
Credential Mode
<Shared Secret Password created in Ariba Buyer Account>
Shared Secret Password
cXML Configuration
AN ID AN01000000001
Language en-US
13. Browse to Tab ‘Module’ and insert the following information in the Processing Sequence:
Number 1
Procedure
1. On the Objects tab of the Integration Builder, use the following navigation path.
2. In the context menu of Communication Channel, select New to start the Create Object wizard.
3. Verify that the following information is correct. Some information is automatically inserted.
Name XI
Namespace http://sap.com/xi/XI/System
Procedure
2. On the ES Repository Model tab, choose Process Integration Scenario option for Type of ES Repository Model.
3. Verify that the data for ES Repository Model Reference(s) match the following. If not, repeat the previous step.
Name AR_Addon_Invoice
Namespace http://ariba.com/xi/ASN/AddOn/OrderConfirmation
Multi-ERP Implementations. For Multi-ERP implementation, add multiple business services defined for your multiple SAP
S/4HANA systems by repeating the steps 6 and 7.
Note
If no corresponding system is displayed in the list, change the value for Search Criteria from For Product
<Product> to All Business System Components.
8. Either use the Configure Connections button in the upper left toolbar or directly click the arrows connecting
different actions to switch between connections.
9. Once a connection is selected (color of both involved actions changes to red), you have to specify the
corresponding Communication Component on the lower Sender and Receiver Business Systems Components
tab.
10. Assign the following systems using the value help to open the Choose Communication Component dialog.
Compo BS_ASN
nent
CC_In
Channel voice_cX
ML_Sende
r
Compo BS_<S4
nent System
ID>CLNT<
Channel
S4 Client
>
CC_In
voice_cX
ML_Send
erReceiver
Multi-ERP Implementations. For Multi-ERP implementation, repeat the steps 2 and 3 for all the entries of
the business systems corresponding to your SAP S/4HANA instances.
11. To check your configured model, choose Check Configurability on the lower left toolbar button. If errors are
shown, review the previous configuration steps.
Configure the receiver determination settings manually, for the receiver MIOut_Async_AddOn_Invoice_cXMLunder
the CS_Invoice_Send integration scenario. Retain the default settings for the other receivers.
This configuration is required only for Multi-ERP implementations. For Multi-ERP implementation, repeat steps 3 to
7 for all your SAP S/4HANA instances.
Procedure
1. On the Objects tab of the Integration Builder, use the following navigation path and open the Receiver
Determination.
Procedure
You must configure the integration scenario for theInvoice transaction in the Integration Directory to be able to run
the transaction. All the steps of a configuration scenario section must be completed to fully configure a scenario.
Note
Ensure that the design is imported into your system and ready before you run these steps. The following steps
assume that the different business systems are defined in the SLD. For more information about configuring the
SLD, see the section Configure System Landscape Directory [page 38]
● Transfer the integration scenario from the Integration Repository to the Integration Directory
● Configure the communication channels
● Configure the integration scenario
● Activate the new configuration
The following figure illustrates the data flow of the Status Update Request transaction.
Use
The first step to configure the integration scenario for the Status Update Request transaction is to transfer it to the
Integration Directory. The integration scenario is loaded into the Integration Repository when the design is
imported.
Procedure
2. In the PI Tools area, choose the link to open SAP NetWeaver Integration Builder in the Integration Directory
area.
3. To start the Transfer Wizard, choose Tools Apply Model from ES Repository…
4. On the first screen of the Transfer Model from ES Repository wizard, select Process Integration Scenario option
for Type of ES Repository Model.
5. In the Name field, use the value help and select the following Process Integration Scenario from the Enterprise
Services Repository.
Name AR_Addon_StatusUpdateRequest_Receive
Namespace http://ariba.com/xi/ASN/AddOn/StatusUpdateRequest
6. Choose Apply.
7. Choose Continue.
8. Change the naming for the configuration scenario to CS_StatusUpdateRequest_Receive
9. Choose Finish.
Once the transfer is completed, the Model Configurator window appears.
10. Cancel the wizard and save the configuration scenario.
Procedure
1. On the Objects tab of the Integration Builder, use the following navigation path.
Menu Path Objects → Communication Component Without Party → Business System → BS_ASN →
Communication Channel
2. In the context menu of Communication Channel, select New to start the Create Object wizard.
3. Verify that the following information. Some information has been inserted automatically.
4. Open the Communication Channel menu and select menu item Apply Template and search for the following
Channel Template.
Name CCT_AddOn_StatusUpdateRequest_cXML_Recei
ver
Namespace http://ariba.com/xi/ASN/AddOn/StatusUpdateRequest
Note
Deployment Mode
Test
Mode
Note
Deployment Mode is set to default value. Check whether this setting matches your requirements. For more
information about this parameter, see the following sections in the Appendix:
○ 5.8.1.1 Adapter Status
Credential Information
Network Id
Credential Domain
Ariba Byer ID (AN****)
Credential
Authentication
TrustedCAs
Trust Store View
Client Certificate
Credential Mode
TrustedCAs
Keystore View
52300
Port
Note
Credential Mode, Client Certificate are set to default values. Check whether these settings match your
requirements. For more information about this parameter, see the following sections in the Appendix:
○ 5.8.1.2 Authentication
Authentication
TrustedCAs
Trust Store View
Shared secret
Credential Mode
<Shared Secret Password created in Ariba Buyer
Shared Secret Password Account>
cXML Configuration
AN ID AN01000000001
Language en-US
Note
AN ID; User Agent, Language, GetProfile Interval, cXML Versionand Expiration Time For The Document
(Hours)are set to default values. For more information about this parameter, see the following sections in
the Appendix:
Note
Proxy Server Configuration, Email Notifications and Adapter Status are set to default values. Check whether
these settings match your requirements. For more information about this parameter, see the following sections
in the Appendix:
○ 5.8.5.1 Proxy Settings in cXML Configuration
14. Browse to Tab ‘Module’ and insert the following information in the Processing Sequence:
15.
Processing Sequence
1
Number
localejbs/ModuleProcessorExitBean
Module Name
Local Enterprise Bean
Type
Exit
Module Key
Module Configuration
exit
Module Key
JNDIName
Parameter Name
deployedAdapters/AribaNetworkAdapterSAPNetweaver/
Parameter Value shareable/AribaNetworkAdapterSAPNetweaver
Procedure
2. On the ES Repository Model tab, choose Process Integration Scenario option for Type of ES Repository Model.
3. Verify that the data for ES Repository Model Reference(s) match the following. If not, repeat the previous step.
Name AR_AddOn_StatusUpdateRequest_Receive
Namespace http://ariba.com/xi/ASN/AddOn/StatusUpdateRequest
Note
If no corresponding system is displayed in the list, change the value for Search Criteria from For Product
<Product> to All Business System Components.
8. Either use the Configure Connections button in the upper left toolbar or directly click the arrows connecting
different actions to switch between connections.
9. Once a connection is selected (color of both involved actions changes to red), you have to specify the
corresponding Communication Component on the lower Sender and Receiver Business Systems Components
tab.
10. Assign the following systems using the value help to open the Choose Communication Component dialog.
Compo BS_ASN
nent
CC_Sta
Channel tusUpda
teRe
quest_cX
ML_Re
ceiver
Compo BS_<S4
nent System
ID>CLNT<
Channel
S4 Client
>
Not re
quired
11. To check your configured model, choose Check Configurability on the lower left toolbar button. If errors are
shown, review the previous configuration steps.
12. If check is successful, choose Create Configuration Objects…
13. Select General option Generation. Leave standard options as displayed.
Procedure
This appendix describes common, inbound, and outbound parameters for the cXML Adapter. Default values
marked in bold.
Name Usage Type Data Type Value Default value bold Description
Production
Inactive
Name Usage Type Data Type Value Default value bold Description
Credential Mode Required string Shared secret Authentication method on Ariba Network.
Client certificate
Credential Do Required string NetworkId The domain for the Buyer's credential.
main
NetworkUserId
DUNS
Credential Required string The Buyer's credential on Ariba Network. The value can be NetworkId, Net
workUserId or DUNS, depending on the credential domain selected.
Shared Secret Optional string The Buyer's shared secret on Ariba Network. This parameter is only required
Password when parameter credentialMode is set as Shared secret.
KeyStore Loca optional string file:/<path> Certificate key store file path. This parameter is
tion only required when parameter credentialMode is
set as Client certificate.
file:///usr/sap/X73/keystore/ariba.jks Example
value (Windows)
file:/D:/AribaDataDir/cert/AribaStoreEntrust
Caution
Store Password Optional string Certificate password for keystore. This parameter is only required when pa
rameter credentialMode is set as Client certificate.
Key Password Optional string Certificate password for key. This parameter is only required when parameter
credentialMode is set as Client certificate.
Port Required integer 443 HTTPS port. This parameter is only required
when parameter credentialMode is set as Client
certificate.
Caution
Do not change the default value. In case of
errors check that default value is set.
User Agent Required string Ariba SN Buyer A textual string representing the client system
that is conducting the cXML conversation.
Caution
Do not change the default value. In case of
errors check that default value is set.
Language Required string en-US Attribute needed for constructing cXML request.
Data Directory Required string D:/AribaDataDir Base directory needed to run the adapter.
cXML Version Required string 1.2.028 The version number of the cXML document data
definition to be used to generate the cXML docu
ments exchanged with Ariba Network. This ver
sion number will be used in the DOCTYPE entity
of the cXML documents.
Use XML Vali Optional boolean true A flag that specifies whether or not the validation
dation is done on the exchanged cXML documents ac
false
cording to the cXML dtds. The validation should
be enabled during the installation/ customization
phase to ensure that the exchanged cXML docu
ments are compliant. In the production phase,
the validation could have a negative impact on
performance.
Use Email Noti required boolean true A switch to turn on/off email notification.
fications
false
SMTP Server required string The SMTP server IP address or host name.
Host
Sender Ad required string The email account for sending email.
dress
Recipient Ad required string The email account for email receiver.
dress
Sender Name optional string AribaSN Adapter Admin The description name for sender.
Email Authenti required boolean true A flag that represents whether or not the email
cation server requires authentication for sending email.
false
User optional string The email sender account. This parameter is only required when parameter
emailAuthentication is set as true.
Password optional string The password for the email sending account. This parameter is only required
when parameter emailAuthentication is set as true.
Name Usage Type Data Type Value Default value bold Description
Use Alterna- optional boolean true A flag that specifies whether or not a particular
tive KeyStore certificate key store is used and contains the cer
false
tificate of the Ariba Network server (to be used
only if the certificate key store used by the JDK
runtime does not contain the Ariba Network
Trusted Authority Certificate.)
Trust KeyStore optional string file:/<path> Certificate key store file path for certification of
Location SSL server. This parameter can be left blank
when connecting to Ariba Network in production.
file:///usr/sap/X73/keystore/ariba.jks Example
value (Windows)
file:/D:/AribaDataDir/cert/AribaStoreEntrust
Caution
In case of errors check that correct prefix
value is set.
Trust KeyStore optional string Certificate password for keystore for certification of SSL server. This parameter
Location can be left blank when connecting to Ariba Network in production.
Name Usage Type Data Type Value Default value bold Description
Get Profile URL required string https://service.ariba.com/serv URL used to send Profile Re
ice/transaction/cxml.asp quest.
(Minutes)
(Minutes)
(Minutes)
Name Usage Type Data Type Value Default value bold Description
Inbound Request required string Confirmation Request The request type for Inbound.
Type
Invoice Detail Request
Name Usage Type Data Type Value Default value bold Description
(Minutes)
Outbound Request required string Order Request The request type for Outbound.
Type
Status Update Request
You can configure the interval and the number of times the adapter framework will attempt to resend a message to
an adapter from the NetWeaver Administrator. This includes the interval between retry attempts for outbound
messages sent by SAP NetWeaver PI to the cXML adapter, and the number of inbound documents sent by the
cXML adapter to PI. For more information on how to configure a message to be retried, see the SAP NetWeaver
Process Integration documentation.
The Ariba Network Adapter for SAP NetWeaver can be configured to use Secure HyperText Transfer Protocol
(HTTPS) through a proxy server. The following methods of authentication on the proxy server are supported:
● Basic
● Digest
● NTLMv1 (Note that NTLMv2 is not supported)
To enable secure communication through a proxy server, configure the following parameters for the cXML Adapter.
Name Usage Type Data Type Value Default value bold Description
Use Proxy Server optional boolean No Enables or disables the use of the
proxy server for remote communi
Yes
cation with Ariba Network
Proxy Server Host optional string Host name or IP address of the proxy server. Required if Use Proxy
Server is set to Yes.
Proxy Server Port optional integer Port used by the proxy server to handle secure communication. Re
quired if Use Proxy Server is set to Yes.
Proxy Authentication optional list None Indicates the method used for au
Method thentication on the proxy server. If
Basic
set to None, the proxy server does
Digest not require authentication.
NTLM
Username optional string The user name used for authentication. Required for all three authenti
cation methods.
Password optional string The password used for authentication. Required for all three authenti
cation methods.
Domain optional string The domain to which the user identified by the Username parameter
belongs. Required for NTLM authentication only.
This Configuration Guide uses form fields for all of its configuration activities. The following fields include standard
names for content delivered with the Ariba Network Integration for SAP Business Suite rapid-deployment solution.
Caution
Do not change the following form fields unless you are sure what you are changing.
Ariba Host
Configuration Scenario
Scenario Namespaces
If your organization has more than one instance of SAP, you can link them to a single Ariba Network account. This
feature allows all the documents from particular vendors to be routed to a single Ariba Network account and in the
reverse direction, the documents from Ariba Network will be routed to a particular SAP S/4HANA instance.
Buying organization or service provider accounts must be enabled for Multi-ERP implementation by Ariba Network
Support. The required configuration sections will only be available for accounts that have been enabled.
In the multi-ERP implementation scenario, each of the SAP S/4HANA systems involved in the integration is
identified by a unique identifier. This identifier, called the SystemID, corresponds to the logical system ID of the
concerned SAP S/4HANA instance.
Each document that passes through the integration will be transformed as follows, to include or to retrieve this
unique identifier from the cXML header
<Header>
<Credential domain="NetworkID">
<Identity>AN50000000365</Identity>
</Credential>
<Credential domain="PrivateID">
<Identity>0000009999</Identity>
</Credential>
</From>
<To>
<Credential domain="NetworkID">
</Credential>
<Credential domain="SystemID">
</Credential>
</To>
The following figures show the SystemID identifier location in outbound and inbound documents.
In case of single-ERP implementation, the SystemID identifier is not inserted in the outgoing documents or
expected in the incoming documents.
In case of multi-ERP implementation, if the SystemID is not found in an inbound document, it is not processed and
fails in the SAP NetWeaver PI integration with a System Error.
● SAP S/4HANA
● SAP NetWeaver PI
● Ariba Network.
You must configure all your SAP S/4HANA instances in the SLD as technical and business systems.
For more information, see the chapter Assign Technical and Business Systems.
The connectivity between all the SAP S/4HANA instances and the SAP NetWeaver PI server has to be set up.
For more information, see the sectionConfiguring SAP S/4HANA Connectivity [page 41]
You must configure the following entries in the value mappings to enable the multi-ERP support for the integration.
Scheme GlobalVariable
Target Agency XI
Scheme GlobalVariable
Scheme Lookup
Scheme Lookup
Fill in the values to set up the transformation rules for Logical/Business systems. The following table shows
examples of the Logical/Business system transformation values. Maintain one set of pairs for each of your SAP S/
4HANA that is connected to your Ariba Network Account.
<S4 System ID>CLNT<S4 Client > BS_<S4 System ID>CLNT<S4 Client > AR_LS_BS
Each inbound scenario, as well as the scheduled scenarios, has to be configured for messages and calls routing.
Refer to the specific section for each transaction to set up the receiver determination rules.
For more information about setting up the receiver determination for the following scenarios, see the
corresponding sections.
The application log is the central tool for monitoring all activities. You can access the application log using
transaction SLG1.
The system records all messages triggered to Ariba or received from Ariba in one or more entries under the Ariba
Integration (CXML_INTEGRATION) object.
6.1.1 INBOUND
The system processes all messages belonging to the namespace sap.com/xi/ARBFND1 and the below defined
interfaces and writes an entry to the application log. You can also review the processing status of the entries.
Messages that have been pushed into the SAP S/4HANA system by middleware create an entry only with the sub
object Inbound. Messages that have been polled from Ariba Network directly into the SAP S/4HANA system are
included in both an entry with the sub object INBOUND and an entry with the sub object POLLING.
6.1.2 POLLING
If you run the integration to Ariba Network through direct connectivity, you must schedule a polling job to retrieve
messages. Each time the polling job runs, it writes an entry in the application log, listing the message type and
timestamp when the system has polled.
After the messages have been polled from Ariba Network, the log entry lists all message IDs (XML ID and payload
ID) that have been retrieved and put in the queue for message processing.
6.1.3 OUTBOUND
Every message leaving the SAP S/4HANA system writes an entry to the application log with this subtype. For direct
connectivity, there are two entries, one for the creation of the cXML message and the other indicating whether the
message has successfully been transferred to Ariba Network.
This sub object is relevant for all messages triggered by extraction reports. When a corresponding background job
for sending such message has run and created messages, the log entry contains all relevant document IDs.
You can filter the application log entries by object and sub object as described above. Date and Time is also a filter
criterion.
If you are searching for specific entries, you can also use the External ID field by entering a business object ID, a
payload ID, or a XML message ID. Note that you have to insert an asterisk before and after the entered ID.
Since Ariba Network Integration with SAP S/4HANA system creates many entries to record the message exchange
with Ariba Network, we recommend that you double check your settings for archiving your application log and
make necessary adjustments.
The Ariba Network can be configured to meet customer requirements. This chapter describes settings in the Ariba
Network Buyer account configured by the customer.
As the Ariba Network allows for a flexible configuration of the process, this document provides a straight forward
setup that allows the integration between SAP S/4HANA system and the Ariba Network.
General Procedure
Note
Transaction rules marked as “Optional” can be set according to your individual requirements (for more information
about this rules please refer to the info button nearby each rule). For transaction rules marked other than
“Optional” (e.g. “Activation required” or “Do not activate”) you have to make the setting accordingly, otherwise
the integration may not work. You may also find transaction rules that are not covered in this document. These
apply to features that are not applicable to an SAP S/4HANA system to Ariba Network integration and are therefore
not listed. You do not need to make settings for them in the Ariba Network.
Use
Make settings for purchase order integration with the Ariba Network.
Allow change orders for fully Optional Please keep in mind that order confirmations
shipped orders and ship notices are not being forwarded to
your SAP S/4HANAsystem. These documents
will remain on the Ariba network and are ac
cessible through the Buyer Account.
Ariba Network Transaction Rule Rule Setting Default SAP S/4HANA Integration Dependency
Under Order Confirmation and Ship Notice Attachment Rules, you can define the following rules:
Ariba Network Transaction Rule Rule Setting Default SAP S/4HANA Integration Dependency
Under Quick Enablement Rules, you can define the following rule:
Ariba Network Quick Enablement allows buying organizations to create new Ariba Network accounts on behalf of
suppliers. They create these accounts by specifying the supplier’s company information in a Correspondent
element in the header of purchase order requests to the supplier. Ariba Network uses this information to create the
supplier’s account.
SAP S/4HANA supports quick enablement of suppliers. This requires a flag in the maintenance of Ariba Network
suppliers, to select suppliers for which quick enablement is to active.
https://connect.ariba.com/AC
After you logged on, you can go to the Search-Tab. In the Search-field you should enter Buyer Administration Guide
and then click on the Submit button. Please open the entry Buyer Administration Guide and search in the pdf-
document for Quick Enablement.
Under Order Confirmation an d Ship Notice Rules, you can define the following rules:
Allow suppliers to send order con Optional Please keep in mind that order confirmations
firmations for material orders. and ship notices are not being forwarded to
your SAP S/4HANA system. These docu
ments will remain on the Ariba network and
are accessible through the Buyer Account.
Service sheets are currently not supported by SAP S/4HANA system, therefore, do not select any checkbox.
1. Under Invoice Rules,go to General Invoice Rules and define the following rules:
Allow suppliers to send invoice Note that the activation of this entry required
attachments Optional an activation of the next entry
Allow suppliers to send invoices Activation required Activation required if you want to receive invoi
to this account ces via the Ariba Network!
Your procurement application Activation required This option is only visible if the previous one is
can download invoice attach activated
ments (MIME multipart mes
sages).
Allow suppliers to send invoice Note that the activation of this entry required
attachments Optional an activation of the next entry
Allow suppliers to send invoice Note that the activation of this entry required
attachments Optional an activation of the next entry
1. Under Invoice Rules, go to PO Invoice Field Rules and define the following rules:
2. Choose Save.
You return to the Configuration screen.
Note
Note that starting with service package 2, this add-on works with non-PO invoices.
Procedure
1. Under Invoice Rules, go to PO and Non-PO Invoice Field Rules and define the following rules:
Procedure
1. Under Invoice Rules, go to Invoice Address Rules and define the following rules:
Use
Blanket purchase orders are currently not supported by SAP S/4HANA system.
Procedure
1. Under Invoice Rules, go to Blanket Purchase Order Invoice Rules and define the following rules:
Enable BPO-specific invoice rules Do not activate Note: the next settings under Blanket Pur
chase Order Invoice Rules group are only visi
ble, if you activate this setting!
Procedure
1. Under Invoice Rules, go to VAT Rules and define the following rules:
Choose Save.
Procedure
1. Under the Heading Invoice Rules, go to Online Invoice Form Rules and define the following rules:
Procedure
Do not require suppliers to enter Keep activated The checkbox is se D-U-N-S number is not validated
their D-U-N-S number lected.
You may want to have a PDF copy of each invoice attached to the invoice. This can only be enabled through Ariba.
Contact Ariba and ask for the following setting.
This configuration is only possible ifyour Ariba Network account has been activated for integration with more than
one SAP S/4HANA system (Multi-ERP). Otherwise, it’s a 1:1connection and you have to skip this chapter.
Prerequisite
Procedure
Use
Prerequisite
The supplier has to be enabled. If this is not the case, the supplier has to be enabled by the Ariba Support
Organization.
Note
Note that the supplier has to accept the relationship. As long as the supplier has not accepted it, the
supplier does not appear under Active Relationships.
Use
Supplier master records in SAP S/4HANA system use IDs for identification. Customers with several ERP and/or
SAP S/4HANA systems may even use different IDs assigned to the same supplier in each respective system.
The settings described in this chapter link a supplier in the Ariba Network (as identified per it’s ANID) to the
supplier IDs used in the customer’s and other systems.
Procedure
Use
In this activity, you decide which messages are to be routed through the Ariba Network.
Procedure
2. Set the flag toActive for messages you want to send to or receive from the Ariba Network
3. Save your entries.
Use
Messages (e.g. Invoices) received in the Ariba Network buyer account need to be picked up by SAP S/4HANA
system regularly. In this activity, you schedule a batch job that connects to the Ariba Network and picks up new
messages.
Use
In this activity, you create basic settings for authentication towards the Ariba Network.
Procedure
Ariba Network
ANID of your Shared secret Identifies a Used if multiple buyer System ID An Ariba Network ID can have
buyer ac set for the test system systems use the same (if enabled) multiple end points. An end point
count buyer account Ariba Network buyer is a document routing placeholder
account. In case you that ensures documents from
are unsure what best Ariba Network are sent to the re
fits your situation, ena quired destinations (system).
ble it.
If you need to enable end points make the required settings here. For more information on end points go to:
https://connect.ariba.com/AC
After you logged on, you can go to the Search-Tab. In the Search-field you should enter Buyer Administration Guide
and then click on the Submit button. Please open the entry Buyer Administration Guide and search in the pdf-
document for End points.
Procedure
Company Code
ANID of your buyer account Company Code The company code’s name
Procedure
Verification
Name of Partner in
Supplier Supplier Name CXML Company Code Company Name
Supplier ID The supplier’s name What the supplier sends The corresponding com Company code descrip
across as <billTo> invoi pany code in the buyer’s tion
ces system
Procedure
Verification
Supplier ID Supplier’s For example, vat For example, Country for Tax code used Description of the
name 7(for 7 %) which you in the buyer’s tax code
make the set system
ting
Use
Out coming invoices (invoices which are sent from S/4HANA Cloud to Ariba Network) carry information such as
applicable taxes, tax rates, and tax amounts.
In this activity, you map the tax categories (such as vat or sales tax) to tax codes used in your system (these
settings are country-specific).This is required for each of your suppliers. You may make settings leaving the field
Supplier empty thus applying this setting to all respective suppliers (wildcard).
Procedure
Supplier ID Supplier’s Country for which Tax code used in Description of the tax For example, vat
name you make the set the buyer’s sys code
ting tem
Use
In this activity, you define settings relevant for the output of purchase orders and supplier invoices. There are two
methods of output management, which can be used:
Note
Note that for the supplier invoice you can use only the Output Management via message control (NAST).
By default, output management via NAST is active. If you want to use the New Output Management for the
purchase order, make the following steps:
2. On the Change View "Activation of New Output Management for Purchasing Docume" screen, select the
following mode:
Use
In this activity, you define settings relevant for the output of purchase orders, if you use the New output
management.
Transaction SPRO
Code
IMG Menu Integration with Other SAP Components Business Network Integration Integration with the Ariba
Network Application-Specific Settings Define Message Output Control Method 2: Use SAP S/
Determination Channel
3. For every supplier that you would like to send purchase orders via the Ariba Network, create a business rule:
Use
In this activity, you define settings relevant for the output of purchase orders and supplier invoices, if you use the
Output Management via message control (NAST).
2. On the Conditions for Output Control screen, select for Purchase Order:
1. EF Purchase Order and choose Condition records.
2. On the Output Types screen, select the entry Neu Purchase Order and choose Condition records.
3. In the Key Combination dialog box, choose Purchasing Output Determination: Document Type
4. On the "Change Purchase order (NEU): Selection" screen, make following entry:
3. To define the conditions for the Invoice Verification on the Conditions for Output Control screen, select:
1. MR Invoice Verification and choose Condition records.
2. On the Output Types screen, select the entry ARCC Ariba Carbon Copy (for CC Invoice) or ARSU Ariba
Status Update (for Invoice Status Update) and choose Condition records.
3. In the Key Combination dialog box, choose CoCde.
4. On the "Change Ariba Carbon Cop (ARCC) : Selection" screen, make following entry:
Procedure
Transaction SPRO
Code
IMG Menu Integration with Other SAP Components Business Network Integration Integration with the Ariba
Network Application-Specific Settings Define Message Output Control Method 1: Use Message
2. On the Change View "Map Application and Output Type to cXML Message": Overview screen, choose New
Entries and create following settings:
IMG Menu Integration with Other SAP Components Business Network Integration Integration
with the Ariba Network Framework Settings Business Add-Ins (BAdIs) BAdIs for
Use
The Business Add-In Notification About Communication Errors (ARBFND_INTEGRATION) with the method Error
Notification (NOTIFY_ABOUT_ERROR) is used in the cXML foundation for integrating business networks. You can
use this BAdI to trigger actions if errors have occurred during the communication between your SAP System and
the business network.
Example
You can find example implementation CL_EX_ARBFND_BADI_INTEGRATION in the BAdI Builder on the
Enhancement Spot Element Definitions tab in the Implementation Example Classes section. This example
implementation illustrates how you can send error notifications as e-mails.
Outbound messages can be triggered by the application itself, for example, the Purchase Order application. Here,
the application displays an output status and the output processing log. Depending on the Customizing settings for
output control, the message is sent immediately after a document was saved, or it is sent periodically by a
scheduled output job.
You can also trigger outbound messages using scheduled reports (jobs), for example, you can trigger the
InvoiceStatusUpdate request. Here, you can trace the outbound messages in the application log (transaction
SLG1).
The application uses a green status for successful processing. The message log contains the PO ID, the cXML
message payload ID, and the XML message ID.
You can also use the message monitor of Web Service Utilities (transaction SRT_MONI) for monitoring XML
messages instead of the XML monitor (transaction SXI_MONITOR).
The XML message IDs can be used as selection parameters for the XML monitor (transaction SXI_MONITOR) to
directly access a cXML message.
The following figure shows how to select a cXML message by its message ID in SXI_MONITOR:
The monitor displays a checkered flag status for a successfully transferred message, as shown in the figure below.
Given that the call to Ariba Network is synchronous, Ariba Network accepts and creates the message.
A complete trace of the message processing can be found in the application log under the Ariba Integration
(ARIBA_INT_TOOL or CXML_INTEGRATION) object.
The application log displays two entries for every outbound message. The first entry records the creation of the
cXML message, the second the transfer to Ariba Network.
If the outbound message is successful, Ariba Network has accepted the document and the message 201 Accepted
is displayed.
If your Forward Error Handling (FEH) is activated, the system can display a yellow status. This means that the
system has forwarded the issue to the FEH application.
The framework additionally offers to send the processing status of an inbound message back to Ariba Network. You
can activate this functionality in the Customizing activity Define Basic Message Settings by selecting the Send
cXMLStatusUpdateRequest Message checkbox. If this functionality is activated, an inbound message that has
successfully been processed by the SAP S/4HANA system changes the routing status of a document from Sent to
Acknowledged on Ariba Network.
Inbound messages that have not been successfully processed by the SAP S/4HANA system will change the status
from Sent to Failed - provided that Forward Error Handling (FEH) is activated and the message is discarded.
If you need to create a support ticket with respect to issue you have found, you can use the following Component
ID: BNS-ARI-SE-ERP.
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your agreements
with SAP) to this:
● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such links, you
agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax and
phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of example
code unless damages have been caused by SAP's gross negligence or willful misconduct.
Gender-Related Language
We try not to use gender-specific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.
SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.