- Last updated
- Save as PDF
There are three subscription and amendment dates that serve as billing trigger dates, as well as a term start date and subscription start date.
Billing trigger dates alsoexistwith an order action if you are an Orders or Orders Harmonization customer. Formore information, seeBilling Trigger Dates on Order Action.
Types of Dates
- The billing trigger dates, along with the bill cycle day (as described above), determine when your subscription starts billing.
- The term start date determines when a subscription term starts (or, if amending the subscription to renew it for a new term, when the new term starts).
- The subscription start date is a date determined by Zuora and is the term start date for the original subscription.
You do not need to specify a term start date when creating a subscription. If you do not specify a term start date, the subscription contract effective date is populated as the term start date. In this case, the Subscription start date, the term start date, and the subscription contract effective date are all set to the same date.
Billing Trigger Dates
Zuora allows you to set up to three billing trigger dates:
- Contract Effective Date: The date of the contract that governs the subscription. This date is required if you use only a single billing trigger date.
- Service Activation Date: The date on which the services or products within a subscription have been activated and access has been provided to the customer.
- Customer Acceptance Date: The date on which the services or products within a subscription has been accepted by the customer.
The required trigger dates can vary by product and are configurable from the Default Subscription Settings. If your company's default subscription settings have Require Customer Acceptance of Orders? or Require Service Activation? set to Yes, you must enter those dates to fully activate the subscription. If either of these options are marked No, the applicable date (customer acceptance or service activation) will be made to match the contract effective date.
The billing trigger dates, along with the customer account BCD and the rate plan charge’s billing day all determine when a charge is billed. Often the contract effective date or the date that triggers the subscription charges, such as the service activation date or customer acceptance date, lines up with the bill cycle day specified in the customer account. When the two dates align, your customer will be billed on the anniversary date of subscription activation. This is known as "anniversary billing."
The billing trigger dates are sequential. This has the following effects:
- If your company uses only a single billing trigger date, only the contract effective date is required to activate a subscription. Even if you only specify that a single date is used, the other two dates (the service activation and customer acceptance dates) are automatically defaulted to be the same as the contract effective date.
- If your company uses two billing trigger dates, you must specify both the contract effective date and the service activate date to activate the subscription. The third date that is not used (the customer acceptance date) is defaulted to the service activation date.
- If your company uses all three billing dates, you must enter a date for all three billing trigger dates. You can specify the same or different dates for each type.
You need to specify the billing trigger dates whencreating a subscription.The system will set thebilling trigger dates that you set upon this time as theactivation dates of the subscription. Then, ifa charge's trigger condition isUpon Contract Effective,Upon Service Activation, orUpon Customer Acceptance, the system will copy the subscription'sactivation dates as the charge's start date. Note thatyou can update the billing trigger dates on the subscription only whenthe subscription is on version 1.The system will correspondingly update theactivation dates of the subscription and then update the charge's start date if the charge has not already been billed.
You can view the billing trigger dates of a subscription either from the Zuora UI and REST API:
- Zuora UI: On the subscription detail page. If the subscription has amendments, click the subscription version to view the billing trigger dates.
- REST API:Get subscriptions by account,Get subscriptions by key, andGet subscriptions by key and version.
For how to update billing trigger dates, seeUpdate the trigger dates for a subscriptionandUpdate the trigger condition for a subscription rate plan charge.
Billing Trigger Dates on Amendments
You need to specifythe billing trigger dates when makingan amendment. Not all amendments' billing trigger dates take real effect. Only the product-level amendments' billing trigger dates might take real effect.Thesubscription-level amendments' billing trigger datesdo not take real effect. See more details as follows:
- The product-level amendments' billing trigger datesdeterminea charge's start date if thecharge's trigger condition isUpon Contract Effective,Upon Service Activation, orUpon Customer Acceptance. If the trigger condition isUpon a Specific Date,the billing trigger dates on the amendment donot take real effect. Amendments of the following types are product-level amendments:
- Add a product
- Update a product
- Remove a product
- Change aproduct
- The subscription-level amendments' billing trigger datesdo not take real effect. You use the specific date required for anamendment other than the amendment's billing trigger dates.Amendments of the following types are subscription-level amendments:
- Terms & Conditions: useTerm Start Date.
- Suspend: useSuspend Date.
- Resume: useResume Date.
- Owner Transfer: anOwner Transfer amendment takes effect immediately, so nodate is required.
- Renewal: the renewal amendment takes effect whenthe current subscription term ends, so no date is required.
- Cancellation: useCancellation Date.
Subscription Dates and Cancelation
The Contract Effective Date is the date that your customer provided as the notice of cancelation. You can also use the same date when populating the Customer Acceptance Date and Service Activation Date of your amend() call to cancel a subscription.
When canceling a subscription, the Effective Date is the date that actually specifies when anamend()to cancel a subscription should take effect.
For example, suppose that you want to cancel a subscription with a service period that ends on April 15, 2012 (2012-04-15). Use the Effective Date 2012-04-16 in the amend() call to cancel thesubscription.
If you use an Effective Date of 2012-04-15, the service period of the invoice generated would have an end date of 2012-04-14.
After the subscription is canceled, theEffectiveDateof the Amendment object is overwritten with theContractEffectiveDate. The reason for this behavior is that when creating a new subscription with an amend() call this is the desired effect. If you query theAmendmentobject after cancelling a subscription, the value ofEffectiveDatemay be different to the one you originally specified, and be different to what is shown as the cancelation date in the web UI. The cancelation date has been set correctlyand can be confirmed by querying theTermEndDateof the amended subscription.
Billing Trigger Dates on Order Action
If you are anOrdersorOrders Harmonizationcustomer, you create or amend a subscription bycreating an orderconsisting of order actions. When creating an order, you must specify billing trigger dates for an order action. Not all order actions' billing trigger dates take real effect. See details as follows:
- The billing trigger dates on the Create Subscription order actiondeterminethe subscription's billing trigger dates. Then, the subscription's billing trigger datesconditionally determinea charge's start datewhenthe trigger condition isUpon Contract Effective,Upon Service Activation, orUpon Customer Acceptance.
- The billing trigger dates on the product-level order actionsconditionally determinea charge's start datewhenthe trigger condition isUpon Contract Effective,Upon Service Activation, orUpon Customer Acceptance.
- The billing trigger dates on the subscription-levelorder actions do not take real effect.
The following diagram illustrates the date-setting logic:
The following sections give a detailed description of the date-setting logic:
Billing Trigger Dates on Create Subscription Order Action
As in the preceding diagram, after the billing trigger dates of the Create Subscription order action are set, the system will copy the billing trigger dates on the Create Subscriptionorder action as the activation dates of thesubscription. Next, ifa charge's trigger condition isUpon Contract Effective,Upon Service Activation, orUpon Customer Acceptance, the system will set the subscription'sactivation dates as the charge's start date. Afterthe order is activated and the subscription is created, you cannot update the billing trigger dates on theorder action. However, you can stillupdate the trigger dates on thesubscriptionwhenthe subscription is on version 1.The system will correspondingly update theactivation dates of the subscription, and then update the charge's start date if the charge is not already billed.
The following isan example.
Suppose you create a subscription through the Create Subscription order action, set the charge's trigger conditionasUpon Service Activation, and then onlyset the Contract Effective Date onthe order action to January 1, 2023. Aftertheorder is placed, both the order and subscription are now in the pending status, and the resultingdatesareas follows:
- On the subscription: The Contract Effective Date isJanuary 1, 2023. The Service Activation Date and Customer Acceptance Date are both not set.
- On the charge:The start date is notset.
Next, suppose you set the subscription's activation datesas Service Activation Date: January 2, 2023, andCustomer Acceptance Date: January 3, 2023. Both the subscription and order are now active, and the resulting datesareas follows:
- On the charge:The start date isJanuary 2, 2023. You can see that the system sets the charge's start date as the same as the activation date of the subscription.
- On the Create Subscription order action: Before setting the subscription to active, the system aligns the billing trigger dates on the Create Subscription order action to those of the subscription.The Contract Effective Date isJanuary 1, 2023. The Service Activation Date isJanuary 2, 2023. The Customer Acceptance Date isJanuary 3, 2023.
Asno order is further madeto the subscription, thissubscription is still on version 1, so you can update the billing trigger dates on the subscription. Suppose youupdate the subscription's activation datesas Service Activation Date: January 4, 2023, and Customer Acceptance Date: January 5, 2023. Also, suppose the rate plan charge has not been billed yet. The resulting dates areas follows:
- On the subscription: The system correspondingly updates the billing trigger dates on the subscription. The Contract Effective Date isJanuary 1, 2023. The Service Activation Date isJanuary 4, 2023. The Customer Acceptance Date isJanuary 5, 2023.
- On the rate plan charge:The system updates the charge's start date. The start date isJanuary 4, 2023.
- On the Create Subscription order action:The billing triggerdays on the order action remain unchanged after the subscription is active.The Contract Effective Date isJanuary 1, 2023. The Service Activation Date isJanuary 2, 2023. The Customer Acceptance Date isJanuary 3, 2023.
Billing Trigger Dates on Product-level Order Actions
The product-level order actions' billing trigger datesdeterminea charge's start date if the trigger condition isUpon Contract Effective,Upon Service Activation, orUpon Customer Acceptance. If the trigger condition isUpon a Specific Date,the billing trigger dates on the order action donot take real effect. Order actions of the following types are product-level order actions:
- Add a product
- Update a product
- Remove a product
- Change a product
Billing Trigger Dates on Subscription-level Order Actions
The subscription-levelorder actions'billing trigger datesdo not take real effect. For these order actions, you only need to use the specific date required for that order action, as follows:
- Terms & Conditions: UseTerm Start Date.
- Suspend: UseSuspend Date.
- Resume - UseResume Date.
- Owner Transfer: AnOwner Transfer order action takes effect immediately when you activatethe order, so nodate is required.
- Renewal: A renewal takes effect whenthe current subscription term ends, so no date is required.
- Cancellation - UseCancellation Effective Date.
Booking date
Booking date is the business’ contract effective date or order effective date in Zuora.
Billing
In Billing, the booking date is captured through the following fields:
| Tenant type | API field | Corresponding UI field |
|---|---|---|
| Orders | Captured through the orderDate field when creating orders | Order Date |
| Subscribe and Amend | Captured through the lastBookingDate field when creating subscriptions or through the bookingDate field when making amendments | Booking Date |
| Orders Harmonization | Captured through either the orderDate or lastBookingDate field, depending on whether you use the order action or amendment to create and manage a subscription | Order Date or Booking Date |
Once the booking date is entered during subscription creation or amendment, you can view the above fields through UI or API.
For the use of the lastBookingDate field in API, see the following API operations:
- Create a subscription
- List subscriptions by account key
- Retrieve a subscription by key
- Retrieve a subscription by key and version
- CRUD: Retrieve a subscription
Revenue
In Revenue, the booking date will be recorded as the Sale Order Date (SO book date) on the Contract item and used in the following areas:
- Transactions with sales order date on or before the open period will be considered for revenue processing.
- Deriving the standalone selling price for allocation
- Determining exchange rates
- Determining configuration for Revenue Policy
Limitations and recommendations
Consider the following limitations and recommendations when populating the booking date:
- Future booking dates cause issues during data processing in Zuora Revenue as the billing document might have an earlier document date than the booking date, this results in data validation issues.
- If you’re a Zuora Revenue customer and using the order date as the booking date for revenue recognition, when creating a scheduled order, it’s recommended to ensure the order date and scheduled execution date fall into the same accounting period.
Invoice item adjustment and discount dates
Zuora uses these dates to determine the subscription service period.Invoice item adjustments and discounts use the same service periods as the invoice item they are offsetting. Cancellation fees caused by subscription cancellations have the service period defined by the cancellation date and the original service period end date of the cancelled item. Activation and usage fees have a one day service period.
The following table shows the type of invoice items that can show up on an invoice and the service start and service end dates that are associated with each invoice item type that is used to derive the revenue recognition schedule for that specific charge.
| Type of invoice item that can appear in an invoice | Service start date used to derive the recognition schedule | Service end dateused to derive the recognition schedule |
|---|---|---|
| Recurring fees | Recurring start period | Recurring end period |
| Activation fees | Date the fee charged | Date the fee charged |
| Usage fees | Prior usage start period | Prior usage end period |
| Discounts | Recurring start period | Recurring end period |
| Invoice item adjustment | Same as item adjusted | Same as item adjusted |
| Cancellation fees | Cancellation date | Same as item cancelled |
Last Invoice Date
The last invoice date isthe date until when charges have been processed.
The last invoice date is the same date as the process through date. If there are more than two charges on the subscription, the last invoice date is thesame date as the latest process through date of all the charges within the subscription.
In the Zuora UI,you can find the process through date of a chargein the following steps:
- Navigate to Customers > Subscriptionsin the left-hand navigation section.
- Click the name of the subscription to enter the detailed subscription view.
- At the bottom of the page in the Product & Charges section,select View by Key Statisticsfromthe drop-down list. The History columnis displayed in the table.
- Click the icon for a charge in the History column.The Process Through date of thecharge is displayedin theCharge History of table.
In the Zuora SOAP API, you can get the process through date of a chargeby querying the ProcessedThroughDate field on the RatePlanCharge object.
In the Zuora REST API, you can get the process through date(processedThroughDate) of a charge usingthe Get Subscription by Key or Get Subscription by Accountmethods.
