Configure the SAP Connector

Configuring and testing your Zuora credentials

Complete the following steps to configure and test your Zuora credentials:

1. Navigate to Marketplace > Integration Hub.
2. Search and select the SAP Connector or SAP Connector (Revenue) tiles. 
3. For the SAP Connector, select the capability you must configure.
4. Click Settings.
5. 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.
6. Click Test Connection to validate your authentication details.
7. Click Save.
8. Click Settings to configure the SAP Connector (Revenue).
9. Enter the Host URL, Username, Password, Role Name, and Client Name.
10. Click Test Connection to validate your authentication details.
11. Click Save.

Configuring S/4HANA Public Cloud destination

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

1. Navigate to Marketplace > Integration Hub.
2. Search and select the SAP Connector or SAP Connector (Revenue) tiles. 
3. For the SAP Connector, select the capability you must configure.
4. Select the Settings tab.
5. Find the SAP Agent Destination Details section.
6. Click the Add a Destination + icon.
7. Enter the Customer ID, Destination Name, and Destination System.
8. Click Add.
9. 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 the SAP Connector or SAP Connector (Revenue) tiles. 
3. For the SAP Connector, select the capability you must configure.
4. Select the Settings tab.
5. Find the SAP Agent Destination Details section
6. Click the Add a Destination + icon.
7. Enter the Customer ID, Destination Name, and Destination System.
8. Click Add.
9. Click Save.

Creating field mappings

For each capability a set of default field mappings are provided which you may extend or modify. The source fields provide a list of all the source objects and fields available with that capability. 

Complete the following steps to add a field mapping:

1. Navigate to Marketplace > Integration Hub.
2. Search and select the SAP Connector or SAP Connector (Revenue) tiles. 
3. For the SAP Connector, select the capability you must configure.
4. Click Field Mapping.
5. Click the Edit Mappings button.
6. Click the + icon. 
7. Choose the source and target field you want to map.

Creating conditional field mappings

Complete the following steps to create conditional field mappings:

1. Navigate to Marketplace > Integration Hub.
2. Search and select the SAP Connector or SAP Connector (Revenue) tiles. 
3. For the SAP Connector, select the capability you must configure.
4. Click Field Mapping.
5. Click the Edit Mappings button.
6. Click the + icon. 
7. Click Save Mappings.

Using Constants 

Complete the following steps to specify constants:

1. Navigate to Marketplace > Integration Hub.
2. Search and select the SAP Connector or SAP Connector (Revenue) tiles. 
3. For the SAP Connector, select the capability you must configure.
4. Click Field Mapping.
5. Click the Edit Mappings button.
6. Click the Open the Expressions Wizard icon.
7. In the Expressions Wizard, select Constant.
8. Enter a constant value.
9. Click the Submit button.
10. Click Save Mappings.

Using negate decimal expressions

Complete the following steps to create negate decimal expressions:

1. Navigate to Marketplace > Integration Hub.
2. Search and select the SAP Connector or SAP Connector (Revenue) tiles. 
3. For the SAP Connector, select the capability you must configure.
4. Click Field Mapping.
5. Click the Edit Mappings button.
6. Select a field of type WHOLE NUMBER or DECIMAL from the Source Path dropdown.
7. Click Save Mappings.

Configuring additional settings 

If you wish to set a billing document date before which billing documents will not be transferred from Zuora, complete the following steps:-

1. Navigate to Marketplace > Integration Hub.
2. Search and select the SAP Connector or SAP Connector (Revenue) tiles. 
3. For the SAP Connector, select the capability you must configure.
4. Select the Settings tab.
5. Find the Additional Settings section.
6. Specify or select a date.
7. Click Save.

If you want transfers that fail to be automatically retried the next time a transfer operation is initiated, complete the following steps:-

1. Navigate to Marketplace > Integration Hub.
2. Search and select the SAP Connector or SAP Connector (Revenue) tiles. 
3. For the SAP Connector, select the capability you must configure.
4. Select the Settings tab.
5. Find the Additional Settings section.
6. Check the box to retry any failed transfer operations.
7. Click Save.

Initiating a dry run 

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

Complete the following steps to initiate a dry run:

1. Navigate to Marketplace > Integration Hub.
2. Search and select the SAP Connector or SAP Connector (Revenue) tiles. 
3. For the SAP Connector, select the capability you must configure.
4. Click Field Mapping.
5. Click the Initiate a Dry Run button.
6. Click the Jobs tab.
7. Click the View button for the dry run job, or jobs, you have created.