SquareConnect::CatalogPricingRule

July 10, 2019 ยท View on GitHub

Description

Defines how prices are modified or set for items that match the pricing rule during the active time period.

Properties

NameTypeDescriptionNotes
nameStringUser-defined name for the pricing rule. For example, "Buy one get one free" or "10% off".[optional]
time_period_idsArray<String>Unique ID for the CatalogTimePeriods when this pricing rule is in effect. If left unset, the pricing rule is always in effect.[optional]
discount_idStringUnique ID for the CatalogDiscount to take off the price of all matched items. Only one of `total_price_money`, `item_price`, or `discount` can be supplied.[optional]
match_products_idStringUnique ID for the CatalogProductSet that will be matched by this rule. A match rule matches within the entire cart.[optional]
apply_products_idStringThe CatalogProductSet to apply the pricing rule to within the set of matched products specified by `match_products_id`. An apply rule can only match once within the set of matched products. If left unset, the pricing rule will be applied to all products within the set of matched products.[optional]
exclude_products_idStringIdentifies the CatalogProductSet to exclude from this 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.[optional]
valid_from_dateStringRepresents the date the Pricing Rule is valid from. Represented in RFC3339 full-date format (YYYY-MM-DD).[optional]
valid_from_local_timeStringRepresents the local time the pricing rule should be valid from. Time zone is determined by the device running the Point of Sale app. Represented in RFC3339 partial-time format (HH:MM:SS). Partial seconds will be truncated.[optional]
valid_until_dateStringRepresents the date the pricing rule will become inactive. Represented in RFC3339 full-date format (YYYY-MM-DD).[optional]
valid_until_local_timeStringRepresents the local time at which the pricing rule will become inactive. Time zone is determined by the device running the Point of Sale app. Represented in RFC3339 partial-time format (HH:MM:SS). Partial seconds will be truncated.[optional]