Skip to main content

Prepare Zuora Billing

Zuora

Prepare Zuora Billing

  1. Last updated
  2. Save as PDF

Preparing Zuora Billing for the SAP GL (Billing) connector involves the following tasks:

Creating a Zuora User Role

Complete the following steps to create a Zuora User Role:

  1. Login using your administrator credentials.
  2. Navigate to Settings > Administration > Manage User Roles.
  3. Select "Platform" from the View Role List.
  4. Click Add New Role.
  5. Type "SAP Connector" in the name field.
  6. Check the API Write Access and Integration Hub boxes.
  7. Click Save.

Creating a Zuora User

After creating a Zuora user role, you should create a user and assign it to the "SAP Connector" Role.

  1. Login using your administrator credentials.
  2. Navigate to Settings > Administration > Manage Users.
  3. Click Add Single User.
  4. Select "SAP Connector" from the Zuora Platform Role drop-down.
  5. Enter your first name, last name, work email, and the login name as "yourname+SAP@yourcompany.com".
  6. Check your work email for a Welcome to Zuora! email and click the "Set your password and get started here" link.
  7. Enter your new password, security question, and security answer.
  8. Click Save.

Creating a Zuora Client

After creating a Zuora User, you should create a Zuora Client.

  1. Login using your administrator credentials.
  2. Navigate to Settings > Administration > Manage Users.
  3. Click on the user name you created previously.
  4. Scroll down to the OAuth Client section.
  5. Enter "SAP Connector" as the client name.
  6. Click Create.
    Zuora displays the Client ID and Client Secret for the OAuth client. Take note of the Client ID and Client Secret.

Configuring Custom fields

Extend the Journal Entry object with the following custom fields populated with appropriate default values from SAP:

  • SAP_COMPANY_CODE__c
  • SAP_DOCUMENT_TYPE__c

Extend the Journal Entry object with the following custom fields that will be used by the connector to record values from SAP for reconciliation purposes:

  • SAP_OBJECT_KEY_REVERSE__c
  • SAP_DOCUMENT_NUMBER__c
  • SAP_OBJECT_KEY__c
  • SAP_REVERSE_DOCUMENT_NUMBER__c

Optionally, extend the Accounting Code object with the following custom fields populated with appropriate default values from SAP:

  • SAP_HOUSE_BANK__c
  • SAP_HOUSE_BANK_ACCOUNT__c

To configure custom fields, click your username at the top right and navigate to Settings > Finance > Manage Custom Fields. For more information, see Custom Fields.

Configuring Segments

A segment is an association with a field on a Zuora object. After configuring segments, data for these segments is automatically included in your journal entries.

To configure segments, click your username at the top right and navigate to Settings > Finance > Configure Segments. For more information, see Configuring Segments.

When you perform a journal run, you may add segments to a segmentation rule to determine how your transactions are segmented into journal entries.

Configuring general ledger segmentation rules

A general ledger segmentation rule determines how your journal entries are segmented when you perform a journal run. A general ledger segmentation rule contains a set of segments, and transactions are grouped into summary journal entries according to the transactions' values for those segments.

Transactions are grouped into summary journal entries based on the following fields:

  • Transaction type
  • Currency
  • Debit account
  • Fields associated with the active general ledger segmentation rule

To configure GL segmentation rules, click your username at the top right and navigate to Settings > Finance > Configure GL Segmentation Rules.

For more information, see Configuring GL Segmentation Rules.

Creating a journal run

Journal runs create journal entries suitable for importing into your general ledger. 

To create a journal run, click Finance > Journal Runs from the left navigation panel and click New Journal Run.

For more information, see Create a Journal Run.