API Release News from September 17, 2026

17. 9. 2026

Klára Hrabcová

Other

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

Breaking Changes:

Reminder: webhook registration requires endpoint permissions

As announced in the September 4, 2026 release news, webhooks can only be registered for endpoint groups that your addon or private API token has access to (for example, order:create requires the Orders endpoint group). Webhooks without matching permissions are unregistered automatically.
Effective date: September 18, 2026.
Action required: check which webhooks your addon has registered and either request extended addon permissions (ACL) or unregister the affected webhooks.

Reminder: product variant webhooks include the parent product GUID

The eventInstance of product variant webhooks changes from the plain variant code to <productGuid>|<variantCode>. Mass events carry a JSON-serialized list of such values, e.g. ["<guid>|<code>", "<guid>|<code>"].
Effective date: September 18, 2026.
Action required: if your integration parses the variant eventInstance as a plain code, split the value on | and read the variant code from the second part.

New Features:

Discount coupons restricted to specific products

Discount coupons can now be limited to specific products. Discount coupon templates now support a productSelectionMode field. The value parameters keeps the existing behaviour (categories, brands and product flags), while specificProducts applies the coupon only to the products listed in productGuids (up to 1000 products). See the documentation.

Fully configured POST shipping method

POST /api/shipping-methods now accepts the complete shipping method configuration, so no follow-up setup in the administration is needed. Existing minimal payloads keep working unchanged.
The response returns the complete created shipping method, including trackingUrl, priority and priceList, in the same shape as GET /api/shipping-methods/{guid}?include=priceList.
See the documentation.

New SDK Version v0.4.17

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

Improvements:

Contact e-mail for private API tokens

Private API tokens can now have an optional contact e-mail, set on the token settings page or in the create-token dialog in the administration. When set, notifications related to the token (rate limiter warnings and the problematic-webhooks fail-ratio report) are also delivered to this address. The e-shop owner keeps receiving them as before.
This is especially useful for external developers and partners who manage their integrations on a given private token, as they are now notified directly without relying on the e-shop owner to forward the alerts.

PDF document format update

We’re updating the PDF format used for generated documents. The new format is fully self-contained and archive-friendly, with no dependency on external data at render time, and it supports embedding machine-readable data such as ISDOC directly within the file. As a result of these improvements, expect generated PDF file sizes to increase by approximately 25%.

Additional filters on list endpoints

List endpoints now support the filters that were previously available only on the corresponding snapshot endpoints.
GET /api/invoices: changeTimeFrom, changeTimeTo, taxDateTo, customerGuid
GET /api/proforma-invoices: changeTimeFrom, changeTimeTo, paid, currencyCode
GET /api/delivery-notes: creationTimeFrom, creationTimeTo, changeTimeFrom, changeTimeTo, customerGuid
GET /api/customers: creationTimeFrom, creationTimeTo, changeTimeFrom, changeTimeTo
GET /api/discount-coupons: discountType, currency, shippingPrice

Consistent `languages` in the eshop endpoint

GET /api/eshop now returns an empty languages array when the Foreign languages module is not active or has not been initialized. Previously the field kept returning language entries left over from an earlier configuration, even though activeModules did not list the module.
Integrations that derive per-language behaviour from languages (for example, creating one record per language) should treat an empty array as a single-language e-shop.

What we plan in the upcoming days:

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

Async batch endpoint for mass product image insertion
Async batch endpoint for mass customer insertion
PATCH shipping method detail endpoint
DELETE shipping method detail endpoint

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!