Skip to main content

Configure the SAP GL (Billing) connector

Zuora

Configure the SAP GL (Billing) connector

  1. Last updated
  2. Save as PDF

Configuring SAP GL (Billing) connector involves the following tasks.

Authenticating your Zuora and connector environments

Complete the following steps to authenticate your Zuora and connector environments:

  1. Navigate to Marketplace > Integration Hub.
  2. Search and select SAP GL (Billing). 
  3. Click Settings.
  4. Enter the Client ID and Client Secret for the Zuora client in the Zuora Authentication section. For more information on how to generate Client ID and Client Secret, see Create an OAuth Client for a User.
  5. Click Test Connection to validate your authentication details.
  6. Click Save.

Configuring an SAP S/4HANA Public Cloud destination

Complete the following steps to configure an SAP S/4HANA Public Cloud destination:

  1. Navigate to Marketplace > Integration Hub.
  2. Search and select SAP GL (Billing). 
  3. Select the Settings tab.
  4. Click the Add a Destination + icon.
  5. Enter the Customer ID, Destination Name, and Destination System.
  6. Click Add.
  7. Click Save.

Configuring an SAP S/4HANA Private Cloud or SAP ECC destinations

Complete the following steps to configure an SAP S/4HANA Private Cloud or SAP ECC destinations:

  1. Navigate to Marketplace > Integration Hub.
  2. Search and select SAP GL (Billing). 
  3. Select the Settings tab.
  4. Find the SAP Agent Destination Details section
  5. Click the Add a Destination + icon.
  6. Enter the Customer ID, Destination Name, and Destination System.
  7. Click Add.
  8. Click Save.

Establishing field mappings

After successful authentication, you can extend the default field mappings between the source and the target fields. The source fields provide a list of fields from the Zuora journal entry, journal entry item, and accounting code objects. 

Complete the following steps to map the fields:

  1. Navigate to Marketplace > Integration Hub.
  2. Search and select SAP GL (Billing). 
  3. Click Field Mapping.
  4. Click the Edit Mappings button.
  5. Click the + icon. 
  6. Choose the applicable source field and map it to the corresponding target field of the SAP journal.
  7. Click the Refresh icon to dynamically refresh the list of fields in the source and target menus upon any field changes in the Zuora or SAP journal object.

Using Constants 

Complete the following steps to specify constants:

  1. Navigate to Marketplace > Integration Hub.
  2. Search and select SAP GL (Billing).
  3. Click Field Mapping.
  4. Click the Edit Mappings button.
  5. Click the Open the Expressions Wizard icon.
  6. In the Expressions Wizard, select Constant.
  7. Enter a constant value.
  8. Click the Submit button.
  9. Click Save Mappings.

Creating value mappings 

Complete the following steps to create value mappings:

  1. Click Field Mapping.
  2. Click the Edit Mappings button.
  3. Click the Open the Expressions Wizard icon.
  4. In the Expressions Wizard, select Value Mapping.
  5. In the Expressions Wizard, select a source field and create your value mapping.
  6. Click the Submit button.
  7. Click Save Mappings.

Configuring default values 

If you have a source field that may contain a null value, you may specify a default value to use instead. To configure default values to be used when a source field is null, complete the following steps:

  1. Click Field Mapping.
  2. Click the Edit Mappings button.
  3. Enter a default value in the Enter Default Value field.
  4. Click Save Mappings.

Specifying custom target fields 

If you have configured one or more custom fields in SAP, you may create field mappings for them by manually entering their names. To specify custom target fields, complete the following steps:

  1. Click Field Mapping.
  2. Click the Edit Mappings button.
  3. Enter the name of the target custom field.

Use the dot operator to specify the custom field. For example, JournalEntries.{custom_field_name}. 

  1. Specify a source field or a constant. 
  2. Click Save Mappings.

Initiating a dry run 

Before attempting your first transfer to the accounting operation, you can initiate a dry run to verify if your settings and field mappings are configured as required. This process executes the field mappings and generates output for any journal entries for any journal runs awaiting transfer to accounting. This operation can result in more than one dry run job. 

Complete the following steps to initiate a dry run:

  1. Click Field Mapping.
  2. Click the Initiate a Dry Run button.
  3. Click the Jobs tab.
  4. Click the View button for the Dry Run job, or jobs, you have created.