The method is used to calculate cost and delivery time by available tariffs.
Request for Calculation by available tariffs
In order to use this process, a POST request should be sent to URL:
| Environment | URL |
|---|---|
| testing | https://api.edu.cdek.ru/v2/calculator/tarifflist |
| production | https://api.cdek.ru/v2/calculator/tarifflist |
Body of the request
Must be sent in the JSON format (Content-Type: application/json).
The following fields are supported:
№ | Field name | Description | Field type | Mandatory |
|---|---|---|---|---|
| 1 | date | Date and time of the planned delivery of the order. Default value: current | dateTime | no |
2 | type | Order type (to check availability of the tariff and additional services for order type): 1 - "e-shop" Default value: 1 | integer | no |
3 | currency | Currency for calculation (see Appendix 1 for details) Default value: contract currency | integer | no |
4 | lang | Language of display of information about tariffs | string(3) | no |
5 | from_location1 | Sending address | location | yes |
| 5.1 | code | Location code (CDEK reference book) | integer | no |
| 5.2 | postal_code | Postal code | string(255) | no |
| 5.3 | country_code | Country code in the format: ISO_3166-1_alpha-2 | string(2) | no |
| 5.4 | city | City name | string(255) | no |
| 5.5 | address | Address string | string(255) | no |
6 | to_location1 | Receiving address | location | yes |
| 6.1 | code | Location code (CDEK reference book) | integer | no |
| 6.2 | postal_code | Postal code | string(255) | no |
| 6.3 | country_code | Country code in the format: ISO_3166-1_alpha-2 | string(2) | no |
| 6.4 | city | City name | string(255) | no |
| 6.5 | address | Address string | string(255) | no |
7 | packages | List of information on packages | package[ ] | yes |
7.1 | weight | Total weight (grams) | integer | yes |
7.2 | length | Package dimensions. Length (centimeters) | integer | no |
7.3 | width | Package dimensions. Width (centimeters) | integer | no |
7.4 | height | Package dimensions. Height (centimeters) | integer | no |
1 The city is identified according to the following algorithm (listed in order of priority):
- By unique city code from the CDEK database. Values are transmitted in from_location.code and to_location.code attributes
- By postal code of the city. Values are transmitted in from_location.postal_code and to_location.postal_code attributes. The country code and city name can be transmitted as an additional parameter.
- By address string. Values are transmitted in from_location.address and to_location.address attributes.
Answer to Calculation by available tariffs
The response body is returned in the JSON format:
№ | Field name | Description | Field type | Mandatory |
|---|---|---|---|---|
| 1 | tariff_codes | Available tariffs | [ ] | no |
1.1 | tariff_code | Tariff code (see Appendix 2 for details) | integer | yes |
1.2 | tariff_name | Name of the tariff in the display language | string() | yes |
1.3 | tariff_description | Description of the tariff in the display language | string() | yes |
1.4 | delivery_mode | Tariff mode (see Appendix 3 for details) | integer | yes |
1.5 | delivery_sum | Price of delivery | float | yes |
1.6 | period_min | Min. delivery time (working days) | integer | yes |
1.7 | period_max | Max. delivery time (working days) | integer | yes |
2 | errors | List or errors | error[] | no |
2.1 | code | Error code | string() | yes |
| 2.2 | message | Error description | string() | yes |
{
"type": "1",
"date": "2020-11-03T11:49:32+0700",
"currency": "1",
"lang": "rus",
"from_location": {
"code": 270
},
"to_location": {
"code": 44
},
"packages": [
{
"height": 10,
"length": 10,
"weight": 4000,
"width": 10
}
]
}
{
"tariff_codes": [
{
"tariff_code": 1,
"tariff_name": "Экспресс лайт дверь-дверь",
"tariff_description": "Классическая экспресс-доставка документов и грузов по всей территории России по принципу «от двери до двери» со стандартными сроками доставки",
"delivery_mode": 1,
"delivery_sum": 1135.0,
"period_min": 2,
"period_max": 2
},
{
"tariff_code": 10,
"tariff_name": "Экспресс лайт склад-склад",
"tariff_description": "Отправитель самостоятельно доставляет груз/документы в офис СД «Экспресс-курьер», получатель самостоятельно забирает груз/документы в офисе СД «Экспресс-курьер»",
"delivery_mode": 4,
"delivery_sum": 960.0,
"period_min": 2,
"period_max": 2
}]
}
Appendix 1. Calculator currencies
Code | Currency |
1 | Ruble |
2 | Tenge |
3 | Dollar |
4 | Euro |
5 | Pound sterling |
6 | Yuan |
7 | Belarusian ruble |
8 | Hryvnia |
9 | Kyrgyzstani som |
10 | Armenian dram |
11 | Turkish lira |
12 | Thai baht |
13 | Won |
14 | Dirham |
15 | Sum |
16 | Tugrik |
17 | Złoty |
18 | Manat |
19 | Lari |
Appendix 2. CDEK Tariffs
Tariffs for Online Stores
Code | Tariff name | Delivery mode | Weight limit | Service | Description |
|---|---|---|---|---|---|
| 7 | International express documents door–door | door–door (D-D) | up to 5 kg | International express | Express delivery for / from abroad of documents and letters. |
| 8 | International express freight door–door | door–door (D-D) | up to 30 kg | International express | Express 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) | |||
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, 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) | |||
| 366 | Parcel door-parcel terminal | door-parcel terminal | up to 30 kg | Parcel | Economy delivery of goods across Russia for e-commerce companies. |
| 368 | Parcel warehouse-parcel terminal | warehouse-parcel terminal | |||
| 378 | Economic parcel warehouse-parcel terminal | warehouse-parcel terminal | 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. |
Chinese Express Tariffs
Code | Tariff name | Delivery mode | Weight limit | 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:
| |
245 | Chinese Express | door–door (D-D) | |||
246 | Chinese Express | warehouse–door (W-D) | |||
247 | Chinese Express | door–warehouse (D-W) |
Regular Delivery Tariffs
| Code | Tariff name | Delivery mode | Weight limit | Service | Description |
| 1 | Express light door–door | door–door (D-D) | up to 30 kg | Express | Classical express delivery of documents and cargoes up to 30 kg. |
| 3 | Super express up to 18 kg | door–door (D-D) | Express delivery | Express delivery of documents and cargoes “from hand to hand” across Russia by a certain hour. | |
| 5 | Economy express warehouse–warehouse | warehouse–warehouse (W-W) | Economy delivery | Cheap delivery of goods across Russia by rail and by road (longer delivery period). | |
| 10 | Express light warehouse-warehouse | warehouse–warehouse (W-W) | up to 30 kg | Express | Classical express delivery of documents and cargoes across Russia. |
| 11 | Express light warehouse–door | warehouse–door (W-D) | up to 30 kg | Express | Classical express delivery of documents and cargoes across Russia. |
| 12 | Express light door–warehouse | door–warehouse (D-W) | up to 30 kg | Express | Classical express delivery of documents and cargoes across Russia. |
| 15 | Express heavy warehouse-warehouse | warehouse–warehouse (W-W) | from 30 kg | Express | Classical express delivery of cargoes across Russia. |
| 16 | Express heavy warehouse–door | warehouse–door (W-D) | from 30 kg | Express | Classical express delivery of cargoes across Russia. |
| 17 | Express heavy door–warehouse | door–warehouse (D-W) | from 30 kg | Express | Classical express delivery of cargoes across Russia. |
| 18 | Express heavy door–door | door–door (D-D) | from 30 kg | Express | Classical express delivery of cargoes across Russia. |
| 57 | Super express up to 9 a.m. | door–door (D-D) | up to 30 kg | Express delivery | Express delivery of documents and cargoes “from hand to hand” across Russia by a certain hour (delivery within 1–2 days). |
| 58 | Super express up to 10 a.m. | door–door (D-D) | up to 30 kg | Express delivery | Express delivery of documents and cargoes “from hand to hand” across Russia by a certain hour (delivery within 1–2 days). |
| 59 | Super express up to 12 p.m. | door–door (D-D) | up to 30 kg | Express delivery | Express delivery of documents and cargoes “from hand to hand” across Russia by a certain hour (delivery within 1–2 days). |
| 60 | Super express up to 14 p.m. | door–door (D-D) | up to 30 kg | Express delivery | Express delivery of documents and cargoes “from hand to hand” across Russia by a certain hour (delivery within 1–2 days). |
| 61 | Super express up to 16 p.m. | door–door (D-D) | up to 30 kg | Express delivery | Express delivery of documents and cargoes “from hand to hand” across Russia by a certain hour (delivery within 1–2 days). |
| 62 | Long-distance express warehouse–warehouse | warehouse–warehouse (W-W) | Economy delivery | Fast economy delivery of cargoes across Russia | |
| 63 | Long-distance super express warehouse-warehouse | warehouse–warehouse (W-W) | Economy delivery | Fast economy delivery of cargoes by a certain hour | |
| 118 | Economy express door–door | door–door (D-D) | Economy delivery | Inexpensive cargo delivery in Russia by rail and road (cargo delivery with an increase in terms). | |
| 119 | Economy express warehouse–door | warehouse–door (W-D) | |||
| 120 | Economy express door–warehouse | door–warehouse (D-W) | |||
| 121 | Main express door–door | door–door (D-D) | Economy delivery | Fast economical cargo delivery in Russia. | |
| 122 | Main express warehouse–door | warehouse–door (W-D) | |||
| 123 | Main express door–warehouse | door–warehouse (D-W) | |||
| 124 | Main super express door–door | door–door (D-D) | Economy delivery | Fast economical cargo delivery by a specific hour. | |
| 125 | Main super express warehouse–door | warehouse–door (W-D) | |||
| 126 | Main super express door–warehouse | door–warehouse (D-W) | |||
| 361 | Express lite door-parcel terminal | door-parcel teminal | up to 30 kg | Express | Classical express delivery of documents and cargoes across Russia. |
| 363 | Express lite warehouse-parcel terminal | warehouse-parcel terminal | |||
| 480 | Express door-door | door–door (D-D) | Express | Classic 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 | |
| 481 | Express door-warehouse | door–warehouse (D-W) | |||
| 482 | Express warehouse-door | warehouse–door (W-D) | |||
| 483 | Express warehouse-warehouse | warehouse–warehouse (W-W) | |||
| 485 | Express door-parcel terminal | door-parcel teminal (D-PT) | |||
| 486 | Express warehouse-parcel terminal | warehouse-parcel terminal (W-PT) |
Appendix 3. Delivery modes
| Code | Delivery mode |
|---|---|
| 1 | door–door |
| 2 | door–warehouse |
| 3 | warehouse–door |
| 4 | warehouse–warehouse |
| 6 | door-parcel teminal |
| 7 | warehouse-parcel terminal |