Skip to main content

Overview of Booking Transactions

Zuora

Overview of Booking Transactions

The Booking Transaction object is available in the data source and data query. Booking transactions capture important changes, custom field direct updates, and the delta values on Rate Plan Charge, Order Line Item, and related objects when a subscription is created or amended in Zuora Billing.

Booking transactions for subscriptions

When a subscription is created or amended, booking transactions are generated on the segment level if one of the following conditions is met:

  • The new segment is a discount, and the new segment's quantity is not the same as the previous segment.
  • The new segment is not a discount, and the new segment's Extended List Price (ELP) value is not the same as the previous segment.
  • The new segment's effective start date is not the same as the previous segment.
  • The new segment's effective end date value is not the same as the previous segment.
  • The Charge Contract Value (CCV) of the new segment is not the same as the previous segment.
  • When a charge is created, a new segment is created and a booking transaction is generated for the new segment.
  • When a charge is updated, a new segment is created and a booking transaction is generated for the segment.
  • When an owner transfer occurs to a subscription and the subscription owner gets changed, all the segments that belong to the new version subscription generate booking transactions.
  • If the current segment is a discount charge and the applied to charge segment is changed, a booking transaction is generated for the discount line.

 

In the following table, you can see how booking transactions get generated for amendments or order actions:

Amendment Types

Order Actions

Booking Transaction Object

 

Create Subscription

Records all charge segments

Add product

Add product

Records the new charge segment created

Update product

Update product

Record the new and old impacted segment

Remove Product

Remove Product

Record all impacted charge segments

Renew Subscription

Renew Subscription

Record the new renewed charge segments

Cancel Subscription

Cancel Subscription

Record all impacted charge segments

Subscription Owner Transfer

Subscription Owner Transfer

Record all charge segments

Suspend and resume

Suspend and resume

Record all impacted charge segments

Terms and Conditions

Terms and Conditions

Record all impacted charge segments

 

Change Plan

Record all impacted charge segments

 

Component

Record all impacted charge segments

Pending to Active

Pending to Active

Record all impacted charge segments

  Revert Order (Only supported with a single version subscription) Record all impacted charge segments

There are more than 50 fields in the Booking Transaction object. For more information, see Booking Transaction object fields and Data Query.

Booking transactions for order line items

When an order line item is created or updated, booking transactions are generated if one of the following conditions is met:

  • The itemState field is set to Booked, SentToBilling, or Complete when creating the order line item
  • The itemState field is transitioned from Executing to Booked, SentToBilling, or Complete.

Limitations

The booking transactions are not generated for the following conditions:

  • Draft subscriptions
  • Deleting a subscription (including deleting an order or deleting an amendment). The deleting operations are not recommended. For more information, see Required configurations and best practices for using Order to Revenue.
  • For any subscription that has an account-level discount charge, the subscription does not generate any booking transaction.