Beta

Create a SAP Commerce source connection in the UI

Last update: April 2, 2025

CREATED FOR:

  • Developer
NOTE
The SAP Commerce source is in beta. See the sources overview for more information on using beta-labeled sources.

The following tutorial walks you through the steps to create a SAP Commerce source connection to bring SAP Subscription Billing contacts and customer data using the Adobe Experience Platform user interface.

Getting started

This tutorial requires a working understanding of the following components of Experience Platform:

If you already have a valid SAP Commerce account, you may skip the remainder of this document and proceed to the tutorial on configuring a dataflow.

Gather required credentials

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

CredentialDescription
Client IDThe value of clientId from the service key.
Client secretThe value of clientSecret from the service key.
Token endpointThe value of url from the service key, it will be similar to https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
RegionYour data center location. The region is present in the url and has a value similar to eu10 or us10. For example if the url is https://eu10.revenue.cloud.sap/api you will need eu10.

For more information, please refer to the SAP Commerce documentation.

Create an Experience Platform schema

Before creating a SAP Commerce source connection, you must also ensure that you first create an Experience Platform schema to use for your source. See the tutorial on creating an Experience Platform schema for comprehensive steps on how to create a schema.

Expand the following section to view an example schema.

View schema example
{
  "_extconndev": {
    "addresses": [
      {
        "addressUUID": "{ADDRESS_UUID}",
        "city": "Burnaby",
        "country": "Canada",
        "email": "chandni@acme.com",
        "houseNumber": "27",
        "isDefault": false,
        "phone": "123-456-7890",
        "postalCode": "V3J 1X9",
        "state": "British Columbia",
        "street": "Beresford"
      }
    ],
    "changedAt": "1687204041",
    "changedBy": "vero@acme.com",
    "contactNumber": "123-456-7980",
    "corporateInfo": {
      "company": "acme"
    },
    "createAt": "1687204041",
    "createdBy": "vero@acme.com",
    "customReferences": [
      {
        "id": "Sample value",
        "typeCode": "Sample value"
      }
    ],
    "customerNumber": "Sample value",
    "customerType": "Sample value",
    "defaultAddress": {
      "addressUUID": "Sample value",
      "city": "North Vancouver",
      "country": "Canada",
      "email": "chandni@acme.come",
      "houseNumber": "34",
      "isDefault": false,
      "phone": "123-456-7890",
      "postalCode": "V7H 2P1",
      "state": "British Columbia",
      "street": "Maple"
    },
    "externalObjectReferences": [
      {
        "externalId": "{EXTERNAL_ID}",
        "externalIdTypeCode": "{EXTERNAL_ID_TYPE_CODE}",
        "externalSystemId": "{EXTERNAL_SYSTEM_ID}"
      }
    ],
    "markets": [
      {
        "active": false,
        "country": "USA",
        "currency": "USD",
        "marketId": "Sample value",
        "priceinfo": {
          "incoterms": "{INCO_TERMS}",
          "incotermsLocation": "{INCO_TERMS_LOCATION}",
          "priceGroup": "{PRICE_GROUP}",
          "priceListType": "{PRICE_LIST_TYPE}"
        },
        "salesArea": {
          "distributionChannel": "{DISTRIBUTION_CHANNEL}",
          "division": "{DIVISION}",
          "salesOrganization": "{SALES_ORGANIZATION}"
        }
      }
    ],
    "personalInfo": {
      "firstName": "Chandni",
      "lastName": "Kaur"
    }
  },
  "_id": "/uri-reference",
  "_repo": {
    "createDate": "2004-10-23T12:00:00-06:00",
    "modifyDate": "2004-10-23T12:00:00-06:00"
  },
  "createdByBatchID": "/uri-reference",
  "modifiedByBatchID": "/uri-reference",
  "personID": "{PERSON_ID}",
  "repositoryCreatedBy": "kevin@acme.com",
  "repositoryLastModifiedBy": "kevin@acme.com"
}