Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Version

Revision date

Revision description

1.5January 29, 2019Creation of the documentation
1.5February 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.5February 19, 2019Added description of the API calculator
1.5March 20, 2019

Additional service "Insurance" is allowed for delivery order.

Added test accounts, test method links.

1.5March 26, 2019

Added ability to identify:

  • order in the methods of changing and deleting an order by the CDEK order number;
  • city by a city name and/or an address string

Added ability to update international order fields in the changing order method.

1.5March 27, 2019Additional service "Package 1" is available.
1.5April 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.5April 24, 2019cityName, postcode и regionFiasGuid were added to the method "List of Cities"
1.5May 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.5June 17, 2019The 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.5August 26, 2019Mandatory fields of the Sender block have been changed in the methods "Registration of a Delivery Order"
1.5September 17, 2019New tag RecipientEmail has been added in the method "Order Change"
1.5September 29, 2019New tag timezone has been added in the "List of cities" method response
1.5October 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.5January 19, 2020Comment attribute has become mandatory in the method "Registration of a courier invitation"
1.5March 23, 2020

New filter havecash and HaveCash, TakeOnly, WorkTimeExceptions fields have been added to the method "Loading the list of pickup points"

1.5March 27, 2020

The "package volume (in m³)" field is excluded from the calculator API

1.5April 17, 2020Added "Sent to the sender city" and "Received in the sending city" statuses
1.5June 8, 2020Keys of online-shop test account were changed
1.5July 10, 2020Updated reasons for Late Delivery
1.5July 13, 2020Fields 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.5July 14, 2020The "ClientSide" field was removed from the "order Registration for delivery" method"
1.5July 23, 2020
  1. Loading the List of Pickup Points
    1. Changed the "default" value in the Type field from PVZ to ALL
    2. Added Dimensions, width, height, depth fields in response to the request
  2. Added new tariffs for the terminals (361,363, 366, 368, 376, 378)
  3. Added new modes of orders: door-post terminal and warehouse-post terminal
  4. A method of creating order and a method of changing the order:

    1. Updated conditions for the SizeA, SizeB, and SizeC fields
    2. Updated the condition for the PvzCode field
  5. Updated permissions for additional services (Appendix 2)
1.5September 3, 2020178, 179, 180, 181, 182, 183, 231, 232,376 tariff codes are no longer available
1.5September 24, 2020Removed the "Creation of a Pre-Alert Document" method
1.5October 5, 2020For the "Create order" and "Changing the order" methods, the "Length", "Width", and "Height" fields are required.
1.5November 11, 2020Field "isHandout" was added in the "Loading the List of Pickup Points" method
1.5December 15, 2020Field "IsReception" was added in the "Loading the List of Pickup Points" method
1.5
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.

Introduction

General Description

This document presents a procedure and format of data exchange between CDEK and its client — an online store or a partner representing online stores.

Answers to frequently asked questions can be found at https://www.cdek.ru/faq_integrator.html.

Please send your requests for account generation, questions and proposals to our email: integrator@cdek.ru.

...

Note
titleNote

Information marked with this symbol is important and must be read and/or followed.

Info
titleInformation

Information marked with this symbol is provided for informational purposes and/or as a suggestion.
only.

Tip
titlePrompt

Information marked with this symbol illustrates a use of settings or principle of operation.

Terms and Definitions

IS means any information system, including software, ERP solution, and online store website.

Integration means a transfer of data from different sources (IS) or provision of unified data to users.

API means an Application Programming Interface. It is a set of ready-made functions, structures and constants provided by an application (library, service) to be used in third-party software (IS).

HTTP means a Hyper Text Transfer Protocol. It is an application-layer communication protocol (originally in the form of HTML hypertext documents).

HTTPS means a Hyper Text Transfer Protocol Secure, an extension of the HTTP protocol that supports encryption. Data communicated via HTTP are “packed” into a SSL or TLS cryptographic protocol. In contrast to HTTP, HTTPS uses a ТСР port 443 by default.

Online store means a client or partner of CDEK who has concluded an online store contract.

Package is an indivisible unit of cargo sent by the online store (there may be several packages in a single order).

Shipment (order) is a sum of all packages that are simultaneously sent by the online store to the same direction.

Volumetric weight is an estimated value of weight in kg. It can be estimated on the basis of specified package dimensions according to the following formula: length * height * width/5,000. This conversion method is commonly used by carriers.

Actual weight is determined by weighing a package on a scale. Net weight and gross weight are used. Net weight is the weight of cargo without package. Gross weight is the weight of packaged cargo.

Estimated weight means the greater of volumetric weight and actual weight. Services are priced on the basis of the estimated weight.

Pickup point means a place at which receivers can pick up their orders. Pickup points may be CDEK warehouses or parcel terminals of partners.

CDS means the CDEK Courier Delivery Service.

International Order is an order where the sender country is not the same as the receiver country, and at least one of the countries is not a member of the Customs Union.

What You Should Know to Make the Integration Work

Step 1: Integration is possible only if there is an agreed contract with CDEK.

Step 2: An online store's representative should examine the documents and frequently asked questions presented on the website https://www.cdek.ru/clients/integrator.html

Step 3: Select an appropriate integration option that best suits your needs:

  • Use ready-made partner modules presented on the company's website.

  • Implement your own solution if ready-made solutions do not suit you for some reason.

Step 4: Test and set integration using a test account.  

  • If you have selected a ready-made partner module and need advice on configuration, please refer to the developer or support service of this module.

  • If you want to implement your own solution, you should try all preliminary settings under your test account.

Step 5: After you have tried everything and settled all issues, request a live account (Account and Secure password) for integration by sending an email to integrator@cdek.ru. Please do not forget to specify the ID of your contract with CDEK. 

Step 6: You can switch over to the live account and work in the normal mode.

Tip
titlePrompt

A sample request for accounts (recommended):
Contract ID
Client’s Platform/IS
email — for notices on accepted/rejected requests, changes in integration.

...

XML API is a solution that allows you to interact with the service online using standard НТТР/НТТРS, as well as XML protocols and formats.

XML API supports the following functionality:

...

1.5January 22, 2021
The history of statuses using the "Order statuses" method can be obtained only for orders created not earlier than 2020.
1.5April 18, 2021
  1. Added requirement for labeling data
  2. Removed additional service "Delivery on weekends" due to redundancy. Delivery is carried out according to the work schedule of the Recipient's office, including on weekends.
1.5April 28, 2021New additional services are available in the "Order registration", "Calculator" methods (Notification of order creation in CDEK, Notification of acceptance of an order for delivery, Courier package A2, Secure package A2, Secure package A3, Secure package A4, Secure package A5)
1.5May 19, 2021New additional services are available in the "Order registration", "Calculator" methods (Box XS (0.5 kg 17x12x9 cm), Box S (2 kg 21x20x11 cm), Box M (5 kg 33x25x15 cm), Box L (12 kg 34x33x26 cm), Box (0.5 kg 17x12x10 cm), Box (1 kg 24x17x10 cm), Box (2 kg 34x24x10 cm), Box (3 kg 24x24x21 cm), Box (5 kg 40x24x21 cm), Box (15 kg 60x35x29 cm), Box (20 kg 47x40x43 cm), Box (30 kg 69x39x42 cm), Bubble wrap, Waste paper, Pressed filler cardboard (55x14x2.3 cm))

Introduction

General Description

This document presents a procedure and format of data exchange between CDEK and its client — an online store or a partner representing online stores.

Answers to frequently asked questions can be found at https://www.cdek.ru/faq_integrator.html.

We accept questions and wishes of clients by e-mail: integrationtor@cdek.ru.

Symbols

Note
titleNote

Information marked with this symbol is important and must be read and/or followed.


Info
titleInformation

Information marked with this symbol is provided for informational purposes and/or as a suggestion.
only.


Tip
titlePrompt

Information marked with this symbol illustrates a use of settings or principle of operation.


Terms and Definitions

IS means any information system, including software, ERP solution, and online store website.

Integration means a transfer of data from different sources (IS) or provision of unified data to users.

API means an Application Programming Interface. It is a set of ready-made functions, structures and constants provided by an application (library, service) to be used in third-party software (IS).

HTTP means a Hyper Text Transfer Protocol. It is an application-layer communication protocol (originally in the form of HTML hypertext documents).

HTTPS means a Hyper Text Transfer Protocol Secure, an extension of the HTTP protocol that supports encryption. Data communicated via HTTP are “packed” into a SSL or TLS cryptographic protocol. In contrast to HTTP, HTTPS uses a ТСР port 443 by default.

Online store means a client or partner of CDEK who has concluded an online store contract.

Package is an indivisible unit of cargo sent by the online store (there may be several packages in a single order).

Shipment (order) is a sum of all packages that are simultaneously sent by the online store to the same direction.

Volumetric weight is an estimated value of weight in kg. It can be estimated on the basis of specified package dimensions according to the following formula: length * height * width/5,000. This conversion method is commonly used by carriers.

Actual weight is determined by weighing a package on a scale. Net weight and gross weight are used. Net weight is the weight of cargo without package. Gross weight is the weight of packaged cargo.

Estimated weight means the greater of volumetric weight and actual weight. Services are priced on the basis of the estimated weight.

Pickup point means a place at which receivers can pick up their orders. Pickup points may be CDEK warehouses or parcel terminals of partners.

CDS means the CDEK Courier Delivery Service.

International Order is an order where the sender country is not the same as the receiver country, and at least one of the countries is not a member of the Customs Union.


What You Should Know to Make the Integration Work

Step 1: Integration is possible only if there is an agreed contract with CDEK.

Step 2: An online store's representative should examine the documents and frequently asked questions presented on the website https://www.cdek.ru/clients/integrator.html

Step 3: Select an appropriate integration option that best suits your needs:

  • Use ready-made partner modules presented on the company's website.

  • Implement your own solution if ready-made solutions do not suit you for some reason.

Step 4: Test and set integration using a test account.  

  • If you have selected a ready-made partner module and need advice on configuration, please refer to the developer or support service of this module.

  • If you want to implement your own solution, you should try all preliminary settings under your test account.

Step 5: After everything has been verified (tested, all problems are resolved), you should receive an access key to the "combat" account (Account and Secure password) for integration. The keys can be obtained in your CDEK personal account at the link: https://lk.cdek.ru/integration/index. To do this, in your personal account in the "Integration" section, click the "Create a key" button, after which the account ID and password will appear in this section.

Step 6: You can switch over to the live account and work in the normal mode.

Tip
titlePrompt

A sample request for accounts (recommended):
Contract ID
Client’s Platform/IS
email — for notices on accepted/rejected requests, changes in integration.


1. General Provisions

XML API is a solution that allows you to interact with the service online using standard НТТР/НТТРS, as well as XML protocols and formats.

XML API supports the following functionality:

1. List of Pickup Points can be used to load the actual list of pickup points with detailed information to be processed in the online store's IS.

...

  • tariff code under which the order has been delivered;

  • price of CDEK services invoiced for the order (i.e. invoiced amount);

  • date of the last change in the order amount;

  • method of order delivery to the receiver (courier, pickup);

  • type of cash on delivery payment.

11. Calculator allows to calculate the delivery cost of one shipment for the defined input parameters.

1.1. Parcel Identifiers and Label Information

...

List of Regions - is used to load detailed information on regions.

In order to load the list of regions, it is necessary to send request on the CDEK server.

12. List of Cities - is used to load detailed information on cities.

In order to load the list of regions, it is necessary to send request on the CDEK server.

13. Calculator allows to calculate the delivery cost of one shipment for the defined input parameters.

1.1. Parcel Identifiers and Label Information

The CDEK would prefer that the client uses CDEK labels (order receipts), which can be loaded in PDF format via XML API. If the client prefers to use its own label, this label must contain receiver's details (full name, address, phone number) and any of identifiers:

...

Note
titleNote

The phone format is validated. We recommend to transfer the number in the international format +7 (ХХХ) ХХХ-ХХ-ХХ:

  • A number should be written in the international format: country code (+7 for Russia) and then the number itself (10 or more digits)

  • A number shouldn’t contain any letters or symbols excluding special symbols:

    • ":" (colon), "#" (hash) are used to indicate an extension number

    • numbers should be separated with "," (comma), ";" (semicolon), "/" (slash)

  • The characters "()" (parentheses) and "-" (dash) are accepted but ignored by the system.


Data are transmitted in the XML format in UTF-8 encoding. Please note that XML markup symbols (< > & " ') may not be entered in fields.

...

  • An exchange of requests is tested by checking the data to be transmitted for correctness, as well as checking types of data and values to be transmitted in parameters of tested methods.
  • Shipments are tested after the exchange of requests. This step involves sending several real orders by the online store.The full functionality, from loading the orders to delivering them to test receivers, is tested. This step is not necessary. It can be implemented as agreed upon with a CDEK manager.

After Upon completion of debugging, the online store reports that it is they are notified that they are ready to switch over to the live combat account. At this the same time, the client must conclude have a contract with CDEKSDEK. For this purpose, the client should send a request to integrator@cdek.ru for providing live account data, if they have not yet been providedTo do this, in your personal account, in the Integration section, click the "Create Key" button, then the Account ID and Password will appear in this section.

1.6. Notifications

The online store can be notified about data transmission results by email. These notifications contain information on both successfully loaded orders and data transmission errors. The list of emails is sent to CDEK together with a request for account. The online store can unsubscribe from these notifications, but it should be noted that all data on upcoming maintenance and changes in the protocol are also sent to this email.

...

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1citypostcode1Postal code of the city for which the list of pickup points is requiredintegerno
2cityid1City code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK_city.zip)city codeintegerno
3typeType of pickup point, possible values:
“PVZ” – display only CDEK warehouses;
“POSTAMAT” – display only partner's parcel terminals;
“ALL” – display all pickup points, irrespective of their type.
If no value is defined, “ALL” will be used as a default value.
string(8)no
4countryidCountry code from the CDEK baseintegerno
5countryisoCountry code in the ISO_3166-1_alpha-2 formatstring(2)no
6regionidRegion code from the CDEK baseintegerno
7havecashlessAvailability of a payment terminal, possible values:
“1”, “true” – available;
“0”, “false” – not available.
booleanno
8havecash

Availability of payment in cash, possible values:
“1”, “true” – available;
“0”, “false” – not available.

booleanno
9allowedcodCash on delivery is permitted, possible values:
“1”, “true” – yes;
“0”, “false” – no.
booleanno
10isdressingroomAvailability of a fitting room, possible values:
“1”, “true” – available;
“0”, “false” – not available.
booleanno
11weightmaxThe maximum weight that can be accepted by a pickup point (values of more than 0 – load pickup points that accept this weight; 0 – pickup points with zero weight are not loaded; no value defined – load all pickup points).integerno
12weightminThe minimum weight that is accepted by a pickup point (pickup points with minimum weight up to the specified value will be transmitted)integerno
13langLocalization of pickup points. Default: “rus”.string(3)no
14takeonlyWhether the pickup point is only a pickup point, possible values:
“1”, “true” – yes;
“0”, “false” – no.
booleanno
15isHandoutAvailability of an issuing orders, possible values:
“1”, “true” – yes;
“0”, “false” – no.
booleanno
16IsReceptionAvailability of a receiving orders, possible values:
“1”, “true” – yes;
“0”, “false” – no.
booleanno

...

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)

1

PvzList

Document title
yes

1.1

Pvz

Pickup points
yes
1.1.1CodeCodestring(10)yes
1.1.2PostalCodePostcodestring(10)yes
1.1.3NameParameterstring(50)yes
1.1.4CountryCodeCountry codeintegeryes
1.1.5countryCodeIsoCountry code in the ISO_3166-1_alpha-2 formatstring(2)no
1.1.6CountryNameCountry namestring(50)yes
1.1.7RegionCodeRegion codeintegeryes
1.1.8RegionNameRegion namestring(50)yes
1.1.9CityCodeCity code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK_city.zip)integeryes1.1.CDEK city codeintegeryes
1.1.10CityCity namestring(50)yes
1.1.11WorkTimeOpening hours, string of the following type: Mon–Fri 9–18, Sat9–16”string(100)yes
1.1.12AddressAddress (street, house, office) in the specified citystring(255)yes
1.1.13FullAddressFull address, including country, region, city, etc.string(255)yes
1.1.14AddressCommentDescription of locationstring(255)yes
1.1.15PhonePhonephoneyes
1.1.16EmailE-mailstring(255)yes
1.1.17

Note

Pickup points note

string(255)

yes

1.1.18coordXCoordinates of location (longitude) in degreesfloatyes
1.1.19coordYCoordinates of location (latitude) in degreesfloatyes
1.1.20

Type

Pickup point type: PVZ, POSTAMAT - CDEK partner's postamat

string(8)

yes

1.1.21

ownerCode

Affiliation of the pickup points company: CDEK — pickup point is owned by CDEK, InPost — pickup point is owned by InPost.

string(6)

yes

1.1.22IsDressingRoomAvailability of a fitting roomstring(4)yes
1.1.23

HaveCashless

Availability of payment terminal

string(4)yes
1.1.24HaveCash
Availability of payment in cash
string(4)yes
1.1.25AllowedCodCash on delivery is permitted in a pickup pointstring(4)yes
1.1.26TakeOnly
Whether the pickup point is only a pickup point
string(4)yes
1.1.27NearestStationNearest station/public transport stopstring(50)yes
1.1.28MetroStationNearest metro stationstring(50)yes
1.1.29SitePickup point's website on the CDEK pagestring(255)no
1.1.30OfficeImageAll photos of the office (except for a photo showing how to get to it)
yes

1.1.30.1

url

All photos have a separate tag with url attribute.
A link to the image is displayed.

string(255)

yes

1.1.31

WorkTimeYOpening hours for every day
yes

1.1.31.1

dayOrdinal number of a day (Monday = 1, Sunday = 7)integeryes

1.1.31.2

periodsOpening hours for these days. If the pickup point does not work on this day, no period is specifiedstring(20)yes
1.1.32WorkTimeExceptions
Office schedule exceptions

yes
1.1.32.1DateDatedatetimeyes
1.1.32.2Time
The period of work on the specified date. If they don’t work on this day, it is not displayed
string(20)yes
1.1.32.3IsWorkingSign of a working / non-working day on a specified datestring(4)yes

1.1.33

WeightLimitWeight limits for a pickup point(the tag is used only if limits are set)
yes

1.1.33.1

WeightMinMinimum weight (in kg) accepted by a pickup point (> WeightMin)floatyes

1.1.33.2

WeightMaxMaximum weight (in kg) accepted by a pickup point (<=WeightMax)floatyes
1.1.34DimensionsDimensions of cells for parcel terminal

1.1.34.1widthWidth (cm)floatYes, if Type= POSTAMAT or ALL
1.1.34.2heightHeight (cm)floatYes, if Type= POSTAMAT or ALL
1.1.34.3depthDepth (cm)floatYes, if Type= POSTAMAT or ALL
1.1.35isHandoutAvailability of an issuing orders    boolean   yes
1.1.36IsReceptionAvailability of a receiving ordersbooleanno

...

29Schedule for delivery /pickup (

No.

Tag / attributeDescriptionTypeof fieldMandatory (yes/no)
1Delivery RequestDocument title
yes
1.1NumberID number of the acceptance certificate/waybill (accompanying document attached upon the transfer of the cargo to CDEK, generated in the online store's system). Identifier of the list of cargoes in the IS of the CDEK client. By default, you can use 1.string(30)yes
1.2DateDate of document (date of order)Datetime/dateyes
1.3AccountOnline store identifier (login)string(255)yes
1.4SecureKeystring(255)yes
1.5OrderCountThe total number of orders in a documentintegeryes
1.6OrderShipment (order)
yes
1.6.1NumberClient shipment number (unique for orders of a particular client). Order identifier in the Client's IS.string(40)yes
1.6.2SendCityCode1Sender's s CDEK city code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK_city.zip)integeryes
1.6.3RecCityCode1Receiver's s CDEK city code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK_city.zip)integeryes
1.6.4SendCityPostCode1Postal code of the sender's citystring(6)yes
1.6.5RecCityPostCoDe1Postal code of the receiver's citystring(6)yes
1.6.6SendCountryCode1Sender's country code to identify a country by postal code. Default value: RUstring(2)no
1.6.7RecCountryCode1Receiver's country code to identify a country by postal code. Default value: RUstring(2)no
1.6.8SendCityName1Name of sender's citystring(255)no
1.6.9RecCityName1Name of receiver's citystring(255)no
1.6.10RecipientINN

TIN of the receiver. Only for international orders.

string(12)no
1.6.11DateInvoice

Invoice date. Only for international orders.

Date time/dateyes, if order is international
1.6.12ShipperName

Shipper. Used to print waybills. Only for international orders.

string (255)yes, if order is international
1.6.13ShipperAddress

Shipper’s address. Used to print waybills. Only for international orders.

string (255)yes, if order is international
1.6.14Passport

Details of the receiver’s passport. Used to print waybills. Only for international orders.


no
1.6.14.1Series

Series of the receiver’s passport.

string (255)no
1.6.14.2Number

Number of the receiver’s passport.

string (255)no
1.6.14.3IssueDate

Date of issue of the receiver’s passport.

Date time/dateno
1.6.14.4IssuedBy

Issuing authority of the receiver’s passport.

string (255)no
1.6.14.5DateBirth

The receiver’s birthdate

Date time/dateno
1.6.15SenderSender. Must be defined if it is different from the online store client. If the online store is a sender, the Sender tag is not available.
no
1.6.15.1CompanyName of sender's companystring(128)no
1.6.15.2NameSender's contact personstring(128)no
1.6.15.3Address1Sender address (address of pickup)
no
1.6.15.3.1StreetStreetstring(50)yes
1.6.15.3.2HouseHousestring(30)no
1.6.15.3.3FlatFlat/officestring(10)no
1.6.15.4PhoneSender's phonephoneno
1.6.16RecipientNameReceiver (full name). At least 3 characters.string(128)yes
1.6.17RecipientEmailReceiver's email for sending order status notifications and contacting in case of failed callsemailno
1.6.18PhoneReceiver's phonephoneyes
1.6.19TariffTypeCode7Code of tariff type (for more details, see Appendix No. 1)integeryes
1.6.20DeliveryRecipientCost2Extra delivery charge collected by the online store from the receiver (the recipient country currency)floatno
1.6.21DeliveryRecipientVATRateVAT rate included in the extra delivery charge (for more details, see Appendix No. 4)string(10)no
1.6.22DeliveryRecipientVATSumVAT amount included in the extra delivery chargefloatno
1.6.23SellerRequisites of the real seller
no
1.6.23.1AddressReal seller’s address. Used to print invoices to display the address of the true seller or trade name. Only for international orders.string (255)yes, if order is international
1.6.23.2NameReal sellerstring (255)yes, if ITN is indicated
1.6.23.3INNITN (Individual Taxpayer Number) of the real sellerstring (20)no
1.6.23.4PhoneTelephone of the real sellerphoneyes, if ITN is indicated
1.6.23.5OwnershipFormCode of type ownership (for more details, see Appendix No. 10)integeryes, if ITN is indicated
1.6.24Comment3Comments (special notes on the order)string(255)no
1.6.25Address1Delivery address. Depending on a delivery mode, it is necessary to specify either Street, House, Flat attributes (delivery to the receiver's address) or PvzCode (pickup)
yes
1.6.25.1StreetReceiver's street. If possible, do not specify prefixes of values, such as “st.”string(50)yes
1.6.25.2HouseReceiver's house, building, block. If possible, do not specify prefixes of values, such as “house”.string(30)no
1.6.25.3FlatReceiver's flat/office. If possible, do not specify prefixes of values, such as “flat”.string(10)no
1.6.25.4PvzCodePickup code. The attribute is required only for orders with the delivery mode “to warehouse”, provided that no additional service “Delivery in the receiver's city” is ordered (AddService="17", for more details, see Appendix 2), and for orders with the "to the parcel terminal" mode".
If the specified pickup point is closed at the time of order creation, the order will be accepted for the nearest functioning pickup point. If the specified parcel terminal is closed at the time of order creation, the order will be accepted for the nearest functioning pickup point or parcel terminal. The receiver will be notified about change of the pickup point via SMS. If all pickup points in the city that can provide the selected service are closed, order registration will be impossible. The relevant error message will be sent.
string(10)yes, if the mode of delivery "to the warehouse" or "to a parcel terminal"
1.6.26PackagePackage (all packages are sent with different Package tags)
yes
1.6.26.1NumberPackage number (ordinal package number or order number can be used), unique for this order. Order identifier in the Client's IS.string(20)no
1.6.26.2BarCodePackage barcode, package identifier (if any); otherwise, transmit a value of the package number: Packege.Number). The parameter is used to handle the cargo at CDEK warehouses), unique for this order. Package identifier in the Client's IS.string(20)yes
1.6.26.3Weight7Total weight (in grams)integeryes
1.6.26.4SizeA4Package dimensions. Length (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
or
if the orders with the delivery mode “to parcel terminal”
or
Total weight >= 100 
1.6.26.5SizeB4Package dimensions. Width (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
or
if the orders with the delivery mode “to parcel terminal”
or
Total weight >= 100 
1.6.26.6SizeC4Package dimensions. Height (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
or
if the orders with the delivery mode “to parcel terminal”
or
Total weight >= 100 
1.6.26.7ItemItems (goods)
yes
1.6.26.7.1AmountQuantity of goods of the same type (pcs).
The maximum number is 999.
Integeryes
1.6.26.7.2WareKeyIdentifier/item number of the goods.string(50)yes
1.6.26.7.3Marking8

Marking of item.
If marking is indicated for Item, the Amount parametr can't be greater than 1.

For the correct display of the marking of the goods in the receipt, it is required to transfer the DISASSEMBLED type of marking, which may look like this:

1) Array of bytes encoded in base64 format

Example: RE0DSU3xvJVMTFdHY3FUbVdSQkZI

2) Array as a string, with or without spaces:

Example 1: 44 4D 04 3D 02 64 1E D1 3E 69 55 72 54 54 4E 2B 65 54 4D 63 74

Example 2: 444D043D02641ED13E69557254544E2B65544D6374

stringno
1.6.26.7.4CostDeclared value of the goods (per item in the contract currency, value >=0). This value is used to calculate the amount of insurance.floatyes
1.6.26.7.5PaymentCash on delivery (per item in the recipient country currency, value >=0) — cash on delivery; in case of prepayment, value = 0.floatyes
1.6.26.7.6PaymentVATRateVAT rate included in the value of the goods (for more details, see the Appendix 4)string(10)no
1.6.26.7.7PaymentVATSumVAT amount included in the value (payment) of the goods.floatno
1.6.26.7.8WeightWeight (per item, in grams)integeryes
1.6.26.7.9CommentName of the goods (may contain description of the goods: size, color)string(255)yes
1.6.26.7.10WeightBrutto

Gross weight (for one unit of goods, in grams). Only for international orders.

integeryes, if order is international
1.6.26.7.11CommentEx

Name of the goods, in English (also can contain description of the goods, such as size and color). Only for international orders.

string(255)no
1.6.26.7.12Link

Link to the e-shop’s website with the goods’ description. Only for international orders.

string(255)no
1.6.27DeliveryRecipientCostAdv

Additional charge for delivery (E-shop charges the receiver), depending on the order’s sum


no
1.6.27.1Threshold

Goods price threshold (valid by condition less than or equal to), in even monetary units

integeryes
1.6.27.2Sum

Additional charge for delivery with total amount that falls within the interval

floatyes
1.6.27.3VATRate

VAT rate included in the additional charge for delivery (for more details, see Appendix No. 4). If the value is unknown, then default value “No VAT” is applied

string(10)no
1.6.27.4VATSum

VAT sum included in the additional charge for delivery

floatno
1.6.28AddServiceAdditional services
no
1.6.28.1ServiceCodeType of additional service (for more details, see Appendix No. 2)integeryes
1.6.28.2CountNumber of packages. It is used and is mandatory only for the additional service "Package 1".services with 24, 54-58, 61-73, 76 codesintegerno
1.6.28.3Schedule5LengthLength of package. It is used and is mandatory only for the additional services with 74, 75 codesfloatno
1.6.29Schedule5

Schedule for delivery /pickup (deprecated, it is recommended to use a separate new_schedule method)


no
1.6.29.1Attempt

Time of delivery (one time interval not less than 3 hours is permitted for one day)


yes
1.6.29.1.1ID

ID number of a schedule from the online store's database. You may use 1 as a default value

integeryes
1.6.291.1.2Date

Date of delivery (only date, in the format “YYYY-MM-DD”, no time) as agreed by the receiver

dateyes
1.6.29.1.3CommentCommentstring(255)no
1.6.29.1.4TimeBeg

Start of a delivery time range (receiver's time)

timeyes
1.6.29.1.5TimeEnd

End of a delivery time range (receiver's time)

timeyes
1.6.29.1.6Address

New delivery address (if change is required). Depending on a delivery mode, Street or House attributes should be specified. Flat – delivery to the receiver's address, or PvzCode – pickup


no
1.6.29.1.6.1Street

Receiver's street. If possible, do not specify prefixesof values, such as “str”

string(50)yes
1.6.29.1.6.2House

Receiver's house, building, block. If possible, do not specify prefixes of values, such as “house”

string(30)yes
1.6.29.1.6.3Flat

Receiver's flat/office. If possible, do not specify prefixes of values, such as “flat.”

string(10)no
1.6.29.1.6.4PvzCode

Pickup code, required only for orders with a delivery mode “to warehouse” and provided that no additional service “Delivery in the receiver's city” has been ordered.

string(10)yes
1.7CallCourier6Call courier
no
1.7.1Call

Waiting for a courier


yes
1.7.1.1Date

Date of courier waiting

dateyes
1.7.1.2TimeBeg

Start time of courier waiting

timeyes
1.7.1.3TimeEnd

End time of courier waiting

timeyes
1.7.1.4LunchBeg

Start time of a lunch break, if it is within a time range [TimeBeg; TimeEnd]

timeno
1.7.1.5LunchEnd

End time of a lunch break, if it is within a time range [TimeBeg; TimeEnd]

timeno
1.7.1.6SendCityCode1

Sender's s CDEK city code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK_city.zip)

integeryes
1.7.1.7SendCityPostCode1

Postal code of the sender's city

string(6)yes
1.7.1.8SendCountryCode1

Sender's country code to identify a country by postal code

string(2)no
1.7.1.9SendCityName1

Name of sender's city

string(255)no
1.7.1.10SendPhone

Sender's contact phone

phoneyes
1.7.1.11SenderName

Sender (full name)

string(255)yes
1.7.1.12CommentComment for courierstring(255)no
1.7.1.13SendAddressSender's address
yes
1.7.1.13.1Street

Sender's street. If possible, do not specify prefixes of values, such as “st.”

string(50)yes
1.7.1.13.2House

Sender's house, building, block. If possible, do not specify prefixes of values, such as “house”.

string(30)yes
1.7.1.13.3Flat

Sender's flat/office. If possible, do not specify prefixes of values, such as “flat”.

string(10)yes

...

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1Delivery RequestDocument title
yes
1.1NumberNumber of an acceptance certificate/waybill. Identifier of the list of cargoes in the IS of the CDEK client. 1 can be used a default value.string(30)yes
1.2DateDate of document (date of order)datetime/dateyes
1.3AccountClient identifier (login)string(255)yes
1.4SecureKeystring(255)yes
1.5OrderCountThe total number of orders in a documentintegeryes
1.6OrderShipment (order)
yes
1.6.1SendCityCode1Sender's s CDEK city code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK_city.zip)Integeryes
1.6.2RecCityCode1Receiver's s CDEK city code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK_city.zip)Integeryes
1.6.3SendCityPostCode1Postal code of the sender's citystring(6)yes
1.6.4RecCityPostCode1Postal code of the receiver's citystring(6)yes
1.6.5SendCountryCode1Sender's country code to identify a country by postal code. Default value: RUstring(2)no
1.6.6RecCountryCode1Receiver's country code to identify a country by postal code. Default value: RUstring(2)no
1.6.7SendCityName1Name of sender's citystring(255)no
1.6.8RecCityName1Name of receiver's citystring(255)no
1.6.9SenderSender
no
1.6.9.1CompanyName of sender's companystring(128)no
1.6.9.2NameSender's contact personstring(128)yes
1.6.9.3Address1Address of pickup
no
1.6.9.3.1StreetStreetstring(50)yes
1.6.9.3.2HouseHousestring(30)no
1.6.9.3.3FlatFlat/officestring(10)no
1.6.9.3.4PhoneSender's phonephoneyes
1.6.10RecipientCompanyName of receiver's companystring(128)yes
1.6.11RecipientNameReceiver (full name). At least 3 characters.string(128)yes
1.6.12RecipientEmailEmail for sending order status notifications and contacting in case of failed callsеmailno
1.6.13PhoneReceiver's phonephoneyes
1.6.14TariffTypeCode7Code of tariff type (for more details, see Appendix No. 1)Integeryes
1.6.15Comment3Comments (special notes on the order)string(255)no
1.6.16Address1Delivery address. Depending on a delivery mode, it is necessary to specify either Street, House, Flat attributes (delivery to the receiver's address) or PvzCode (pickup)
yes
1.6.16.1StreetReceiver's street. If possible, do not specify prefixes of values, such as “st.”string(50)yes
1.6.16.2HouseReceiver's house, building, block. If possible, do not specify prefixes of values, such as “house”string(30)no
1.6.16.3FlatReceiver's flat/office. If possible, do not specify prefixes of values, such as “flat”string(10)no
1.6.16.4PvzCodePickup code. The attribute is required only for orders with the delivery mode “to warehouse”, provided that no additional service “Delivery in the receiver's city” is ordered (AddService="17", for more details, see Appendix 2), and for orders with the "to the parcel terminal" mode".
If the specified pickup point is closed at the time of order creation, the order will be accepted for the nearest functioning pickup point. If the specified parcel terminal is closed at the time of order creation, the order will be accepted for the nearest functioning pickup point or parcel terminal. The receiver will be notified about change of the pickup point via SMS. If all pickup points in the city that can provide the selected service are closed, order registration will be impossible. The relevant error message will be sent.
string(10)yes, if the mode of delivery "to the warehouse" or "to a parcel terminal"
1.6.17PackagePackage (all packages are sent with different Package tags)
yes
1.6.17.1NumberPackage number (ordinal package number or order number can be used), unique for this order. Order identifier in the Client's IS.string(20)no
1.6.17.2BarCodePackage barcode, package identifier (if any); otherwise, transmit a value of the package number: Packege.Number). The parameter is used to handle the cargo at CDEK warehouses, uniquefor this order. Package identifier in the Client's IS.string(20)yes
1.6.17.3Weight7Total weight (in grams)integerno
1.6.17.4SizeA4Package dimensions. Length (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
or
if the orders with the delivery mode “to parcel terminal”
or
Total weight >= 100 g
1.6.17.5SizeB4Package dimensions. Width (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
or
if the orders with the delivery mode “to parcel terminal”
or
Total weight >= 100 g
1.6.17.6SizeC4Package dimensions. Height (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
or
if the orders with the delivery mode “to parcel terminal”
or
Total weight >= 100 g
1.6.18AddServiceAdditional services
no
1.6.18.1ServiceCodeType of additional service (for more details, see Appendix No. 2)integeryes
1.6.18.2CostDeclared value of the package. It is used and is mandatory only for the additional service "Insurance".floatno
1.6.1828.3CountNumber of packages. It is used and is mandatory only for the additional service "Package 1".integerservices with 24, 54-58, 61-73, 76 codesintegerno
1.6.28.4LengthLength of package. It is used and is mandatory only for the additional services with 74, 75 codesfloatno

1Identification of sender city and receiver city (in the case of “to the door” mode) uses the following algorithm by order of priority:

  • By pickup code (PvzCode attribute).
  • By unique city code (City ID) in CDEK’s database. City IDs in CDEK’s database can be found in lists of cities in the documents package (https://cdek.ru/storage/source/document/1/CDEK_city.zip). The values are represented in SendCityCode, RecCityCode attributes.By the city’s postcode. The values  The values are represented in SendCityCode, RecCityCode attributes.

  • By the city’s postcode. The values are represented in SendCityPostCode, RecCityPostCode attributes. Along with the postcode, the country code (attributes SendCountryCode, RecCountryCode) and/or the city’s name (attributes SendCityName, RecCityName) can be used for specifying: the country code of the sought city should match with that described in the related attribute, and the transferred name of the city should be included in the name of the sought one. The city’s name can be in the client’s language (all localizations will be searched).

  • By address string which is formed by concatenating the following fields: SendCityName/RecCityName + Address.Street + Address.House.

Identification of sender city and receiver city (in the case of “to the warehouse” mode) uses the following algorithm by order of priority:

  • By unique city code (City ID) in CDEK’s database. City IDs in CDEK’s database can be found in lists of cities in the documents package (https://cdek.ru/storage/source/document/1/CDEK_city.zip). The values are represented in RecCityCode attribute.
  • By pickup code (PvzCode attribute).

  • By the city’s postcode. The value is represented in RecCityPostCode attribute. Along with the postcode, the country code (attribute RecCountryCode) and/or the city’s name (attribute RecCityName) can be used for specifying: the country code of the sought city should match with that described in the related attribute, and the transferred name of the city should be included in the name of the sought one. The city’s name can be in the client’s language (all localizations will be searched).

Usually, the city code serves to indicate the sender’s city, and the post code – to indicate the receiver’s city

...

Usually, the city code serves to indicate the sender’s city, and the post code – to indicate the receiver’s city

It should be noted that the database of postal codes in the CDEK IS may contain incomplete and sometimes inaccurate information on postal codes. Therefore, the user should be able to adjust the postal code parameter, if necessary.

...

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1CallCourierDocument title
yes
1.2DateDate of document (date of invitation)datetime/dateyes
1.3AccountOnline store identifier (login)string(255)yes
1.4SecureKeystring(255)yes
1.5CallCountThe total number of courier invitations in the documentintegeryes
1.6CallWaiting for a courier
yes
1.6.1DateDate of courier waitingdateyes
1.6.2TimeBegStart time of courier waitingtimeyes
1.6.3TimeEndEnd time of courier waitingtimeyes
1.6.4LunchBegStart time of a lunch break, if it is within a time range [TimeBeg; TimeEnd]timeno
1.6.5LunchEndEnd time of a lunch break, if it is within a time range [TimeBeg; TimeEnd]timeno
1.6.6SendCityCode1Sender's CDEK city code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK_city.zip)integeryes, if DispatchNumber is not defined
1.6.7SendCityPostCode1

Postal code of the sender's city

string(6)yes
1.6.8SendCountryCode1

Sender's country code to identify a country by postal code.

string(2)no
1.6.9SendCityName1

Name of sender's city

string(255)no
1.6.10SendPhoneSender's contact phonephoneyes, if
1. DispatchNumber is not defined
2. DispatchNumber is defined, but phone number is not defined in an order
1.6.11SenderNameSender (full name)string(255)yes, if
1. DispatchNumber is not defined
2. DispatchNumber is defined, but full name is not defined in an order
1.6.12WeightTotal weight (in grams) The document contain an integral number, but clients may transmit number with a decimal point. In this case, it will be rounded. If no number is transmitted, a default value (0.49 kg) will be written in the order.stringyes, if DispatchNumber is not defined
1.6.13CommentCargo descriptionstring(255)yes, if DispatchNumber is not defined
1.6.14DispatchNumber2Number of an assigned orderstring(10)no
1.6.15IgnoreTime

If “true” is selected, parameters of courier arrival will not be checked

boolean

no, default value: “false”

1.6.16Address1Sender address
yes
1.6.16.1StreetReceiver's street. If possible, do not specify prefixes of values, such as
“st.”.
string(50)yes
1.6.16.2HouseReceiver's house, building, block. If possible, do not specify prefixes of values, such as “house”string(30)yes
1.6.16.3FlatReceiver's flat/office. If possible, do not specify prefixes of values, such as “flat”.string(10)yes

...

  • By unique city code (City ID) in CDEK’s database. City IDs in CDEK’s database can be found in lists of cities in the documents package (https://cdek.ru/storage/source/document/1/CDEK_city. zip). The values are represented in SendCityCode, RecCityCode attributes.

  • By the city’s postcode. The values are represented in SendCityPostCode, RecCityPostCode attributes. Along with the postcode, the country code (attributes SendCountryCode, RecCountryCode) and/or the city’s name (attributes SendCityName, RecCityName) can be used for specifying: the country code of the sought city should match with that described in the related attribute, and the transferred name of the city should be included in the name of the sought one. The city’s name can be in the client’s language (all localizations will be searched);

  • By address string which is formed by concatenating the following fields: SendCityName/RecCityName + Address.Street + Address.House.

...

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.

Status history can be obtained for orders created no earlier than 2020.

4.9.2. Response Format

The CDEK server will return a result in the form of XML:

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1StatusReportDocument title
yes
1.1DateFirstStart date and time of the period during which order statuses have changeddatetime/dateyes
1.2DateLastEnd date and time of the period during which order statuses have changeddatetime/dateyes
2OrderShipment (order)
yes
2.1ActNumberAcceptance certificate numberstring(30)yes
2.2NumberClient's shipment number. Order identifier in the IS of a CDEK client.string(30)yes
2.3DispatchNumberCDEK shipment number (assigned when orders are imported). Order identifier in the CDEK IS.integeryes
2.4DeliveryDateDelivery date:datetimeno
2.5RecipientNameRecipient at the time of delivery (filled only in the order status "Delivered")string(50)no
2.6ReturnDispatchNumberNumber of return shipment (order number under which the goods are returned to the online store in case of statuses “Not delivered”, “Delivered” – “Partial delivery”)integerno
2.7ReverseDispatchNumberReverse waybill number (number of the waybill in which the cargo is returned if there is an additional service #48 " REVERSE")integerno
2.8StatusCurrent order status
yes
2.8.1DateStatus date. Greenwich mean time indicateddatetimeyes
2.8.2CodeStatus code (for more details, see Appendix No. 5)integeryes
2.8.3DescriptionStatus namestring(100)yes
2.8.4CityCodeStatus change city, CDEK city code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK_city.zip)integeryes
2.8.5CityNameName of the status change citystring(100)yes
2.8.6State1Status change history
yes
2.8.6.1DateStatus datedatetimeyes
2.8.6.2CodeStatus code (for more details, see Appendix No. 5)integeryes
2.8.6.3DescriptionStatus namestring(100)yes
2.8.6.4CityCodeStatus change city, city code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK_city.zip)integeryes2.8.6.5 CDEK city codeintegeryes
2.8.6.5CityNameName of the status change citystring(100)yes
2.9ReasonCurrent additional status
yes
2.9.1DateAdditional status datedatetimeyes
2.9.2CodeAdditional status code (for more details, see Appendix No. 6)integerno
2.9.3DescriptionAdditional status namestring(100)no
2.10DelayReasonCurrent delay reason
yes
2.10.1DateDelay reason datedatetimeyes
2.10.2CodeDelay reason code (for more details, see Appendix No. 7)integerno
2.10.3DescriptionDelay reasonstring(50)no
2.10.4State1Delay reason history
yes
2.10.4.1DateDelay reason datedatetimeyes
2.10.4.2CodeDelay reason code (for more details, see Appendix No. 7)integerno
2.10.4.3DescriptionDelay reasonstring(50)no
2.11Package2Package
no
2.11.1NumberPackage number. Order identifier in the IS of еру CDEK client.string(20)yes
2.11.2

BarCode

Package barcode, package identifier

string(20)

yes

2.11.3Item2Items
yes
2.11.3.1WareKeyIdentifier/item number of the goods.string(20)yes
2.11.3.2MarkingMarking of itemstringno
2.11.3.3DelivAmountNumber of delivered items. Default value is equal to the number of items transferred for delivery.integeryes
2.11.3.4AmountQuantity of goods of the same type (pcs). The maximum number is 999.integeryes
2.12Attempt3Delivery time taken from the delivery schedule
no
2.12.1IDID number of a schedule from the online store's databaseintegeryes
2.12.2ScheduleCodeDelay reason code (for more details, see Appendix No. 7)integeryes
2.12.3ScheduleDescriptionDelay reasonstring(50)yes
2.13CallHistory of notification calls to the receiver
no
2.13.1.1CallGoodHistory of successful calls
no
2.13.1.1GoodSuccessful call
yes
2.13.1.1.1DateDate of a successful calldateyes
2.13.1.1.2DateDelivAgreed date of delivery/ pickupdateyes
2.13.2CallFailHistory of failed calls
no
2.13.2.1FailFailed call
yes
2.13.2.1.1DateDate of calldateyes
2.13.2.1.2ReasonCodeFailed call reason code (for more details, see Appendix No. 8)integeryes
2.13.2.1.3ReasonDescriptionReason for a failed callstring(255)yes
2.13.3CallDelayHistory of call reschedules
no
2.13.3.1DelayCall reschedule
yes
2.13.3.1.1DateDate of calldateyes
2.13.3.1.2DateNextDate to which call is rescheduleddateyes
3ReturnOrderReturn shipment
no
3.1ActNumberAcceptance certificate numberstring(30)yes
3.2NumberClient's shipment number. Order identifier in the IS of the CDEK client.string(30)yes
3.3DispatchNumberCDEK number of return order (assigned when the return order is agreed). Order identifier in the CDEK IS.integeryes
3.4DeliveryDateDelivery datedatetimeno
3.5RecipientNameRecipient at the time of deliverystring(50)no
3.6StatusCurrent order status
yes
3.6.1DateStatus datedatetimeyes
3.6.2CodeStatus code (for more details, see Appendix No. 5)integeryes
3.6.3DescriptionStatus namestring(100)yes
3.6.4CityCodeStatus change city, CDEK city code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK_city.zip)integeryes
3.6.5CityNameName of the status change citystring(100)yes
3.6.6State1Status change history
yes
3.6.6.1DateStatus datedatetimeyes
3.6.6.2CodeStatus code (for more details, see Appendix No. 5)integeryes
3.6.6.3DescriptionStatus namestring(100)yes
3.6.6.4CityCodeStatus change cityintegeryes
3.6.6.5CityNameName of the status change citystring(100)yes
3.7ReasonCurrent additional status
yes
3.7.1DateAdditional status datedatetimeyes
3.7.2CodeAdditional status code (for more details, see Appendix No. 6)integerno
3.7.3DescriptionAdditional status namestring(100)no
3.8DelayReasonCurrent delay reason
yes
3.8.1DateDelay reason datedatetimeyes
3.8.2CodeDelay reason code (for more details, see Appendix No. 7)integerno
3.8.3DescriptionDelay reasonstring(50)no

...

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1InfoReportDocument title
yes
1.1OrderShipment (order)
yes
1.1.1NumberClient's shipment number. Order identifier in the IS of the CDEK client.string(30)yes
1.1.2DateDate on which the order has been transferred to the CDEK databasedateyes
1.1.3DispatchNumberCDEK shipment number (assigned when orders are imported). Order identifier in the CDEK IS.integeryes
1.1.4TariffTypeCodeTariff code (for more details, see Appendix No. 1)integeryes
1.1.5WeightEstimated weight (in kilograms)floatyes
1.1.6DeliverySumCost of delivery, in the settlement currency. Default: rubles.floatyes
1.1.7DateLastChangeLast change date for cost of deliverydateno
1.1.8CashOnDelivCash-on-delivery amount to be collected from the receiver in the currency of the receiver's country. Default: rubles.floatno
1.1.9CashOnDelivFactCash-on-delivery amount collected from the receiver in the currency of the receiver's country (default: rubles), subject to possible partial delivery. Available only for orders with the status “Delivered”floatno
1.1.10CashOnDelivTypePayment type of cash-on-delivery. Possible values: cash, cashless. Tag missing if payment information has not gotstrong(10)no
1.1.11DeliveryModeDelivery mode code (for more details, see Appendix No. 1)integeryes
1.1.12PvzCodePickup code specified in order at the time of request, for the delivery mode “to warehouse”string(10)yes
1.1.13DeliveryVariantDelivery option: (COURIER – courier, PVZCDEK – CDEK pickup point, PVZCLIENT – partner’s pickup point)string(10)yes
2.13SendCitySender's city
yes
2.13.1CodeCity code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK_city.zip)city codeintegeryes
2.13.2PostCodePostal code of the citystring(6)yes
2.13.3NameCity namestring(50)yes
2.14RecCityReceiver's city
yes
2.14.1CodeCity code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK _ city .zip)codeintegeryes
2.14.2PostCodePostal code of the citystring(6)yes
2.14.3NameCity namestring(50)yes
2.15AddedServiceAdditional services for orders
no
2.15.1ServiceCodeAdditional service code (for more details, see Appendix No. 2)integeryes
2.15.2SumValue of service in the settlement currency, default: rubles.floatyes
2.16PackagePackage (all packages are sent with different Package tags)
yes
2.16.1NumberPackage numberstring(20)yes
2.16.2BarCodePackage barcode, package identifierstring(20)yes
2.16.3WeightTotal weight (in kilograms)integeryes
2.16.4VolumeWeightVolumetric weight (in kilograms), calculated by formula: SizeA*SizeB*SizeC/5,000integeryes
2.16.5SizeAPackage dimensions. Length (in centimeters)integeryes
2.16.6SizeBPackage dimensions. Width (in centimeters)integeryes
2.16.7SizeCPackage dimensions. Height (in centimeters)integeryes
2.16.8ItemItems (goods)
yes
2.16.8.1WareKeyIdentifier/item number of the goodsstring(50)yes
2.16.8.2MarkingMarking of itemstringno
2.16.8.3CommentName of the goods (may contain description of the goods: size, color)string(255)yes
2.16.8.4AmountQuantity of the goods transferred for deliveryintegeryes
2.16.8.5DelivAmountQuantity of items of the same type delivered (pcs)integeryes
2.16.8.6CostDeclared value of the goods (per item in the specified the contract currency)floatyes
2.16.8.7PaymentCash on delivery (per item in the recipient country currency)floatyes
2.16.8.8VATRateVAT rate included in the value of the goods (for more details, see Appendix No. 4)string(10)no
2.16.8.9VATSumVAT amount included in the value (payment) of the goods.floatno
2.16.8.10WeightWeight (per item, in kilograms)integeryes

...

Code Block
languagexml
firstline1
titleInfoRequest
<?xml version="1.0" encoding="utf-8"?>
<InfoRequest Date="2019-01-23T00:00:00" Account="0278f9e8004f6b08f37497001e804007" Secure="3e10b5b7d1da1dfa42cb70c329964ec2" ShowHistory="1" ShowReturnOrder="1">
	<Order DispatchNumber="1105256461"/>
</InfoRequest>

...

No.Tag/ attributeDescriptionType of fieldMandatory (yes/no)
1regionCodeExtRegion codeintegerno
2regionCodeRegion code in the CDEK ISintegerno
3regionFiasGuidRegion code according to the Federal Information Address SystemUUIDno
4pageNumber of the results page. Default value: 0integerno
5sizeLimitation on the number of results displayed. Default value: 1,000integeryes, if page is specified
6countryCodeCountry code in the format ISO 3166-1 alpha-2string(2)no
7cityNameCity namestringno
8cityCodeCity code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK _ city .zip)codeintegerno
9postcodePostal codestringno
10langLocalization. Default: “rus”.string(3)no

...

No.Tag/ attributeDescriptionType of fieldMandatory (yes/no)
1cityUuidEntity identifier in the CDEK ISUUIDyes
2cityNameCity namestring(255)yes
3cityCodeCity code from the CDEK base (https://cdek.ru/storage/source/document/1/CDEK_city.zip)city codeintegeryes
4regionRegion namestring(255)yes
6regionCodeExtRF region codeintegerno
7regionCodeRegion code in the CDEK ISintegerno
8subRegionName of region's districtstring(255)no
9countryCountry namestring(255)yes
10countryCodeCountry code in the format ISO 3166-1 alpha-2integeryes
11latitudeLatitudefloatno
12longitudeLongitudefloatno
13kladrCity code according to the Russian Classifier of Addressesstring(20)no
14fiasGuid Code of an address object according to the Russian Classifier of AddressesUUIDno
15regionFiasGuidRegion code according to the Federal Information Address SystemUUIDno
16paymentLimitCash-on-delivery amount limit, possible values:
1 – no limit;
0 – cash on delivery is not accepted;
positive value – the cash-on-delivery amount does not exceed this value.
floatyes
17timezoneCity timezonestringno

...

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1version

The version by used API - “1.0”.

stringyes
2authLogin1Client identifier (login)stringno
3secure1Keystringno
4dateExecute2

Planning date of shipment in the format “YYYY-ММ-DD”

dateno
5langLocalization of city name. Default: “rus”.string(3)no
6senderCountryCode3Sender country code in the ISO_3166-1_alpha-2 formatstring(2)no
7receiverCountryCode3Receiver country code in the ISO_3166-1_alpha-2 formatstring(2)no
8senderCityId3

Origin city code in accordance with city codes provided by CDEK (https://cdek.ru/storage/source/document/1/CDEK_city.zip)with CDEK city code

integeryes
9senderCity3Sender city namestringno
10senderCityPostCode3

Zip code of the origin city

integeryes
11receiverCityId3

Code of city of destination in accordance with city codes provided by CDEK (https://cdek.ru/storage/source/document/1/CDEK_city.zip)with CDEK city code

integeryes
12receiverCityPostCode3

City of destination zip code

integeryes
13receiverCity3Receiver city namestringno
14senderLongitude3Sender city longitudefloatno
15receiverLongitude3Receiver city longitudefloatno
16senderLatitude3Sender city latitudefloatno
17receiverLatitude3Receiver city latitudefloatno
18tariffId4Code of chosen tariff (for more details, see Appendix No. 1)integeryes
19tariffList4List of tariffs
yes
19.1priority

The specified priority

integeryes
19.2id

Tariff code (for more details, see Appendix No. 1)

integeryes
20modeId

Chosen delivery mode (for more details, see Appendix No. 1)

integerno
21goodsPackage dimensions
yes
21.1weightWeight (in kilograms)floatyes
21.2lengthLength (in centimeters)integeryes
21.3widthWidth (in centimeters)integeryes
21.4heightHeight (in centimeters)integeryes
22servicesList of additional service (for more details, see Appendix No. 2)
no
22.1idNumber identifier of additional serviceintegeryes
22.2param5Parameter of additional service if necessaryintegerno

...

  • by unique city code from the CDEK database (city ID). Values are transferred in senderCityId and receiverCityId attributes;
  • by postal code of the city. Values are transferred in senderCityPostCode and receiverCityPostCode attributes. Along with the postcode, the country code (attributes senderCountryCode, receiverCountryCode), the city’s name (attributes senderCity, receiverCity) and city longitude and city latitude (attributes senderLongitude, receiverLongitude, senderLatitude, receiverLatitude);
  • if putting both values then senderCityId/receiverCityId is taking, senderCityPostCode/receiverCityPostCode should be ignored.

...

5 For additional services 2, 24, 25 and 32, the parameter value is mandatory and must be passed in the request. For service 2 - insurance in param it is necessary to transfer the amount from which the insurance will be calculated (must be transferred in the currency of mutual settlements). Service 30 is only available for an on-line store contract, so the request must be passed the values of authLogin and secure. For services 24, 25 and , 32, 54-58, 61-73, 76 a quantity value is transmitted to param, for 74, 75 services a length value is transmitted.

4.13.1.2. Response Format

...

No.Tag / attribute
DescriptionType of fieldMandatory (yes/no)
1version

The version by used API - “1.0”.

stringyes
2authLogin1Client identifier (login)stringno
3secure1Keystringno
4dateExecute2

Planning date of shipment in the format “YYYY-ММ-DD”

dateno
5langLocalization of city name. Default: “rus”.string(3)no
6senderCountryCode3Sender country code in the ISO_3166-1_alpha-2 formatstring(2)no
7receiverCountryCode3Receiver country code in the ISO_3166-1_alpha-2 formatstring(2)no
8senderCityId3

Origin city code in accordance with city codes provided by CDEK (https://cdek.ru/storage/source/document/1/CDEK_city.zip)with CDEK city code

integeryes
9senderCityPostCode3

Zip code of the origin city

integeryes
10senderCity3Sender city namestringno
11receiverCityId3

Code of city of destination in accordance with city codes provided by CDEK (https://cdek.ru/storage/source/document/1/CDEK_city.zip)with CDEK city code

integeryes
12receiverCityPostCode3

City of destination zip code

integeryes
13receiverCity3Receiver city namestringno
14senderLongitude3Sender city longitudefloatno
15receiverLongitude3Receiver city longitudefloatno
16senderLatitude3Sender city latitudefloatno
17receiverLatitude3Receiver city latitudefloatno
18currencyThe currency in which you need to calculate shipping cost. Default - RUBstringno
19tariffId4Code of chosen tariff (for more details, see Appendix No. 1)integeryes
20tariffList4List of tariffs
yes
20.1id

Tariff code (for more details, see Appendix No. 1)

integeryes
21goodsPackage dimensions
yes
21.1weightWeight (in kilograms)floatyes
21.2lengthLength (in centimeters)integeryes
21.3widthWidth (in centimeters)integeryes
21.4heightHeight (in centimeters)integeryes
22servicesList of additional service (for more details, see Appendix No. 2)
no
22.1idNumber identifier of additional serviceintegeryes
22.2param5Parameter of additional service if necessaryintegerno

...

  • by unique city code from the CDEK database (city ID). Values are transferred in senderCityId and receiverCityId attributes;
  • by postal code of the city. Values are transferred in senderCityPostCode and receiverCityPostCode attributes. Along with the postcode, the country code (attributes senderCountryCodereceiverCountryCode), the city’s name (attributes senderCity, receiverCity) and city longitude and city latitude (attributes senderLongitude, receiverLongitude, senderLatitude, receiverLatitude);

...

While specifying the rates you should choose one tariff or the list of rates with priorities. If you specified tariffId and tariffList – tariffId will be chosen, the list will be ignored.

5 The locations in the list can be specified by the first option (using weight, length, width and height), the second (using weight and volume) and combining these options (one piece in first, another second, etc.). Shipping cost will be calculated based on the highest values of physical or volume weight.

...

 For additional services 2, 24, 25 and 32, the parameter value is mandatory and must be passed in the request. For service 2 - insurance in param it is necessary to transfer the amount from which the insurance will be calculated (must be transferred in the currency of mutual settlements). Service 30 is only available for an on-line store contract, so the request must be passed the values of authLogin and secure. For services 24, 25, 32, 54-58, 61-73, 76 a quantity value is transmitted to param, for 74, 75 services a length value is transmitted.


4.13.2.2. Response Format

If tariffId was transmitted in the request, then the response corresponds to that described in 4.14.1.2.
Otherwise the CDEK server will return a result:

...

Code Block
languagexml
firstline1
titleResponse
{
	"result":
	[
		{
			"tariffId":1,
			"status":true,
			"result":
				{
				"price":"1077",
				"deliveryPeriodMin":2,
				"deliveryPeriodMax":3,
				"tariffId":1,
				"priceByCurrency":1077,
				"currency":"RUB",
				"percentVAT":20,
				"services":
					[
						{
							"id":2,
							"title":"Insurance",
							"price":7.5,
							"rate":0.75
						}
					]
				}
			},
			{
				"tariffId":8,
				"status":false,
				"result":
					{
						"errors":
						{
							"code":3,
							"text":"Impossible to deliver to this area under given conditions"
						}
					}
			}
	]
}

Appendices

Appendix 1. CDEK Tariffs and Delivery Modes

Tariffs for Online Stores

...

Code

...

Tariff name

...

Delivery mode

...

Service

...

Description

...

					}
			}
	]
}


Appendices

Appendix 1. CDEK Tariffs and Delivery Modes

Tariffs for Online Stores

Code

Tariff name

Delivery mode

Weightlimit

Service

Description

7International express documents door–doordoor–door (D-D)up to 5 kgInternational expressExpress delivery for / from abroad of documents and letters.
8International express freight door–door door–door (D-D)up to 30 kgInternational expressExpress delivery to / from abroad of goods and parcels up to 30 kg.

136

Warehouse–warehouse parcel

warehouse–warehouse (W-W)

up to 30 kg




Parcel

Economy delivery of goods across Russia for e-commerce companies.

137

Warehouse–door parcel

warehouse–door (W-D)

138

Door–warehouse parcel

Door–warehouse (D-W)

139

Door–door parcel

door–door (D-D)

366

Parcel door-parcel terminal

door-parcel terminal (D-T)
368Parcel warehouse-parcel terminalwarehouse-parcel terminal (W-T)
178International express freight warehouse–warehousewarehouse–warehouse (W-W)up to 30 kgInternational expressExpress delivery to / from abroad of goods and parcels up to 30 kg.
179International express freight warehouse–doorwarehouse–door (W-D)
180International express freight door–warehousedoor–warehouse (D-W)
181International express documents warehouse–warehousewarehouse–warehouse (W-W)up to 5 kgInternational expressExpress delivery for / from abroad of documents and letters.
182International express documents warehouse–doorwarehouse–door (W-D)
183International express documents door–warehousedoor–warehouse (D-W)
231Economy door–door parceldoor–door (D-D)

up to 50 kg


Economy parcel


Economy delivery of goods by road/rail across Russia for e-commerce companies.

This tariff is applicable to directions from Moscow to CDEK offices located east of the Urals and in Crimea.


232Economy door–warehouse parceldoor–warehouse (D-W)

233

Economy warehouse–door parcel

warehouse–door (W-D)

234

Economy warehouse–warehouse parcel

warehouse–warehouse (W-W)

376Economic parcel door-parcel terminaldoor-parcel terminal (W-T)
378Economic parcel warehouse-parcel terminalwarehouse-parcel terminal (W-T)

291

CDEK Express warehouse-warehouse

warehouse–warehouse (W-W)


CDEK Express

Delivery of goods from abroad to Russia, Ukraine, Kazakhstan, Kyrgyzstan, Uzbekistan including customs clearance.

Two options of the service:

1) We pick up a cargo in a foreign country, import it to the RF, clear it through customs, and deliver it to the client

2) The client imports a cargo to Russia on its own. We clear it through Russian customs and deliver it to the client

293

CDEK Express door–door

door–door (D-D)

294

CDEK Express warehouse–door

warehouse–door (W-D)

295

CDEK Express door–warehouse

door–warehouse (D-W)

Chinese Express Tariffs

Code

Tariff name

Delivery mode

Weightlimit

Service

Description

243

Chinese Express

warehouse–warehouse (W-W)


Chinese Express

Delivery from China to Russia, Belarus and Kazakhstan. Cost of delivery is divided into intervals:

  • up to 200 g;

  • every additional 100 g up to 1 kg;

  • every additional kilogram in excess of 1 kg;

245

Chinese Express

door–door (D-D)


246

Chinese Express

warehouse–door (W-D)


247

Chinese Express

door–warehouse (D-W)

Regular Delivery Tariffs

CodeTariff nameDelivery modeWeight limitServiceDescription
1Express light door–doordoor–door (D-D)up to 30 kgExpressClassical express delivery of documents and cargoes up to 30 kg.
361Express lite door-parcel terminaldoor-parcel terminal (D-T)
363Express lite warehouse-parcel terminalwarehouse-parcel terminal (W-T)
3Super express up to 18 kgdoor–door (D-D)
Express deliveryExpress delivery of documents and cargoes “from hand to hand” across Russia by a certain hour.
5Economy express warehouse–warehousewarehouse–warehouse (W-W)
Economy deliveryCheap delivery of goods across Russia by rail and by road (longer delivery period).
10Express light warehouse-warehousewarehouse–warehouse (W-W)up to 30 kgExpressClassic Express delivery of documents and cargo within the Russian Federation, Belarus, Kazakhstan, Armenia, Kyrgyzstan and between these countries.
11Express light warehouse–doorwarehouse–door (W-D)up to 30 kgExpress
12Express light door–warehousedoor–warehouse (D-W)up to 30 kgExpress
15Express heavy warehouse-warehousewarehouse–warehouse (W-W)from 30 kgExpressClassic Express delivery within Russia, Belarus, Kazakhstan, Armenia, Kyrgyzstan and between these countries.
16Express heavy warehouse–doorwarehouse–door (W-D)from 30 kgExpress
17Express heavy door–warehousedoor–warehouse (D-W)from 30 kgExpress
18Express heavy door–doordoor–door (D-D)from 30 kgExpress
57Super express up to 9 a.m.door–door (D-D)up to 30 kgExpress deliveryExpress delivery of documents and cargoes “from hand to hand” across Russia by a certain hour (delivery within 1–2 days).
58Super express up to 10 a.m.door–door (D-D)up to
5
30 kg
International express
Express deliveryExpress delivery
for / from abroad
of documents and
letters
cargoes
“from hand to hand” across Russia by a certain hour (delivery within 1–2 days).
8
59
International express freight door–door
Super express up to 12 p.m.door–door (D-D)up to 30 kg
International express
Express deliveryExpress delivery
to / from abroad
of
goods and parcels up to 30 kg.

136

Warehouse–warehouse parcel

warehouse–warehouse (W-W
documents and cargoes “from hand to hand” across Russia by a certain hour (delivery within 1–2 days).
60Super express up to 14 p.m.door–door (D-D)up to 30 kg
Parcel
Express delivery
Economy
Express delivery of
goods across Russia for e-commerce companies.

137

Warehouse–door parcel

warehouse–door (W-D)

138

Door–warehouse parcel

Door–warehouse (D-W)

139

Door–door parcel
documents and cargoes “from hand to hand” across Russia by a certain hour (delivery within 1–2 days).
61Super express up to 16 p.m.door–door (D-D
)366

Parcel door-parcel terminal

door-parcel terminal (D-T)368Parcel warehouse-parcel terminalwarehouse-parcel terminal (W-T
)
178International express freight warehouse–warehousewarehouse–warehouse (W-W)
up to 30 kg
International express
Express deliveryExpress delivery
to / from abroad
of
goods and parcels up to 30 kg.179International express freight warehouse–doorwarehouse–door (W-D)180International express freight door–warehousedoor–warehouse (D-W)181International express documents 182International express documents warehouse–doorwarehouse–door (W-D)183International express documents door–warehousedoor–warehouse (D-W)231Economy door–door parcel
documents and cargoes “from hand to hand” across Russia by a certain hour (delivery within 1–2 days).
62Long-distance express warehouse–warehousewarehouse–warehouse (W-W)
up to 5 kgInternational expressExpress delivery for / from abroad of documents and letters.

Economy deliveryFast economy delivery of cargoes across Russia
63Long-distance super express warehouse-warehousewarehouse–warehouse (W-W)
Economy deliveryFast economy delivery of cargoes by a certain hour
118Economy express door–door door–door (D-D)

up to 50 kg


Economy
parcel
delivery
Economy
Low-cost delivery of goods
by road/rail across Russia for e-commerce companies.

This tariff is applicable to directions from Moscow to CDEK offices located east of the Urals and in Crimea.

232Economy door–warehouse parceldoor–warehouse (D-W)

233

Economy warehouse–door parcel
within the Russian Federation, Belarus, Kazakhstan, Armenia, Kyrgyzstan and between these countries, railway and road transport (delivery of goods with an increase in time).
119Economy express warehouse–doorwarehouse–door (W-D)
234

120Economy
warehouse–warehouse parcel
express door–warehouse
warehouse–warehouse
door–warehouse (
W

293

CDEK Express
D-W)
376Economic parcel door-parcel terminaldoor-parcel terminal (W-T)378Economic parcel warehouse-parcel terminalwarehouse-parcel terminal (W-T)

291

CDEK Express warehouse-warehouse

warehouse–warehouse (W-W)

CDEK Express

Delivery of goods from abroad to Russia, Ukraine, Kazakhstan, Kyrgyzstan, Uzbekistan including customs clearance.

Two options of the service:

1) We pick up a cargo in a foreign country, import it to the RF, clear it through customs, and deliver it to the client

2) The client imports a cargo to Russia on its own. We clear it through Russian customs and deliver it to the client


CDEK Express
121Main express door–doordoor–door (D-D)
Economy deliveryFast economical cargo delivery in Russia.
122Main express warehouse–doorwarehouse–door (W-D)
123Main express door–warehousedoor–warehouse (D-W)
124Main super express door–doordoor–door (D-D)

294


CDEK Express
Economy deliveryFast economical cargo delivery by a specific hour.
125Main super express warehouse–door warehouse–door (W-D)

295



Code

Tariff name

Delivery mode

Weightlimit

Service

Description

243

Chinese Express

warehouse–warehouse (W-W)

Chinese Express

Delivery from China to Russia, Belarus and Kazakhstan. Cost of delivery is divided into intervals:

  • up to 200 g;

  • every additional 100 g up to 1 kg;

  • every additional kilogram in excess of 1 kg;

245

Chinese Express

door–door (D-D)

246

Chinese Express
126Main super express door–warehousedoor–warehouse (D-W)

Chinese Express Tariffs



480Express door-doordoor–door (D-D)
ExpressClassic express delivery of documents and cargoes according to standard delivery times within the country (Russia, Belarus, Armenia, Kyrgyzstan, Kazakhstan). It also operates in directions between the countries of the customs community (Russia, Belarus, Armenia, Kyrgyzstan, Kazakhstan).
No weight limits
481Express door-warehousedoor–warehouse (D-W)
482Express warehouse-doorwarehouse–door (W-D)
247
483
Chinese
Express warehouse-warehouse
door–warehouse
warehouse–warehouse (
DCodeTariff nameDelivery modeWeight limitServiceDescription1Express light door–doordoor–door (D-D
W-W)

Regular Delivery Tariffs

485Express door-parcel terminaldoor-parcel teminal (D-PT)
486Express warehouse-parcel terminalwarehouse-parcel terminal (W-PT)
361Express lite door-parcel terminaldoor-parcel teminal (D-PT)up to 30 kgExpressClassical express delivery of documents and cargoes
up to 30 kg
across Russia.
361
363

Express lite

door

warehouse-parcel terminal

door
warehouse-parcel terminal (
D-T)363Express lite warehouse-parcel terminalwarehouse-parcel terminal (W-T)3Super express up to 18 kgdoor–door (D-D)Express deliveryExpress delivery of documents and cargoes “from hand to hand” across Russia by a certain hour.5Economy express warehouse–warehousewarehouse–warehouse (W-W)Economy deliveryCheap delivery of goods across Russia by rail and by road (longer delivery period).10Express light warehouse-warehousewarehouse–warehouse (W-W)up to 30 kgExpressClassic Express delivery of documents and cargo within the Russian Federation, Belarus, Kazakhstan, Armenia, Kyrgyzstan and between these countries.11Express light warehouse–doorwarehouse–door (W-D)up to 30 kgExpress12Express light door–warehousedoor–warehouse (D-W)up to 30 kgExpress15Express heavy warehouse-warehousewarehouse–warehouse (W-W)from 30 kgExpressClassic Express delivery within Russia, Belarus, Kazakhstan, Armenia, Kyrgyzstan and between these countries.16Express heavy warehouse–doorwarehouse–door (W-D)from 30 kgExpress17Express heavy door–warehousedoor–warehouse (D-W)from 30 kgExpress18Express heavy door–doordoor–door (D-D)from 30 kgExpress57Super express up to 9 a.m.door–door (D-D)up to 30 kgExpress deliveryExpress delivery of documents and cargoes “from hand to hand” across Russia by a certain hour (delivery within 1–2 days).58Super express up to 10 a.m.door–door (D-D)up to 30 kgExpress deliveryExpress delivery of documents and cargoes
“from hand to hand” across Russia by a certain hour (delivery within 1–2 days).59Super express up to 12 p.m.door–door (D-D)up to 30 kgExpress deliveryExpress delivery of documents and cargoes “from hand to hand” across Russia by a certain hour (delivery within 1–2 days).60Super express up to 14 p.m.door–door (D-D)up to 30 kgExpress deliveryExpress delivery of documents and cargoes “from hand to hand” across Russia by a certain hour (delivery within 1–2 days).61Super express up to 16 p.m.door–door (D-D)up to 30 kgExpress deliveryExpress delivery of documents and cargoes “from hand to hand” across Russia by a certain hour (delivery within 1–2 days).62Long-distance express warehouse–warehousewarehouse–warehouse (W-W)Economy deliveryFast economy delivery of cargoes across Russia63Long-distance super express warehouse-warehousewarehouse–warehouse (W-W)Economy deliveryFast economy delivery of cargoes by a certain hour118Economy express door–door door–door (D-D)Economy deliveryLow-cost delivery of goods within the Russian Federation, Belarus, Kazakhstan, Armenia, Kyrgyzstan and between these countries, railway and road transport (delivery of goods with an increase in time).119Economy express warehouse–doorwarehouse–door (W-D)120Economy express door–warehousedoor–warehouse (D-W)121Main express door–doordoor–door (D-D)Economy deliveryFast economical cargo delivery in Russia.122Main express warehouse–doorwarehouse–door (W-D)123Main express door–warehousedoor–warehouse (D-W)124Main super express door–doordoor–door (D-D)Economy deliveryFast economical cargo delivery by a specific hour.125Main super express warehouse–door warehouse–door (W-D)126Main super express door–warehousedoor–warehouse (D-W)

Delivery modes

...

Code

...

Name

...

Abbreviation

...

Description

...

1

...

door–door

...

D-D

...

The courier picks up a cargo from the sender and delivers it to the specified receiver's address.

...

2

...

door–warehouse

...

D-W

...

The courier picks up a cargo from the sender and delivers it to a warehouse. The receiver picks up the cargo in a pickup point on his/her own.

...

3

...

warehouse–door

...

W-D

...

The sender delivers a cargo to a warehouse on his/her own. Then the courier delivers the cargo to the specified receiver's address.

...

4

...

warehouse–warehouse

...

W-W

...

The sender delivers a cargo to a warehouse on his/her own. The receiver picks up the cargo in a pickup point on his/her own.

...

Info

it is possible to transmit in the calculator all the additional services listed below, except for the following: more than 15 minutes of waiting at the sender's office, warehouse storage, other, pickup in the sender's city, delivery in the receiver's city, default interest, crating, courier lising, special thermal conditions, agency comission

Service codeAddition to an orderParameterDescription2Permitted (only for delivery order)INSURANCE

Insurance coverage of a parcel. Extra insurance charge depends on the declared value of a shipment.

Note
titleNote

The service is charged automatically for all orders of the online store and cannot be added by the online store in the AddService tag.

3PermittedDELIVERY ON WEEKENDSCDEK can ship and deliver documents and cargoes on weekends and public holidays.
When documents or cargoes are shipped or delivered on weekends or public holidays, 300 rubles are added to the basic tariff.5Not permitted, charged automaticallyHEAVY CARGOHeavy cargoes are charged as follows:
if the weight of a package is from 75 to 200 kg, the tariff is increased by 18 rubles per kilogram;
if the weight of a package exceeds 200 kg, the tariff is increased by 25 rubles per kilogram.
The cost of delivery of heavy cargoes can be calculated on an individual basis.
Tariffs on these shipments will be calculated on an individual basis and promptly (within one business day) and may be significantly lower than our basic tariffs.6Not permitted, charged automaticallyOVERSIZED CARGOIn case of an oversized cargo one of whose sides exceeds 1.5 m, the tariff will be increased by 60 % (unless the cost of delivery is charged on the basis of volumetric weight).
In case of an oversized cargo one of whose sides exceeds 2.2 m, the tariff will be increased by 100 % (unless the cost of delivery is charged on the basis of volumetric weight).7PermittedDANGEROUS CARGOESIn addition to ordinary documents and cargoes, CDEK is ready to deliver dangerous cargoes (other than prohibited for delivery).
Due to a certain risk, the cost of delivery of hazardous goods is increased by 1.5 times.8Not permitted, charged automaticallyMORE THAN 15 MINUTES OF WAITING IN THE SENDER'S OFFICEA cargo must be prepared by the time of courier arrival.
According to CDEK rules, a courier can wait for a client to hand over or accept a cargo within 15 minutes.
If the waiting time exceeds 15 minutes, an extra fee of 170 roubles is charged.
Not permitted in the Parcel tariffs.9Not permitted, charged automaticallyMORE THAN 15 MINUTES OF WAITING IN THE RECEIVER'S OFFICE10Not permitted, charged automaticallyWAREHOUSE STORAGEOur company can store goods in its warehouse within the first 7 days FREE OF CHARGE.
Starting from the eighth day, the storage fee is charged as follows:
  • standard shipment (1 package with dimensions limited to 25*40*60 cm). Basic tariff: 15 rubles per package for 1 calendar day, including weekends and public holidays;
  • non-standard shipment (1 package with dimensions in excess of 25*40*60cm). Basic tariff: 30 rubles per package for 1 calendar day, including weekends and public holidays.
13Not permitted, to be charged by a CDEK employeeOTHERAdditional fee from the CDEK Credit Control Department.14Not permitted, charged automaticallyREMOTE AREAIf cargoes are picked up or delivered by a courier from a remote area of the city, an additional fee is charged.
You can get the effective list of remote areas from the Help Desk by phone 8-800-250-04-05 (toll free) or from CDEK managers in office of your city.15Not permitted, charged automaticallyREPEATED INVITATIONWhen a repeated courier invitation is required for a previously canceled order, or delivery / pickup have failed through the client's fault, an additional fee is charged.
This fee depends on the weight of shipment and cost of delivery in the city.16PermittedPICKUP IN THE SENDER'S CITYAdditional service that allows a cargo to be picked up in the sender's city, provided that the “from warehouse” delivery mode is chosen (not available for the Parcel tariffs)17PermittedDELIVERY IN THE RECEIVER'S CITYAdditional service that allows a cargo to be delivered in the receiver's city, provided that the “to warehouse” delivery mode is chosen (only for Long-distance and Long-distance super express tariffs)20Not permitted, to be charged by a CDEK employeeDEFAULT INTERESTAdditional fee from the CDEK Credit Control Department.23Not permitted, to be charged by a CDEK employeeCRATINGCDEK offers crating services to provide additional safety for your shipment. The cost of crating for each shipment is calculated on an individual basis. In other words, CDEK offers a customized package for your cargo.24PermittedPACKAGE 1The price of 310*215*280 mm box is 30 rubles (for cargoes up to 10 kg).25Available only through the personal account and the call centerPACKAGE 2The price of 430*310*28 0mm box is 45 rubles (for cargoes up to 15 kg).26Available only through the call centerCOURIER LEASINGWhen you need to deliver or accept documents to federal agencies, such as tax authorities, ministries, embassies, courts, supervision services etc., or waiting time for your orders exceeds one hour, our company is willing to provide a courier for you. Price of the service: 170 rubles per hour. Minimum time: 3 hours (510 rubles).27Available only through the personal account and the call centerSMS NOTIFICATIONCDEK offers the SMS notification service to each client.
A sender will be notified of date and time of delivery via SMS. Price of the service: 5 rubles30PermittedHOME FITTINGA courier delivers several items (clothing, footwear, etc.) to a buyer for fitting.32Not permitted, charged automatically depending on terms and conditions of the contractDOCUMENT SCANNINGTo confirm that your goods have been delivered, we can provide you with scanned documents signed by the receiver.
Price of the service: 50 rubles33Available only through the personal account and the call centerACCESS BY STAIRS

The service is provided if oversized and heavy cargoes (heavier than 10 kg) need to be lifted to a floor.
This service has two options: “Access by Stairs” and “Access by Elevator”.
The price of the “Access by Stairs” service (no elevator is available)
for cargoes up to and including 30 kg — 50rubles per floor
for 31-50 kg — 70 rubles per floor
for 51-100 kg — 100 rubles per floor
for 101-150 kg — 130 rubles per floor
for cargoes heavier than 150 kg — 150 rubles per floor

The price of the Access by Elevator service:
for cargoes up to and including 30 kg — 50 rubles
for 31-50 kg — 70 rubles
for 51-100 kg — 100 rubles
for 101-150 kg — 130 rubles
for cargoes heavier than 100 kg — 150 rubles.34Available only through the personal account and the call centerACCESS BY ELEVATOR35Not permitted, charged automaticallyNOTIFICATION CALLThe Notification Call service is a preliminary call to receivers by operators of the call center prior to delivery. Price of the service: 15 rubles per order.36PermittedPARTIAL DELIVERY

Upon delivery, a buyer may refuse to accept one or several items and purchase only part of his/her order.

Info
titleInformation

The service cannot be enabled if there’s only one item in the order.

37PermittedINSPECTION OF CONTENTSA buyer can inspect contents of his/her order before paying for it (opening a parcel).40Not permitted, charged automaticallySPECIAL THERMAL CONDITIONSDirections that support delivery with special thermal conditions: Kemerovo–Novokuznetsk, Novosibirsk–Krasnoyarsk, Novosibirsk–Kemerovo, Novosibirsk–Tomsk, Novosibirsk–Omsk, Novosibirsk–Barnaul, Barnaul–Gorno-Altaysk AND OPPOSITE DIRECTIONS!41Not permitted, charged automaticallyRETURN OF DOCUMENTSThe CDEK Delivery Service can return accompanying documents marked by the receiver, as well as return the goods to online stores and other sales outlets.42Not permitted, charged automaticallyAGENCY COMMISSIONOur company can collect money from clients for goods and cash services.48PermittedREVERSEA return delivery order from the receiver to the sender, for example, signed documents
W-PT)

Delivery modes

Code

Name

Abbreviation

Description

1

door–door

D-D

The courier picks up a cargo from the sender and delivers it to the specified receiver's address.

2

door–warehouse

D-W

The courier picks up a cargo from the sender and delivers it to a warehouse. The receiver picks up the cargo in a pickup point on his/her own.

3

warehouse–door

W-D

The sender delivers a cargo to a warehouse on his/her own. Then the courier delivers the cargo to the specified receiver's address.

4

warehouse–warehouse

W-W

The sender delivers a cargo to a warehouse on his/her own. The receiver picks up the cargo in a pickup point on his/her own.

6  door-parcel terminal  D-T  The courier picks up a cargo from the sender and delivers to the post terminal. The receiver picks up the cargo in out of terminal on his/her own.
7  warehouse-parcel terminal  W-T The sender delivers a cargo to a warehouse on his/her own. The courier delivers the parcel terminal. The receiver picks up the cargo in out of terminal on his/her own.


Appendix 2. Additional Services*

Info

it is possible to transmit in the calculator all the additional services listed below, except for the following: more than 15 minutes of waiting at the sender's office, warehouse storage, other, pickup in the sender's city, delivery in the receiver's city, default interest, crating, courier lising, special thermal conditions, agency comission


Service codeAddition to an orderParameterDescription
2Permitted (only for delivery order)INSURANCE

Insurance coverage of a parcel. Extra insurance charge depends on the declared value of a shipment.

Note
titleNote

The service is charged automatically for all orders of the online store and cannot be added by the online store in the AddService tag.


3PermittedDELIVERY ON WEEKENDSCDEK can ship and deliver documents and cargoes on weekends and public holidays.
When documents or cargoes are shipped or delivered on weekends or public holidays, 300 rubles are added to the basic tariff.
5Not permitted, charged automaticallyHEAVY CARGOHeavy cargoes are charged as follows:
if the weight of a package is from 75 to 200 kg, the tariff is increased by 18 rubles per kilogram;
if the weight of a package exceeds 200 kg, the tariff is increased by 25 rubles per kilogram.
The cost of delivery of heavy cargoes can be calculated on an individual basis.
Tariffs on these shipments will be calculated on an individual basis and promptly (within one business day) and may be significantly lower than our basic tariffs.
6Not permitted, charged automaticallyOVERSIZED CARGOIn case of an oversized cargo one of whose sides exceeds 1.5 m, the tariff will be increased by 60 % (unless the cost of delivery is charged on the basis of volumetric weight).
In case of an oversized cargo one of whose sides exceeds 2.2 m, the tariff will be increased by 100 % (unless the cost of delivery is charged on the basis of volumetric weight).
7PermittedDANGEROUS CARGOESIn addition to ordinary documents and cargoes, CDEK is ready to deliver dangerous cargoes (other than prohibited for delivery).
Due to a certain risk, the cost of delivery of hazardous goods is increased by 1.5 times.
8Not permitted, charged automaticallyMORE THAN 15 MINUTES OF WAITING IN THE SENDER'S OFFICEA cargo must be prepared by the time of courier arrival.
According to CDEK rules, a courier can wait for a client to hand over or accept a cargo within 15 minutes.
If the waiting time exceeds 15 minutes, an extra fee of 170 roubles is charged.
Not permitted in the Parcel tariffs.
9Not permitted, charged automaticallyMORE THAN 15 MINUTES OF WAITING IN THE RECEIVER'S OFFICE
10Not permitted, charged automaticallyWAREHOUSE STORAGEOur company can store goods in its warehouse within the first 7 days FREE OF CHARGE.
Starting from the eighth day, the storage fee is charged as follows:
  • standard shipment (1 package with dimensions limited to 25*40*60 cm). Basic tariff: 15 rubles per package for 1 calendar day, including weekends and public holidays;
  • non-standard shipment (1 package with dimensions in excess of 25*40*60cm). Basic tariff: 30 rubles per package for 1 calendar day, including weekends and public holidays.
13Not permitted, to be charged by a CDEK employeeOTHERAdditional fee from the CDEK Credit Control Department.
14Not permitted, charged automaticallyREMOTE AREAIf cargoes are picked up or delivered by a courier from a remote area of the city, an additional fee is charged.
You can get the effective list of remote areas from the Help Desk by phone 8-800-250-04-05 (toll free) or from CDEK managers in office of your city.
15Not permitted, charged automaticallyREPEATED INVITATIONWhen a repeated courier invitation is required for a previously canceled order, or delivery / pickup have failed through the client's fault, an additional fee is charged.
This fee depends on the weight of shipment and cost of delivery in the city.
16PermittedPICKUP IN THE SENDER'S CITYAdditional service that allows a cargo to be picked up in the sender's city, provided that the “from warehouse” delivery mode is chosen (not available for the Parcel tariffs)
17PermittedDELIVERY IN THE RECEIVER'S CITYAdditional service that allows a cargo to be delivered in the receiver's city, provided that the “to warehouse” delivery mode is chosen (only for Long-distance and Long-distance super express tariffs)
20Not permitted, to be charged by a CDEK employeeDEFAULT INTERESTAdditional fee from the CDEK Credit Control Department.
23Not permitted, to be charged by a CDEK employeeCRATINGCDEK offers crating services to provide additional safety for your shipment. The cost of crating for each shipment is calculated on an individual basis. In other words, CDEK offers a customized package for your cargo.
24PermittedPACKAGE 1The price of 310*215*280 mm box is 30 rubles (for cargoes up to 10 kg).
25Available only through the personal account and the call centerPACKAGE 2The price of 430*310*28 0mm box is 45 rubles (for cargoes up to 15 kg).
26Available only through the call centerCOURIER LEASINGWhen you need to deliver or accept documents to federal agencies, such as tax authorities, ministries, embassies, courts, supervision services etc., or waiting time for your orders exceeds one hour, our company is willing to provide a courier for you. Price of the service: 170 rubles per hour. Minimum time: 3 hours (510 rubles).
27Available only through the personal account and the call centerSMS NOTIFICATIONCDEK offers the SMS notification service to each client.
A sender will be notified of date and time of delivery via SMS. Price of the service: 5 rubles
30PermittedHOME FITTINGA courier delivers several items (clothing, footwear, etc.) to a buyer for fitting.
32Not permitted, charged automatically depending on terms and conditions of the contractDOCUMENT SCANNINGTo confirm that your goods have been delivered, we can provide you with scanned documents signed by the receiver.
Price of the service: 50 rubles
33Available only through the personal account and the call centerACCESS BY STAIRS

The service is provided if oversized and heavy cargoes (heavier than 10 kg) need to be lifted to a floor.
This service has two options: “Access by Stairs” and “Access by Elevator”.
The price of the “Access by Stairs” service (no elevator is available)
for cargoes up to and including 30 kg — 50rubles per floor
for 31-50 kg — 70 rubles per floor
for 51-100 kg — 100 rubles per floor
for 101-150 kg — 130 rubles per floor
for cargoes heavier than 150 kg — 150 rubles per floor


The price of the Access by Elevator service:
for cargoes up to and including 30 kg — 50 rubles
for 31-50 kg — 70 rubles
for 51-100 kg — 100 rubles
for 101-150 kg — 130 rubles
for cargoes heavier than 100 kg — 150 rubles.

34Available only through the personal account and the call centerACCESS BY ELEVATOR
35Not permitted, charged automaticallyNOTIFICATION CALLThe Notification Call service is a preliminary call to receivers by operators of the call center prior to delivery. Price of the service: 15 rubles per order.
36PermittedPARTIAL DELIVERY

Upon delivery, a buyer may refuse to accept one or several items and purchase only part of his/her order.

Info
titleInformation

The service cannot be enabled if there’s only one item in the order.


37PermittedINSPECTION OF CONTENTSA buyer can inspect contents of his/her order before paying for it (opening a parcel).
40Not permitted, charged automaticallySPECIAL THERMAL CONDITIONSDirections that support delivery with special thermal conditions: Kemerovo–Novokuznetsk, Novosibirsk–Krasnoyarsk, Novosibirsk–Kemerovo, Novosibirsk–Tomsk, Novosibirsk–Omsk, Novosibirsk–Barnaul, Barnaul–Gorno-Altaysk AND OPPOSITE DIRECTIONS!
41Not permitted, charged automaticallyRETURN OF DOCUMENTSThe CDEK Delivery Service can return accompanying documents marked by the receiver, as well as return the goods to online stores and other sales outlets.
42Not permitted, charged automaticallyAGENCY COMMISSIONOur company can collect money from clients for goods and cash services.
48PermittedREVERSEA return delivery order from the receiver to the sender, for example, signed documents.
54PermittedCOURIER PACKAG A2The price 50 rubles
55PermittedSECURE PACKAGE A2The price 30 rubles
56PermittedSECURE PACKAGE A3The price 20 rubles
57PermittedSECURE PACKAGE A4The price 15 rubles
58PermittedSECURE PACKAGE A5The price 15 rubles
59PermittedNOTIFY ORDER CREATEDUsed when creating an order.
Recipient countries: Russia, Kazakhstan, Belarus
60PermittedNOTIFY ORDER DELIVERYUsed when creating an order.
Recipient countries: Russia, Kazakhstan, Belarus
61PermittedBox XS (0.5 kg 17x12x9 cm)A box made of three-layer corrugated cardboard with dimensions 170 * 125 * 95 mm. The maximum capacity is 0.5 kg.
The cost of 1 piece is 20 rubles.
Available for all tariffs from the warehouse.
62PermittedBox S (2 kg 21x20x11 cm)A box made of three-layer corrugated cardboard with dimensions of 216 * 200 * 110 mm. The maximum capacity is 2 kg.
The cost of 1 piece is 40 rubles.
Available for all tariffs from the warehouse.
63PermittedBox M (5 kg 33x25x15 cm)A box made of three-layer corrugated cardboard with a size of 330 * 250 * 155 mm. The maximum capacity is 5 kg.
The cost of 1 piece is 60 rubles.
Available for all tariffs from the warehouse.
64PermittedBox L (12 kg 34x33x26 cm)A box made of three-layer corrugated cardboard measuring 340 * 330 * 264 mm. The maximum capacity is 12 kg.
The cost of 1 piece is 70 rubles.
Available for all tariffs from the warehouse.
65PermittedBox (0.5 kg 17x12x10 cm)A box made of three-layer corrugated cardboard with dimensions 170 * 120 * 100 mm. The maximum capacity is 0.5 kg.
The cost of 1 piece is 20 rubles.
Available for all tariffs from the warehouse.
66PermittedBox (1 kg 24x17x10 cm)A box made of three-layer corrugated cardboard with dimensions of 240 * 170 * 100 mm. The maximum capacity is 1 kg.
The cost of 1 piece is 30 rubles.
Available for all tariffs from the warehouse.
67PermittedBox (2 kg 34x24x10 cm)A box made of three-layer corrugated cardboard measuring 340 * 240 * 100 mm. The maximum capacity is 2 kg.
The cost of 1 piece is 40 rubles.
Available for all tariffs from the warehouse.
68PermittedBox (3 kg 24x24x21 cm)A box made of three-layer corrugated cardboard with dimensions of 240 * 240 * 210 mm. The maximum capacity is 3 kg.
The cost of 1 piece is 50 rubles.
Available for all tariffs from the warehouse.
69PermittedBox (5 kg 40x24x21 cm)A box made of three-layer corrugated cardboard measuring 400 * 240 * 210 mm. The maximum capacity is 5 kg.
The cost of 1 piece is 60 rubles.
Available for all tariffs from the warehouse.
70PermittedBox (10 kg 40x35x28 cm)A box made of three-layer corrugated cardboard measuring 400 * 350 * 280 mm. The maximum capacity is 10 kg.
The cost of 1 piece is 70 rubles.
Available for all tariffs from the warehouse.
71PermittedBox (15 kg 60x35x29 cm)A box made of three-layer corrugated cardboard with dimensions of 600 * 350 * 290 mm. The maximum capacity is 15 kg.
The cost of 1 piece is 100 rubles.
Available for all tariffs from the warehouse (except for the "warehouse-parcel terminal" mode).
72PermittedBox (20 kg 47x40x43 cm)A box made of three-layer corrugated cardboard with a size of 470 * 400 * 430 mm. The maximum capacity is 20 kg.
The cost of 1 piece is 120 rubles.
Available for all tariffs from the warehouse (except for the "warehouse-parcel terminal" mode).
73PermittedBox (30 kg 69x39x42 cm)A box made of three-layer corrugated cardboard with dimensions of 690 * 390 * 420 mm. The maximum capacity is 30 kg.
The cost of 1 piece is 140 rubles.
Available for all tariffs from the warehouse (except for the "warehouse-parcel terminal" mode).
74PermittedBubble wrapHigh pressure polyethylene, two layers. It is an additional packaging material for packing shipments into transport packaging.
1 meter - 30 rubles.
Available for all tariffs from the warehouse.
75PermittedWaste paperWrapping paper (waste paper, class E). Width 0.42 m.Designed for packing various types of shipments (cargo) and filling voids inside the package
1 meter - 15 rubles.
Available for all tariffs from the warehouse.
76PermittedFiller pressed cardboard (55x14x2.3 cm)Protective insert made of sheet compressed cardboard. It is applied for:
- inner lathing inside the corrugated box
- wrapping and separating attachments inside the corrugated box
- filling voids.
The cost of 1 piece is 20 rubles.
Available for all tariffs from the warehouse.

* Prices of services may be outdated. Please, find the latest information on our official website.

...