For an automated check of this page, visit the JSON version
2022-04-21
PlatformKey Support
We've added a platformKey parameter to the deliveries/POST method to better identify the connection API provider. platformKey only applies to developers add-ons, CMS and WMS systems.
2022-04-20
Improvements to collection protocols
We have added the ability to request a protocol only for specific deliveries to the collection-protocols/POST method.
2022-04-19
We have extended APIdoc to include English
Your English-speaking colleagues can now also read the documentation. The language switcher is located on the right side in the top navigation.
2022-04-06
We have updated all tables with carrier and service dials
In the dials section we have added tables with the list of services. All entries are now synchronized with our API so they will always be up to date.
2021-07-27
We have expanded the API documentation with a new section -Frequently Asked Questions-
In response to your suggestions, we have started compiling the most frequently asked questions and will gradually add them to this section: https://apidoc.stiteknabalik.cz/en/faq
We have added support for shipment monitoring
Our API has been extended with a new v4/monitored-deliveries endpoint, which allows you to create a so-called monitored shipment for Track and Trace on packages exported outside Štíteknabalík.cz. More information can be found here: https://apidoc.stiteknabalik.cz/en/methods#monitored-deliveries
2021-06-10
Correction of incorrect names of two parameters
In the deliveries/GET method we corrected two names of parameters notDelivery, notPicketUp to notDelivered and notPickedUp.
2021-05-03
Extension of the GET method to include the tracking page of the shipper
We added an attribute agentTrackingUrl to the deliveries/GET method, which returns a link to the tracking page of the shipper with the shipment details. More in the description of the GET method.
2021-04-26
Change of URLs to get OAuth client
After the recent update of Štíteknabalík.cz application, some URLs have been changed. This mainly concerns the OAuth client registration address and the new application address. The change does not affect the endpoints for the REST API.
2021-04-14
Shipment detail, v4/list method modifications and ZPL formats
We have now added a list of supported ZPL formats to the v4/list/zpl-tickets list. Also, some field names in the lists have been changed (for example, active will now be isActive, etc.). We have also added a new parameter foxdeliDetailUrl to the shipment responses, which contains the absolute address of the shipment detail in Štíteknabalík.cz.
2021-03-24
Modification of endpoint for dials
In v4/list methods the level of data immersion has been changed. To maintain compatibility with the entire API, we have removed one level of immersion. Example: data.agents[] will now be directly in data[], data.deliveryStates.stateCategory[] will now be only in data.stateCategory[], data.extraServices[] will now be only in data[].
2021-02-16
Adding new methods for getting dials
Štíteknabalík.cz API has been enriched with new methods for automated getting of v4/list dials. Learn more about the new methods here https://apidoc.stiteknabalik.cz/en/methods#list.
2021-01-28
Deactivated standard transport for GEIS
As of 1st Feb 2021, a major change is taking place at the GEIS carrier. The standard parcel transport is discontinued and will be taken over by DPD. From now on, GEIS transport services will be limited to cargo transport only.
2021-01-19
Added cargo support
We have added new features to Štíteknabalík.cz to support cargo transport. The first carrier to support cargo within Štíteknabalík.cz is Geis. The modifications are mainly related to the POST/deliveries method and the new containerCode and containerItems parameters. The list of shipping units for cargo has been added to the codebooks.
2021-01-06
Updated shipping services
We have added newly supported services of carriers Zásilkovna, PPL and PBH to the dials.
2021-01-05
Added description of OAuth 2.0 integration
Added missing description of OAuth 2.0 integration and use.
2020-12-21
Supported and used printers
We have added to the table of label printers of our clients.
2020-11-09
Added parameter validations to deliveries/POST and Sandbox
Added a column "Validation" to the table with the description of fields for deliveries/POST request. In addition, as of mid-November, our testing environment is changing to SANDBOX.
2020-11-03
Change of the names InTime and Uloženka to WE|DO
The carriers InTime and Uloženka will merge into one entity called WEIDO CZ s.r.o., abbreviated as WEDO or WE|DO, from November 2020. This change has not affected the dials, but only the names of the services.
2020-10-22
Extension of the Traces/GET method
We have extended the response of the deliveries/traces/GET method with important information such as status codes, categories and flags. More in the description at https://apidoc.stiteknabalik.cz/en/apidoc#methods-traces
2020-10-07
Modifications to descriptions
We have only modified the wording of some paragraphs and added information about shipment validation.
2020-09-30
Description of the method for states and imports has been added
Methods for creating and reading transport protocols have been added to the documentation. We have also added methods for obtaining shipment statuses and obtaining a list of collection points.
2020-09-29
Label printing
Methods for printing PDF and ZPL labels have been added.
2020-09-23
Added PUT/PATCH/DELETE/GET methods
Added and revised all methods for working with shipments.
2020-09-19
Deliveries/POST method added
Completely added specification for shipment sealing method.
2020-09-17
Added dials
Added for Track and Trace states and label dimensions. New documentation added for deliveries/POST method.
2020-09-11
Downloads and dials
We have added new dials to the documentation. We also now provide the possibility to download individual sections (API, dials, CSV) to a PDF file.
2020-08-18
New authentication method
We have added Basic authentication using a generated token. The original OAuth 2.0 remains. The choice of logging into the API is up to the user.
2020-08-14
Modification of the labels Zásilkovna, Česká Pošta
We have modified the width of the content of the labels. The reason for this was that on some printers the barcode and part of the exto was overflowing outside the label.
Launching new API documentation
We have launched new API documentation.