Page tree

Versions Compared

Key

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

...


Table of Contents

Revision History

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".

Introduction

General Description

...

1.3. Data Formats and Coding

Units:

ParameterUnitSymbolNumber of digits (mandatory)
Weightkilogramkgthree digits
Weightgramg
Length of sidescentimetercm
Currency

two digits
Quantitypiecepcs
Latitude, longitudedecimal degreesºfour digits


Type of data:

Float — floating-point number. A dot, rather than a comma, is used as a decimal separator.

...

The online store is identified with two parameters:

ParameterDescription
AccountContractor identifier (login)
SecureKey generated through encryption according to the algorithm described above

To ensure the security of data transfer/request, the online store must transmit a value of the secure field, calculated according to the algorithm:

...

In order to facilitate the integration process, CDEK will provide separate test accounts for each client/contract:

TypeParameterValue
Online-storeAccountz9GRRu7FxmO53CQ9cFfI6qiy32wpfTkd
Secure passwordw24JTCv4MnAcuRTx0oHjHLDtyt3I6IBq
DeliveryAccount7JM7K5twfzEV1ssCRklthcIPbbVZrZrZ
Secure passwordt8XBoL1rUofIK9dKoXVB3Tji2F2hPHSk


Note
titleNote

In the test mode, the client’s orders are not displayed in his/her account on the website https://lk.cdek.ru/user/login.

...

3.1. Basic URL of the Interface

3.2. List of API Methods

No.

Method

Link (production)

Link (test)

1

Loading the list of pickup points

https://integration.cdek.ru/pvzlist/v1/xml

https://integration.edu.cdek.ru/pvzlist/v1/xml

2

Order registration


2.1

Order from the online store

https://integration.cdek.ru/new_orders.php

https://integration.edu.cdek.ru/new_orders.php

2.2

Delivery order

https://integration.cdek.ru/addDelivery

https://integration.cdek.ru/addDeliveryRaw (for transferring the content in the request body)

https://integration.edu.cdek.ru/addDelivery

https://integration.edu.cdek.ru/addDeliveryRaw (for transferring the content in the request body)

3

Order change

http://integration.cdek.ru/update

http://integration.cdek.ru/updateRaw (for transferring the content in the request body)

http://integration.edu.cdek.ru/update

http://integration.edu.cdek.ru/updateRaw (for transferring the content in the request body)

4

Order deletion

https://integration.cdek.ru/delete_orders.php

https://integration.edu.cdek.ru/delete_orders.php

5

Printing an order receipt

https://integration.cdek.ru/orders_print.php

https://integration.edu.cdek.ru/orders_print.php

6

Registration of a courier invitation

https://integration.cdek.ru/call_courier.php

https://integration.edu.cdek.ru/call_courier.php

7

Recording of notification call results

https://integration.cdek.ru/new_schedule.php

https://integration.edu.cdek.ru/new_schedule.php

8

Printing a package barcode

https://integration.cdek.ru/ordersPackagesPrint

https://integration.cdek.ru/ordersPackagesPrintRaw (for transferring the content in the request body)

https://integration.edu.cdek.ru/ordersPackagesPrint

https://integration.edu.cdek.ru/ordersPackagesPrintRaw (for transferring the content in the request body)

9

Creation of a pre-alert document

https://integration.cdek.ru/addPreAlertPrint

https://integration.cdek.ru/addPreAlertRaw (for transferring the content in the request body)

https://integration.edu.cdek.ru/addPreAlert

https://integration.edu.cdek.ru/addPreAlertRaw (for transferring the content in the request body)

10

Order Status Report

https://integration.cdek.ru/ status_report_h.php

https://integration.edu.cdek.ru/status_report_h.php

11

Order Information Report

https://integration.cdek.ru/info_report.php

https://integration.edu.cdek.ru/info_report.php

12

List of Regions

https://integration.cdek.ru/v1/location/regions?

https://integration.edu.cdek.ru/v1/location/regions?

13

List of Cities

https://integration.cdek.ru/v1/location/cities?

https://integration.edu.cdek.ru/v1/location/cities?
14Cost calculation on tarrifs with priorityhttp://api.cdek.ru/calculator/calculate_price_by_json.phphttp://api.edu.cdek.ru/calculator/calculate_price_by_json.php
15Cost calculation on tariffs without priorityhttp://api.cdek.ru/calculator/calculate_tarifflist.phphttp://api.edu.cdek.ru/calculator/calculate_tarifflist.php

3.3. Translation of integration errors

...

In order to load the list of pickup points, it is necessary to send a GET request with the following parameters:

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 (see the file “City_XXX_YYYYMMDD.xls”)integerno
3typeType of pickup point, possible values:
“PVZ” – display only CDEK warehouses;
“POSTOMAT” – display only partner's parcel terminals;
“ALL” – display all pickup points, irrespective of their type.
If no value is defined, “PVZ” 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
8allowedcodCash on delivery is permitted, possible values:
“1”, “true” – yes;
“0”, “false” – no.
booleanno
9isdressingroomAvailability of a fitting room, possible values:
“1”, “true” – available;
“0”, “false” – not available.
booleanno
10weightmaxThe maximum weight that can be accepted by a pickup point (values of more than 0 – load pickup points that accept this weight; 0 – load all pickup points; no value defined – pickup points with zero weight are not loaded).integerno
11langLocalization of pickup points. Default: “rus”.string(3)no
12takeonlyWhether the pickup point is only a pickup point, possible values:
“1”, “true” – yes;
“0”, “false” – no.
booleanno

1 If both parameters cityid and citypostcode are indicated, the system gives priority to cityid to determine a city among all countries in which CDEK is present.

...

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

1.1.18

Тэг/Атрибут

Описание

Тип поля

Обяз.

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 (see the file“City_XXX_YYYYMMDD.xls”)integeryes
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
qqIdNumber of QQ (for China)

string(10)

yes

Note

Pickup points note

string(255)

yes

1.1.
19
18coordXCoordinates of location (longitude) in degreesfloatyes
1.1.
20
19coordYCoordinates of location (latitude) in degreesfloatyes
1.1.
21
20

Type

Pickup point type: PVZ — CDEK warehouse, POSTOMAT — CDEK partner's postamat

string(8)

yes

1.1.
22
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.
23
22IsDressingRoomAvailability of a fitting roomstring(4)yes
1.1.
24
23

HaveCashless

Availability of payment terminal

string(4)yes
1.1.
25
24AllowedCodCash on delivery is permitted in a pickup pointstring(4)yes
1.1.
26
25NearestStationNearest station/public transport stopstring(50)yes
1.1.
27
26MetroStationNearest metro stationstring(50)yes
1.1.
28
27SitePickup point's website on the CDEK pagestring(255)yes
1.1.
29
28OfficeImageAll photos of the office (except for a photo showing how to get to it)
yes

1.1.

29

28.1

url

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

string(255)

yes

1.1.

30

29

WorkTimeYOpening hours for every day
yes

1.1.

30

29.1

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

1.1.

30

29.2

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

1.1.

31

30

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

1.1.

31

30.1

.

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

1.1.

31

30.2

.

WeightMaxMaximum weight (in kg) accepted by a pickup point (<=WeightMax)floatyes


Example. List of pickup points

...

Registration of a Request from the Online Store

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 document, default value: 1.integeryes
1.6Currency

Currency identifier for prices, RUB is a default parameter. Only for international orders

string(10)no
1.7OrderShipment (order)
yes
1.7.1NumberClient shipment number (unique for orders of a particular client). Order identifier in the Client's IS.string(40)yes
1.7.2SendCityCode1Sender's city code from the CDEK base (see the file “City_XXX_YYYYMMDD.xls”)integeryes
1.7.3RecCityCode1Receiver's city code from the CDEK base (see the file “City_XXX_YYYYMMDD.xls”)integeryes
1.7.4SendCityPostCode1Postal code of the sender's citystring(6)yes
1.7.5RecCityPostCoDe1Postal code of the receiver's citystring(6)yes
1.7.6SendCountryCode1Sender's country code to identify a country by postal code. Default value: RUstring(2)no
1.7.7RecCountryCode1Receiver's country code to identify a country by postal code. Default value: RUstring(2)no
1.7.8SendCityName1Name of sender's citystring(255)no
1.7.9RecCityName1Name of receiver's citystring(255)no
1.7.10RecipientINN

TIN of the receiver. Only for international orders.

string(12)no
1.7.11DateInvoice

Invoice date. Only for international orders.

Date time/dateyes, if order is international
1.7.12ShipperName

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

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

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

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

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


no
1.7.14.1Series

Series of the receiver’s passport.

string (255)no
1.7.14.2Number

Number of the receiver’s passport.

string (255)no
1.7.14.3IssueDate

Date of issue of the receiver’s passport.

Date time/dateno
1.7.14.4IssuedBy

Issuing authority of the receiver’s passport.

string (255)no
1.7.14.5DateBirth

The receiver’s birthdate

Date time/dateno
1.7.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.7.15.1CompanyName of sender's companystring(128)no
1.7.15.2NameSender's contact personstring(128)no
1.7.15.3Address1Address of pickup
no
1.7.15.3.1StreetStreetstring(50)yes
1.7.15.3.2HouseHousestring(30)yes
1.7.15.3.3FlatFlat/officestring(10)no
1.7.15.4PhoneSender's phonephoneno
1.7.16RecipientNameReceiver (full name). At least 3 characters.string(128)yes
1.7.17RecipientEmailReceiver's email for sending order status notifications and contacting in case of failed callsemailno
1.7.18PhoneReceiver's phonephoneyes
1.7.19TariffTypeCodeCode of tariff type (for more details, see Appendix No. 1)integeryes
1.7.20DeliveryRecipientCost2Extra delivery charge collected by the online store from the receiver (in the specified currency)floatno
1.7.21DeliveryRecipientVATRateVAT rate included in the extra delivery charge (for more details, see Appendix No. 4)string(10)no
1.7.22DeliveryRecipientVATSumVAT amount included in the extra delivery chargefloatno
1.7.23RecipientCurrency3Code of cash-on-delivery currency: extra delivery charge and payment for the goods to be collected from the receiver. The currency is considered to be a currency of the receiver's country (for details, see Appendix No. 3)string(10)no
1.7.24ItemsCurrencyCode of declared value currency (all items in the order). Currency of settlements with the CDEK client under contract.string(10)no
1.7.25SellerRequisites of the real seller
no
1.7.25.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.7.25.2NameReal sellerstring (255)yes, if ITN is indicated
1.7.25.3INNITN (Individual Taxpayer Number) of the real sellerstring (20)no
1.7.25.4PhoneTelephone of the real sellerphoneyes, if ITN is indicated
1.7.25.5OwnershipFormCode of type ownership (for more details, see Appendix No. 10)integeryes, if ITN is indicated
1.7.26Comment4Comments (special notes on the order)string(255)no
1.7.27Address1Delivery 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.7.27.1StreetReceiver's street. If possible, do not specify prefixes of values, such as “st.”string(50)yes
1.7.27.2HouseReceiver's house, building, block. If possible, do not specify prefixes of values, such as “house”.string(30)yes
1.7.27.3FlatReceiver's flat/office. If possible, do not specify prefixes of values, such as “flat”.string(10)no
1.7.27.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).
If the specified pickup point is closed at the time of order creation, the order will be accepted for the nearest functioning pickup point. 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
1.7.28PackagePackage (all packages are sent with different Package tags)
yes
1.7.28.1NumberPackage number (ordinal package number or order number can be used), unique for this order. Order identifier in the Client's IS.string(20)yes
1.7.28.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.7.28.3WeightTotal weight (in grams)integeryes
1.7.28.4SizeA5Package dimensions. Length (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
1.7.28.5SizeB5Package dimensions. Width (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
1.7.28.6SizeC5Package dimensions. Height (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
1.7.28.7ItemItems (goods)
yes
1.7.28.7.1AmountQuantity of goods of the same type (pcs).
The maximum number is 999.
Integeryes
1.7.28.7.2WareKeyIdentifier/item number of the goods.string(50)yes
1.7.28.7.3MarkingMarking of item.
If marking is indicated for Item, the Amount parametr can't be greater than 1.
stringno
1.7.28.7.4CostDeclared value of the goods (per item in the specified currency, value >=0). This value is used to calculate the amount of insurance.floatyes
1.7.28.7.5PaymentCash on delivery (per item in the specified currency, value >=0) — cash on delivery; in case of prepayment, value = 0.floatyes
1.7.28.7.6PaymentVATRateVAT rate included in the value of the goods (for more details, see the Appendix 4)string(10)no
1.7.28.7.7PaymentVATSumVAT amount included in the value (payment) of the goods.floatno
1.7.28.7.8WeightWeight (per item, in grams)integeryes
1.7.28.7.9CommentName of the goods (may contain description of the goods: size, color)string(255)yes
1.7.28.7.10WeightBrutto

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

integeryes, if order is international
1.7.28.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.7.28.7.12Link

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

string(255)no
1.7.29DeliveryRecipientCostAdv

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


no
1.7.29.1Threshold

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

integeryes
1.7.29.2Sum

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

floatyes
1.7.29.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.7.29.4VATSum

VAT sum included in the additional charge for delivery

floatno
1.7.30AddServiceAdditional services
no
1.7.30.1ServiceCodeType of additional service (for more details, see Appendix No. 2)integeryes
1.7.30.2CountNumber of packages. It is used and is mandatory only for the additional service "Package 1".integerno
1.7.31Schedule7

Schedule for delivery /pickup


no
1.7.31.1Attempt

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


yes
1.7.31.1.1ID

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

integeryes
1.7.31.1.2Date

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

dateyes
1.7.31.1.3CommentCommentstring(255)no
1.7.31.1.4TimeBeg

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

timeyes
1.7.31.1.5TimeEnd

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

timeyes
1.7.31.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.7.31.1.6.1Street

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

string(50)yes
1.7.31.1.6.2House

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

string(30)yes
1.7.31.1.6.3Flat

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

string(10)no
1.7.31.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.8CallCourier8Call courier
no
1.8.1Call

Waiting for a courier


yes
1.8.1.1Date

Date of courier waiting

dateyes
1.8.1.2TimeBeg

Start time of courier waiting

timeyes
1.8.1.3TimeEnd

End time of courier waiting

timeyes
1.8.1.4LunchBeg

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

timeno
1.8.1.5LunchEnd

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

timeno
1.8.1.6SendCityCode1

Sender's city code from the CDEK base (see the file “City_XXX_YYYYMMDD.xls”)

integeryes
1.8.1.7SendCityPostCode1

Postal code of the sender's city

string(6)yes
1.8.1.8SendCountryCode1

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

string(2)no
1.8.1.9SendCityName1

Name of sender's city

string(255)no
1.8.1.10SendPhone

Sender's contact phone

phoneyes
1.8.1.11SenderName

Sender (full name)

string(255)yes
1.8.1.12CommentComment for courierstring(255)no
1.8.1.13SendAddressSender's address
yes
1.8.1.13.1Street

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

string(50)yes
1.8.1.13.2House

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

string(30)yes
1.8.1.13.3Flat

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

string(10)yes


Registration of a Delivery Order

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 document, default value: 1.integeryes
1.6OrderShipment (order)
yes
1.6.1ClientSide6Client type: sender, receiver, third person. Possible values: “sender”, “receiver”, “other” (third party)string(10)yes
1.6.2NumberClient shipment number (unique for orders of a particular client). Order identifier in the Client's IS.string(40)yes
1.6.3SendCityCode1Sender's city code from the CDEK base (see the file“City_XXX_YYYYMMDD.xls”)Integeryes
1.6.4RecCityCode1Receiver's city code from the CDEK base (see the file “City_XXX_YYYYMMDD.xls”)Integeryes
1.6.5SendCityPostCode1Postal code of the sender's citystring(6)yes
1.6.6RecCityPostCode1Postal code of the receiver's citystring(6)yes
1.6.7SendCountryCode1Sender's country code to identify a country by postal code. Default value: RUstring(2)no
1.6.8RecCountryCode1Receiver's country code to identify a country by postal code. Default value: RUstring(2)no
1.6.9SendCityName1Name of sender's citystring(255)no
1.6.10RecCityName1Name of receiver's citystring(255)no
1.6.11SenderSender
no
1.6.11.1Company6Name of sender's companystring(128)no
1.6.11.2NameSender's contact personstring(128)no
1.6.11.3Address1Address of pickup
no
1.6.11.3.1StreetStreetstring(50)yes
1.6.11.3.2HouseHousestring(30)yes
1.6.11.3.3FlatFlat/officestring(10)no
1.6.11.4PhoneSender's phonephoneyes
1.6.12RecipientCompanyName of receiver's companystring(128)yes
1.6.13RecipientNameReceiver (full name). At least 3 characters.string(128)yes
1.6.14RecipientEmailEmail for sending order status notifications and contacting in case of failed callsеmailno
1.6.15PhoneReceiver's phonephoneyes
1.6.16TariffTypeCodeCode of tariff type (for more details, see Appendix No. 1)Integeryes
1.6.17Comment4Comments (special notes on the order)string(255)no
1.6.18Address1Delivery 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.18.1StreetReceiver's street. If possible, do not specify prefixes of values, such as “st.”string(50)yes
1.6.18.2HouseReceiver's house, building, block. If possible, do not specify prefixes of values, such as “house”string(30)yes
1.6.18.3FlatReceiver's flat/office. If possible, do not specify prefixes of values, such as “flat”string(10)no
1.6.18.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).
If the specified pickup point is closed at the time of order creation, the order will be accepted for the nearest functioning pickup point.
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
1.6.19PackagePackage (all packages are sent with different Package tags)
yes
1.6.19.1NumberPackage number (ordinal package number or order number can be used), unique for this order. Order identifier in the Client's IS.string(20)yes
1.6.19.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.19.3WeightTotal weight (in grams)integeryes
1.6.19.4SizeA5Package dimensions. Length (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
1.6.19.5SizeB5Package dimensions. Width (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
1.6.19.6SizeC5Package dimensions. Height (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
1.6.20AddServiceAdditional services
no
1.6.20.1ServiceCodeType of additional service (for more details, see Appendix No. 2)integeryes
1.6.20.2CostDeclared value of the package. It is used and is mandatory only for the additional service "Insurance".floatno
1.6.20.3CountNumber of packages. It is used and is mandatory only for the additional service "Package 1".integerno

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

...

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

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1ResponseDocument title
yes
1.1OrderOrder
yes
1.1.1DispatchNumberCDEK order numberintegeryes
1.1.2NumberOrder number of the online storestring(40)yes
1.1.3ErrorCodeError codestring(255)no
1.1.4MsgFixed text “Orders added”
Description of error (if any)
string(255)yes
1.2CallCall courier
no
1.2.1Number

Invitation number

string(30)yes
1.2.2ErrorCodeError codestring(255)no
1.2.3Msg

Fixed text “Orders added”

Description of error (if any)

string(255)yes


Example 1. Registration of an “online store” order

...

4.3.1. Description of Request Fields to be Transmitted

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1UpdateRequestDocument title
yes
1.1NumberAcceptance certificate number Order identifier in the IS of the CDEK client.string(30)yes
1.2DateDate of document (date of order)Date time/ dateyes
1.3AccountOnline store identifier (login)string(255)yes
1.4SecureKeystring(255)yes
1.5OrderCountThe total number of orders in a document, default value: 1.integeryes
1.6OrderShipment (order)
yes
1.6.1Number1Client shipment number (unique for orders of a particular client). Order identifier in the Client's IS.string(40)yes
1.6.2DispatchNumber1CDEK order numberintegeryes
1.6.3Delivery Recipient CostAdditional delivery charge collected by the online store from the receiver (in the specified currency)floatno
1.6.4Delivery RecipientVATRateVAT rate included in the extra delivery charge
(for more details, see Appendix No. 4)
string(10)no
1.6.5DeliveryRecipientVATSumVAT amount included in the extra. delivery chargefloatno
1.6.6RecipientNameReceiver (full name). At least 3 characters.string(128)no
1.6.7PhoneReceiver's phonephoneno
1.6.8RecipientINNTIN of the receiver. Only for international orders.string(12)no
1.6.9DateInvoiceInvoice date. Only for international orders.Date time/dateno
1.6.10PassportDetails of the receiver’s passport. Used to print waybills. Only for international orders.
no
1.6.10.1SeriesSeries of the receiver’s passport.string(255)no
1.6.10.2NumberNumber of the receiver’s passport.string(255)no
1.6.10.3IssueDateDate of issue of the receiver’s passport.Date time/dateno
1.6.10.4IssuedByIssuing authority of the receiver’s passport.string(255)no
1.6.10.5DateBirth

The receiver’s birthdate

Date time/dateno
1.6.11AddressDelivery 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)
no
1.6.11.1StreetReceiver's street. If possible, do not specify prefixes of values, such as “st.”string(50)yes
1.6.11.2HouseReceiver's house, building, block. If possible, do not specify prefixes of values, such as “house”.string(30)yes
1.6.11.3FlatReceiver's flat/office. If possible, do not specify prefixes of values, such as “flat”.string(10)no
1.6.11.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).
If the specified pickup point is closed at the time of order creation, the order will be accepted for the nearest functioning pickup point. 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
1.6.12DeliveryRecipientCostAdvAdditional charge for delivery (E-shop charges the receiver), depending on the order’s sumДоп. сбор за доставку (которую ИМ берет с получателя), в зависимости от суммы заказа
no
1.6.12.1Threshold

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

integeryes
1.6.12.2Sum

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

floatyes
1.6.12.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.12.4VATSum

VAT sum included in the additional charge for delivery

floatno
1.6.13PackagePackage (all packages are sent with different Package tags)
no
1.6.13.1NumberPackage number (ordinal package number or order number can be used), unique for this order. Order identifier in the Client's IS.string(20)yes
1.6.13.2BarCodePackage barcode, package identifier (if any); otherwise, transmit a value of the package number Package.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.13.3WeightTotal weight (in grams)integeryes
1.6.13.4SizeAPackage dimensions. Length (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
1.6.13.5SizeBPackage dimensions. Width (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
1.6.13.6SizeCPackage dimensions. Height (in centimeters)integeryes, if other dimensions are indicated, in a range of 1 to 1,500
1.6.13.7ItemItems (goods)
yes
1.6.13.7.1Amount

Quantity of goods of the same type (pcs). The maximum number is 999.

integeryes
1.6.13.7.2WareKeyIdentifier/item number of the goods.string(50)yes
1.6.13.7.3MarkingMarking of item.
If marking is indicated for Item, the Amount parametr can't be greater than 1.
stringno
1.6.13.7.4CostDeclared value of the goods (per item in the specified currency, value >=0). This value is used to calculate the amount of insurance.floatyes
1.6.13.7.5PaymentCash on delivery (per item in the specified currency, value >=0) — cash on delivery, in case of prepayment, value = 0.floatyes
1.6.13.7.6PaymentVATRateVAT rate included in the value of the goods (for more details, see Appendix No. 4)string(10)yes
1.6.13.7.7PaymentVATSumVAT amount included in the value (payment) of the goods.floatyes
1.6.13.7.8Weight

Weight (per item, in grams)

integeryes
1.6.13.7.9Comment

Name of the goods (may contain description of the goods: size, color)

string(255)yes
1.6.13.7.10WeightBruttoGross weight (for one unit of goods, in grams). Only for international orders.integerno
1.6.13.7.11CommentExName 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.13.7.12LinkLink to the e-shop’s website with the goods’ description. Only for international orders.string(255)no

1 The order is identified either by “DispatchNumber” or by "Number".

...

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

No.

Tag/ attribute

Description

Type of field

Mandatory (yes/no)

1

ResponseDocument title
yes

1.1

OrderOrder
yes

1.1.1

DispatchNumberCDEK order numberIntegeryes

1.1.2

NumberOrder number of the online storestring(40)yes

1.1.3

ErrorCodeError codestring(255)no

1.1.4

MsgFixed text “Orders changed”
Description of error (if any)
string(255)yes


Example. Order change

Code Block
languagexml
titleUpdateRequest
<?xml version="1.0" encoding="UTF-8"?>
<updaterequest account="0278f9e8004f6b08f37497001e804007"
    date="2019-01-23 11:20:45" number="soOEl" ordercount="1" secure="3e10b5b7d1da1dfa42cb70c329964ec2">
    <order deliveryrecipientcost="10.02" deliveryrecipientvatrate="VATX" deliveryrecipientvatsum="0.0" number="number-s785558445">    
        <package barcode="barcode-soOEl00" number="soOEl00" sizea="2.0" sizeb="3.0" sizec="4.0" weight="100.0">
            <item amount="2" comment="comment-soOEl000" cost="8.0" payment="10.0" paymentvatrate="VATX" paymentvatsum="0.0" warekey="warekey-soOEl000" weight="1.0"/>
        </package>
    </order>
</updaterequest>

...

4.4.1. Description of Request Fields to be Transmitted

No.

Tag/ attributeDescriptionType of fieldMandatory (yes/no)

1

DeleteRequestDocument title
yes

1.1

NumberAcceptance certificate number.
Order identifier in the IS of the CDEK client.
string(30)yes

1.2

DateDate of document (date of order)datetime/dateyes

1.3

AccountOnline store identifier (login)string(255)yes

1.4

SecureKeystring(255)yes

1.5

OrderCountThe total number of orders to be deleted in the document. Default value: 1.integeryes

2

OrderShipment (order)
yes

2.1

Number1Client's shipment number.
Order identifier in the IS of the CDEK client.
string(40)yes
2.2DispatchNumber1CDEK order numberintegeryes

1 The order is identified either by “DispatchNumber” or by "Number".

...

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

No.

Tag / attributeDescriptionType of fieldMandatory (yes/no)

1

ResponseDocument title
yes

1.1

DeleteRequestOrders to be deleted
yes

1.1.1

MsgInformation messagestring(255)yes

1.1.2

OrderOrderintegeryes

1.1.2.1

NumberAcceptance certificate number. Order identifier in the IS of the CDEK client.string(40)yes

1.1.2.2

ErrorCodeError codestring(255)no

1.1.2.3

MsgFixed text “Order deleted”
Description of error (if any)
string(255)yes


Example. Order deletion

Code Block
languagexml
titleDeleteRequest
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<deleterequest number="soOEl" ordercount="1" account="0278f9e8004f6b08f37497001e804007" date="2019-01-23 18:41:51" secure="3e10b5b7d1da1dfa42cb70c329964ec2">
	<order number="number-s785558445"/>
</deleterequest>

...

4.5.1. Description of Request Fields to be Transmitted

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1OrdersPrintDocument title
yes
1.1DateDate of document (date of invitation)datetime/dateyes
1.2AccountOnline store identifier (login)string(255)yes
1.3SecureKeystring(255)yes
1.4OrderCountTotal number of orders transmitted in a documentintegeryes
1.5CopyCountNumber of copies of a receipt per sheet. We recommend specifying at least 2: one will be attached to a cargo; another will be retained by the sender.integerno
1.6LangIdentifier of language in which the request is sent and the response is expectedstring(3)no
1.7OrderShipment (order)
yes
1.7.1DispatchNumber1CDEK shipment number (assigned when orders are imported). Order identifier in the IS of the CDEK client.integeryes
1.7.2Number1Client's shipment number. Order identifier in the IS of the CDEK client.string(30)yes
1.7.3Date1Date of an acceptance certificate, based on which the order has been transferred.dateyes

1 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.

...

In case of error, the result will be returned as XML:

No.

Tag / attributeDescriptionType of fieldMandatory (yes/no)

1

ResponseDocument title
yes

1.1

OrderOrder
yes

1.1.1

ErrorCodeError codestring(255)no

1.1.2

MsgError descriptionstring(255)yes


Example. Printing an order receipt

Code Block
languagexml
titleOrdersPrint
<?xml version="1.0" encoding="UTF-8"?>
<OrdersPrint Date="2019-01-23" Account="0278f9e8004f6b08f37497001e804007" Secure="3e10b5b7d1da1dfa42cb70c329964ec2" OrderCount="1" CopyCount="1">
    <Order DispatchNumber="1105256461"/>
</OrdersPrint>


Response (success)

View file
nameprintorder.pdf
height250


Code Block
languagexml
titleResponse (not success)
<?xml version="1.0" encoding="UTF-8"?>
<response>
    <Order DispatchNumber="1105256461" ErrorCode="ERR_INVALID_DISPATCHNUMBER" Msg="The order is not found in the database CDEK: DispatchNumber = 1105256461"/>
</response>

...

4.6.1. Description of Data to be Transmitted

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 document. Default value: 1.integeryes
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 city code from the CDEK base (see the file
“City_XXX_YYYYMMDD.xls”)
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.5 kg) will be written in the order.stringyes, if DispatchNumber is not defined
1.6.13CommentCommentstring(255)no
1.6.14DispatchNumberNumber 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.16Address1Receiver's 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

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

...

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

No.

Tag / attributeDescriptionType of fieldMandatory (yes/no)

1

ResponseDocument title
yes

1.1

CallWaiting for a courier
yes

1.1.1

NumberInvitation numberstring(30)yes

1.1.2

ErrorCodeError codestring(255)no

1.1.3

MsgFixed text “Orders added”
Description of error (if any)
string(255)yes


Example. Registration of a courier invitation

...

4.7.1. Description of Input Parameters

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1ScheduleRequestDocument title.
yes
1.1DateDate of document (date of invitation)datetime/dateyes
1.2AccountOnline store identifier (login)string(255)yes
1.3NumberNumber of an acceptance certificate/waybill. Identifier of the list of cargoes in the IS of the CDEK client. You can use 1 as a default value.string(30)yes
1.4SecureKeystring(255)yes
1.5Order CountTotal number of requests for notification calls. Default value: 1.Integeryes
1.6OrderShipment (order)
yes
1.6.1DispatchNumber1CDEK shipment number (assigned when orders are imported).
Order identifier in the IS of a CDEK client.
integeryes
1.6.2Number1Client shipment number (unique for orders of a particular client). Order identifier in the Client's IS.string(40)yes
1.6.3Date1Date of document (date of order)datetime/dateyes
1.6.4AttemptTime of delivery.
yes
1.6.4.1IDID number of a schedule from the online store's database. You may use 1 as a default value.integeryes
1.6.4.2DateDate of delivery (only date, in the format “YYYY-MM-DD”, no time) as agreed by the receiverdateyes
1.6.4.3CommentCommentstring(255)no
1.6.4.4DeliveryRecipientCostAdditional delivery charge collected by the online store from the receiver (in the specified currency)floatno
1.6.4.5DeliveryRecipientVATRateVAT rate included in the extra delivery charge (for more details, see Appendix No. 4)string(10)no
1.6.4.6DeliveryRecipientVATSumVAT amount included in the extra delivery chargefloatno
1.6.4.7TimeBegStart of a delivery time range (receiver's time)timeyes
1.6.4.8TimeEndEnd of a delivery time range (receiver's time)еimeyes
1.6.4.9AddressNew 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.4.9.1StreetReceiver's street. If possible, do not specify prefixes of values, such as “str”string(50)yes
1.6.4.9.2HouseReceiver's house, building, block. If possible, do not specify prefixes of values, such as “house”string(30)yes
1.6.4.9.3FlatReceiver's flat/office. If possible, do not specify prefixes of values, such as “flat.”string(10)no
1.6.4.9.4PvzCodePickup 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 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.

...

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

No.

Tag / attributeDescriptionType of fieldMandatory (yes/no)

1

ResponseDocument title
yes

1.1

ScheduleResuestWaiting for a courier
yes

1.1.1

NumberInvitation numberstring(40)no

1.1.2

DispatchNumberCDEK order numberintegeryes

1.1.3

ErrorCodeError codestring(255)no

1.1.4

MsgFixed text or Description of error (if any)string(255)yes


Example. Recording of Notification Call Results

...

4.8.1. Description of Data to be Transmitted

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1OrdersPackagesPrintDocument title
yes
1.1DateDate of documentdatetime/dateyes
1.2AccountOnline store identifier (login)string(255)yes
1.3SecureKeystring(255)yes
1.4OrderCountTotal number of orders transmitted in a documentintegeryes
1.5CopyCountNumber of copies. Default value: 1integerno
1.6PrintFormatPrint format, acceptable values: A4, A5, A6 (A – Latin letter). Default value: A4string(2)no
1.7OrderShipment (order)
yes
1.7.1DispatchNumber1CDEK shipment number (assigned when orders are imported). Order identifier in the IS of the CDEK client.integeryes
1.7.2Number1Client's shipment number. Order identifier in the IS of the CDEK client.string(40)yes
1.7.3Date1Date of an acceptance certificate, based on which the order has been transferreddateyes

1 The order is identified either by “DispatchNumber” or by Number. If the request has a value of the “DispatchNumber” attribute, “Number” attribute will be ignored.

...

In response, the CDEK server will return a pdf file, which contains a package for a single order, in four copies. In case of error, the result will be returned as XML:

No.Tag/ attributeDescriptionType of fieldMandatory (yes/no)
1ResponseDocument title
yes
1.1OrderOrder
yes
1.1.1ErrorCodeError codestring(255)no
1.1.2MsgError descriptionstring(255)yes


Example. Printing a Package Barcode

Code Block
languagexml
titleOrdersPackagesPrint
<?xml version="1.0" encoding="UTF-8"?>
<OrdersPackagesPrint Account="0278f9e8004f6b08f37497001e804007" Secure="3e10b5b7d1da1dfa42cb70c329964ec2" Date="2019-01-24" OrderCount="1" printFormat="A6">
    <Order DispatchNumber="1105256461" Number="s785558447" Date="2019-01-24"/>
</OrdersPackagesPrint>


Response (success)

View file
nameprintpackagebarcode.pdf
height250


Code Block
languagexml
titleResponse (not success)
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response>
    <Order ErrorCode="ERR_INVALID_DISPATCHNUMBER" Msg="Orders not found by dispatchNumber 1105256461"/>
    <TraceId>e32939c969dfb6d9</TraceId>
</response>

...

4.9.1. Description of Data to be Transmitted

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

yes
1.1DateDate of planned transmission. Format: YYYY-MM-DDDatetime/dateyes
1.2AccountOnline store identifier (login)string(255)yes
1.3SecureKeystring(255)yes
1.4PlannedMeetingDateДата планируемой передачи. В формате YYYY-MM-DDDatetime/dateyes
1.5PvzCodeReceiver's officeintegeryes
1.6OrderNumber of orders for picking up the consolidated cargo. Must contain at least one element.

1.6.1DispatchNumber1Order number in the CDEK systemstring(30)yes
1.6.2Number1Order number in the online store systemstring(40)yes

1 The order is identified either by “DispatchNumber” or by Number. If the request has a value of the “DispatchNumber” attribute, “Number” attribute will be ignored.

...

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

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1ResponseDocument title
yes
1.1OrderOrder
yes
1.1.1ErrorCodeError codestring(255)no
1.1.2MsgFixed test or description of error (if any)string(255)yes


Example. Creation of a Pre-Alert Document

...

4.10.1. Description of Data to be Transmitted

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1StatusReportDocument title
yes
1.1DateDate of requestdatetime/dateyes
1.2AccountClient identifier (login)string(255)yes
1.3SecureKeystring(255)yes
1.4ShowHistoryThe attribute indicating that the order history must be loaded (1 – yes, 0 – no)booleanno
1.5ShowReturnOrderThe attribute indicating that the list of return orders must be loaded (1 – yes, 0 – no)booleanno
1.6ShowReturnOrderHistoryThe attribute indicating that the history of return orders must be loaded (1 – yes, 0 – no)booleanno
1.7LangIdentifier of language in which the request is sent and the response is expectedstring(3)no
1.7ChangePeriod1The period during which the order status has changed.
no
1.7.1DateFirstStart date of requested perioddatetime/dateyes
1.7.2DateLastEnd date of requested perioddatetime/dateno
1.8Order1Shipment (order)
no
1.8.1DispatchNumber2CDEK shipment number (assigned when orders are imported). Order identifier in the CDEK IS.integeryes
1.8.2Number2Client's shipment number. Order identifier in the IS of the CDEK client.string(30)yes
1.8.3Date2Date of an acceptance certificate, based on which the order has been transferreddateyes

1 The request must contain at least one of two tags: ChangePeriod or Order:

...

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 deliverystring(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.7StatusCurrent order status
yes
2.7.1DateStatus date. Greenwich mean time indicateddatetimeyes
2.7.2CodeStatus code (for more details, see Appendix No. 5)integeryes
2.7.3DescriptionStatus namestring(100)yes
2.7.4CityCodeStatus change city, city code from the CDEK base (see the file “City_XXX_YYYYMMDD.xls”)integeryes
2.7.5CityNameName of the status change citystring(100)yes
2.7.6State1Status change history
yes
2.7.6.1DateStatus datedatetimeyes
2.7.6.2CodeStatus code (for more details, see Appendix No. 5)integeryes
2.7.6.3DescriptionStatus namestring(100)yes
2.7.6.4CityCodeStatus change city, city code from the CDEK base (see the file “City_XXX_YYYYMMDD.xls”)integeryes
2.7.6.5CityNameName of the status change citystring(100)yes
2.8ReasonCurrent additional status
yes
2.8.1DateAdditional status datedatetimeyes
2.8.2CodeAdditional status code (for more details, see Appendix No. 6)integerno
2.8.3DescriptionAdditional status namestring(100)no
2.9DelayReasonCurrent delay reason
yes
2.9.1DateDelay reason datedatetimeyes
2.9.2CodeDelay reason code (for more details, see Appendix No. 7)integerno
2.9.3DescriptionDelay reasonstring(50)no
2.9.4State1Delay reason history
yes
2.9.4.1DateDelay reason datedatetimeyes
2.9.4.2CodeDelay reason code (for more details, see Appendix No. 7)integerno
2.9.4.3DescriptionDelay reasonstring(50)no
2.10Package1Package
no
2.10.1NumberPackage number. Order identifier in the IS of еру CDEK client.string(20)yes
2.10.2Item2Items
yes
2.10.2.1WareKeyIdentifier/item number of the goods.string(20)yes
2.10.2.2MarkingMarking of itemstringno
2.10.2.3DelivAmountNumber of delivered items. Default value is equal to the number of items transferred for delivery.integeryes
2.10.2.4AmountQuantity of goods of the same type (pcs). The maximum number is 999.integeryes
2.11Attempt3Delivery time taken from the delivery schedule
no
2.11.1IDID number of a schedule from the online store's databaseintegeryes
2.11.2ScheduleCodeDelay reason code (for more details, see Appendix No. 7)integeryes
2.11.3ScheduleDescriptionDelay reasonstring(50)yes
2.12CallHistory of notification calls to the receiver
no
2.12.1.1CallGoodHistory of successful calls
no
2.12.1.1GoodSuccessful call
yes
2.12.1.1.1DateDate of a successful calldateyes
2.12.1.1.2DateDelivAgreed date of delivery/ pickupdateyes
2.12.2CallFailHistory of failed calls
no
2.12.2.1FailFailed call
yes
2.12.2.1.1DateDate of calldateyes
2.12.2.1.2ReasonCodeFailed call reason code (for more details, see Appendix No. 8)integeryes
2.12.2.1.3ReasonDescriptionReason for a failed callstring(255)yes
2.12.3CallDelayHistory of call reschedules
no
2.12.3.1DelayCall reschedule
yes
2.12.3.1.1DateDate of calldateyes
2.12.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, city code from the CDEK base (see the file “City_XXX_YYYYMMDD.xls”)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

1 The State tag is used only if ShowHistory = 1 (see the Description of Data to be Transmitted).

...

4.11.1. Description of Data to be Transmitted

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1InfoRequestDocument title
yes
1.1DateDate of requestdatetime/dateyes
1.2AccountClient identifier (login)string(255)yes
1.3SecureKeystring(255)yes
1.4ChangePeriodThe period during which the tariff has changed.
no
1.4.1DateBegStart date of requested perioddateno
1.4.2DateEndEnd date of requested perioddateno
1.5OrderShipment (order)
no
1.5.1DispatchNumber1CDEK shipment number (assigned when orders are imported). Order identifier in the CDEK IS.integeryes
1.5.2Number1Client's shipment number. Order identifier in the IS of a CDEK client.string(30)yes
1.5.3Date1Date of an acceptance certificate, based on which the order has been transferreddateyes

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.

...

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

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 (see the file “City_XXX_YYYYMMDD.xls”)integeryes
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 (see the file “City_XXX_YYYYMMDD.xls”)integeryes
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 currency,floatyes
2.16.8.7PaymentCash on delivery (per item in the specified 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


Info
titleInformation

The order information report method and order registration method refer to different modules of system, synchronization between which can take up to 10 minutes. We recommend to call order information report method after this time after creating an order.

...

In order to load the list of regions, it is necessary to send a GET request with the following parameters:

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1regionCodeExtRegion codestring(10)no
2regionCodeRegion code in the CDEK ISintegerno
3regionFiasGuidRegion code according to the Federal Information Address SystemUUIDno
4countryCodeCountry code in the CDEK ISintegerno
5countryCode ExtCode according to the Russian Classifier of Countries of the Worldintegerno
6pageNumber of the results page. Default value: 0integerno
7sizeLimitation on the number of results displayed. Default value: 1,000integeryes, if page is specified
8langLocalization. Default: “rus”.string(3)no


4.12.2. Response Format

The CDEK server returns a result with the following fields:

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1regionUuidEntity identifier in the CDEK ISUUIDyes
2regionNameRegion namestring(255)yes
3prefixPrefix (possible values: region, territory, republic, autonomous okrug, region, city)string(20)no
4regionCodeExRegion codeString( 10)no
5regionCodeRegion code in the CDEK ISString( 10)no
6regionFiasGuidRegion code according to the Federal Information Address SystemUUIDno
7countryNameCountry namestring(255)yes
8countryCodeCountry code in the format ISO 3166-1 alpha-2integerno
9countryCodeExtCode according to the Russian Classifier of Countries of the Worldintegerno


Example 1. List of Regions in JSON

...

In order to load the list of cities, it is necessary to send a GET request with the following parameters:

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-2stringno
7cityNameCity namestringno
8cityCodeCity code from the CDEK base (see the file “City_XXX_YYYYMMDD.xls”)integerno
9postcodePostal codestringno
10langLocalization. Default: “rus”.string(3)no

4.12.2. Response Format

The CDEK server returns a result with the following fields:

No.Tag/ attributeDescriptionType of fieldMandatory (yes/no)
1cityUuidEntity identifier in the CDEK ISUUIDyes
2cityNameCity namestring(255)yes
3cityCodeCity code from the CDEK base (see the file “City_XXX_YYYYMMDD.xls”)integeryes
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


Example 1.List of cities in JSON

...

To get the rate and transit time you should send json-object to CDEK server to the following address:

4.14.1.1. Description of Data to be Transmitted

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
5senderCityId3

Origin city code in accordance with city codes provided by CDEK (file City_XXX_YYYYMMDD.xls»)

integeryes
6senderCityPostCode3

Zip code of the origin city

integeryes
7receiverCityId3

Code of city of destination in accordance with city codes provided by CDEK (file «City_XXX_YYYYMMDD.xls»)

integeryes
8receiverCityPostCode3

City of destination zip code

integeryes
9tariffId4Code of chosen tariff (for more details, see Appendix No. 1)integeryes
10tariffList4List of tariffs
yes
10.1priority

The specified priority

integeryes
10.2id

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

integeryes
10.3modeId

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

integerno
11goodsLocation's dimension
yes
11.1weightWeight (in kilograms)floatyes
11.2lengthLength (in centimeters)integeryes
11.3widthWidth (in centimeters)integeryes
11.4heightHeight (in centimeters)integeryes
11.5volume5Shipment's volume (in cubic meters)floatyes
12servicesList of additional service (for more details, see Appendix No. 2)
no
12.1idNumber identifier of additional serviceintegeryes
12.2param6Parameter of additional service if necessaryintegerno


1 Authorization is not obligatory for regular delivery tariffs and authLoginsecure parametrs might be not provided.

...

The CDEK server will return a result:


No.Tag / attributeDescriptionType of field
1error

Array errors (for more details, see Appendix No. 9)


1.1codeError codeinteger
1.2textError textstring
2price

Price for delivery in RUB

double
3deliveryPeriodMin

Minimum delivery time in days

integer
4deliveryPeriodMaxMaximum delivery time in daysinteger
5deliveryDateMinMinimum delivery date, 'YYYY-ММ-DD', eg “2018-07-29”string
6deliveryDateMax

Maximum delivery date , 'YYYY-ММ-DD', eg “2018-07-30”

string
7tariffId

Tariff code, regarding to which the delivery cost was calculated

integer
8cashOnDelivery

Cash payment limits will appear if there is any

float
9priceByCurrencyThe price is in the currency at which the on-line store operates with the CDEK. Currency is determined by authLogin and secure.float
10currency

Price in currency, in which the web shop works with CDEK (for more details, see Appendix No. 3)

string
11percentVATThe rate of VAT for this client. It appears if authLogin and secure are transferred, and the rate of on-line store is determined from them. If the VAT rate is not stipulated by the terms of the contract, this parameter will not be displayed.integer
12servicesList of transmitted additional services (for more details, see Appendix 2)
12.1idService IDinteger
12.2titleService titlestring
12.3priceAdditional service cost without VAT in RUBfloat
12.4rateThe percentage to calculate the additional servicesfloat


Example. Calculate shipping cost

...

To get the rate and transit time you should send json-object to CDEK server to the following address:

url

type

http://api.cdek.ru/calculator/calculate_tarifflist.php

Content-Type: application/json

4.14.2.1. Description of Data to be Transmitted

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
5senderCityId3

Origin city code in accordance with city codes provided by CDEK (file City_XXX_YYYYMMDD.xls»)

integeryes
6senderCityPostCode3

Zip code of the origin city

integeryes
7receiverCityId3

Code of city of destination in accordance with city codes provided by CDEK (file «City_XXX_YYYYMMDD.xls»)

integeryes
8receiverCityPostCode3

City of destination zip code

integeryes
9currencyThe currency in which you need to calculate shipping cost. Default - RUBstringno
10tariffId4Code of chosen tariff (for more details, see Appendix No. 1)integeryes
11tariffList4List of tariffs
yes
11.1id

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

integeryes
12goodsLocation's dimension
yes
12.1weightWeight (in kilograms)floatyes
12.2lengthLength (in centimeters)integeryes
12.3widthWidth (in centimeters)integeryes
12.4heightHeight (in centimeters)integeryes
13servicesList of additional service (for more details, see Appendix No. 2)
no
13.1idNumber identifier of additional serviceintegeryes
13.2param5Parameter of additional service if necessaryintegerno

1 Authorization is not obligatory for regular delivery tariffs and authLoginsecure parametrs might be not provided.

...

The CDEK server will return a result:


No.Tag / attributeDescriptionType of field
1tariffId

Tariff code, regarding to which the delivery cost was calculated

integer
2statusResponse status (true - successful, false - unsuccessful)string
3resultCost and delivery time of tariff
3.1error

Array errors (for more details, see Appendix No. 9)


3.1.1codeError codeinteger
3.1.2textError textstring
3.2price

Price for delivery in RUB

double
3.3deliveryPeriodMin

Minimum delivery time in days

integer
3.4deliveryPeriodMaxMaximum delivery time in daysinteger
3.5cashOnDeliveryCash payment limits will appear if there is anyfloat
3.6priceByCurrencyThe price is in the currency that was transfered in the requestfloat
3.7currencyPrice in currency that was thransfered in the requeststring
3.8percentVATThe rate of VAT for this client. It appears if authLogin and secure are transferred, and the rate of on-line store is determined from them. If the VAT rate is not stipulated by the terms of the contract, this parameter will not be displayedinteger
3.9servicesList of transmitted additional services (for more details, see Appendix 2)
3.9.1idService IDinteger
3.9.2titleService titlestring
3.9.3priceAdditional service cost without VAT in RUBfloat
3.9.4rateThe percentage to calculate the additional servicesfloat


Example. Calculate shipping cost

...

Tariffs for Online Stores

Code

Tariff name

Delivery mode

Weightlimit

Service

Description

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

warehouse–door (W-D)

139

Door–door parcel

door–door (D-D)

233

Economy warehouse–door parcel

warehouse–door (W-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.

234

Economy warehouse–warehouse parcel

warehouse–warehouse (W-W)

291

CDEK Express warehouse-warehouse

warehouse–warehouse (W-W)


CDEK Express

Delivery of goods from abroad to Russia, including customs clearance.

Three 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. The order is executed as, e.g., “Beijing-“Novosibirsk”

2) The client imports a cargo to Russia on its own. We clear it through Russian customs and deliver it to the client. The order is executed, e.g., as Moscow–Novosibirsk.

3) The client imports a cargo to Russia and clears it to the Russian customs. We only deliver it to the client. The order is executed, e.g., as Moscow–Novosibirsk.

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.
3Super express up to 18 kgdoor–door (D-D)
1. Express deliveryExpress delivery of documents and cargoes “from hand to hand” across Russia by a certain hour.
5Economy express warehouse–warehousewarehouse–warehouse (W-W)
1. 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 kgExpressClassical express delivery of documents and cargoes across Russia.
11Express light warehouse–doorwarehouse–door (W-D)up to 30 kgExpressClassical express delivery of documents and cargoes across Russia.
12Express light door–warehousedoor–warehouse (D-W)up to 30 kgExpressClassical express delivery of documents and cargoes across Russia.
15Express heavy warehouse-warehousewarehouse–warehouse (W-W)from 30 kgExpressClassical express delivery of cargoes across Russia.
16Express heavy warehouse–doorwarehouse–door (W-D)from 30 kgExpressClassical express delivery of cargoes across Russia.
17Express heavy door–warehousedoor–warehouse (D-W)from 30 kgExpressClassical express delivery of cargoes across Russia.
18Express heavy door–doordoor–door (D-D)from 30 kgExpressClassical express delivery of cargoes across Russia.
57Super express up to 9 a.m.door–door (D-D)up to 5 kg1. Express 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 kg1. Express 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 5 kg1. Express 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 5 kg1. Express 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)
1. Express 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)
1. Economy deliveryFast economy delivery of cargoes across Russia
63Long-distance super express warehouse-warehousewarehouse–warehouse (W-W)
1. Economy deliveryFast economy delivery of cargoes by a certain hour

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.


Appendix 2. Additional Services*

Info

You can transfer all the additional services listed below in the calculator.


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. Waiting time for a courier is 30 minutes.
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.

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

...

Anchor
Currency
Currency
Appendix 3. Currencies

CodeParameterReceiver's country
RUBRussian rubleRussia
USDUS dollarUnited States
EUREuroCountries of Europe
KZTTengeKazakhstan
GBPPound sterlingUnited Kingdom
CNYYuanChina
BYNBelarusian rubleBelarus
UAHGrzywnaUkraine
AMDArmenian dramArmenia
KGSKyrgyzstani somKyrgyzstan
TLTurkish liraTurkey
THBThai bahtThailand
KRWSouth korean wonSouth Korea
AEDUAE dirhamUnited Arab Emirates
UZSUzbek sumUzbekistan
MNTMongolian tugrikMongolia


Appendix 4. VAT Rates

IdentifierType of VAT rate
VATXFREE OF VAT
VAT00%
VAT1010%
VAT2020%


Appendix 5. Order Statuses*

CodeStatusComment
1CreatedAn order has been registered in the CDEK database.
2DeletedAn order has been canceled by an online store before it has been delivered to a CDEK warehouse in the sender's city.
3Recieved at shipment warehouseA parcel has been accepted by a CDEK warehouse in the sender's city.
6Sent for shipmentA parcel has been issued from a CDEK warehouse in the sender's city. A parcel has been prepared for delivery (consolidated with other parcels).
16Returned to shipment warehouseA parcel has been accepted again in the sender's city (it has not been handed over to a carrier for some reason).
Note: this status does not mean that a parcel has been returned to a sender.
7Handed to carrier in shipment locationA shipment in the sender's city has been registered. Consolidated parcel has been handed over for delivery (to an airport/ loaded into a car).
21Sent to transit locationA shipment to the transit city has been registered. Data and time of shipment have been recorded by a carrier.
22Received at transit locationA receipt in the transit city has been registered.
13Accepted at transit warehouseA parcel has been accepted in the transit city.
17Returned to transit warehouseA parcel has been accepted again in the transit city (cargo has been returned to the warehouse).
Note: this status does not mean that the parcel has been returned to the sender.
19Sent for shipment in transit locationA parcel has been issued from a warehouse in the transit city.
20Handed to carrier in transit locationA shipment in the transit city has been registered by a carrier.
8Send to destination cityA shipment to the receiver's city has been registered. A parcel is in transit.
9Received in destination cityA receipt in the receiver's city has been registered.
10Accepted at delivery warehouseA parcel has been accepted by a warehouse of the receiver's city. Waiting for delivery to door.
12Accepted at warehouse for pick upA parcel has been accepted by a warehouse in the receiver's city. Delivery to a warehouse. A parcel will be stored until it is picked up by the client (online store's customer).
11Sent for deliveryA parcel has been added to a courier card and handed over to a courier for delivery.
18Returned to delivery warehouseA parcel has been accepted again by a warehouse in the receiver's city. Delivery attempt has been failed for some reason. Waiting for a repeated delivery attempt.
Note: this status does not mean that a parcel has been returned to the sender.
4DeliveredA parcel has been successfully delivered and handed over to a receiver (final status).
5Not deliveredA buyer has refused to accept a parcel. Return to the online store (final status).

* These statuses are assigned to both orders of direct flow (sender-to-receiver delivery) and orders of return flow (return of undelivered parcel to the sender).

...

Appendix 6. Additional Order Statuses

CodeAdditional statusDelivery service rendered
(0–no, 1–yes)
Related status
1Returned, wrong address0Not delivered
2Returned, no answer0Not delivered
3Returned, the recepient does not reside there0Not delivered
4Returned, can`t complete: the weight is different from declared for more than X g0Not delivered
5Returned, can`t complete: no parcel in fact0Not delivered
6Returned, can`t complete: order number duplicated in inventory list0Not delivered
7Returned, can`t complete: can`t be deliveried to this town 0Not delivered
8Returned, package is damaged during picking up0Not delivered
9Returned, package is damaged at the carrier`s location0Not delivered
10Returned, package is damaged at our storage or during delivery0Not delivered
11Returned, non-receipt, no reason1Not delivered
12Returned, non-receipt, quality claims1Not delivered
13Returned, non-receipt, not enough goods in the package1Not delivered
14Returned, non-receipt, the goods don`t match the description1Not delivered
15Returned, non-receipt, not satisfied with delivery time 1Not delivered
16Returned, non-receipt, already bought1Not delivered
17Returned, non-receipt, a customer changed his mind1Not delivered
18Returned, non-receipt, fulfilment error1Not delivered
19Returned, package is damaged at the receiver`s location1Not delivered
20Partial delivery1Delivered
21Returned, non-receipt, no money1Not delivered
22Returned, non-receipt, the goods don`t meet customer expectation1Not delivered
23Returned, product expired0Not delivered
24Returned, didn`t clear customs0Not delivered
25Returned, can`t complete: commercial freight0Not delivered
26Lost0Not delivered
27Non-required, ready for disposal 0Not delivered


Appendix 7. Reasons for Late Delivery

CodeReason
1Wrong phone number
2Phone is not in service
3No answer
4Had no time
5Mechanical problem
6Wrong address
7Abandonment of an application
8Don't know what to ship
9Package is not ready
10Refused to recieve
11Abandonment of payment
12Contact person is not with a company
13Contact person is out
14Shipment was sent through other company
15Didn't get through
16Partial delivery
17Business closed
18Can't find adress
19Address got changed
20Required additional info to get shippment
21Refusal of receipt
22Change date
23Pass required / limited access
24No passport / copy of passport
25Coupon missing
26Sales receipt required
27No power of attorney from the recipient
28No power of attorney from CDEK
29Documents required
30Shipment couldn't fit delivery truck
31Wanted a courier
32Sender requests document signature
33The queue for the grant
34Whaiting call from operator
35Not enough time
36Self pick up
37Packstation is crowded
38Packstation isn't work
39Shipment couldn't fit packstation's cell
40Refusal to accept
41Rejectioon of request
42Entry permit required
43Entry fee
44Restricted area
45No identity documents
46City changed
47Address does not exist
48Delivery to P.O. box
49Dangerous cargo
52Refused by address


Appendix 8. Reasons for Failed Calls

CodeReason
1Phone is busy
2The subscriber does not answer
3Subscriber unavailable
4Wrong Number
5Phone unknown
6Silence
7Reset
8Hung up

Appendix 9. Possible calculator errors

CodeError text

0

Internal server mistake. Please consult to CDEK IT team for correction.

1

The API that you provided is not supported

2

Authorization mistake

3

Impossible to deliver to this area under given conditions

4

Error when specifying the parameters

5

No pieces are specified for sending

6

No tariff or tariffs list

7

No city of origin

8

No city of destination

9

No date of shipping is specified while authorization

10

Mode of delivery mistake

11

Incorrectly specified data format

12

Decoding data mistake. Awaiting <json или jsop>

13

No zip code for city of origin in CDEK database

14

Impossible to uniquely identify the city of origin by zip code

15

No zip code for city of destination in CDEK database

16

Impossible to identify the city of destination by zip code

Appendix 10. Forms of ownership

CodeForm of ownership
1Joint-Stock Company
61Closed Joint-Stock Company
63Sole Trader
119Open Joint-Stock Company
137Limited Liability Company
147Public Joint-Stock Company