Scheduled price changes

Write the price change today. It takes effect on the date you set.

Quantaprice is a pricing engine with an API. You write a price increase, a campaign or a new VAT rate in advance with a start date, and every price query returns the new price from that moment, to the second. The nightly job and the manual change at midnight are no longer needed.

What you get

Three timed changes, prepared in advance

Price increases on a date

Every price takes a start_date. The current price remains in force until that instant, and the new price applies from it, on the pricelist and on every pricelist that inherits the price.

Campaigns with a start and an end

A campaign pricelist has a start date and an end date. Outside that period it prices nothing, so the regular price is returned again when the campaign ends.

VAT on the legal date

A VAT rate has a start date. You add the new rate when the law is passed, and the old rate stays in force until the date the new one takes effect.

Scope

What you can schedule

A scheduled update is an ordinary write with a future date. Without a date, the write takes effect now. You use the same endpoints for both, and nothing is deployed when the date arrives.

  • Prices, with their quantity breaks. Set start_date on the price. A start date is an instant, so you choose the time zone: 2027-01-01T00:00:00+01:00 is midnight in Stockholm. What can be scheduled
  • Pricelists and their rules. A pricelist's rules, parent, VAT mode, metadata, and start and end dates change at a valid_from. A scheduled rule change recalculates the affected prices from its start, and prices before the start remain as they were. Price rules
  • Articles and bundles. An article's name, metadata and bundle components take a valid_from, and a bundle rule takes an effective_from. A bundle priced as the sum of its parts follows scheduled changes to its component prices. Bundles
  • VAT, rounding and exchange rates. VAT rates, an article's VAT class in a tax area, rounding profiles and exchange rates all take a date. VAT Rounding
  • Inherited prices. A scheduled price on a parent pricelist takes effect at the same moment on the pricelists that inherit it. A pricelist with its own price for the SKU is not affected. Inheritance

Your storefront needs no change for a scheduled price. It queries the price when it renders the page and receives the price in force at that second. Commerce platform patterns

Example

A January price increase, written in December

One price, one start date, and one query that shows the result before customers see it.

Write the new price with its start date

The chair, SKU-CHAIR-001, costs 2,390.00 SEK on retail-sek today. From midnight on 1 January, Stockholm time, it costs 2,490.00 SEK.

POST /price
{
  "sku": "SKU-CHAIR-001",
  "pricelist": "retail-sek",
  "start_date": "2027-01-01T00:00:00+01:00",
  "price": { "fields": { "fixed": 2490.00 } }
}

Check the price before it goes live

A price query with an as_of after the start returns the price as it will be at that moment, with the VAT rates, exchange rates and rounding that apply then. Queries with as_of

POST /price/query
{
  "skus": ["SKU-CHAIR-001"],
  "pricelist_filter": { "pricelists": ["retail-sek"] },
  "currency_code": "SEK",
  "tax_area": "SE",
  "as_of": "2027-01-01T08:00:00+01:00"
}
Moment queriedPrice returned, excl. VAT
Before 1 January 00:00, Stockholm time2,390.00
From 1 January 00:00, Stockholm time2,490.00

The figures assume that retail-sek holds prices excluding VAT and has no price rules or rounding profile.

Review or replace what is scheduled

GET /changes/retail-sek/SKU-CHAIR-001 lists the versions of the price, including those scheduled for later, with who wrote each one. To replace everything scheduled after a new price, send it with "remove_future_changes": true. When the new price takes effect, the price it replaced becomes history, and a query with an earlier as_of still returns it for as long as its history is kept. The changes to one price

Campaigns and VAT

Campaigns that end on time, and VAT that changes on the legal date

A weekend campaign as a pricelist with two dates

Create a campaign pricelist that applies from Friday at 00:00 to Monday at 00:00, and write the campaign prices on it. Pricelist dates

POST /pricelist
{
  "code": "weekend-sek",
  "name": "Weekend campaign",
  "currency_code": "SEK",
  "vat_mode": "NET",
  "start_date": "2027-03-05T00:00:00+01:00",
  "end_date": "2027-03-08T00:00:00+01:00"
}

Name both pricelists in the price query. A listed pricelist that has not started or has ended is ignored, so the same query returns the regular price before and after the weekend. While both pricelists apply, the query returns the lowest price excluding VAT and names the pricelist it comes from. Best-price selection

POST /price/query
{
  "skus": ["SKU-CHAIR-001"],
  "pricelist_filter": { "pricelists": ["retail-sek", "weekend-sek"] },
  "currency_code": "SEK",
  "tax_area": "SE"
}

One request returns the lowest price of the 30 days before the reduction, excluding VAT, the figure that the EU price-reduction rule (Omnibus) refers to for announced reductions to consumers. The lowest price over a period

A new VAT rate, added when the law is passed

A new tenant includes the national VAT rates of 31 tax areas. When a country changes a rate, you add the new rate with the date it takes effect. This example uses an invented change: Sweden's 12% rate rising to 13% on 1 January 2028.

POST /vatrate
{
  "tax_area_code": "SE",
  "vat_class_code": "REDUCED",
  "rate": 13.0,
  "start_date": "2028-01-01T00:00:00Z"
}

The old rate stays in force until that date, and the change requires no change to any pricelist or price. If a product moves to another VAT class on a date, the article's VAT class in the tax area takes a start_date in the same way. VAT rates

Enterprise plan

Price approval before a change goes live

Price approval is an Enterprise-plan feature for organisations that require segregation of duties: the person who sets a price is never the person who makes it live. See the plans.

Price releases

With approval on, every price write goes into a named price release. Price queries, the change feed and webhooks see none of it until the release is published, and then all of it at the same moment. Price approval

A second person publishes

The engine enforces the rule: whoever created the release, wrote a price into it or submitted it cannot publish it, and an API key cannot publish. The approver sees a preview with the price in force, the new price and the change in percent. Approving

Approve now, start later

A price in a release keeps its own later start date, so you can approve a release in December for prices that start on 1 January. The release records who approved it and when. When the prices take effect

Approval covers price writes. Changes that reprice without a price write, such as a pricelist's rules or parent, are controlled by permissions and are not held for approval. What approval covers

FAQ

Questions about scheduled price changes

How exactly does a scheduled price change take effect?

To the second. A start date is an instant with a time zone, so 2027-01-01T00:00:00+01:00 is midnight in Stockholm. Until that moment the current price remains in force, and from that moment every price query uses the new one.

Can I check a scheduled price before it goes live?

Yes. Send a price query with an as_of after the start date, and it returns the price as it will be then. The list of changes to a price includes the versions scheduled for later, and you can read a pricelist, article or rounding profile as it will be with asOf.

How do I replace changes that are already scheduled?

Send the new price, article, pricelist or rounding profile with remove_future_changes set to true. It replaces everything scheduled after it.

How does a campaign end?

A campaign pricelist has a start date and an end date, and outside that period it prices nothing. A price query ignores a listed pricelist that has not started or has ended, so the campaign pricelist can stay in your query filter and the regular price is returned again when the campaign ends.

Does a scheduled price reach customer pricelists?

Yes. A scheduled price on a parent pricelist takes effect at the same moment on the pricelists that inherit it. A pricelist with its own price for the SKU is not affected.

Can a price change require approval before it goes live?

Yes, on the Enterprise plan. With price approval on, price changes go into a price release and take effect only when a person who made none of the changes publishes it. A price in the release with a later start date keeps that date, so a release can be approved in December for prices that start on 1 January.

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. Price approval is an Enterprise-plan feature.

Get started

Schedule your next price change with your own catalogue.

The Evaluation plan is free for 90 days: load your pricelists, write a price with a future start date, and query it with as_of before it goes live.