Skip to main content

Sales set-up · step 3 of 3

Pricing Rule

A pricing rule is a named set of conditions on item, party, territory, quantity or date that changes the price or discount of every sale or purchase line that meets the conditions.

Why it exists: Because the price on each line should come from a stated rule that anyone can read, not from whoever typed the discount last.

Where it sits

  1. Pricing RuleThis document

Sales set-up: Territory → Sales Partner (ERPNext DocType) → Pricing Rule

How a pricing rule moves through its life

Four states. Pick one to see what a pricing rule is, and what it can still become.

Valid-from date is in the future. The rule does not match yet.

Then: Active

Pricing Rule1 of 4
Pricing RuleScheduled

Valid-from date is in the future. The rule does not match yet.

Then: Active

Not disabled, and the transaction date falls between the valid-from and valid-upto dates.

Then: Expired

Pricing Rule2 of 4
Pricing RuleActive

Not disabled, and the transaction date falls between the valid-from and valid-upto dates.

Then: Expired

The valid-upto date has passed. The rule no longer matches.

Then: Disabled

Pricing Rule3 of 4
Pricing RuleExpired

The valid-upto date has passed. The rule no longer matches.

Then: Disabled

The disable box is ticked. The rule never matches, whatever its dates.

Ends here

Pricing Rule4 of 4
Pricing RuleDisabled

The disable box is ticked. The rule never matches, whatever its dates.

Ends here

Rules that must hold, and what breaks them

Rules

  • When more than one rule matches and they do not stack, the highest priority number wins. If the top priority is still shared, ERPNext stops with a conflict error.
  • A price rule sets a rate or a discount. It cannot be saved with neither.
  • A rule's minimum quantity cannot exceed its maximum quantity, and its minimum amount cannot exceed its maximum amount.

Does this happen in your business?

Tick what you recognise. Each tick shows what it costs.

Mistakes people make with pricing rules

Tick any that happen here.

In ERPNext, and in your system

How ERPNext models it

DocTypeWhat it does here
Pricing Rulepriority (1 to 20; a higher number wins) and has_priority (for zero). apply_multiple_pricing_rules lets rules stack.
Pricing Ruleapplicable_for: Customer, Customer Group, Territory, Sales Partner, Campaign, Supplier or Supplier Group.
Pricing Rule Item CodeChild table for Item Code. Item Group and Brand have their own child tables.
Pricing Rulerate_or_discount: Rate, Discount Percentage or Discount Amount. Required for a price rule.

What other systems call it

SystemNameNote
ERPNextPricing RuleDocType Pricing Rule. Docs updated 2026-07-24; source pricing_rule.json and utils.py at v16.50.0.
TallyPrice ListTally's own site (published 2019-11-11, updated 2025-08-28). Price lists per stock item or group, with rates for distributors, dealers and retailers. A price level attaches a tier to a party. The page does not say how overlapping prices combine.
Zoho BooksPrice ListZoho Books help (undated). Attached to a contact and applied to new transactions automatically; a line-item list can be chosen too. The page does not describe how two lists combine.
SAP Business OnePrice ListSAP Learning: price lists, period and volume discounts, discount groups, special prices for Business Partners and blanket agreements. Which one wins is from a third-party summary, not confirmed by SAP.
OdooPricelistRules apply to a product, a category or all products. A product's own rule overrides its category's (Odoo 18.0 docs). The docs do not give the tie-break for equal rules.

From each maker's own documentation, checked 13 October 2026. A dash: not confirmed.

Where a pricing rule connects

Questions about pricing rules

The one most people ask is answered first. Type to find the rest.

What does a pricing rule mean for the business?

Pricing rules hold the discounts a business has agreed to give. A rule is safe only when a person can say which rule wins and why. Overlapping rules cause most mispriced invoices, and the conflict is easy to create: two rules that each look right can both match the same line. Priority, stacking and dates decide the outcome, so they belong in the rule itself, not in someone's memory.

Reviewed 14 October 2026. All 40 documents: the ERP glossary.

Start with one conversation

One message, call or WhatsApp is enough. Every line reaches the team directly.

Team away now