Для разработчиковЗаказать интеграциюНа сайт CDEK →

Calculator. Calculation by tariff code

 

The method is used to calculate cost and delivery time by tariff code.

Request for Calculation by tariff code

In order to use this process, a POST request should be sent to URL:

EnvironmentURL
testinghttps://api.edu.cdek.ru/v2/calculator/tariff
productionhttps://api.cdek.ru/v2/calculator/tariff

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"

  2. - "delivery"

Default value: 1

integer

no

3

currency

Currency for calculation (see Appendix 1 for details)

Default value: contract currency

integer

no

4

tariff_code

Tariff code (see Appendix 2 for details)

integer

yes

5

from_location1

Sending address

location

yes

5.1

code

CDEK location code ("List of Cities" method)

integer

no

5.2postal_code

Postal code

string(255)

no

5.3country_code

Country code in the format: ISO_3166-1_alpha-2

string(2)

no

5.4city

City name

string(255)

no

5.5address

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

Postal code

string(255)

no

6.3country_code

Country code in the format: ISO_3166-1_alpha-2

string(2)

no

6.4city

City name

string(255)

no

6.5address

Address string

string(255)

no

7

services

Additional services

service[ ]

no

7.1

code

Type of additional services, code from the reference book of additional services (see Appendix 3 for details)

string()

yes

7.2

parameter

Additional service parameter:

  • Number of packages. It is used and is mandatory only for PACKAGE_1, COURIER_PACKAGE_A2, SECURE_PACKAGE_A2, SECURE_PACKAGE_A3, SECURE_PACKAGE_A4, SECURE_PACKAGE_A5, CARTON_BOX_XS, CARTON_BOX_S, CARTON_BOX_M, CARTON_BOX_L, CARTON_BOX_500GR, CARTON_BOX_1KG, Фото документовCARTON_BOX_2KG, CARTON_BOX_3KG, CARTON_BOX_5KG, CARTON_BOX_10KG, CARTON_BOX_15KG, CARTON_BOX_20KG, CARTON_BOX_30KG, CARTON_FILLER (for all orders types).

  • Declared value of the package. It is used and is mandatory only for INSURANCE (only for orders of delivery type).

  • Length of package. It is used and is mandatory only for BUBBLE_WRAP, WASTE_PAPER (for all orders types).

  • Number of photos for service PHOTO_OF_DOCUMENTS 

string()

no

8

packages

List of information on packages

package []

yes

8.1

weight

Total weight (grams)

integer

yes

8.2

length

Package dimensions. Length (centimeters)

integer

no

8.3

width

Package dimensions. Width (centimeters)

integer

no

8.4

height

Package dimensions. Height (centimeters)

integer

no

1 The city is identified according to the following algorithm (listed in order of priority):

  1. By unique city code from the CDEK database. Values are transmitted in from_location.code and to_location.code attributes
  2. 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.
  3. By address string. Values are transmitted in from_location.address and to_location.address attributes. 

Answer to Calculation by tariff code

The response body is returned in the JSON format:

№

Field name

Description

Field type

Mandatory

1

delivery_sum

Price of delivery

float

yes

2

period_min

Min. delivery time (working days)

integer

yes

3

period_max

Max. delivery time (working days)

integer

yes

4

weight_calc

Calculated weight (grams)

integer

yes

5

services

Additional services (returned if the request contained additional services)

service[ ]

no

5.1

code

Type of additional services, code from the reference book of additional services

string()

yes

5.2

sum

Price of service

float

yes

6

total_sum

Price of delivery including additional services

float

yes

7

currency

Currency of the price of delivery (CDEK code)

string(3)

yes

8

errors

List or errors

error[]

no

8.1

code

Error code

string()

yes

8.2

message

Error description

string()

yes


{
    "type": "2",
    "date": "2020-11-03T11:49:32+0700",
    "currency": "1",
    "tariff_code": "11",
    "from_location": {
        "code": "270"
    },
    "to_location": {
        "code": "44"
    },
    "services": [
        {
            "code": "CARTON_BOX_XS",
            "parameter": "2"
        }
    ],
    "packages": [
        {
            "height": 10,
            "length": 10,
            "weight": 4000,
            "width": 10
        }
    ]
}


{
    "period_min": 2,
    "currency": "RUB",
    "delivery_sum": 1040.0,
    "weight_calc": 4000,
    "services": [
        {
            "code": "CARTON_BOX_XS",
            "sum": 100.0
        }
    ],
    "period_max": 2,
    "total_sum": 1140.0
}


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
55Japanese yenJPY

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

warehouse–door (W-D)

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. 
Service for the delivery of goods from abroad with customs clearance services (services for distance selling companies).




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)

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.

184E-com Standard door–doordoor–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).
185E-com Standard warehouse–warehousewarehouse–warehouse (W-W)
186E-com Standard warehouse–doorwarehouse–door (W-D)
187E-com Standard door–warehousedoor–warehouse (D-W)
497E-com Standard door-parcel terminaldoor-parcel terminal (D-PT)
498E-com Standard warehouse-parcel terminalwarehouse-parcel terminal (W-PT)
2261

Documents Express

door–door (D-D)Individual restrictions depending on the directionDocuments Express





Fast international delivery of documents



2266Documents Express door-parcel terminal (D-PT)
2262Documents Express door–warehouse (D-W)
2263Documents Express warehouse–door (W-D)
2267Documents Express warehouse-parcel terminal (W-PT)
2264Documents Express warehouse–warehouse (W-W)

Regular Delivery Tariffs

CodeTariff nameDelivery modeWeight limitServiceDescription
1*Express lite door–doordoor–door (D-D)up to 30 kgExpress

Classical express delivery of documents and cargoes up to 30 kg.

You need to use "Express" tariff

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 delivery

Cheap delivery of goods across Russia by rail and by road (longer delivery period).

You need to use "Main express" tariff

10*Express lite warehouse-warehousewarehouse–warehouse (W-W)up to 30 kgExpress

Classical express delivery of documents and cargoes across Russia.

You need to use "Express" tariff

11*Express lite warehouse–doorwarehouse–door (W-D)up to 30 kgExpress

Classical express delivery of documents and cargoes across Russia.

You need to use "Express" tariff

12*Express lite door–warehousedoor–warehouse (D-W)up to 30 kgExpress

Classical express delivery of documents and cargoes across Russia.

You need to use "Express" tariff

15Express heavy warehouse-warehousewarehouse–warehouse (W-W)from 30 kgExpress

Classical express delivery of cargoes across Russia.

You need to use "Express" tariff

16Express heavy warehouse–doorwarehouse–door (W-D)from 30 kgExpress

Classical express delivery of cargoes across Russia.

You need to use "Express" tariff

17Express heavy door–warehousedoor–warehouse (D-W)from 30 kgExpress

Classical express delivery of cargoes across Russia.

You need to use "Express" tariff

18Express heavy door–doordoor–door (D-D)from 30 kgExpress

Classical express delivery of cargoes across Russia.

You need to use "Express" tariff

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).

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)


118Economy express door–doordoor–door (D-D)
Economy delivery

Inexpensive cargo delivery in Russia by rail and road (cargo delivery with an increase in terms).

You need to use "Main express" tariff

119Economy express warehouse–doorwarehouse–door (W-D)
120Economy express door–warehousedoor–warehouse (D-W)
361Express lite door-parcel terminaldoor-parcel teminalup to 30 kgExpress

Classical express delivery of documents and cargoes across Russia.

You need to use "Express" tariff

363

Express lite warehouse-parcel terminal

warehouse-parcel termina
480Express door-doordoor–door (D-D)
ExpressClassic 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
481Express door-warehousedoor–warehouse (D-W)
482Express warehouse-doorwarehouse–door (W-D)
483Express warehouse-warehousewarehouse–warehouse (W-W)
485Express door-parcel terminaldoor-parcel teminal (D-PT)
486Express warehouse-parcel terminalwarehouse-parcel terminal (W-PT)
* - tariffs are available only in this method. In other methods, the tariffs are replaced by 480, 481, 482, 483, respectively. The calculation for the old and new tariffs is the same.

Appendix 3. Additional Services

Code

Name

INSURANCE

Insurance

DELIV_WEEKEND

Delivery on weekends

TAKE_SENDER

Pickup in the sender's city

DELIV_RECEIVER

Delivery in the receiver's city

TRYING_ON

Home fitting

PART_DELIV

Partial delivery

INSPECTION_CARGO

Inspection of contents

REVERSE

Reverse

DANGER_CARGO

Dangerous cargoes

PACKAGE_1

Package 1

PACKAGE_2

Package 2

WAIT_FOR_RECEIVER

Waiting over 15 minutes at receiver’s

WAIT_FOR_SENDER

Waiting over 15 minutes at sender’s

REPEATED_DELIVERY

Repeated delivery

SMS

SMS notification

GET_UP_FLOOR_BY_HAND

Delivery to the floor, manual

GET_UP_FLOOR_BY_ELEVATOR

Delivery to the floor, elevator

CALL

Call

THERMAL_MODE

Thermal mode

COURIER_PACKAGE_A2COURIER PACKAG A2
SECURE_PACKAGE_A2SECURE PACKAGE A2
SECURE_PACKAGE_A3SECURE PACKAGE A3
SECURE_PACKAGE_A4SECURE PACKAGE A4
SECURE_PACKAGE_A5SECURE PACKAGE A5
NOTIFY_ORDER_CREATEDNOTIFY ORDER CREATED
NOTIFY_ORDER_DELIVERYNOTIFY ORDER DELIVERY
CARTON_BOX_XSBox XS (0.5 kg 17x12x9 cm)
CARTON_BOX_SBox S (2 kg 21x20x11 cm)
CARTON_BOX_MBox M (5 kg 33x25x15 cm)
CARTON_BOX_LBox L (12 kg 34x33x26 cm)
CARTON_BOX_500GRBox (0.5 kg 17x12x10 cm)
CARTON_BOX_1KGBox (1 kg 24x17x10 cm)
CARTON_BOX_2KGBox (2 kg 34x24x10 cm)
CARTON_BOX_3KGBox (3 kg 24x24x21 cm)
CARTON_BOX_5KGBox (5 kg 40x24x21 cm)
CARTON_BOX_10KGBox (10 kg 40x35x28 cm)
CARTON_BOX_15KGBox (15 kg 60x35x29 cm)
CARTON_BOX_20KGBox (20 kg 47x40x43 cm)
CARTON_BOX_30KGBox (30 kg 69x39x42 cm)
BUBBLE_WRAPBubble wrap
WASTE_PAPERWaste paper
CARTON_FILLERFiller pressed cardboard (55x14x2.3 cm)
BAN_ATTACHMENT_INSPECTION

Disable attachment inspection

PHOTO_OF_DOCUMENTS

Photos of documents

LOADING_OPERATIONS_AT_THE_SENDER

Loading and unloading at the sender's address

LOAD_THE_OPERATION_AT_THE_RECIPIENT 

Loading and unloading at the recipient


 

© 2000—2024, Курьерская компания СДЭК