Welcome to Zuora Product Documentation

Explore our rich library of product information

Product rate plan charge with dynamic pricing update 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

Id* Unique identifier of the product rate plan charge (PRPC) to be updated.

e.g., 9c4867ed55db43a89731605d5654d4ed

string

Name

A new display name for the charge.

string

Description Description for the charge.

sting

Trigger Event

The event that triggers the charge, if updates are supported.

Enum contract_effective, service_activation, customer_acceptance.

string

Unit of Measure* Unit of measure (UOM) used to quantify or price the charge.

e.g., Each, Seats, License.

string

Default Quantity The default quantity applied when the charge is added to a product or offer.

integer

Min Quantity

The minimum allowed quantity, if supported.

integer

Max Quantity

The maximum allowed quantity, if supported.

integer

List Price BaseThe list price basis. This field is typically read-only after creation.

e.g., Per_Billing_Period.

string

Bill Cycle > Type* The source of the default billing period.

e.g., default_from_customer or specific_day_of_month.

string

Bill Cycle > Day of Month The day of the month to bill when the billing period source is specific_day_of_month.

integer

Bill Cycle > Day of Week

The day of the week to bill when using a weekly billing mode.

string

Bill Cycle > Period

The billing period.

e.g., bill_cycle_period_month, bill_cycle_period_quarter.

string

Bill Cycle > Specific Period

The custom billing period text, if applicable.

string

Bill Cycle > Period Alignment

The alignment behavior.

e.g., align_to_charge or align_to_term_start.

string

Bill Cycle > TimingIndicates whether billing occurs in advance or in arrears.

enum: in_advance , in_arrears.

string

Pricing > Flat Amounts

A mapping of currencies to their corresponding flat amounts.

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

object

Pricing > Flat Amounts > Property Name *

additional property

integer

Rate Cards > Attributes* Specify the conditions that must all evaluate to true for the row to apply. Use between for numeric ranges or date ranges.

array of objects

Rate Cards > Attributes > Name*

A name for the Attribute name.

e.g., Age, Region, EffectiveDate.

string

Rate Cards > Attributes > Operator

Comparison operator used to evaluate the condition.

enum: >, >=, <, <=, ==, between, between-inclusive.

string

Rate Cards > Attributes > Value

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

string, integer, boolean, arry of strings.

Rate Cards > Pricing > Flat Amounts *

Maps each currency code to its corresponding flat amount.

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

object

Rate Cards > Pricing > Flat Amounts > Property Name*

Any additional property

integer

Tax Code

Tax code to associate with the charge.

string

Tax Mode

Tax mode to apply to the price, if supported.

e.g., tax_exclusive or non_taxable).

string

Price Change Option

Specifies how price changes are applied when the charge is updated.

e.g., no_change.

string

Use Tenant Default For Price Change

If true, tenant defaults govern price change behavior.

boolean

Delivery Schedule > Property Name

Configuration for delivery by day of the week, if delivery scheduling is enabled.

object

Prepayment > Property Name

Prepayment configuration, including credit options, rollover, and validity settings.

object

Prepaid

Indicates whether the charge is prepaid.

boolen

Overage Options > Property Name

Overage configuration for usage charges.

object

Accounting > Accounting Code

Accounting code associated with the charge for reporting and ERP mapping. Typically a short code or identifier, rather than 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

string

Accounting > Accounts Receivable Account Type

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

string

Accounting > Deferred Revenue Accounting

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

string <= 100 characters

Accounting > Deferred Revenue Accounting Type

Accounting method applied to deferred revenue. Maps to the deferredRevenueAccountingType field in the accounting object.

string

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

string <= 100 characters

Accounting > Recognized Revenue Account Type

Account type associated with the recognized_revenue_account. Maps to the recognizedRevenueAccountType field in the accounting object.

string

Accounting > Adjustment Liability Account

Name of the account whose account type is Adjustment Liability. The account must exist in the tenant's chart of accounts.e.g.

adjustL-1

string <= 100 characters

Accounting > Adjustment Liability Account Type

Account type associated with the adjustment_liability_account. Maps to the adjustmentLiabilityAccountType field in the accounting object.

string

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

string <= 100 characters

Accounting > Adjustment Revenue Account Type

Account type associated with the adjustment_revenue_account. Maps to the adjustmentRevenueAccountType field in the accounting object.

string

​Accounting > Contract Asset Account

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

e.g., CA-2

string

Accounting ​> Contract Asset Account Type

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

string

Accounting > Contract Liability Account

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

e.g., CL-2

string <= 100 characters

​Accounting > Contract Liability Account Type

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

string

Accounting > Contract Recognized Revenue Account

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

string

Accounting > Contract Recognized Revenue Account Type

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

string

Accounting > Unbilled Receivables Account

Name of the account whose account type is Unbilled Receivables.

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 settings.

object

​Netsuite > Property Name*

NetSuite integration attributes for the charge.

object

Custom Fields > ​Property Name*

Tenant-specific custom field values on the charge.

object

Labels > Property Name*

Free-form labels/tags attached to the charge.

object

organization labels

Organization-level labels associated with the charge.

array of objects

ocm json by currency. > Property Name*

Any additional property.

object

Attributes > ​Name*

Name of the attribute.

e.g., Region, Age, EffectiveDate.

string

Attributes ​> Type

Data type of the attribute.

Enum: string, integer, double, boolean, date, datetime.

string

​Attributes > ​Mapping > Object

Target object

e.g., account, subscription.

string

Attributes > Mapping > Field

Field on the target object.

e.g., age__c.

string