Query quantityRules on a product variant within the context of a catalog: use the catalogPriceList query or priceList query to retrieve price rules associated with a B2B catalog, then inspect quantityRules { minimumQuantity maximumQuantity increment } for each variant
To set quantity rules use the priceListFixedPricesAdd or priceListUpdate mutation depending on whether you are setting a fixed price or adjusting rules on an existing price list; check current API docs for the exact mutation that exposes quantityRule fields
Quantity price breaks (tiered pricing) are set as multiple FixedPrice entries on the price list for the same variant with different minimumQuantity thresholds; create a separate fixed price entry for each tier
Test by querying the priceList for the relevant company location's catalog after mutation and confirming the correct tier prices appear at the expected quantity thresholds
In the Storefront API, buyers querying product prices with company context (buyer identity) will see the tier price matching their cart quantity; verify by adding different quantities to a B2B cart and checking unitPrice
Audit quantity rules for all variants after bulk import to ensure none violate business rules (e.g., minimum quantity exceeds maximum quantity)
Known gotchas
Quantity rules (minimum, maximum, increment) and quantity price breaks are separate concepts — quantity rules control what the buyer can order, while price breaks control what they pay; both are configured on the price list but via different fields
B2B catalog pricing only applies when the Storefront API request includes a valid company context token; without it the standard retail price is returned, which can mislead testing if the buyer context is not set correctly
Price list mutations can affect many variants at once; use bulk price list operations for catalogs with thousands of variants rather than individual mutations per variant to avoid API rate limits
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp