Here’s what’s new in API that’s been in production since May 28, 2026!
Breaking changes:
Credit note item creation will be restricted to shipping and payment items
Reminder: Creating credit note items of type product will no longer be supported. Only shipping and payment item types will be accepted. The change will be released by June 15, 2026. More info in the previous release news.
Empty billingAddress.company will be rejected in order endpoints
Reminder: Sending an empty string ("") for billingAddress.company in POST /api/orders and PATCH /api/orders/{code}/head will return HTTP 422 with a validation error. The change will be released by June 15, 2026. More info in the previous release news.
Mandatory field countryCode in orders
In order to comply with mandatory country requirements on invoices and other order-related documents, we will require countryCode to be provided directly in the order object.
The field countryCode will become mandatory in our POST and PATCH order endpoints. Currently, this field may not be required in all cases.
The change will be released by June 15, 2026. More info in the previous release news.
New Features:
Webhooks for customer groups
Three new webhook events are now available: customerGroup:create, customerGroup:update, and customerGroup:delete. See the documentation.
New SDK Version v0.4.4
The official Shoptet API SDK has been updated to version 0.4.4 – see all changes here.
Improvements:
Field paidon Invoice and Proforma Invoice Endpoints
The paid boolean field is now available on all invoice and proforma invoice API endpoints — detail, list, and snapshot. See the documentation.
WebP Image Upload Support
The API now accepts WebP images for upload. Previously, WebP was supported for serving images via HTTP pages but could not be uploaded through API endpoints.
What we plan in the upcoming days:
BATCH endpoint for updating discount coupons
Extended endpoint settings for Premium private tokens
Within the private API tokens, we will be expanding their settings – until now, tokens were automatically granted access for the entire API. It will now be possible to set which endpoint groups a given private token has access to and whether it has read-only/write permissions.
For newly created tokens, it will be necessary to set permissions, while for already existing tokens, full access will remain set and it will be possible to modify it retroactively. I.e. this new improvement will not disrupt the current behavior of already existing private tokens.
This new functionality will be released by June 4, 2026. Premium users will be informed via newsletter and admin news.
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!
