Welcome to Zuora Product Documentation

Explore our rich library of product information

Multi-Org and invoice settlement harmonization

Use this reference to understand how transactions behave when Invoice Settlement Harmonization (ISH) is enabled in a Multi-Org environment.

When Invoice Settlement Harmonization (ISH) is enabled within a Multi-Org environment, transaction types behave differently based on whether they belong to Invoice Settlement framework or legacy settlement transactions.

  • Invoice Settlement (IS) transactions such as Invoices and payments are labeled with a specific organization (Org) identifier.

  • Legacy settlement transactions such as Invoice Item Adjustments (IIA) and Invoice Adjustments (IA), and Credit Balance Adjustments (CBA) are not Org-labeled and are not associated with a specific Org.

This distinction might require additional handling and reconciliation when you work with org-specific and unlabeled accounting periods.

Transaction labeling behavior

Transaction IdentifierTransaction TermAssociated Organization
U-2INV-1 for -$100US
U-2IIA-1 for -$20N/A
U-2IA-1 for -$30N/A
U-2CBA-1 for -$40N/A

Allocation to accounting periods

  • INV-1 (Invoice) is assigned to the customer accounting period with the US Org label.

  • IIA-1 (Invoice Item Adjustment) is assigned to the customer accounting period without an Org label.

  • IIA-1 revenue schedule is allocated to an accounting period without an Org label.

  • IA-1 (Invoice Adjustment) is assigned to the customer accounting period without an Org label.

  • CBA-1 (Credit Balance Adjustment) is assigned to the customer accounting period without an Org label.

Current scope

  1. Org labeling constraints:

    • IS transactions such as invoices and payments are Org-labeled.

    • Legacy transactions such as IIA, IA, and CBA remain unlabeled, and might require reconciliation.

  2. Accounting period reconciliation:

    • Since legacy settlement transactions do not carry an Org identifier, you must align unlabeled adjustments with Org-specific accounting periods.

The organization labeling is applied as follows:

Transaction ItemAllocationOrganization Label
INV-1with customer accounting periodUS
IIA-1with customer accounting periodUnlabeled org
IIA-1 revenue schedulewith customer accounting periodUnlabeled org
IA-1with customer accounting periodUnlabeled org
CBA-1with customer accounting periodUnlabeled org