<- Object

Object

All versions ->

CatalogPricingRule

Defines how discounts are automatically applied to a set of items that match the pricing rule during the active time period.

Link to section

Properties

Link to section

name

string

User-defined name for the pricing rule. For example, "Buy one get one free" or "10% off".

Link to section

time_period_ids

string [ ]

A list of unique IDs for the catalog time periods when this pricing rule is in effect. If left unset, the pricing rule is always in effect.

Link to section

discount_id

string

Unique ID for the CatalogDiscount to take off the price of all matched items.

Link to section

match_products_id

string

Unique ID for the CatalogProductSet that will be matched by this rule. A match rule matches within the entire cart, and can match multiple times. This field will always be set.

Link to section

apply_products_id

string

Deprecated

Deprecated: Please use the exclude_products_id field to apply an exclude set instead. Exclude sets allow better control over quantity ranges and offer more flexibility for which matched items receive a discount.

CatalogProductSet to apply the pricing to. An apply rule matches within the subset of the cart that fits the match rules (the match set). An apply rule can only match once in the match set. If not supplied, the pricing will be applied to all products in the match set. Other products retain their base price, or a price generated by other rules.

Link to section

exclude_products_id

string

CatalogProductSet to exclude from the pricing rule. An exclude rule matches within the subset of the cart that fits the match rules (the match set). An exclude rule can only match once in the match set. If not supplied, the pricing will be applied to all products in the match set. Other products retain their base price, or a price generated by other rules.

Link to section

valid_from_date

string

Represents the date the Pricing Rule is valid from. Represented in RFC 3339 full-date format (YYYY-MM-DD).

Link to section

valid_from_local_time

string

Represents the local time the pricing rule should be valid from. Represented in RFC 3339 partial-time format (HH:MM:SS). Partial seconds will be truncated.

Link to section

valid_until_date

string

Represents the date the Pricing Rule is valid until. Represented in RFC 3339 full-date format (YYYY-MM-DD).

Link to section

valid_until_local_time

string

Represents the local time the pricing rule should be valid until. Represented in RFC 3339 partial-time format (HH:MM:SS). Partial seconds will be truncated.

Link to section

exclude_strategy

string

If an exclude_products_id was given, controls which subset of matched products is excluded from any discounts.

Default value: LEAST_EXPENSIVE

Link to section

minimum_order_subtotal_money

The minimum order subtotal (before discounts or taxes are applied) that must be met before this rule may be applied.

Link to section

customer_group_ids_any

string [ ]

A list of IDs of customer groups, the members of which are eligible for discounts specified in this pricing rule. Notice that a group ID is generated by the Customers API. If this field is not set, the specified discount applies to matched products sold to anyone whether the buyer has a customer profile created or not. If this customer_group_ids_any field is set, the specified discount applies only to matched products sold to customers belonging to the specified customer groups.