Here’s what’s news in API Release that’s been in production since September 24, 2024!
Breaking Changes:
Fortunately, none! Let’s have a toast!
New features:
Auto-deployed Postman collection for Shoptet API
We have just released a major update for our API collection and now taking it to the next level with auto-deployment after every release.
See the details in linked article decribing the whole, here.
Downloading invoices as isdoc file
In compliance with the legislative obligation, we are extending the possibility of downloading invoices in isdoc format, which will take effect at the beginning of 2025.
In order to make it easier to create very similar products or copying them, we have decided, based on feedback from many of you, our partners, to add functionality for duplicating products to the API, identified by a GUID.
This duplication will allow products to have the same attributes as the original product, but some are conditional on the module being activated. Important note: If you previously had any active modules (such as Heureka, List, Global Sale) that are no longer active, the resulting data may differ slightly because data requiring an active module will not be copied in this case.
Please pay sufficient attention to the description of the behavior of this endpoint in our APIARY.
New reading for article section details
As a first step in managing article sections and the ability to serve more complex data, we have added a new endpoint for reading these broader item details
See GET https://shoptet.docs.apiary.io/#reference/articles/detail-of-article-section/detail-of-article-section for more details
Improvements:
Order sources extension
Due to the expansion of marketplaces, together with some of you, we see a need to expand our current OrderSources enumeration, which was currently insufficient and needed to be expanded
We have added demanded data to this endpoint, such as any information about the sectioning of articles, which can be found under the new defaultSectionId for default article section ID and sectionIds attributes.
Please note: referring to the new attributes above, the historical one sectionId is currently deprecated and will be completely deleted without any replacement on 01.12. 2024
Also new ogImage attribute is included, representing the image for social media
For more details visit the GET Detail of article or https://shoptet.docs.apiary.io/#reference/articles/list-of-all-articles/list-of-all-articles in APIARY
Extension of query filters on Invoices snapshot
We’ve extended the range of current query filters in Invoices Snapshot with new supporting filters represented by the following attributes:
hasTaxId– through the presence of a TAX identification number. For a Czech address, the taxId is the same as the vatId
hasVatId – through the presence of a VAT identification number
hasCompanyId – through the presence of a company registration
