API Release news from March 9, 2026

Here’s what’s new in API release that’s been in production since March 9, 2026!

Breaking Changes:

Request ID added to all API responses

• On April 9, 2026 we will extend all response bodies with a new section metadata with the requestId parameter.
• The exception is responses for endpoints returning files such as pdf and isdoc.
• metadata.requestId is primary used for logging/reporting purposes.
• Please remember to include the value from metadata.requestId or from the header X-Request-ID when contacting the technical support with your specific inquiry for better traceability.

Example of a successful response body:

    {
        "data": {
            "contactInformation": {
                "eshopName": "www.domena-eshopu.cz",
                "url": "https:\/\/www.domena-eshopu.cz\/",
                "companyId": "28935675",
               ...
            }
            ...
        },
        "errors": 'null',
        "metadata": {
            "requestId": "019c8c34-64f3-7328-af43-bf1e34fa39d7"
        }
    }

Example of a unsuccessful response body:

    {
        "data": 'null',
        "errors": [
            {
                "errorCode": "missing-access-token",
                "message": "Missing access token. Please add `Shoptet-Access-Token` header to your request.",
                "instance": "unknown"
            }
        ],
        "metadata": {
            "requestId": "019c8c34-64f3-7328-af43-bf1e34fa39d7"
        }
    }

Deprecation of buyPrice

• Reminder: the field buyPrice will be removed on March 19, 2026 as mentioned in the previous release news.

Deprecation of shippingCompanyCode & response code update

• Reminder: the field shippingCompanyCode is marked as deprecated and will be removed on March 19, 2026 as mentioned in the previous release news.

Mandatory field countryCode in orders

• Reminder: the field countryCode in Orders will be mandatory in our POST and PATCH order endpoints as mentioned in the the previous release news.

New location of reviews endpoints

• Reminder: mentioned in the previous release news – will be deleted by May 4th, 2026.

Upcoming credit notes & orders upcoming validation changes

• Reminder: mentioned in the previous release news.

---

New features:

New version of SDK

• We have a new version of SDK v0.3.0 – see more information here.

---

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