Multi-currency B2B pricing

Multi-currency pricing, price breaks and customer prices. In one engine.

Quantaprice is a pricing engine for B2B commerce. It holds your pricelists, customer prices and quantity breaks, and returns the price a customer pays in the currency you ask for, with VAT and rounding for the market.

What you get

Three things B2B pricing needs, built in

Multi-currency

EUR and about 30 currencies with daily ECB exchange rates. Keep pricelists in local currencies, or convert one pricelist into other currencies at query time.

Quantity breaks

Volume prices on every price: a fixed unit price or a percentage of the sales price from a minimum quantity, returned in the requested currency with VAT.

Customer-specific prices

Pricelists per customer or segment that inherit from your base pricelist and change only what differs, with rules for negotiated discounts.

Currencies

Sell in every currency without maintaining every price

Every pricelist has one currency. A price query names the currency it answers in, and prices from pricelists in other currencies are converted with your exchange rates. You decide which prices are set locally and which follow the base price.

  • Daily ECB rates. Rates for every currency the European Central Bank publishes are fetched every 24 hours. You can set rates manually, and add currencies the ECB does not publish. Exchange rates
  • Markup and stable prices. A pricelist can inherit from a parent in another currency. Its prices are converted at the ECB rate with your markup, and the rate is renewed when the ECB rate moves past a threshold you set, not every day, so local prices stay stable. Inheriting from another currency
  • VAT per market. Each query names a tax area, and every result holds the price excluding and including VAT, and the VAT amount. VAT is rounded to each currency's precision, for example to whole yen. VAT Currencies
  • Rounding per currency. A rounding profile per currency gives each market its own price points, such as prices ending in .99 or whole units. Rounding
  • Reproducible. A query with as_of returns the price, converted at the rate in force at that moment, so a quoted price can be reproduced for as long as its history is kept. Historical queries

A price query calculates in this order: price rules, currency conversion, VAT, rounding. A price inherited from a parent in another currency is converted first, and the pricelist's rules then apply to the converted price.

Example

Price breaks that follow each customer's price

One base price with two quantity breaks, one customer with a negotiated 10% discount, and one query.

Write the base price with its breaks

The pump, PUMP-200, exists as an article and costs 100.00 EUR on standard-eur. From 10 units the unit price is 95% of the sales price, and from 50 units 85%. A break can also be a fixed unit price.

POST /price
{
  "sku": "PUMP-200",
  "pricelist": "standard-eur",
  "price": { "fields": { "fixed": 100.00 } },
  "quantity_breaks": [
    { "quantity_break": 10, "percent_of_base": 0.95 },
    { "quantity_break": 50, "percent_of_base": 0.85 }
  ]
}

Give the customer their own pricelist

customer-acme has standard-eur as its parent and a price rule, sales * 0.9. It inherits the price of every article that matches its rules, with its quantity breaks, so nothing is copied per SKU. A price written on the customer pricelist overrides the inherited one. Inheritance

Query the customer's price

POST /price/query
{
  "skus": ["PUMP-200"],
  "pricelist_filter": { "pricelists": ["customer-acme"] },
  "currency_code": "EUR",
  "tax_area": "DE"
}
Response (excerpt)
{
  "sku": "PUMP-200",
  "sales_price_ex_vat": 90.00,
  "sales_price_inc_vat": 107.10,
  "vat_amount": 17.10,
  "vat_rate": 19.0,
  "price": {
    "pricelist": "customer-acme",
    "currency_code": "EUR",
    "quantity_breaks": [
      { "quantity_break": 10, "sales_price_ex_vat": 85.50, "sales_price_inc_vat": 101.75, "vat_amount": 16.25 },
      { "quantity_break": 50, "sales_price_ex_vat": 76.50, "sales_price_inc_vat": 91.04, "vat_amount": 14.54 }
    ],
    "meta": { "inherited": true }
  }
}

The figures assume no rounding profile for EUR.

QuantityBase priceAcme, excl. VATAcme, incl. 19% VAT
1–9100.0090.00107.10
10–4995.0085.50101.75
50+85.0076.5091.04

The query does not take a quantity: it returns every break, and your cart applies the one with the highest quantity that does not exceed the order quantity. Ask for "currency_code": "SEK" instead, and the same prices and breaks come back converted to SEK, with VAT and rounding applied in SEK. Quantity breaks

Customer prices

The right price for every customer, from one query

Inheritance

Pricelists form a tree: base, segment, customer. Rules on each level compound, and a change to the base price reaches every level below it. Inheritance

Selection by metadata

Tag pricelists with a customer ID, segment or region, and select them in the query without hard-coding pricelist codes in your shop. Pricelist filters

Best price

When a customer qualifies for several pricelists, each candidate is converted to the requested currency and the lowest price is returned, with its source. Best-price selection

FAQ

Questions about currencies and price breaks

Which currencies does Quantaprice support?

EUR and every currency in the European Central Bank's daily reference rates, about 30, including USD, GBP, CHF, SEK, NOK, DKK, PLN, JPY and CNY. You can add other currencies and set their exchange rates yourself.

Where do the exchange rates come from?

From the ECB's daily feed, fetched automatically every 24 hours. You can set rates manually, or turn automatic updates off and manage every rate yourself. Prices that a pricelist inherits from a parent in another currency are converted at the ECB rate with a markup you choose, per currency if you like. No markup applies to a conversion into your base currency.

Can a customer see prices in their own currency without a separate pricelist?

Yes. A price query names the currency it answers in. Prices on pricelists in other currencies are converted with your tenant's exchange rates, then VAT and rounding are applied in that currency.

How do quantity breaks work?

Each price can carry quantity breaks: from a minimum quantity, either a fixed unit price or a percentage of the sales price. A price query returns every break, converted, rounded and with VAT in the same way as the sales price, and you apply the break that matches the order quantity.

Do quantity breaks follow a customer's negotiated discount?

A percentage break does: it is calculated from the sales price on the pricelist the price comes from, so on a customer pricelist with a 10% discount, a 95% break gives 95% of the customer's price. Quantity breaks are inherited with the price from the parent pricelist.

What happens when a customer qualifies for several pricelists?

A price query can select several pricelists, by code and by metadata such as a customer ID or segment. Every candidate price is converted to the requested currency, and the lowest price excluding VAT is returned, with the pricelist it came from.

Can I try it with my own catalogue?

Yes. The Evaluation plan is free for 90 days with 100,000 articles and 1M prices, and includes every API.

Get started

Try it with your own catalogue.

The Evaluation plan is free for 90 days: load your pricelists in your currencies, add quantity breaks and customer prices, and query them through the API.