Common use cases

Knowledge Center > Zuora RevPro > Zuora Billing - RevPro Integration overview > Common use cases

Common use cases

Zuora Billing - RevPro Integration is in Limited Availability. We are actively soliciting feedback from a small set of early adopters before releasing as generally available. 

Zuora Billing - RevPro Integration includes support for various use cases. The following table demonstrates how order actions or amendments are mapped to RevPro sales order actions: 

Zuora Order Action/amendment Termed subscription: Segment/charge behavior Evergreen subscription: Segment/charge behavior RevPro SO action
New Subscription
  • New Charge ID
  • New Segment
  • New Charge ID
  • New Segment with no End Date
New SO Line
New Product
  • New Charge ID
  • New Segment
  • New Charge ID
  • New Segment with no End Date
New SO Line
Amendment/Order Action - Price Change
  • Original Charge ID
  • Existing Charge Segment with an End Date
  • Original Charge ID
  • Existing Charge Segment with an End Date
Update Existing SO Line
Amendment/Order Action - Price Change
  • New Charge Segment with an End Date
  • New Charge Version
  • New Charge Segment with no End Date
  • New Charge Version
New SO Line
Amendment/Order Action - Quantity Change
  • Original Charge ID
  • Existing Charge Segment with an End Date
  • Original Charge ID
  • Existing Charge Segment with an End Date
Update Existing SO Line
Amendment/Order Action - Quantity Change
  • New Charge Segment with an End Date
  • New Charge Version
  • New Charge Segment with no End Date

  • New Charge Version

New SO Line
Renewal
  • Original Charge ID
  • New Charge Segment with an End Date
  • Original Charge ID
  • New Charge Segment with no End Date
New SO Line
Remove Product
  • Original Charge ID
  • Bring forward Segment End Date
  • Original Charge ID
  • Create Segment End Date
Update SO Line
Cancel
  • Original Charge ID
  • Bring forward Segment End Date
  • Original Charge ID
  • Create Segment End Date
Update SO Line
Terms and Conditions
  • Original Charge ID
  • Extend or bring forward Segment End Date
  • Original Charge ID
  • Extend or bring forward Segment End Date
Update SO Line
Suspend
  • Original Charge ID
  • Bring forward Segment End Date
  • Original Charge ID
  • Bring forward Segment End Date
Update SO Line
Resume
  • Original Charge ID
  • New Segment
  • Original Charge ID
  • New Segment
New SO Line
Owner Transfer None None None

When creating a new subscription or amending an existing subscription in Zuora Billing, the number of the created SO lines depends on the discount type of rate plan charges:

  • For regular rate plan charges without discount, including one-time charges and recurring charges, each charge is mapped to one sales order (SO) line in RevPro.
  • For fixed amount discount charges, a charge is treated in RevPro as a new and stand-alone SO line that will not be allocated, regardless of how it is applied. This is done through extracting the Fixed Amount Discount amount from the Rate Plan Charge Tier data source from Zuora Billing.
  • For percentage discount charges, a charge can be mapped to multiple SO lines in RevPro depending on the number of transactions it is applied to. It ensures RevPro can correctly allocate the revenue against the charges that have been discounted.

See Charge Models for more information on rate plan charge models.

Segment splitting for amendments

Zuora Billing - RevPro Integration uses the combination of original charge ID and charge segment to identify the granular transactions within the booking and billing data.
When you create a new termed subscription associated with a rate plan charge, Zuora Billing creates a new charge segment that starts from the subscription term start date until the term end date. For evergreen subscriptions, no end date is set for this segment. 
If you amend the price or quantity during the subscription term, the initial charge segment will be split into two segments - the existing segment and the new segment.

  • For the existing segment: the start date remains the original term start date, and the end date is updated to the amendment date. 
  • For the new segment: the start date is the amendment date and the end date remains the original subscription term end date. No end date is set for evergreen subscriptions. 

When a subscription is renewed, a new charge segment is created accordingly. 

Examples

The examples of typical use cases are provided in this section to help you understand how the actions in Zuora Billing affect RevPro behaviors.

New subscription

If you create a subscription of Product A (Quantity:1) on Jan 1, 2019 for 1 year in Zuora Billing, and the monthly fee is $100, the following data will be sent to RevPro:

Charge Name Original Charge ID Subscription Version Charge Segment Quantity Dates Booked Value RevPro Transaction Type
Product A Monthly 1a2b3c 1 1 1 01/01/19 - 12/31/19 $1,200 New SO (#1)

RevPro will create a new revenue contract that includes one SO line (SO #1).

Increase price

The monthly fee is increased to $150 on Jul 1st, 2018, then the original rate plan charge segment will be split into two segments:

Charge Name Original Charge ID Subscription Version Charge Segment Quantity Dates Booked Value RevPro Transaction Type
Product A Monthly 1a2b3c 2 1 1 01/01/19 - 06/30/19 $600 Update SO (#1)
Product A Monthly 1a2b3c 2 2 1 07/01/19 - 12/31/19 $900 New SO (#2)

This amendment will trigger the prospective contract modification to the existing revenue contract. RevPro will bring forward the end date for SO #1 and create a new SO line (SO #2).

Increase quantity

On Oct 1, 2019, you want to increase the quantity to 2, then the latest charge segment will be split again into two segments:

Charge Name Original Charge ID Subscription Version Charge Segment Quantity Dates Booked Value RevPro Transaction Type
Product A Monthly 1a2b3c 2 2 1 07/01/19 - 09/30/19 $450 Update SO (#2)
Product A Monthly 1a2b3c 2 3 2 10/01/19 - 12/31/19 $900 New SO (#3)

This amendment will trigger the prospective contract modification to the existing revenue contract. RevPro will bring forward the end date for SO #2 and create a new SO line (SO #3).

Add a product

On Nov 1, 2019, you want to add a Product B (quantity:1) to this subscription for one month. It is a one-time charge and the price of Product B is $500 per month. The following data will be sent to RevPro:

Charge Name Original Charge ID Subscription Version Charge Segment Quantity Dates Booked Value RevPro Transaction Type
Product B 1a2b3c 3 1 1 11/01/19 - 11/30/19 $500 New SO (#4)

This amendment will trigger the prospective contract modification to the existing revenue contract. A new performance obligation (POB) will be added to the contract (SO #4).

Renew subscription

On Dec 31, 2019, you decide to renew the subscription for Product A with the existing quantity for the following year at the price of $150 per month. The data sent to RevPro will be:

Charge Name Original Charge ID Subscription Version Charge Segment Quantity Dates Booked Value RevPro Transaction Type
Product A Monthly 1a2b3c 4 4 2 01/01/20 - 12/31/20 $3,600 New SO (#5)

RevPro will create a new revenue contract that includes a new SO line.

Last modified

Tags

This page has no custom tags.

Classifications

(not set)