SAP Commerce connection

SAP Commerce, formerly known as Hybris, is a cloud-based e-commerce platform solution for B2B and B2C enterprises and available as part of the SAP Customer Experience portfolio. SAP Subscription Billing is a product under the portfolio and enables complete subscription lifecycle management with simplified selling and payment experiences through standardized integrations.

This Adobe Experience Platform destination uses the SAP Subscription Billing customer management API, to update your customer details within SAP Commerce from an existing Experience Platform audience after activation.

Instructions to authenticate to your SAP Commerce instance are further below, in the Authenticate to destination section.

Use cases

To help you better understand how and when you should use the SAP Commerce destination, here is a sample use case that Adobe Experience Platform customers can solve by using this destination.

SAP Commerce customers store information about individuals or organizational entities who interact with your business. Your team uses the customers existing in SAP Commerce to build the Experience Platform audiences. After sending these audiences to SAP Commerce, their information is updated and each customer is assigned a property with its value as the audience name that indicates which audience the customer belongs to.

Prerequisites

Refer to the sections below for any prerequisites that you must set up in Experience Platform and SAP Commerce and for information that you must gather before working with the SAP Commerce destination.

Experience Platform prerequisites

Before activating data to the SAP Commerce destination, you must have a schema, a dataset, and audiences created in Experience Platform.

Refer to Experience Platform documentation for Audience Membership Details schema field group if you need guidance on audience statuses.

Prerequisites for the SAP Commerce destination

Note the following prerequisites in order to export data from Platform to your SAP Commerce account:

You must have an SAP Subscription Billing account

In order to export data from Platform to your SAP Commerce account, you need to have an SAP Subscription Billing account. If you do not have a valid billing account, contact your SAP account manager. Refer to the SAP Platform Configuration document for additional details.

Generate a service key

• The SAP Commerce service key allows you to access the SAP Subscription Billing API through Experience Platform. Refer to the SAP Commerce create a Service Key with Client ID and Client Secret to create a service key. SAP Commerce requires the following:
  • Client ID
  • Client secret
  • URL. The URL pattern is as follows: https://subscriptionbilling.authentication.eu10.hana.ondemand.com. This value will be used later to obtain values for Region and Endpoint.

{
    "url": "https://eu10.revenue.cloud.sap/api",
    "uaa": {
        "clientid": "XXX",
        "clientsecret": "XXX",
        "url": "https://subscriptionbilling.authentication.eu10.hana.ondemand.com",
        "identityzone": "subscriptionbilling",
        "identityzoneid": "XXX",
        "tenantid": "XXX",
        "tenantmode": "dedicated",
        "sburl": "https://internal-xsuaa.authentication.eu10.hana.ondemand.com",
        "apiurl": "https://api.authentication.eu10.hana.ondemand.com",
        "verificationkey": "XXX",
        "xsappname": "XXX",
        "subaccountid": "XXX",
        "uaadomain": "authentication.eu10.hana.ondemand.com",
        "zoneid": "XXX",
        "credential-type": "binding-secret"
    },
    "vendor": "SAP"
}

Create custom references in SAP Subscription Billing

To update the Experience Platform audience status in SAP Subscription Billing, you need a custom reference field for each audience selected in Platform.

To create the custom references, Login to your SAP Subscription Billing account and navigate to the [Master Data and Configuration] > [Custom References] page. Next, select Create to add a new reference for each audience selected in Platform. You will require these reference field names in the subsequent Schedule audience export and example step.

An example of how to create a custom Reference Type within SAP Subscription Billing is shown below:

For additional guidance, refer to the SAP Subscription Billing custom references documentation.

Gather required credentials

To connect SAP Commerce to Experience Platform, you must provide values for the following connection properties:

Guardrails

API requests to the SAP Cloud Management service are subject to Rate Limits. When the rate limit is exceeded, you will encounter a HTTP 429 Too Many Requests response status code .

Supported identities

SAP Commerce supports update of identities described in the table below. Learn more about identities.

Supported audiences

This section describes all the audiences that you can export to this destination.

This destination supports the activation of all audiences generated through the Experience Platform Segmentation Service.

This destination also supports the activation of the audiences described in the table below.

Export type and frequency

Refer to the table below for information about the destination export type and frequency.

Connect to the destination

To connect to this destination, follow the steps described in the destination configuration tutorial. In the configure destination workflow, fill in the fields listed in the two sections below.

Within Destinations > Catalog, search for SAP Commerce. Alternatively you can locate it under the eCommerce category.

Authenticate to destination

Fill in the required fields below. Refer to the Generate a service key section for any guidance.

To authenticate to the destination, select Connect to destination.

If the details provided are valid, the UI displays a Connected status with a green check mark. You can then proceed to the next step.

Fill in destination details

To configure details for the destination, fill in the required and optional fields below. An asterisk next to a field in the UI indicates that the field is required.

• Name: A name by which you will recognize this destination in the future.
• Description: A description that will help you identify this destination in the future.
• Type of Customer: Select either Individual or Corporate depending on the entities within your audience. The SAP Subscription Billing schema switches the mandatory fields depending on this selection which is mapped to the customerType attribute. If the selection is Corporate, then the mandatory mappings like firstName and lastName required for an individual customer will be ignored and company becomes mandatory and vice-versa.

Enable alerts

You can enable alerts to receive notifications on the status of the dataflow to your destination. Select an alert from the list to subscribe to receive notifications on the status of your dataflow. For more information on alerts, see the guide on subscribing to destinations alerts using the UI.

When you are finished providing details for your destination connection, select Next.

Activate audiences to this destination

Read Activate profiles and audiences to streaming audience export destinations for instructions on activating audiences to this destination.

Map attributes and identities

To correctly send your audience data from Adobe Experience Platform to the SAP Commerce destination, you must go through the field mapping step. Mapping consists of creating a link between your Experience Data Model (XDM) schema fields in your Platform account and their corresponding equivalents from the target destination. To correctly map your XDM fields to the SAP Commerce destination fields, follow the steps below:

Map the customerNumberSAP identity

The customerNumberSAP identity is a mandatory mapping for this destination. Follow the steps below to map it:

1. In the Mapping step, select Add new mapping. You can now see a new mapping row on the screen.
   
2. In the Select source field window, choose the Select identity namespace and select customerNumberSAP.
   
3. In the Select target field window, choose the Select identity namespace and select the customerNumber identity.
   

An example with the identity mapping is shown below:

Mapping attributes

To add any other attributes you want to update between your XDM profile schema and your SAP Subscription Billing account, repeat the steps below:

1. In the Mapping step, select Add new mapping. You can now see a new mapping row on the screen.
   
2. In the Select source field window, choose the Select attributes category and select the XDM attribute.
   
3. In the Select target field window, choose Select custom attributes category and type the name of the SAP Subscription Billing attribute from the list of customer schema attributes.
   

Map mandatory attributes for the selected customer type

Mandatory attribute mappings depend on the Type of Customer that you had selected. To map the mandatory attributes, select from the below:

Mapping additional attributes

You can then add any additional mappings between your XDM profile schema and the SAP Subscription Billing schema attributes for a customer as shown below:

When you are finished providing the mappings for your destination connection, select Next.

Schedule audience export and example

When performing the Schedule audience export step, you must manually map Platform audiences to the attributes in SAP Subscription Billing.

An example of the Schedule audience export step, with the location of the SAP Commerce Mapping ID highlighted, is shown below:

To do this, select each segment, then enter name of the custom reference from SAP Subscription Billing in the SAP Commerce Mapping ID destination connector field. For guidance on creating custom references, refer to the Create custom references in SAP Subscription Billing section.

For example, if your selected Experience Platform audience is sap_audience1 and you want its status to be updated into the SAP Subscription Billing custom reference SAP_1, specify this value in the SAP_Commerce Mapping ID field.

An example Reference Type from SAP Subscription Billing is shown below:

An example of the Schedule audience export step, with an audience selected and its corresponding SAP Commerce Mapping ID highlighted, is shown below:

As shown the value within the Mapping ID field should exactly match the SAP Subscription Billing Reference Type value .

Repeat this section for each activated Platform audience.

Based on the image shown above where you have selected two audiences, the mapping would be as below:

Validate data export

To validate that you have correctly set up the destination, follow the steps below:

Log in to the SAP Subscription Billing account, then navigate to the Contacts page to check the audience statuses. The list can be configured to display columns for the custom references and display the corresponding audience statuses.

Data usage and governance

All Adobe Experience Platform destinations are compliant with data usage policies when handling your data. For detailed information on how Adobe Experience Platform enforces data governance, see the Data Governance overview.

Errors and troubleshooting

Refer to the SAP Subscription Billing Error Types documentation page for a list of possible error types and their response codes.

Additional resources

Additional useful information from the SAP documentation is below:

• Onboard SAP Subscription Billing

Changelog

This section captures the functionality and significant documentation updates made to this destination connector.