Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Page Sections

Define your chart of accounts

Learn how to define and configure your chart of accounts in Zuora to manage financial transactions and integrate with your accounting system.

Out of the box, Zuora can provide you with basic revenue data to use in your general ledger accounting system. If you later decide to use Zuora as a full-featured revenue sub-ledger system, you can access more powerful and complete features by integrating Zuora Billing with Zuora Revenue. In the meantime, you can immediately start applying accounting codes to your Zuora transactions, providing basic accounting information immediately and ensuring that valuable historical accounting data will be in place later.

To define the chart of accounts, the following steps are outlined.

  1. Review your chart of accounts

    Zuora uses a set of accounting codes (stored in a chart of accounts) to identify different types of financial transactions within your Zuora data. This allows you to use your Zuora data for revenue accounting.

    To do this, you'll need to configure the Zuora chart of accounts to contain a subset of your primary accounting system's general ledger account codes. For new tenants, a standard set of codes is provided as a starting place, and that may be all you need.

    For detailed information, see Set up chart of accounts.

  2. Assign accounting codes to your financial transactions

    After you are sure that the chart of accounts is tailored to your needs, you can configure your system to automatically assign the correct accounting codes to the various types of transactions, such as invoices, payments, credits, and refunds. In some cases, you can override the automatically-assigned accounting code for an individual transaction. You'll find detailed explanations of all this in the instructions linked below.

    For detailed information, see Assign accounting codes.

After completing steps 1 and 2 above, begin to use accounting codes with all your transactions. Where Zuora wants you to provide or approve an accounting code, you'll see a drop-down list that lets you choose an appropriate code. As your data accumulates, you can draw basic reports and data exports that include this accounting data, which you can use to provide revenue data for your accounting system.

Chart of accounts setup

Zuora's chart of accounts uses accounting codes to categorize transactions, aiding in financial reporting and management by identifying affected accounts like Accounts Receivable or Cash.

Zuora's chart of accounts contains the accounting codes used to categorize your Zuora transactions for accounting purposes. In accounting terms, these codes identify the account affected by a transaction, such as Accounts Receivable or Cash. In most cases, the general ledger account names are used for Zuora accounting codes.

Using accounting codes to group transactions within reports makes it easy to generate reports on the various categories of financial activity. One typical purpose of such reports is to produce totals for summary journal entries in an accounting system.

Not everyone uses accounting codes in the same way. For instance, some use the same accounting code for payments and refunds so that you get a single net payment amount when you total the transactions for that accounting code. Others prefer to use separate accounting codes to keep separate totals for payments and refunds.

Once the accounting codes are in use, there are strict limitations on your changes. We strongly recommend that the company CFO or Controller participate in planning your Finance configuration.

Supported fields

The Zuora chart of accounts includes the following fields:

FieldDescriptionFinance note
Name

Required. Name of the accounting code. Once this code is used in a transaction, the name cannot be changed.

Note that duplicate accounting code names are not allowed.

All tenants
NotesOptional text field for notes about the account.All tenants
Type

The account type, such as Assets, Accounts Receivable, Cash, and so on. The Type can be changed at a later time unless it is Accounts Receivable.

Note: It is suggested to use the On-Account Receivable accounting code type as a credit memo On-Account accounting code if you enable the Advanced AR Settlement feature.

The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memos, and Invoice Item Settlement. If you want to have access to the feature, see Invoice Settlement Enablement and Checklist Guide for more information. After Invoice Settlement is enabled, theInvoice Item Adjustment feature will be deprecated for your tenant.

All tenants
GL Account NameOptional. The name of the corresponding account in your general ledger accounting system.Finance only
GL Account NumberOptional. The number of the corresponding account in your general ledger accounting system.Finance only

Pre-populated accounting code values

Your chart of accounts is pre-loaded by default with typical accounting codes that work well for many companies.

We recommend that you review your chart of accounts, add any new accounts you know you will need, and consider deactivating any accounts that you will not be using in the future.

View your chart of accounts

To view a list of your accounting codes, access the Chart of Accounts page by completing the following steps:

  1. Click your user avatar at the top right and then click Finance. The Finance Settings page opens.

  2. Click Manage Chart of Accounts. The Chart of Accounts page opens and displays the accounting codes in a table format, showing their name, type, and status.

Manage an accounting code

Learn how to create, edit, and delete accounting codes within the Chart of Accounts, ensuring proper management and assignment to transactions.

  1. To create an accounting code perform the following steps:
    You can create an accounting code from the Chart of Accounts page. An accounting code cannot be deleted after creation.
    1. Click your user avatar at the top right and then click Finance. The Finance Settings page opens.
    2. Click Manage Chart of Accounts. The Chart of Accounts page opens.
    3. Click New Accounting Code.
    4. Specify the fields as necessary and then click Create Accounting Code. The following fields are required.
      • Name: The name must be unique within the selected type. After the accounting code is used in a transaction, the name cannot be changed.
      • Type: Select one from the dropdown list, which is populated with a standard set of high-level accounting codes.
      Note:

      You can create multiple accounting codes for Accounts Receivable (AR) under Chart of Accounts if you have Invoice Item Settlement enabled.

      You cannot set a blank value to the Accounts Receivable accounting code, even when the disallow blank accounting rule is set to 'No'.

  2. To edit an accounting code:, perform the following steps:
    1. Open the Chart of Accounts page and click Edit in the Actions column.

      You can also activate or deactivate an accounting code using the Actions column.

      You cannot deactivate an accounting code that is assigned to one or more transaction types. For more information about assigning accounting codes to transaction types, see Assign accounting codes.
    Note:

    When you deactivate an accounting code, ensure that you remove the accounting code from the following:

    • All Product Rate Plan Charge(PRPC)
    • Finance Settings > Configure Accounting Codes - check for all transaction types
    • Finance Settings > Manage Non-Subscription Items and Standalone Orders
  3. To delete an accounting code, perform the following steps:
    1. Click Delete in the Actions column.

      You must have the Delete Unused Accounting Code Finance permission in order to delete an accounting code. You can only delete accounting codes that have never been associated with any transactions. An accounting code must be deactivated before you can delete it.

      You can also delete an accounting code using the SOAP API. See AccountingCode for more information.

Having tailored the chart of accounts to your satisfaction, the next steps are:

  • Assign accounting codes from the chart of accounts to the appropriate transactions. For more information, see Assign accounting codes.
  • Use accounting codes with all your transactions for an entire accounting period (or retroactively apply them to transactions in an open period).

Now, you'll have the data you need to close the accounting period and export your summary revenue data.

Accounting codes usage in Zuora Billing

Zuora Billing requires the assignment of accounting codes to various financial transactions to provide accurate revenue accounting data.

For Zuora to provide you with revenue accounting data, you must assign accounting codes to various revenue transactions (invoices, payments, credits, refunds).

Before you begin, your chart of accounts must be configured for your business. See Chart of account setup for more information.

Financial transactions

You can use Zuora Billing as a simple revenue sub-ledger or a more full-featured revenue sub-ledger. Either way, every financial transaction in Zuora Billing must be associated with an accounting code that maps to the GL account affected by the transaction. The transactions which require an accounting code are:

  • Invoices
  • Invoice adjustments
  • Invoice item adjustments
  • Credit balance adjustments
  • Payments (and credit balance payments)
  • Refunds (and credit balance refunds)
  • Credit and debit memos
  • FX Gain/Loss

Credit balance payments and credit balance refunds can use their own separate codes or use the same codes as payments and refunds.

Add or change codes

If you don't use accounting codes, your transactions are recorded with a blank code. If you later start using accounting codes, new transactions created after the change will reflect the accounting codes, and old transactions will still have the blank code.

The same principle generally applies when making other changes as well:

  • If you edit the codes you're using, transactions recorded before the edits will still have the old codes, and new transactions will have the new codes.
  • If you change an accounting code assignment for a particular type of transaction, the change applies only to new transactions. For instance, if you assign a different accounting code to a product rate plan charge, any new invoices that you create will use the new accounting code. Existing invoices will not be affected by the change and will still have the old accounting code.

How accounting codes are derived and defined

The following chart summarizes where accounting codes are derived and defined in Zuora Billing. Detailed explanations are provided in the next section.

TransactionWhere the Accounting Code is Derived FromWhere to Define the Accounting Code in Zuora
Invoice ItemRate Plan Charge
  • If Zuora Finance is enabled:Product Catalog Rate Plan Charge > Finance > Accounting Code
  • If Zuora Finance is not enabled:Product Catalog Rate Plan Charge > Name > Accounting Code
Invoice PaymentPayment Method
Tax ItemTax CodeFinance Settings > Configure Accounting Codes
Credit Balance PaymentFinance Settings: Configure Accounting CodesFinance Settings > Configure Accounting Codes
Payment RefundPayment MethodFinance Settings > Configure Accounting Codes
Credit Balance RefundFinance Settings: Configure Accounting CodesFinance Settings > Configure Accounting Codes
Credit Balance AdjustmentFinance Settings: Configure Accounting CodesFinance Settings > Configure Accounting Codes

Invoice Adjustment

Note: Invoice Adjustment is deprecated on Production. Zuora recommends that you use the Invoice Item Adjustment instead.
Invoice Adjustment TransactionWhen creating an Invoice Adjustment, go to Additional Fields > Accounting Code
Invoice Item AdjustmentInvoice Item: Rate Plan Charge
  • If Zuora Finance is enabled:Product Catalog Rate Plan Charge > Finance > Accounting Code
  • If Zuora Finance is not enabled:Product Catalog Rate Plan Charge > Name > Accounting Code
  • When adjusting an invoice item, go to Advanced Options > Change Accounting Codes. See Override Invoice Item Adjustment Service Periods and Accounting Codes for more information.

The following transaction types are only available if you enable the Invoice Settlement feature.

The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memos, and Invoice Item Settlement. If you want to have access to the feature, see Invoice Settlement Enablement and Checklist Guide for more information. After Invoice Settlement is enabled, the Invoice Item Adjustment feature will be deprecated for your tenant.

Credit Memo

Note: Credit memos can be created due to an invoice/debit memo write-off.

If a write-off credit memo impacts revenue, the deferred revenue accounting code used at the time of invoice/DM posting will be used during the write-off CM creation.

For non-revenue impacting write offs, such as write offs using bad-debt expense accounts, the accounting code can be selected in Finance settings > Manage accounting codes.

Finance Settings: Configure Accounting CodesFinance Settings > Configure Accounting Codes
Debit MemoInvoice Item: Rate Plan Charge
  • If Zuora Finance is enabled:Product Catalog Rate Plan Charge > Finance > Accounting Code
  • If Zuora Finance is not enabled:Product Catalog Rate Plan Charge > Name > Accounting Code

Accounting codes for transaction types

This section discusses the best accounting codes to assign to various transaction types.

Note: Associating an accounting code at the transaction level might take some time. Allow some time before exporting the accounting information associated with the transactions.

Invoice Items

For invoicing, the accounting code maps to an income or revenue GL account in your accounting system.

An invoice can include multiple items, such as subscription fees, support fees, and professional services fees. The GL account that you would associate with each of those items corresponds to the Zuora accounting code to assign at the product rate plan charge level. In Zuora, each invoice item will be tracked by the accounting code from the product rate plan charge.

You can use the same accounting code for any product rate plan charges that have the same revenue attributes. For example, subscriptions that contain quarterly billing schedules may have the same accounting codes as subscriptions that contain annual billing schedules.

Setting finance rules for rate plan charges

When creating a rate plan charge, select the revenue recognition rule that you want to use with the charge:

  • Recognize upon invoicing: Select this rule so revenue will go straight against the Recognized Revenue accounting code – revenue is recognized all at once when the charge is invoiced.
  • Recognize daily over time: Select this to include the charge in the Zuora Finance standard deferred revenue report, which recognizes revenue over a period of time using a daily recognition calculation. When closing an accounting period, Zuora will group all invoice items using the Deferred Revenue General Ledger account.

Using discount specific accounting codes and rules to manage revenue

When creating or editing a discount charge, select this option to define the finance information (including revenue recognition rules and accounting codes) for this discount charge. If you do not select this option, the discount charge uses finance information from the regular charge where the discount is applied.

Configuring accounting codes

Use the accounting codes to map to the GL accounts you use to create journal entries. Depending on how you choose to recognize revenue, you might need to enter either a recognized revenue account or both a recognized revenue account and a deferred revenue account.

If you have any existing accounting codes, we have automatically migrated them to the recognized revenue account. This has not changed any existing functionality of the accounting codes.

The accounting code represents the offsetting account to your accounts receivable (AR). We now automatically select accounting codes for you based on the revenue recognition rule that you have selected.

If you recognize revenue upon invoicing, we populate the accounting code with the value from the recognized revenue account. If you recognize revenue daily over time, we populate the accounting code with the value from the deferred revenue account.

Invoice Item Adjustments

The accounting code and accounting period for an invoice item adjustment automatically map to the same revenue GL account that was used for the original invoice item. If you have a direct integration with your accounting system, invoice item adjustments will reduce your corresponding accounts receivable balance. An invoice item adjustment can increase or decrease the invoice balance.

Invoice Payments

Accounting codes for invoice payments are defined under Finance > Configure Accounting Codes, and typically map to a bank account in your accounting system.

Credit Balance Payments

Accounting code for credit balances are defined under Finance > Configure Accounting Codes. A credit balance payment is created from an overpayment. The accounting code for a credit balance payment typically maps to a bank account in your accounting system and is generally different from the accounting code you would use for a normal payment.

Payment Refunds

Accounting codes for payments are defined under Finance > Configure Accounting Codes. The accounting code in a payment refund typically maps to a bank account in your accounting system. A refund also updates the accounts receivable in your GL. You then process an invoice item adjustment to the extent that the accounts receivable needs to be removed from your financial statements.

Credit Balance Refunds

Accounting codes for your credit balances are defined under Finance > Configure Accounting Codes. A credit balance refund occurs when you refund a credit balance payment. The accounting code for a credit balance refund is typically a bank account in your accounting system.

Credit Balance Adjustments (Increase)

The accounting code for a credit balance adjustment typically maps to a cash-on-account GL account in your accounting system. This transaction type is used when creating a credit balance from a negative invoice, which results in an increase to the credit balance amount on a customer account.

Credit Balance Adjustments (Decrease)

The accounting code for a credit balance adjustment typically maps to a cash-on-account GL account in your accounting system. This transaction type is used to transfer funds from the credit balance to a positive invoice, thus reducing the invoice balance.

Credit Memos

The Credit Memo transaction type is only available if you enable the Invoice Settlement feature.

Note:

The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memos, and Invoice Item Settlement. If you want to have access to the feature, see Invoice Settlement Enablement and Checklist Guide for more information. After Invoice Settlement is enabled, the Invoice Item Adjustment feature will be deprecated for your tenant.

Accounting codes for your credit memos are defined under Finance > Configure Accounting Codes.

The accounting code for a credit memo that is applied to invoices inherits the Accounts Receivables from the invoice on the credit entry, and inherits the On-Account from the credit memo on the debit entry.

The accounting code for a credit memo that is applied to debit memos inherits the Accounts Receivables from the debit memo on the credit entry, and inherits the On-Account from the credit memo on the debit entry.

The accounting code for credit memo refunds inherits the Bank Account from the refund on the credit entry, and inherits the On-Account from the credit memo on the debit entry.

Non-revenue impacting write off: This field is available only if you have enabled the enhanced write-off permission for your tenant. Contact Zuora Global Support to enable this permission.

You can create and select accounting codes for a non-revenue impacting write off, such as write offs to a bad-debt expense account.

The accounting code for a credit memo that is applied to invoices inherits the Accounts Receivables from the invoice on the credit entry, and inherits the On-Account from the credit memo on the debit entry.

The accounting code for a credit memo that is applied to debit memos inherits the Accounts Receivables from the debit memo on the credit entry, and inherits the On-Account from the credit memo on the debit entry.

Debit Memos

The Debit Memo transaction type is only available if you enable the Invoice Settlement feature.

Note:

The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memos, and Invoice Item Settlement. If you want to have access to the feature, see Invoice Settlement Enablement and Checklist Guide for more information. After Invoice Settlement is enabled, the Invoice Item Adjustment feature will be deprecated for your tenant.

The accounting code for debit memo automatically maps to the same revenue GL account that was used for the original invoice item. If you have a direct integration with your accounting system, debit memo items will reduce your corresponding accounts receivable balance.

FX Gain/Loss

FX Gain/Loss transaction type is only available if you enable the FX Gain Loss GL Entries. For more information, see Create FX Gain Loss GL Entries. The accounting code for FX Gain/Loss is applied to realized and unrealized FX gain loss on accounting period end and reversal entries.