We start have launched the delivery of parcels in SDEK parcel terminal! Already now you can send order to parcel terminals. Details of the protocol extension are here.
For the "Order statuses" report, a limitation is introduced for the period of uploading changes. The period will be limited to 31 days. Those. DateLast - DateFirst = 31 days. If you try to enter a longer period, an error will be returned.
|Table of Contents|
|1.5||January 29, 2019||Creation of the documentation|
|1.5||February 4, 2019|
New tags for international order registration have been added to the method "Order registration" for online store
New tags for the method "Order Change" have been added: RecipientName tag, Phone tag, Address block, DeliveryRecipientCostAdv block
A recommended phone number format has been described
|1.5||February 19, 2019||Added description of the API calculator|
|1.5||March 20, 2019|
Additional service "Insurance" is allowed for delivery order.
Added test accounts, test method links.
|1.5||March 26, 2019|
Added ability to identify:
Added ability to update international order fields in the changing order method.
|1.5||March 27, 2019||Additional service "Package 1" is available.|
|1.5||April 8, 2019|
Added description of the calculator method "Calculating on tariffs without priority"
The country code in the ISO_3166-1_alpha-2 format has been added to the method "Loading the list of pickup points"
|1.5||April 24, 2019||cityName, postcode и regionFiasGuid were added to the method "List of Cities"|
|1.5||May 13, 2019|
In the method "Registration of a Request from the Online Store" added the ability to specify the requisites of a real seller in the Seller block for further printing of requisites on checks: Name, Address, Phone, INN, OwnershipForm
Removed individual elements SellerName and SellerAddress
|1.5||June 17, 2019||The opportunity to transfer goods marking will appear soon. In the documentation described the pass format of goods marking in the methods "Registration of a Request from the Online Store", "Order Update" and output format of goods marking in the methods "Order Status Report", "Order Information Report".|
|1.5||August 26, 2019||Mandatory fields of the Sender block have been changed in the methods "Registration of a Delivery Order"|
|1.5||September 17, 2019||New tag RecipientEmail has been added in the method "Order Change"|
|1.5||September 29, 2019||New tag timezone has been added in the "List of cities" method response|
|1.5||October 28, 2019|
New filter weightmin has been added in the method "Loading the List of Pickup Points"
New fileds have been added in the calculator methods for identify cities (senderCountryCode, receiverCountryCode, senderCity, receiverCity, senderLongitude, receiverLongitude, senderLatitude, receiverLatitude fields)
|1.5||January 19, 2020||Comment attribute has become mandatory in the method "Registration of a courier invitation"|
|1.5||March 23, 2020|
New filter havecash and HaveCash, TakeOnly, WorkTimeExceptions fields have been added to the method "Loading the list of pickup points"
|1.5||March 27, 2020|
The "package volume (in m³)" field is excluded from the calculator API
|1.5||April 17, 2020||Added "Sent to the sender city" and "Received in the sending city" statuses|
|1.5||June 8, 2020||Keys of online-shop test account were changed|
|1.5||July 10, 2020||Updated reasons for Late Delivery|
|1.5||July 13, 2020||Fields were removed from the "Description of Input Parameters" method:|
"DeliveryRecipientCost" - Additional delivery charge collected by the online store from the receiver (in the recipient country currency)
"DeliveryRecipientVATRate" - VAT rate included in the extra delivery charge (for more details, see Appendix No. 4)
"DeliveryRecipientVATSum" - VAT amount included in the extra delivery charge
|1.5||July 14, 2020||The "ClientSide" field was removed from the "order Registration for delivery" method"|
|1.5||July 23, 2020|
|1.5||September 3, 2020||178, 179, 180, 181, 182, 183, 231, 232,376 tariff codes are no longer available|
|1.5||September 24, 2020||Removed the "Creation of a Pre-Alert Document" method|
|1.5||October 5, 2020||For the "Create order" and "Changing the order" methods, the "Length", "Width", and "Height" fields are required.|
|1.5||November 11, 2020||Field "isHandout" was added in the "Loading the List of Pickup Points" method|
|1.5||December 15, 2020||Field "IsReception" was added in the "Loading the List of Pickup Points" method|
January 15, 2021
|For the "Order statuses" report, a restriction on the period for uploading changes has been introduced. The period is limited to 31 days.|
|No.||Tag / attribute||Description||Type of field||Mandatory (yes/no)|
|1.1||Date||Date of request||datetime/date||yes|
|1.2||Account||Client identifier (login)||string(255)||yes|
|1.4||ShowHistory||The attribute indicating that the order history must be loaded (1 – yes, 0 – no)||boolean||no|
|1.5||ShowReturnOrder||The attribute indicating that the list of return orders must be loaded (1 – yes, 0 – no)||boolean||no|
|1.6||ShowReturnOrderHistory||The attribute indicating that the history of return orders must be loaded (1 – yes, 0 – no)||boolean||no|
|1.7||Lang||Identifier of language in which the request is sent and the response is expected||string(3)||no|
|1.7||ChangePeriod1||The period during which the order status has changed.||no|
|1.7.1||DateFirst3||Start date of requested period||datetime/date||yes|
|1.7.2||DateLast3||End date of requested period||datetime/date||no|
|1.8.1||DispatchNumber2||CDEK shipment number (assigned when orders are imported). Order identifier in the CDEK IS.||integer||yes|
|1.8.2||Number2||Client's shipment number. Order identifier in the IS of the CDEK client.||string(40)||yes|
|1.8.3||Date2||Date of an acceptance certificate, based on which the order has been transferred||date||yes|
2 The order is identified either by “DispatchNumber” or by two parameters — Number and Date. If the request has a value of the “DispatchNumber” attribute, “Number” and “Date” attributes will be ignored.
3 The maximum period for uploading changes is 31 days. Those. DateLast - DateFirst = <31 days.
4.9.2. Response Format
The CDEK server will return a result in the form of XML: