SAP Ariba

This page covers the setup of Integration & Exception Monitoring with SAP Cloud ALM for the following SAP Ariba Products:

  • SAP Ariba Sourcing
  • SAP Ariba Procurement
  • SAP Ariba Network
  • SAP Ariba Cloud Integration Gateway (CIG)

Release restriction

Note: Support for SAP Ariba Network only customers will be available with SAP Ariba release 2108 (August 2021)

Available Monitoring Content

CategoryTypeDescriptionSupported Processes
SAP Ariba Cloud Integration Gateway TransactionsMessagesMessages send via SAP Ariba Cloud Integration Gateway
  • Integration
SAP Ariba Network MessagesMessagesMessages send via SAP Ariba Network
  • Setting Up Automation of Order-to-Invoice with Ariba Network (4A1)
  • Setting Up Automation of Source-to-Pay with Ariba Network (42K)
SAP Ariba Procurement Integration MessagesMessagesMessages send from and to SAP Ariba Procurement
  • Setting Up Guided Buying Capability with SAP Ariba Buying (2NV)
  • Setting Up Guided Buying for Central Procurement with SAP Ariba Buying (3EN)
SAP Ariba Sourcing Integration MessagesMessagesMessages send from and to SAP Ariba Sourcing
  • Setting Up Contract Management with SAP Ariba Contracts (4AZ)
  • Setting Up Contract for Central Procurement with SAP Ariba Contracts (4B0)
  • Setting Up Sourcing with SAP Ariba Sourcing (4BL)
  • Setting Up Central Procurement with SAP Ariba Sourcing (4QN)

Setup Steps in SAP Ariba

Request Access to the SAP Ariba API Portal

To be able to collect messages from SAP Ariba you need to be onboarded to the SAP Ariba developer portal. In this portal an application will be created which then allows you to collect messages information.

This application can only be created by SAP Ariba Customer Support and needs to be requested by your Designated Support Contact (DSC). 

To find you DSC please follow the FAQ How can I see my company's Basic users and Designated Support Contacts (DSCs)?

  1. Provide your DSC with your realm name. The realm is part of the URL you use to access SAP Ariba:
    • SAP Ariba Buyer Example: https://s1.ariba.com/Buyer/Main/ad/loginPage/...&realm=mycompany
    • SAP Ariba Sourcing Example: https://mycompany.sourcing.ariba.com/
  2. The following information needs to be part of the service request
    • A client application needs to be created for you for Integration Event Monitoring Query API for Procurement
    • If this is the first time you are creating a client application, SAP Ariba Customer Support has to create an organization for you in the SAP Ariba developer portal
  3. The DSC needs to request the following information from SAP Ariba Customer Support:
    1. SAP Ariba API URL (Data Center specific): Productive URL for Integration Event Monitoring Query API
    2. SAP Ariba OAuth URL (Data Center specific)
    3. OAuth Client ID
    4. Application key
    5. AN-ID

The following table contains the data centers with the respective SAP Ariba API URL and SAP Ariba OAuth URL:

Data CenterAPI Portal URLSAP Ariba API URLSAP Ariba OAuth URL
US PRODhttps://developer.ariba.com/api/https://openapi.ariba.com/https://api.ariba.com/
EU PRODhttps://eu.developer.ariba.com/api/https://eu.openapi.ariba.com/https://api-eu.ariba.com/
RU PRODhttps://ru.developer.ariba.com/api/https://ru.openapi.ariba.com/https://api-ru.ariba.com/
CN PRODhttps://developer.ariba.cn/api/https://openapi.ariba.cn/https://api.ariba.cn/
UAE PRODhttps://mn1.developer.ariba.com/api/https://mn1.openapi.ariba.com/https://api.mn1.ariba.com/
KSA PRODhttps://mn2.developer.ariba.com/api/https://mn2.openapi.ariba.com/https://api.mn2.ariba.com/
AU PRODhttps://developer.au.cloud.ariba.com/api/https://openapi.au.cloud.ariba.com/https://api.au.cloud.ariba.com/

Collect OAuth Connection Information

After the application is created and you are provided with the information above, go to the correct SAP Ariba API Portal (see links above) and generate an OAuth secret for your application.

  1. Log on to the SAP Ariba API portal with a user that has the Organization Admin role
  2. Click Manage in the left-hand menu 
  3. Find your application for Integration Monitoring under 'My Applications' and select it
  4. On the right side you will find the OAuth client ID, and the application key. Make sure it matches the information provided to you by SAP Ariba Customer Support, especially if you have more than one application in the SAP Ariba API portal. 
  5. Click on Actions > Generate OAuth Secret. Please note that generating a new OAuth secret invalidates any old OAuth secrets!
  6. Click Submit
  7. The OAuth secret will be displayed temporarily. Copy it and save it in a secured location.

After finishing all steps you should have the following information available for the next steps in SAP Cloud ALM:

  • SAP Ariba API URL
  • SAP Ariba OAuth URL
  • OAuth client ID
  • OAuth secret
  • Application key
  • AN-ID

Setup Steps in SAP Cloud ALM

Create Cloud Service for SAP Ariba Cloud Integration Gateway

Currently SAP Ariba Cloud Integration Gateway cannot be collected automatically from the System Landscape Information Service (SLIS). Hence if you use SAP Ariba CIG you have to create the cloud service manually in the Landscape Management Service.

The other three SAP Ariba products will be discovered automatically from SLIS. You can use one of those services to find the Root URL that you need to use for the SAP Ariba CIG service.

  1. Open Landscape Management application from the launchpad
  2. Click the Add button to create a new service
    1. Name: Enter a name for the service
    2. Tenant ID: 
    3. Cloud Service Type: Select 'SAP Ariba Cloud Integration Gateway'
    4. Tenant Type: Select the appropriate type from the list
    5. Root URL: Enter SAP Ariba API URL
    6. External ID: Enter the AN-ID 
  3. Save you service

Create HTTP End-Point

You have to create one end-point for each of the SAP Ariba products in your SAP Cloud ALM. The end-point creation is similar for each of the products, so you have to go through the following steps four times. 

  1. Open the Landscape Management application from the launchpad
  2. Select your SAP Ariba service
  3. Press the > button at the end of the line
  4. On the tab "Endpoints" press the Add button to create a new end-point
  5. Enter a description
  6. Choose the use-case "Integration Monitoring"
  7. Root URL: Enter the SAP Ariba API URL 
  8. Choose OAuth authentication enter the OAuth credentials retrieved from the SAP Ariba API Portal:
    • Client ID: OAuth client ID
    • Client Secret: OAuth secret
    • Token Service URL: Extend your SAP Ariba OAuth URL with '/v2/oauth/token'
    • API Key: Enter the Application key

Connection Error with Cloud ALM 2011

Please note that with SAP Cloud ALM Release 2011 there might be an error if you perform a connection test. This doesn't influence the Interface Monitoring data collection and this error can be ignored.

Error message when clicking 'Ping Connection'

  • [401] Connection to <Ariba endpoint> cannot be established. Ensure that the URL and the login credentials, which are maintained for the endpoint, are correct.

When clicking 'Check Connection' during the end-point creation you will see the following error message

  • Connection to <Ariba endpoint> cannot be established - [Failed to obtain OAuth access token]. Ensure that the URL and the login credentials, which are maintained for the endpoint, are correct. - return code 401

Activate Monitoring (Standard)

In SAP Cloud ALM you can easily activate the standard monitoring content without any additional setup effort. 

  1. Open the Integration & Exception Monitoring application from the launchpad
  2. Open the scope selection via the target icon in the upper right corner
  3. Change the drop-down for Display Service to "All"
  4. Select your cloud service in the scope
  5. Click the rack-wheel icon in the upper right corner to access the configuration
  6. Expand the Configuration panel
  7. Change the toggle button next to the cloud service from OFF to ON

Adjust Monitoring and Alerting (Expert)

You can change which parts of the standard content are activated for each cloud service, activate and deactivate alerts or create own alerts with specific filters. 

  1. In the configuration panel, click on the name of the cloud service
  2. The "Configuration of Services" screen opens
  3. In the "Configuration for Services" screen, click the > button at the end of the line for the cloud service you want to change

Adjust Monitoring Categories

  1. Use the toggle button in the column Active to turn a monitoring category ON or OFF

Adjust Alerting

  1. Use the toggle button in the column Active to turn a standard alert ON or OFF
  2. Press the > button at the end of the line to access the detail setup for an existing alert or use the + button to create a new alert
  3. Adjust the display name if desired
  4. Expand the Filter Configuration tray
  5. Enter a filter name
  6. Select the filter category
  7. Maintain the available filter fields (see details below)

Available Alerts

  • Erroneous SAP Ariba Cloud Integration Gateway Transaction Detected (Single): Creates an alert for each failed message in SAP Ariba CIG
  • Erroneous SAP Ariba Cloud Integration Gateway Transaction Detected (Grouped): Creates an alert if one or more failed messages on SAP Ariba CIG were detected since the last data collection

Available Filter Parameters

The following filter parameters filter the collected messages. To find the correct values choose a message for which you would want to create an alert in the monitoring and drill-down to the message details. The filter values can be found on the Status Details card or on the Application Data card.

  • Message Older Than N Minutes: Default value = 10
  • Application Name: See Application Data card, e.g. Ariba:CIG
  • Component Name: See Application Data card, e.g. Ariba:CIG:P2P
  • Direction: INBOUND or OUTBOUND
  • Document Type: See Application Data card, e.g. QueryStockRequest
  • Receiver ID: See Application Data card
  • Receiver Name: See Application Data card
  • Sender ID: See Application Data card
  • Sender Name: See Application Data card
  • Status: Status as per the Status Details card, e.g. FAILURE
  • Status Group: Status group as per the Status Details card, e.g. ERROR
  • Status Text: Status text as per the Status Details card

Available Alerts

  • Erroneous SAP Ariba Network Message Detected: Creates an alert for each failed message in SAP Ariba Network
  • Erroneous SAP Ariba Network Messages Detected: Creates an alert if one or more failed messages on SAP Ariba Network were detected since the last data collection

Available Filter Parameters

The following filter parameters filter the collected messages. To find the correct values choose a message for which you would want to create an alert in the monitoring and drill-down to the message details. The filter values can be found on the Status Details card or on the Application Data card.

  • Message Older Than N Minutes: Default value = 10
  • Component Name: See Application Data card
  • Direction: INBOUND or OUTBOUND
  • Document Type: See Application Data card
  • Event Name: See Application Data card
  • Receiver Name: See Application Data card
  • Receiver Network ID: See Application Data card
  • Sender Name: See Application Data card
  • Sender Network ID: See Application Data card
  • Status: Status from the Status Details card
  • Status Group: Status Group from the Status Details card
  • Status Detail: Status Text from the Status Details card

Available Alerts

  • Erroneous SAP Ariba Procurement  Integration Message Detected: Creates an alert for each failed message in SAP Ariba Procurement
  • Erroneous SAP Ariba Procurement  Integration Messages Detected: Creates an alert if one or more failed messages on SAP Ariba Procurement were detected since the last data collection

Available Filter Parameters

The following filter parameters filter the collected messages. To find the correct values choose a message for which you would want to create an alert in the monitoring and drill-down to the message details. The filter values can be found on the Status Details card or on the Application Data card.

  • Message Older Than N Minutes: Default value = 10
  • Component Name: See Application Data card
  • Direction: INBOUND or OUTBOUND
  • Event Name: See Application Data card
  • Status: Status from the Status Details card
  • Status Group: Status Group from the Status Details card
  • Status Detail: Status Text from the Status Details card

Available Alerts

  • Erroneous SAP Ariba Sourcing Integration Message Detected: Creates an alert for each failed message in SAP Ariba Sourcing
  • Erroneous SAP Ariba Sourcing Integration Messages Detected: Creates an alert if one or more failed messages on SAP Ariba Sourcing were detected since the last data collection

Available Filter Parameters

The following filter parameters filter the collected messages. To find the correct values choose a message for which you would want to create an alert in the monitoring and drill-down to the message details. The filter values can be found on the Status Details card or on the Application Data card.

  • Message Older Than N Minutes: Default value = 10
  • Company Code Id: See Application Data card
  • Component Name: See Application Data card
  • Direction: INBOUND or OUTBOUND
  • Event Name: See Application Data card
  • Integration Channel: See Application Data card
  • Purchase Group Id: See Application Data card
  • Purchase Organization Id: See Application Data card
  • Realm: See Application Data card
  • Status: Status from the Status Details card
  • Status Group: Status Group from the Status Details card
  • Status Detail: Status Text from the Status Details card
  • System Id: See Application Data card

Further Information

Supported Events

ProductProcessEvents
SAP Ariba Sourcing / SAP Ariba ContractsSetting Up Contract Management with SAP Ariba Contracts (4AZ)
  • PurchaseContractRequestExport [Outbound]
  • PurchaseContractStatusUpdateRequestImport [Inbound]
SAP Ariba Sourcing / SAP Ariba ContractsSetting Up Contract for Central Procurement with SAP Ariba Contracts (4B0)
  • PurchaseContractRequestExport [Outbound]
  • PurchaseContractStatusUpdateRequestImport [Inbound]
SAP Ariba Sourcing / SAP Ariba ContractsSetting Up Sourcing with SAP Ariba Sourcing (4BL)
  • S4HANARequestForQuotation [Inbound]
  • RFQConfirmationS4Request [Outbound]
  • SupplierQuotationS4RequestAsync  [Outbound]
  • S4HanaQuotationConfirmation [Inbound]
SAP Ariba Sourcing / SAP Ariba ContractsSetting Up Central Procurement with SAP Ariba Sourcing (4QN)
  • S4HANARequestForQuotation [Inbound]
  • RFQConfirmationS4Request [Outbound]
  • SupplierQuotationS4RequestAsync  [Outbound]
  • S4HanaQuotationConfirmation [Inbound]
SAP Ariba Procurement / SAP Ariba Guided BuyingSetting Up Guided Buying Capability with SAP Ariba Buying (2NV)
  • RequisitionSubmit [Outbound]
  • RequisitionFinalApproval [Outbound]
  • RequisitionLineAddAttachment [Outbound]
  • RequisitionLineRemoveAttachment [Outbound]
  • RequisitionDelete [Outbound]
  • PurchaseOrderStatusNotificationMsgS4Hana [Inbound]
  • PurchaseRequisitionReplicationNotificationS4Hana [Inbound]
SAP Ariba Procurement / SAP Ariba Guided BuyingSetting Up Guided Buying for Central Procurement with SAP Ariba Buying (3EN)
  • RequisitionSubmit [Outbound]
  • RequisitionFinalApproval [Outbound]
  • RequisitionLineAddAttachment [Outbound]
  • RequisitionLineRemoveAttachment [Outbound]
  • RequisitionDelete [Outbound]
  • PurchaseOrderStatusNotificationMsgS4Hana [Inbound]
  • PurchaseRequisitionReplicationNotificationS4Hana [Inbound]
Ariba Network

Setting Up Automation of Order-to-Invoice with Ariba Network (4A1)

Setting Up Automation of Source-to-Pay with Ariba Network (42K)

  • ProcessOrderRequest
  • ProcessShipNoticeRequest
  • ProcessConfirmationRequest
  • ProcessReceiptRequest
  • ProcessInvoiceDetailRequest
  • ProcessStatusUpdateRequest
  • ProcessPaymentProposalRequest
  • ProcessServiceEntrySheet
  • ProcessStatusUpdateRequest
  • ProcessQuoteRequest (AN Discovery)
  • ProcessQuoteMessageOrder (AN Discovery)
SAP Ariba Cloud Integration GatewayIntegration
  • Status log for transmitted documents (document types see supported processes for SAP Ariba products)