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_location | Sending address | location | yes |
6 | to_location | Receiving address | location | yes |
6.1 | code | Location code (CDEK reference book) | string() | yes |
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 |
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 |
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 |