API Release news from May 18, 2026

Here’s what’s new in API that’s been in production since May 18, 2026!

Breaking changes:

Deprecated reviews endpoints have been removed

• The /products/reviews and /eshop/reviews endpoints have been permanently removed from the API and from the database. If your integration still uses either of these endpoints, requests will now fail. Please migrate to the current reviews endpoints in the API documentation.

Credit note item creation will be restricted to shipping and payment items

• Following previous release news, we concluded that POST credit note item creation endpoint will NOT be removed from API. However, creating credit note items of type product will no longer be supported! Only shipping and payment item types will be accepted. This aligns the endpoint behavior with the admin interface. Please update any integrations that currently create product-type credit note items. The change will be released by June 15, 2026.

Empty billingAddress.company will be rejected in order endpoints

• 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: Must be at least 1 characters long on data.billingAddress.company. Please update your order creation and update flows before this date to avoid unexpected errors. The change will be released by June 15, 2026.

New Features:

Default order status per customer group

• The customer group endpoints (GET, POST, PATCH /api/customer-groups) now support a defaultOrderStatus attribute. You can set or update the default order status that applies to all orders from customers in a given group — consistent with the administration UI. Other previously missing attributes (due date, checkboxes, etc.) have also been added. Customer group endpoints have been reorganized into a new dedicated Customer groups section in the API documentation, separate from the general Customers section.

New SDK Version v0.4.2

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

Improvements:

Unified varSymbol and specSymbol field definitions

• We have unified and fixed the validations below:
  • varSymbol and specSymbol within the API — type tightened from number to integer.
  • priceRatio in quantity discounts — incorrect regex replaced with proper numeric constraints on PATCH/POST data settings.discountValue.priceRatio.
• Definitions have been unified across all endpoints without a breaking change, as the new definition is backwards-compatible with existing valid inputs.

What we plan in the upcoming days:

• Webhooks for customerGroup:create, customerGroup:update, and customerGroup:delete

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