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 toBooked
,SentToBilling
, orComplete
when creating the order line item - The
itemState
field is transitioned fromExecuting
toBooked
,SentToBilling
, orComplete
.
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.