API Release news from April 30, 2026

Here’s what’s new in API that’s been in production since April 30, 2026!

Breaking changes:

New location of product reviews endpoints

• The old /product/reviews location will be deleted by May 4th, 2026. All reviews endpoints (GET, POST, PATCH) are now available under /reviews.

Upcoming credit notes & orders upcoming validation changes

• Reminder: All changes to validations for orders and credit notes in API will be released by May 4th, 2026. More info in the previous release news.

Mandatory field countryCode in orders

• Reminder: the field countryCode will become mandatory in the POST and PATCH order endpoints. Please make sure your integration includes this field to avoid validation errors. More info in the previous release news.

New Features:

Create Parametric Category Definition Endpoint

• A new POST /api/parametric-categories-definition endpoint is now available for creating a parametric category definition — the parent entity that specifies which parameters apply to a given category. This definition must exist before creating a parametric category combination via POST /api/parametric-categories. Attempting to create a combination without a matching definition returns 422. See the documentation.

Parametric Categories: Available Parameters Endpoint

• A new endpoint GET /api/parametric-categories-available-parameters is now available. It returns the list of available parameters and filters for a given category, allowing you to determine valid options before creating a parametric category combination. See the documentation.

Batch Pricelist Update

• A new bulk async job for pricelist price updates PATCH /api/pricelists/{id}/batch is now available. See the documentation.

Mass Delete Products and Variants via Async Job

• A new async job for bulk product and variant deletion DELETE /api/products/batch is now available. The job fires the standard massDelete webhook event on completion. See the documentation.

Availability Webhooks

• Three new webhook events are now available: availability:create, availability:update, and availability:delete. See the documentation.

New SDK Version v0.4.1

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

Improvements:

ZIP Code Validation Extended to 15 EU Countries

• ZIP code format validation now covers 15 additional EU countries with numeric postal codes. Previously, only Czech Republic, Slovakia, and Hungary had ZIP validation enforced.
  • 4-digit ZIP: Austria (AT), Belgium (BE), Bulgaria (BG), Cyprus (CY), Denmark (DK), Luxembourg (LU), Slovenia (SI)
  • 5-digit ZIP: Germany (DE), Estonia (EE), Spain (ES), Finland (FI), Croatia (HR), Italy (IT), Lithuania (LT)
  • 6-digit ZIP: Romania (RO)
• Countries with non-numeric ZIP formats (France, Poland, Netherlands, etc.) are not yet validated — a follow-up is planned.

What we plan in the upcoming days:

Unification and fixes in validations of varSymbol, specSymbol, and priceRatio

• During next week, we plan to unify and fix 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.

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