Page tree
Skip to end of metadata
Go to start of metadata

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:

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

1date

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"
2 - "delivery"

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
Available: rus, eng, zho
Default value: rus

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.2message

Error description

string()

yes

Sample Request
{
    "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
        }
    ]
}
Sample Response
{
    "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

7International express documents door–doordoor–door (D-D)up to 5 kgInternational expressExpress delivery for / from abroad of documents and letters.
8International express freight door–doordoor–door (D-D)up to 30 kgInternational expressExpress 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)

  366Parcel door-parcel terminaldoor-parcel terminal

up to 30 kg


ParcelEconomy delivery of goods across Russia for e-commerce companies.
  368Parcel 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:

  • 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)
Express deliveryExpress delivery of documents and cargoes “from hand to hand” across Russia by a certain hour.
5Economy express warehouse–warehousewarehouse–warehouse (W-W)
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 30 kgExpress 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 30 kgExpress 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 30 kgExpress 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 30 kgExpress 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)up to 30 kgExpress 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)
Economy deliveryFast economy delivery of cargoes across Russia
63Long-distance super express warehouse-warehousewarehouse–warehouse (W-W)
Economy deliveryFast economy delivery of cargoes by a certain hour
118Economy express door–doordoor–door (D-D)
Economy deliveryInexpensive cargo delivery in Russia by rail and road (cargo delivery with an increase in terms).
119Economy express warehouse–doorwarehouse–door (W-D)
120Economy express door–warehousedoor–warehouse (D-W)
121Main express door–doordoor–door (D-D)
Economy deliveryFast economical cargo delivery in Russia.
122Main express warehouse–doorwarehouse–door (W-D)
123Main express door–warehousedoor–warehouse (D-W)
124Main super express door–doordoor–door (D-D)
Economy deliveryFast economical cargo delivery by a specific hour.
125Main super express warehouse–doorwarehouse–door (W-D)
126Main super express door–warehousedoor–warehouse (D-W)
361Express lite door-parcel terminaldoor-parcel teminalup to 30 kgExpressClassical express delivery of documents and cargoes across Russia.
363

Express lite warehouse-parcel terminal

warehouse-parcel terminal

Appendix 3. Delivery modes

CodeDelivery mode
1door–door
2door–warehouse
3warehouse–door
4warehouse–warehouse
6door-parcel teminal
7warehouse-parcel terminal
  • No labels