API Release news from October 23, 2025

Here’s what’s new in API release that’s been in production since October 23, 2025!

Important notice:

Bulgarian transition to EURO

• 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.

Breaking Changes:

Upcoming pricelist prices structure updates

• 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.

Upcoming credit notes & orders upcoming validation changes

• In order to align our product with accounting standards, we will roll out some changes to validations for orders and credit notes
• The system will now notify the User when he opens a document that was fully or partially credited and the changes can cause tax issues.
• The system will also notify the User when he opens an Order that was fully or partially credited and the changes can cause tax issues.
• In the future, these changes will not be allowed at all and will raise an error in the API.

---

New features:

Endpoint for orders with product claims

• It is now possible to list all ordered products with unfulfilled claims, see more here.

Improvements:

Updated documentation examples across all endpoints

• New json lines schemas for snapshot and BATCH endpoints, see more here for BATCH endpoints and snapshots.

Order item type “bazar” in PATCH/POST endpoints

• Order item with type “bazar” can now be added or changed in PATCH/POST endpoints, see more here.

PATCH/POST article sections with image upload

• It is possible to upload and update the article section image file via API, see more here for POST endpoint and PATCH endpoint.

Bugs fixed:

Info about wholesale split in endpoints

• Missing info in API about wholesale split – this info can now be found in GET eshop-info, GET payment-methods and GET shipping-methods endpoints under wholesale_split_active .

---

What we plan in the upcoming days:

New endpoints in progress, e.g.:

• BATCH endpoint for updating product priority (order) across multiple categories
• POST/PATCH endpoints for e-shop & product reviews
• PATCH endpoint for order completion

Please note: The plan above is subject to change due to unexpected events or changes in priorities – we do not commit to deliver these outputs and outcomes. Thank you for your understanding.

If you have any API-related questions, feedback or requests, please do not hesitate to contact us on api@shoptet.cz. We would love to hear from you!

Post navigation