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 |