API Release News from September 4, 2026

Here’s what’s new in API that’s been in production since September 4, 2026!

Breaking Changes:

Reminder: changes announced on August 20, 2026

Reminder from the previous release news – please make sure your integration is ready:

• PATCH /api/pricelists/{id}: a 0 value will represent an actual zero price and will no longer clear the price. Use null to remove a price. Rolled out gradually per e-shop starting September 14, 2026.

Webhook registration will require endpoint permissions

• As part of the planned webhooks expansion development, we are tightening the security of webhook registration. Webhooks can only be registered for endpoint groups your addon or private API token has permission to access. For example, the order:create webhook requires access to the Orders endpoint group.
• What you need to do by September 18, 2026:
  1. Check which webhooks your addon has registered and which endpoint groups they belong to.
  2. Either request an extension of your addon permissions (ACL) for these endpoint groups, or unregister the affected webhooks.
• After this date, all webhooks without a matching permission will be unregistered automatically.
• If all your registered webhooks already have the corresponding endpoint permissions, this change does not affect you and no adjustments to your integration are needed.
• Affected partners with at least one webhook registered without the corresponding permission have been contacted directly via e-mail with a list of the webhooks concerned. Please, check your integration permissions and your email.

Product variant webhooks will include the parent product GUID

• The eventInstance of product variant webhooks currently contains only the variant code. Since a variant code alone does not identify the parent product, the value will be extended with the product GUID in the format <productGuid>|<variantCode>. For mass events, eventInstance will be a JSON-serialized list of these values, e.g. ["<guid>|<code>", "<guid>|<code>"].
• Effective date: September 18, 2026.
• Action required: If your integration parses eventInstance of these webhooks as a plain variant code, update it to split the value on the | character and read the variant code from the second part.

---

New Features:

Shipping method detail with pricelists

• New endpoint GET /api/shipping-methods/{guid} returns the detail of a single shipping method. With the include=priceList query parameter, the response also contains the pricelist configuration as set up in the admin. See the documentation.

Abandoned carts snapshot

• New asynchronous endpoint GET /api/abandoned-carts/snapshot exports the list of abandoned carts of registered customers, matching the Abandoned carts overview in the admin. See the documentation.

New SDK Version v0.4.16

• The official Shoptet API SDK has been updated to version 0.4.16 – see all changes here.

---

Improvements:

xmlFeedName is writable in product endpoints

• The xmlFeedName field, previously returned only in responses, can now be set in the request body of POST /api/products, PATCH /api/products/{guid}, PATCH /api/products/code/{code} and the async batch endpoint PATCH /api/products/batch. See the documentation.

Heureka exclusion flags in product endpoints

• Product POST and PATCH endpoints now accept and return two Heureka flags on variants, mirroring the existing zbozicz field: heurekaFeedExcluded and heurekaCartExcluded. The values are shared with the admin and XML feed import. See the documentation.

Filters for the List of project reviews

• The List of project reviews endpoint now supports the dateFrom, dateTo, visible and orderCode query parameters.

---

What we plan in the upcoming days:

New features and improvements in progress, e.g.:

• Optional contact e-mail per Premium private token, so integration notifications reach the team or partner operating the integration in addition to the project owner
• Async batch endpoint for mass product image insertion
• Extended POST /api/shipping-methods with pricelists
• Async batch endpoint for mass customer insertion

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