Welcome to Zuora Product Documentation

Explore our rich library of product information

Product rate plan charge with dynamic pricing import fields

Use this reference to view all the fields associated with the product rate plan charge with dynamic pricing data dictionary.

Note: Fields with an asterisk mark indicate mandatory fields.
Name Description Value

IsNewProductRatePlanCharge

Required when creating a new product rate plan charge. Enter True if applicable; otherwise, enter False. This field cannot be left blank.

true of false

Charge Model* Charge model that determines how the charge is calculated.

Enum: flat_fee, per_unit, overage, volume, tiered, tiered_overage, discount_fixed_amount, discount_percentage, custom_charge_model, delivery, minimum_commitment_true_up, calculated, high_water_mark_volume_pricing, high_water_mark_tiered_pricing, multi_attribute_pricing, prerated_pricing, prerated_per_unit

string

Charge Type* Charge category in the catalog.

Enum: one_time, recurring, usage.

string

Description Description for the charge.

string

Name* Name of the charge as displayed in the product catalog.

string

Unit of Measure* Unit of measure (UOM) used to quantify or price the charge. e.g., Each, Seats, Licenses.

string

Default Quantity Default quantity applied when the charge is added, if not specified elsewhere.

double

End Date Condition Condition that determines when the charge becomes inactive. Use subscription_end when the charge should remain active until the subscription ends. Duration-based fields such as up_to_periods and up_to_periods_type do not apply when this value is used.

Enum: end_date_one_time, subscription_end, fixed_period, specific_end_date.

string

Up To Periods

Number of periods used with end_date_condition = fixed_period. Combined with up_to_periods_type to determine the fixed duration of the charge. Ignored when end_date_condition = subscription_end.

integer 32

Up To Periods TypeUnit used to define the fixed period when end_date_condition is fixed_period. Ignored when end_date_condition is subscription_end.

Enum: billing_periods, days, weeks, months, years.

sting

Bill Cycle > Type* Determines how the billing day is selected for this charge.

Enum: default_from_customer, specific_day_of_month, subscription_start_day, charge_trigger_day, specific_day_of_week, term_start_day, term_end_day.

string

Bill Cycle > Period* Length of each billing period.

Enum: bill_cycle_period_month, bill_cycle_period_quarter, bill_cycle_period_semi_annual, bill_cycle_period_annual, bill_cycle_period_eighteen_months, bill_cycle_period_two_years, bill_cycle_period_three_years, bill_cycle_period_five_years, bill_cycle_period_specific_months, bill_cycle_period_subscription_term, bill_cycle_period_week, bill_cycle_period_specific_weeks, bill_cycle_period_specific_days.

string

Bill Cycle > Period Alignment* Specifies how the billing period is aligned.

Enum: align_to_charge, align_to_subscription_start, align_to_term_start, align_to_term_end.

string

Bill Cycle > Timing

Specifies whether the charge is billed before or after the service period.

Enum: in_advance, in_arrears.

string

Bill Cycle > Day of Week

Specifies the day of the week.

Enum:sunday, monday, tuesday, wednesday, thursday, friday, saturday.

string

Bill Cycle > Day of Month

Required when type is specific_day_of_month.

string

List Price Base Specifies the basis used to interpret the list price.

Enum: Per_Billing_Period, Per_Month, E, Per_Year, Per_Specific_Months, Per_Validity_Period.

string

Specific List Price Base Optional value used when list_price_base requires a specific quantity, such as the number of months for Per_Specific_Months.

e.g., 0

double

Trigger Event*

Specifies the event that activates the charge on a subscription.

Enum: contract_effective, service_activation, customer_acceptance, specific_date.

string

Product Rate Plan Id*

Identifier of the product rate plan that owns this charge.

string

Specific List Price Base Number of months used when list_price_base is Per_Specific_Months. Required when list_price_base is Per_Specific_Months. The value must be an integer from 1 to 120.

Formula

Formula applied after rate-card lookup to adjust the computed price.

String

Tax Code

Tax code used for tax calculation on this charge.

string

Tax Mode

Tax mode for this charge.

Enum: non_taxable, tax_exclusive, tax_inclusive.

string

Accounting > Accounting Code

Accounting code associated with the charge for reporting and ERP mapping. This is a code or identifier, not the general ledger (GL) account name.

e.g.,PRPC-REV-001

string

Accounting > Accounts Receivable Account

Name of the Accounts Receivable (AR) account used to record invoices for this charge. The account must exist in the tenant's chart of accounts.

e.g., Accounts Receivable

sting

Accounting > Accounts Receivable Account Type

Account type associated with the accounts_receivable_account. Maps to the accountsReceivableAccountType field in the accounting object.

sting

Accounting > Deferred Revenue Account

Name of the deferred revenue (liability) account used to record revenue before it is recognized. The account must exist in the tenant's chart of accounts.

e.g.,Deferred Revenue

sting

Accounting > Deferred Revenue Accounting Type Accounting method applied to deferred revenue. Maps to the deferredRevenueAccountingType field in the accounting object.

sting

Accounting > Recognized Revenue Account Name of the account whose account type is Recognized Revenue. The account must exist in the tenant's chart of accounts.

e.g.ContractRevRec-1

sting <= 100 characters

Accounting > Recognized Revenue Account Type Account type associated with the recognized_revenue_account. Maps to the recognizedRevenueAccountType field in the accounting object.

sting

Accounting > Adjustment Liability Account

Name of the account whose account type is Adjustment Liability.

e.g.,adjustL-1

sting <= 100 characters

Accounting > Adjustment Liability Account Type Account type associated with the adjustment_liability_account. Maps to the adjustmentLiabilityAccountType field in the accounting object.

sting

Accounting > Adjustment Revenue Account Name of the account whose account type is Adjustment Revenue. The account must exist in the tenant's chart of accounts.

e.g., adjustRev-1

sting <= 100 characters

Accounting > Adjustment Revenue Account Type Account type associated with the adjustment_revenue_account. Maps to the adjustmentRevenueAccountType field in the accounting object.

sting

Accounting > Contract Asset Account Name of the account whose account type is Contract Asset.

e.g., CA-2

sting <= 100 characters

Accounting > Contract Asset Account Type

Account type associated with the contract_asset_account. Maps to the contractAssetAccountType field in the accounting object.

sting

Accounting > Contract Liability Account

Name of the account whose account type is Contract Liability.

e.g.,Contract Recognized Revenue

sting <= 100 characters

Accounting Contract Liability Account Type

Account type associated with the contract_liability_account. Maps to the contractLiabilityAccountType field in the accounting object.

sting

Accounting > Contract Recognized Revenue Account

Name of the recognized revenue account used for contract-based revenue recognition. The account must exist in the tenant's chart of accounts.

e.g.,Contract Recognized Revenue

sting

Accounting > Contract Recognized Revenue Account Type

Account type associated with the contract_recognized_revenue_account. Maps to the contractRecognizedRevenueAccountType field in the accounting object.

sting

Accounting > ​Unbilled Receivables Account

Name of the account whose account type is Unbilled Receivables. The account must exist in the tenant's chart of accounts.

e.g.,unbilledR-1

string <= 100 characters

Accounting >​ Unbilled Receivables Account Type

Account type associated with the unbilled_receivables_account. Maps to the unbilledReceivablesAccountType field in the accounting object.

string

Revenue > ​Property Name*

Revenue recognition configuration, .

object

Custom_Fields > ​Property Name*

Tenant custom fields on the charge.

object

​Attributes > ​Name*

Name of the attribute.

e.g., Age, Region, EffectiveDate

sting

​Attributes ​> Type

Data type of the attribute.

enum: StringIntegerDoubleBooleanDateDatetime

string

​Attributes > ​Mapping > Object

Name of the Zuora object from which to retrieve the attribute value.

e.g., account , subscription

string

Attributes > Mapping > Field

Name of the field on the target object.

e.g., age__c

sting

Pricing > Flat_Amounts*

Map of currency to flat amount.

e.g., {"USD":100}.

object

Pricing > Flat_Amounts > ​Property Name*

Any additional property.

integer

Rate Cards > Attributes > ​Name

Name of the attribute used in the condition.

e.g., Age, Region, EffectiveDate.

string

Rate Cards > Attributes > ​Operator

Comparison operator used to evaluate the condition.

enum:>>=<<===betweenbetween-inclusive

string

Rate Cards > ​Attributes > Value

Comparison value used to evaluate the condition. The value must match the attribute's declared data type. For between and between-inclusive, provide an array of exactly two string or number values representing the range.

e.g., One of:stringnumberbooleanArray of strings or numbersComparison value. For between, provide an array of two values. The value type must align with the attribute's declared type.

string

Rate Cards > ​Pricing > Flat Amounts

Map of currency to flat amount.

e.g., {"USD":100}.

object

​Rate Cards > ​Pricing >​ Flat Amounts > ​Property Name*

Any additional property.

Integer