Welcome to Zuora Product Documentation

Explore our rich library of product information

Single Action-Create Order with Commitments

This reference article lists all the fields associated with the Single Action-Create Order with Commitments data dictionary.

Note: Fields with an asterisk mark indicate mandatory fields.
Name Description Value
IsNewOrder Marker Column TRUE
Order Date*

The date on which the order is signed. If the contract effective date field is omitted or set to null for any order action under the order, the system uses the order date as the contract effective date.

string <date>

Commitments Action*

Indicates whether to create a commitment.

Value: create

string

Commitments Currency*

Currency of the commitment.

string <= 100 characters

commitments ​Description

The description of the commitment

string<= 500 characters

Commitments Name*

The name of the commitment.

String <= 255 characters

Commitments > Commitment Number

Unique identifier assigned to a commitment record.

string

Commitments > Priority*

Specifies the evaluation order of commitments. A lower numeric value indicates a higher priority. If multiple commitments have the same priority value, the system evaluates the commitment created earlier first.

integer

Commitments > Prepayment Type ​ The prepayment type of the commitment. ​ ​

Enum: "NotPrepaid","FullyPrepaid"

Example: FullyPrepaid

string

Commitments Type*

Specifies the type of commitment applied to the agreement

Enum: "MinCommitment","MaxCommitment"

String

Commitments > Specific Period Alignment Date The specific date for the period alignment. This field is required only if the periodAlignmentOption is set to SpecificDate.

string(date)

Commitments > Account Receivable Accounting Code

The accounting code on the commitment object for customers.

string <= 100 characters

Commitments > Period Alignment Option

Specifies how commitment periods are aligned within a commitment.

Default: CommitmentStartDate Enum: "CommitmentStartDate","SpecificDate"

string

Commitments > Taxable

Specifies whether the charge is taxable. If this field is set to true, both the fields TaxCode and TaxMode must be specified.

boolean

Commitments > TaxCode

Specifies the tax classification applied to the charge.

Note: This field is available when the taxable field is set to true.

string<= 100 characters

commitments > TaxMode

Specifies how tax is applied to the charge amount.
Note: This field is available when the taxable field is set to true.

Enum: "TaxInclusive", "TaxExclusive"

string

Commitments > Adjustment Liability Accounting Code

Specifies the accounting code used to track liability-related adjustments for the commitment on the customer account

Note: This field is only available if you have the Order to Revenue feature enabled.

string<= 100 characters

Commitments > Deferred Revenue Accounting Code

Specifies the deferred revenue accounting code for the commitment.

string <= 100 characters

Commitments > Recognized Revenue Accounting Code

Specifies the recognized revenue accounting code for the commitment.

string<= 100 characters

Commitments > Revenue Amortization Method

Specifies the method used to recognize and amortize revenue associated with the commitment.

string <= 200 characters

Commitments > Revenue Recognition Rule

Specifies the rule used to determine the revenue associated with the commitment is recognized.

string <= 255 characters

Commitments > Revenue Recognition Timing

Specifies the timing method used for revenue recognition on the commitment.

string <= 200 characters

Commitments ​> Adjustment Liability Accounting Code

Specifies the accounting code to record liability-related adjustments for the commitment.

Note: This field is only available if you have the Order to Revenue feature enabled.

string <= 100 characters

Commitments > Adjustment Revenue Accounting Code

Specifies the accounting code to record revenue-related adjustments for the commitment.
Note: This field is only available if you have the Order to Revenue feature enabled.

string <= 100 characters

Commitments > ​Contract Asset Accounting Code

Specifies the accounting code to record contract liability amounts associated with the commitment.

Note: This field is only available if you have the Order to Revenue feature enabled.

string <= 100 characters

Commitments ​> Contract Liability Accounting Code

Specifies the accounting code to record recognized revenue amounts for the commitment.

Note: This field is only available if you have the Order to Revenue feature enabled.

string <= 100 characters

Commitments ​> Contract Recognized Revenue Accounting Code

Specifies the accounting code to record unbilled receivable amounts associated with the commitment.
Note: This field is only available if you have the Order to Revenue feature enabled.

string <= 100 characters

Commitments > Unbilled Receivables Accounting Code

Specifies the accounting code to record unbilled receivable amounts associated with the commitment.
Note: This field is only available if you have the Order to Revenue feature enabled.

string <= 100 characters

Commitments​ > Exclude Item Billing From Revenue Accounting

Indicates whether commitment-related billing documents, including invoice items, invoice item adjustments, credit memo items, and debit memo items, are excluded from revenue accounting processing.
Note: This field is only available if you have the Order to Revenue feature enabled.

boolean

Commitments > Is Allocation Eligible

Indicates whether the commitment is eligible for revenue allocation during the revenue recognition process.

Note: This field is only available if you have the Order to Revenue feature enabled.

boolean

Commitments > ​isUnbilled

Indicates whether the commitment is treated as unbilled for revenue recognition and accounting purposes.
Note: This field is only available if you have the Order to Revenue feature enabled.
Fboolean

Commitments > Eligible Account Conditions > Field

Specifies the account field name used in a single eligibility condition.

string

Commitments > Eligible Account Conditions > Operator

Specifies the comparison operator used in a single eligibility condition.

Example:

  • eq: equal, field = value
  • neq: not equal, field != value
  • gt: greater than, field > value
  • lt: less than, field < value
  • gte: greater than or equal, field >= value
  • lte: less than or equal, field <= value - lk: like, field like value
  • in: in, field in value, multiple values are separated by commas
  • nl: null, field is null
  • nnl: not null, field is not null
Enum: "eq","neq","gt","lt","gte","lte","lk","in","nl","nnl"

string

Commitments > Eligible Account Conditions > Value

Specifies the value or list of comma-separated values used to evaluate a single eligibility condition.

Note: Account Condition only contains account related fields. Support is provided only for the indexed custom fields.

string

Commitments > Eligible Account Conditions > Conditions

The conditions are evaluated and combined using the specified relation.
Note: The conditions are combined by the relation.

Array of objects

Commitments > Eligible Account Conditions > Relation

Specifies the logical relationship among the conditions.

Enum: "and","or"

string

Commitments > Eligible Charge Conditions > Field

Specifies the charge-related field name used in a single eligibility condition.

string

Commitments > Eligible Charge Conditions > Operator

Specifies the comparison operator used in a single eligibility condition.

Example:

  • eq: equal, field = value
  • neq: not equal, field != value
  • gt: greater than, field > value
  • lt: less than, field < value
  • gte: greater than or equal, field >= value
  • lte: less than or equal, field <= value
  • lk: like, field like value
  • in: in, field in value, multiple values are separated by commas
  • nl: null, field is null
  • nnl: not null, field is not null
Enum: "eq","neq","gt","lt","gte","lte","lk","in","nl","nnl"

string

Commitments > Eligible Charge Conditions > Value

Specifies the value or list of comma-separated values used to evaluate a single eligibility condition.

Note:
  • PPDD (PrePaid DrawDown) charge will not be loaded during evaluation.
  • Charge condition only contains charge related fields. Support is provided only for the indexed custom fields.
  • Charge types supports only the OneTime, Recurring and Usage values.
  • Charge models supports only the FlatFee, PerUnit, Overage, Volume Tiered, TieredWithOverage, and Calculated values.

string

Commitments > Eligible Charge Conditions > Conditions

Specifies the collection of charge eligibility conditions that are evaluated together.

array of objects

Commitments > Eligible Charge Conditions > Relation

Specifies the logical relationship among the conditions.

Enum: "and","or"

string

Commitments Is Unbilled

This field is used to dictate how to perform the accounting during revenue recognition.

Note: This field is only available if you have the Order to Revenue feature enabled.

boolean

Commitments > Schedules > Action

Value: create

string

Commitments > Schedules > Amount*

Specifies the committed amount for each period in the commitment schedule.

integer

Commitments > Schedules > Amount Base

Specifies the level to which the committed amount applies.

Default: CommitmentPeriod

Value: CommitmentPeriod

string

Commitments > Schedules > Period Type

Specifies the frequency type of each period in the commitment schedule, such as monthly or yearly.

Default: "Month"

Enum: "Month","Quarter","SemiAnnual","Year","SpecificMonths","SinglePeriod"

string

Commitments > Schedules > Specific Period Length

Specifies the exact duration of each period in the commitment schedule.

integer

Commitments > Schedules > Start Date*

Specifies the start date of the commitment schedule.

string (date)

Commitments > Schedules >End Date*

Specifies the end date of the commitment schedule period.

Note: A commitment can contain a maximum of 100 schedule periods.

string (date)

Commitments > Schedules > Prepayment Definition Prepayment Frequency

The prepayment frequency for the prepayment definition.

If the value is Specific_Months, Specific_Weeks, or Specific_Days, use the specificFrequency field to specify the duration.

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

string

Commitments > Schedules > Prepayment Definition Specific Frequency

The specific frequency length.

This field is required when prepaymentFrequency is Specific_Months, Specific_Weeks, or Specific_Days.

integer

Commitments > Schedules > Prepayment Definition Custom Fields

Container for custom fields of a prepayment definition object.

object

Existing Account Id

The account ID under which this order will be created. This field sets the default invoice owner account and subscription owner account for any new subscriptions in the order. To override these defaults for individual subscriptions, use the subscriptionOwnerAccountNumber and invoiceOwnerAccountNumber nested fields in the subscriptions field. If you want to relax the restriction that the existingAccountNumber must be the invoice owner of the subscriptions in this order, submit a request to Zuora Global Support.

Note: You can specify either the existingAccountNumber or existingAccountId field, but not both.

string

Existing Account Number*

The account number under which this order will be created. This field sets the default invoice owner account and subscription owner account for any new subscriptions in the order. To override these defaults for individual subscriptions, use the subscriptionOwnerAccountNumber and invoiceOwnerAccountNumber nested fields in the subscriptions field. If you want to relax the restriction that the existingAccountNumber must be the invoice owner of the subscriptions in this order, submit a request to Zuora Global Support.

Example:"A00000097"

string <= 70 characters

order Number

The order number of the new order. If not provided, system will auto-generate a number for this order.Note: The characters #, ?, and / are not allowed in this field. Additionally, to ensure compatibility with the UI when viewing orders, use only the following special characters: _,-, ., ~, *, (, ), and '.

string <= 100 characters

status

The status of the order. The default value is Completed. The following values are supported:

  • Draft: The order is in draft status.
  • Pending: The order is in pending status.
  • Completed: The order is in completed status.
  • Scheduled: The order is in scheduled status and it is only valid if the Scheduled Orders feature is enabled.
  • Executing: The scheduled order is executed by a scheduler and it is only valid if the Scheduled Orders feature is enabled.
  • Failed: The scheduled order has failed.
Note:

If you have the Pending Subscription Processing feature turned on and want to update a completed order with an active subscription with pending charges, you must specify Completed in this field because the default order status is Pending for this scenario.

Enum: "Draft","Pending","Completed","Scheduled","Executing","Failed"

string

Scheduling Options Scheduled Date

The date for the order scheduled.

string (date)

Scheduling Options Scheduled Date Policy

Date policy of the scheduled order.

Value: SpecificDate

string