Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Pricing and Price Lists

Every product has a base price — the default selling price. Price lists let you override this base price for different markets, customer segments, currencies, or time periods, giving you flexible multi-tier pricing without changing the product itself.

How Pricing Works

Price Resolution

When Beelocity needs to determine a product’s price (for a specific variant, in a specific context), it checks in this order:

  1. Variant-specific price in the active price list — if the price list has a price set specifically for this variant, use it.
  2. Product-level price in the active price list + the variant’s price adjustment — if the price list has a price for the parent product, add the variant’s adjustment (e.g., +200 DA for XL size).
  3. Product base price + the variant’s price adjustment — if no price list applies, fall back to the product’s base price plus any variant adjustment.

First match wins. This means variant-level prices in a price list always take priority, giving you precise control when you need it.

Example

A “Basic T-Shirt” has a base price of 2,500 DA. The XL variant has a +200 DA price adjustment.

Price listProduct priceXL variant priceResolved XL price
No price list2,500 + 200 = 2,700 DA (base + adjustment)
“Retail DZD” with product price 2,800 DA2,800 DA2,800 + 200 = 3,000 DA
“Retail DZD” with XL variant price 3,200 DA2,800 DA3,200 DA3,200 DA (variant price wins)

Price Lists

A price list is a named collection of prices in a given currency. You create price lists to represent different pricing strategies:

Price listPurpose
Retail DZDStandard consumer prices in Algerian Dinar
WholesaleDiscounted bulk pricing for resellers — typically 15-30% below retail
Promotional — Ramadan 2025Temporary discounted prices with start and end dates
Export EURPricing in Euros for international clients
VIP ClientsSpecial pricing for high-value long-term partners

Creating a Price List

  1. Go to Price Lists from the Products section.
  2. Click Create Price List.
  3. Fill in:
    • Name — a descriptive label (e.g., “Retail DZD”, “Wholesale Q1 2025”).
    • Currency — the currency for all prices in this list (e.g., DZD, EUR, USD). See Currencies.
    • Validity period (optional) — set a start and end date if this price list is temporary (e.g., a seasonal promotion).
    • Default flag — mark one price list as the default. The default list is used when no other list is specified.
  4. Save.

Adding Prices to a Price List

After creating a price list, add prices for your products:

  • Product-level prices — set a price that applies to the product and all its variants (plus each variant’s individual price adjustment).
  • Variant-level prices — set a specific price for a particular variant, overriding the product-level price. Use this when certain variants have prices that cannot be expressed as a simple adjustment from the product price.

You do not need to add every product to every price list. Products not in a price list simply use their base price.

Time-Based Pricing

Both price lists and individual prices support validity dates. This lets you set up pricing changes in advance:

  • Create a “Ramadan Promotion” price list with a start date of the first day of Ramadan and an end date for the last day. Beelocity will automatically apply the promotional prices during that period and revert to normal pricing afterward.
  • Schedule a price increase for next quarter by creating new prices with a future effective date.

No manual intervention is needed — the system applies the right price based on the current date.

Tips

  • Start with one default price list — for most organizations, a single “Retail” price list in your primary currency covers the majority of transactions. Add more lists only when you have a concrete need (wholesale pricing, a different currency, a promotion).
  • Use product-level prices + variant adjustments — this is more maintainable than setting individual prices on every variant. If a T-shirt costs 2,500 DA and XL is +200 DA, set the product price and the adjustment. You only need variant-level prices for exceptions.
  • Name price lists descriptively — include the purpose and currency in the name. “Wholesale EUR” is immediately clear. “Price List 2” is not.
  • Plan promotions in advance — create promotional price lists with future validity dates so they activate automatically. This avoids last-minute scrambles and ensures prices are correct from the first moment of the promotion.
  • Review prices periodically — price lists can accumulate over time. Deactivate old promotional lists and review ongoing lists to ensure prices are still accurate.