Orders - Create Subscription on an Existing Account with Volume Charge - Data dictionary

IsNewOrder

Marker Column

Existing Account Number*

The account number that this order will be created under. Note that this actually specifies the invoice owner account of the subscriptions included in this order.

Order Date*

The date the order is signed. If the contract effective date field is skipped or its value is left as null, all the order actions under this order will use this order date as the contract effective date.

Order Number

The order number of the new order. If not provided, system will auto-generate a number for this order.Note: Make sure the order number does not contain a slash.

IsNewSubscription

Marker Column

Subscriptions Subscription Number

Subscription number of the subscription. For example, A-S00000001.

If you do not set this field, Zuora will generate the subscription number.

IsNewSubscriptionOrderAction

Marker Column

Subscriptions Order Actions Create Subscription Subscription Number

Leave this empty to represent new subscription creation. Specify a subscription number to update an existing subscription.

IsNewSubscriptionOrderActioncreateSubscriptionratePlan

Marker Column

Subscriptions Order Actions Create Subscription Subscribe To Rate Plans Product Rate Plan Id*

Internal identifier of the product rate plan that the rate plan is based on.

IsNewSubscriptionOrderActioncreateSubscriptionratePlanRatePlanCharge

Marker Column

Subscriptions Order Actions Create Subscription Subscribe To Rate Plans Charge Overrides Product Rate Plan Charge Id*

Internal identifier of the product rate plan charge that the charge is based on.

IsNewSubscriptionOrderActioncreateSubscriptionratePlanRatePlanChargepriceRecurringVolumePricingUpdatechargeTier

Marker Column

Subscriptions Order Actions Create Subscription Subscribe To Rate Plans Charge Overrides Pricing Recurring Volume tier Number*

Subscriptions Order Actions Create Subscription Subscribe To Rate Plans Charge Overrides Pricing Recurring Volume tier Price*

Price or per-unit price of the tier, depending on the value of the priceFormat field.

Subscriptions Order Actions Create Subscription Subscribe To Rate Plans Charge Overrides Pricing Recurring Volume tier Price Format*

Specifies whether the tier has a fixed price or a per-unit price.

Enum: "FlatFee" "PerUnit"

Subscriptions Order Actions Create Subscription Subscribe To Rate Plans Charge Overrides Pricing Recurring Volume tier Starting Unit*

Number of units at which the tier becomes effective.

Subscriptions Order Actions Create Subscription Subscribe To Rate Plans Charge Overrides Pricing Recurring Volume tier Ending Unit

Limit on the number of units for which the tier is effective.

Subscriptions Order Actions Create Subscription Subscribe To Rate Plans Charge Overrides Start Date Trigger Event

Condition for the charge to become active.

If the value of this field is SpecificDate, use the specificTriggerDate field to specify the date when the charge becomes active.

Enum: "ContractEffective" "ServiceActivation" "CustomerAcceptance" "SpecificDate"

Subscriptions Order Actions Create Subscription Subscribe To Rate Plans Charge Overrides Billing Bill Cycle Day

The day of the month that each billing period begins is only applicable if the value of the billCycleType field is SpecificDayofMonth.

Subscriptions Order Actions Create Subscription Subscribe To Rate Plans Charge Overrides Billing Bill Cycle Type

Specifies how Zuora determines the day that each billing period begins on.

DefaultFromCustomer - Each billing period begins on the bill cycle day of the account that owns the subscription.

SpecificDayofMonth - Use the billCycleDay field to specify the day of the month that each billing period begins on.

SubscriptionStartDay - Each billing period begins on the same day of the month as the start date of the subscription.

ChargeTriggerDay - Each billing period begins on the same day of the month as the date when the charge becomes active.

SpecificDayofWeek - Use the weeklyBillCycleDay field to specify the day of the week that each billing period begins on.

Enum: "DefaultFromCustomer" "SpecificDayofMonth" "SubscriptionStartDay" "ChargeTriggerDay" "SpecificDayofWeek"

Subscriptions Order Actions Create Subscription Subscribe To Rate Plans Charge Overrides Billing Period

Billing frequency of the charge. The value of this field controls the duration of each billing period.

If the value of this field is Specific_Days, Specific_Months or Specific_Weeks, use the specificBillingPeriod field to specify the duration of each billing period.

Enum: "Month" "Quarter" "Semi_Annual" "Annual" "Eighteen_Months" "Two_Years" "Three_Years" "Five_Years" "Specific_Months" "Subscription_Term" "Week" "Specific_Weeks" "Specific_Days"

Subscriptions Order Actions Create Subscription Subscribe To Rate Plans Charge Overrides Billing Period Alignment

Specifies how Zuora determines when to start new billing periods. You can use this field to align the billing periods of different charges.

AlignToCharge - Zuora starts a new billing period on the first billing day that falls on or after the date the charge becomes active.

AlignToSubscriptionStart - Zuora starts a new billing period on the first billing day that falls on or after the subscription's start date.

AlignToTermStart - For each subscription term, Zuora starts a new billing period on the first billing day that falls on or after the start date of the term.

See the billCycleType field for information about how Zuora determines the billing day.

Enum: "AlignToCharge" "AlignToSubscriptionStart" "AlignToTermStart"

Subscriptions Order Actions Create Subscription Terms Auto Renew

Specifies whether the subscription automatically renews at the end of the each term. Only applicable if the type of the first term is TERMED.

Subscriptions Order Actions Create Subscription Terms Renewal Setting

Specifies the type of the terms that follow the first term if the subscription is renewed. Only applicable if the type of the first term is TERMED.

RENEW_WITH_SPECIFIC_TERM - Each renewal term has a predefined duration. The first entry in renewalTerms specifies the duration of the second term of the subscription, the second entry specifies the duration of the third term of the subscription, and so on. The last entry specifies the ultimate duration of each renewal term.

RENEW_TO_EVERGREEN - The second term of the subscription does not have a predefined duration.

Enum: "RENEW_WITH_SPECIFIC_TERM" "RENEW_TO_EVERGREEN"

Subscriptions Order Actions Create Subscription Terms Initial Terms Term Type*

Type of the first term. If the value of this field is TERMED, the first term has a predefined duration based on the value of the period field. If the value of this field is EVERGREEN, the first term does not have a predefined duration.

Enum: "TERMED" "EVERGREEN"

Subscriptions Order Actions Create Subscription Terms Initial Terms Period

Duration of the renewal term in months, years, days, or weeks, depending on the value of the periodType field.

Subscriptions Order Actions Create Subscription Terms Initial Terms Period Type

Unit of time that the renewal term is measured in.

Enum: "Month" "Year" "Day" "Week"

Subscriptions Order Actions Create Subscription Terms Initial Terms Start Date

Start date of the first term, in YYYY-MM-DD format.

IsNewSubscriptionOrderActioncreateSubscriptionTermRenewalTerm

Marker Column

Subscriptions Order Actions Create Subscription Terms Renewal Terms Period

Duration of the first term in months, years, days, or weeks, depending on the value of the periodType field. Only applicable if the value of the termType field is TERMED.

Subscriptions Order Actions Create Subscription Terms Renewal Terms Period Type

Unit of time that the first term is measured in. Only applicable if the value of the termType field is TERMED.

Enum: "Month" "Year" "Day" "Week"

IsNewSubscriptionOrderActionTriggerDate

Marker Column

Subscriptions Order Actions Trigger Dates Name

Name of the trigger date of the order action.

Enum: "ContractEffective" "ServiceActivation" "CustomerAcceptance"

Subscriptions Order Actions Trigger Dates Trigger Date

Trigger date in YYYY-MM-DD format.