API Release news from August 21, 2025

22. 8. 2025

Here’s what’s news in API Release that’s been added to production!

Breaking Changes:

With effect from 1.9.2025 we are starting to implement 5 times “over-limit” hard validation of the rate-limiter on all integrations
This will be followed by implementations that exceed the limits by more than 3.5x, 2x and finally we will roll out to all integrations.
Please note: there will be a gap of about a month between each phase, with an expected completion date at the end of the year.

Please note that Bulgaria will be transitioning to EUR currency since 1.1.2026
The convergence exchange rate is fixed at 1 EUR = 1.95583 BGN
There are number of steps and deadlines, for more information visit the official websites, for brief summary, you can use https://en.wikipedia.org/wiki/Bulgaria_and_the_euro
From 1.1.2026 all Bulgarian shops will be switched to EUR. In the meantime, documents in API can still be created with BGN currency.
Prices in PDF documents will be displayed both in EUR and BGN prices.
As for the front end modifications (display of both EUR and BGN prices), more information from the FE team can be found here.

In the long term, we will revise price structure so that each price has its own independent currency and VAT rate.
We will start with the purchasePrice and gradually roll out these changes to other prices.
It will be a long-term process involving numerous steps, this serves only as a heads-up notification that such revision will take place in the near future.

New webhook is emitted when the status of an order changes from unpaid to paid.
For more information, please consult the documentation below.
https://api.docs.shoptet.com/shoptet-api/openapi/section/code-lists/webhook-event-types

Product list can now be filtered by availabilityId and availabilityInStockId
The main purpose of this functionality is when availability cannot be deleted because it is used on some products.
https://api.docs.shoptet.com/shoptet-api/openapi/products/getlistofproducts