Calculator. Calculation by available tariffs
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 | CDEK location code ("List of Cities" method) | 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 | CDEK location code ("List of Cities" method) | 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 | Сurrency code |
|---|---|---|
1 | Ruble | RUB |
2 | Tenge | KZT |
3 | Dollar | USD |
4 | Euro | EUR |
5 | Pound sterling | GBP |
6 | Yuan | CNY |
7 | Belarusian ruble | BYR |
8 | Hryvnia | UAH |
9 | Kyrgyzstani som | KGS |
10 | Armenian dram | AMD |
11 | Turkish lira | TRY |
12 | Thai baht | THB |
13 | Won | KRW |
14 | Dirham | AED |
15 | Sum | UZS |
16 | Tugrik | MNT |
17 | Złoty | PLN |
18 | Manat | AZN |
19 | Lari | GEL |
| 55 | Japanese yen | JPY |
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 | E-com Express warehouse-warehouse | warehouse-warehouse (W-W) | up to 500 kg | E-com Express | The fastest express delivery by air. |
293 | E-com Express door–door | door–door (D-D) | |||
294 | E-com Express warehouse–door | warehouse–door (W-D) | |||
295 | E-com Express door–warehouse | door–warehouse (D-W) | |||
509 | E-com Express door-parcel terminal | door-parcel terminal (D-PT) | |||
510 | E-com Express warehouse-parcel terminal | warehouse-parcel terminal (W-PT) | |||
| 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. |
| 184 | E-com Standard door–door | door–door (D-D) | E-com Standard | Standard express delivery. Service for the delivery of goods from abroad with customs clearance services (services for distance selling companies). | |
| 185 | E-com Standard warehouse–warehouse | warehouse–warehouse (W-W) | |||
| 186 | E-com Standard warehouse–door | warehouse–door (W-D) | |||
| 187 | E-com Standard door–warehouse | door–warehouse (D-W) | |||
| 497 | E-com Standard door-parcel terminal | door-parcel terminal (D-PT) | |||
| 498 | E-com Standard warehouse-parcel terminal | warehouse-parcel terminal (W-PT) | |||
| 2261 | Documents Express | door–door (D-D) | Individual restrictions depending on the direction | Documents Express | Fast international delivery of documents |
| 2266 | Documents Express | door-parcel terminal (D-PT) | |||
| 2262 | Documents Express | door–warehouse (D-W) | |||
| 2263 | Documents Express | warehouse–door (W-D) | |||
| 2267 | Documents Express | warehouse-parcel terminal (W-PT) | |||
| 2264 | Documents Express | warehouse–warehouse (W-W) |
Regular Delivery Tariffs
| Code | Tariff name | Delivery mode | Weight limit | Service | Description |
| 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. | |
| 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 | |
121 | Long-distance express door–door | door–door (D-D) | |||
122 | Long-distance express warehouse–door | warehouse–door (W-D) | |||
123 | Long-distance express door–warehouse | door–warehouse (D-W) | |||
63 | Long-distance super express warehouse-warehouse | warehouse–warehouse (W-W) | Economy delivery | Fast economical cargo delivery by a specific hour. | |
124 | Main super express door–door | door–door (D-D) | |||
125 | Main super express warehouse–door | warehouse–door (W-D) | |||
126 | Main super express door–warehouse | door–warehouse (D-W) | |||
| |||||
| 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 |
© 2000—2024, Курьерская компания СДЭК