Pricing & Price Lists
Pricing & Price Lists
ZingaShop prices products through price lists. A price list is a named set of prices in one currency, and the storefront picks the right list for each shopper based on currency, storefront, and (optionally) customer group. This model lets you sell the same catalog in multiple currencies and to multiple customer segments without duplicating products.
How pricing resolves
For a given shopper and cart, ZingaShop selects an eligible price list by:
- Currency — the list's currency must match the shopper's currency.
- Assignment — the list must apply to the storefront, the customer's group, or the customer specifically.
- Validity — the list must be active and within its date range (if set).
- Priority — among eligible lists, the highest-priority one wins.
Then, for each item, ZingaShop uses the explicit per-variant price from that list; if none exists, it falls back to a bulk pricing rule or to the default list's price.
Price lists
Each price list has a code and name, a currency, a priority, and an optional active date range. You can create as many as you need, for example a RETAIL_USD and a RETAIL_CAD list both assigned to a North American storefront, so a USD cart uses the first and a CAD cart the second.
Price lists can be pinned to specific storefronts. When a storefront has pinned lists, only those are considered for its shoppers; otherwise all eligible lists on the account are considered.
Per-variant prices
Within a price list you set prices per variant (SKU). Each price entry carries:
| Field | Purpose |
|---|---|
| Unit price | The selling price for the variant in the list's currency |
| Compare-at price | The reference/"was" price shown struck through to signal a discount |
| Cost | Your cost, for margin reporting (not shown to shoppers) |
| Quantity range | The minimum (and optional maximum) quantity this price applies to |
| Date range | Optional start/end for time-limited pricing |
Offer vs. standard price
The compare-at price is how you show a markdown. Set the unit price to your current selling price and the compare-at price to the higher original; the storefront displays the original struck through next to the offer price and can calculate the saving. Leave compare-at empty when there is no offer.
Quantity-break tiers
To offer volume pricing, add multiple price entries for the same variant with different quantity ranges, for example 1–9 at one price and 10+ at a lower price. The storefront and cart apply the entry whose range matches the quantity being purchased, giving you tiered or wholesale pricing per SKU.
Currency and FX-derived lists
Because each list is tied to a currency, adding a currency to a storefront is a matter of creating (or assigning) a matching price list. A list can also be derived from another: instead of entering every price by hand, base it on another list and apply an FX rate and a markup factor, with rounding rules for tidy display prices. Explicit per-variant entries on a derived list still override the calculated price, so you can hand-tune specific SKUs.
Bulk pricing rules
Within a list you can define bulk rules that adjust prices across a scope rather than SKU by SKU:
- Scope — all products, or by category, brand, product, or variant.
- Adjustment — a percentage off, a fixed amount off, or a fixed absolute price.
Rules are a convenient way to, say, take 10% off an entire brand in one list while keeping per-SKU overrides where you need them.
Per-customer and per-group pricing
Price lists can be assigned to a customer group or an individual customer as well as to a storefront. More specific assignments win: a customer-specific list outranks a group list, which outranks a storefront list. This supports B2B and wholesale pricing, VIP tiers, and negotiated account prices.
Storefront overrides
For one-off cases, a product assigned to a storefront can carry a per-storefront price override, letting the same product cost differently on a boutique site versus a discount site without forking the catalog or creating a separate list.
Managing pricing
Price lists are managed in the Zingasuite portal at https://console.zingasuite.com and through the public API, which is useful for syncing prices from an ERP or running scheduled repricing. See the Developer API Reference chapter. Promotional discounts (coupons, cart-level offers) are separate from base pricing and are covered in Promotions, Loyalty & Marketing.