Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

We have launched the delivery of parcels in SDEK parcel terminal! Already now you can send order to parcel terminals. Details of the protocol extension are here.
Delivery of parcels works both with prepayment and cash on delivery , with non-cash payment on the spot.

...

Version

Revision date

Revision description

1.5January 29, 2019Creation of the documentation
1.5February 4, 2019

New tags for international order registration have been added to the method "Order registration" for online store

New tags for the method "Order Change" have been added: RecipientName tag, Phone tag, Address block, DeliveryRecipientCostAdv block

A recommended phone number format has been described

1.5February 19, 2019Added description of the API calculator
1.5March 20, 2019

Additional service "Insurance" is allowed for delivery order.

Added test accounts, test method links.

1.5March 26, 2019

Added ability to identify:

  • order in the methods of changing and deleting an order by the CDEK order number;
  • city by a city name and/or an address string

Added ability to update international order fields in the changing order method.

1.5March 27, 2019Additional service "Package 1" is available.
1.5April 8, 2019

Added description of the calculator method "Calculating on tariffs without priority"

The country code in the ISO_3166-1_alpha-2 format has been added to the method "Loading the list of pickup points"

1.5April 24, 2019cityName, postcode и regionFiasGuid were added to the method "List of Cities"
1.5May 13, 2019

In the method "Registration of a Request from the Online Store" added the ability to specify the requisites of a real seller in the Seller block for further printing of requisites on checks: Name, Address, Phone, INN, OwnershipForm

Removed individual elements SellerName and SellerAddress

1.5June 17, 2019The opportunity to transfer goods marking will appear soon. In the documentation described the pass format of goods marking in the methods "Registration of a Request from the Online Store", "Order Update" and output format of goods marking in the methods "Order Status Report", "Order Information Report".
1.5August 26, 2019Mandatory fields of the Sender block have been changed in the methods "Registration of a Delivery Order"
1.5September 17, 2019New tag RecipientEmail has been added in the method "Order Change"
1.5September 29, 2019New tag timezone has been added in the "List of cities" method response
1.5October 28, 2019

New filter weightmin has been added in the method "Loading the List of Pickup Points"

New fileds have been added in the calculator methods for identify cities (senderCountryCode, receiverCountryCode, senderCity, receiverCity, senderLongitude, receiverLongitude, senderLatitude, receiverLatitude fields)

1.5January 19, 2020Comment attribute has become mandatory in the method "Registration of a courier invitation"
1.5March 23, 2020

New filter havecash and HaveCash, TakeOnly, WorkTimeExceptions fields have been added to the method "Loading the list of pickup points"

1.5March 27, 2020

The "package volume (in m³)" field is excluded from the calculator API

1.5April 17, 2020Added "Sent to the sender city" and "Received in the sending city" statuses
1.5June 8, 2020Keys of online-shop test account were changed
1.5July 10, 2020Updated reasons for Late Delivery
1.5July 13, 2020Fields were removed from the "Description of Input Parameters" method:
"DeliveryRecipientCost" - Additional delivery charge collected by the online store from the receiver (in the recipient country currency)
"DeliveryRecipientVATRate" - VAT rate included in the extra delivery charge (for more details, see Appendix No. 4)
"DeliveryRecipientVATSum" - VAT amount included in the extra delivery charge
1.5July 14, 2020The "ClientSide" field was removed from the "order Registration for delivery" method"
1.5July 23, 2020
  1. Loading the List of Pickup Points
    1. Changed the "default" value in the Type field from PVZ to ALL
    2. Added Dimensions, width, height, depth fields in response to the request
  2. Added new tariffs for the terminals (361,363, 366, 368, 376, 378)
  3. Added new modes of orders: door-post terminal and warehouse-post terminal
  4. A method of creating order and a method of changing the order:

    1. Updated conditions for the SizeA, SizeB, and SizeC fields
    2. Updated the condition for the PvzCode field
  5. Updated permissions for additional services (Appendix 2)
1.5September 3, 2020178, 179, 180, 181, 182, 183, 231, 232,376 tariff codes are no longer available
1.5September 24, 2020Removed the "Creation of a Pre-Alert Document" method
1.5October 5, 2020For the "Create order" and "Changing the order" methods, the "Length", "Width", and "Height" fields are required.
1.5November 11, 2020Field "isHandout" was added in the "Loading the List of Pickup Points" method
1.5December 15, 2020Field "IsReception" was added in the "Loading the List of Pickup Points" method
1.5
January 15, 2021
For the "Order statuses" report, a restriction on the period for uploading changes has been introduced. The period is limited to 31 days.
1.5January 22, 2021
The history of statuses using the "Order statuses" method can be obtained only for orders created not earlier than 2020.
1.5April 18, 2021
  1. Added requirement for labeling data
  2. Removed additional service "Delivery on weekends" due to redundancy. Delivery is carried out according to the work schedule of the Recipient's office, including on weekends.
1.5April 28, 2021New additional services are available in the "Order registration", "Calculator" methods (Notification of order creation in CDEK, Notification of acceptance of an order for delivery, Courier package A2, Secure package A2, Secure package A3, Secure package A4, Secure package A5)
1.5May 19, 2021New additional services are available in the "Order registration", "Calculator" methods (Box XS (0.5 kg 17x12x9 cm), Box S (2 kg 21x20x11 cm), Box M (5 kg 33x25x15 cm), Box L (12 kg 34x33x26 cm), Box (0.5 kg 17x12x10 cm), Box (1 kg 24x17x10 cm), Box (2 kg 34x24x10 cm), Box (3 kg 24x24x21 cm), Box (5 kg 40x24x21 cm), Box (15 kg 60x35x29 cm), Box (20 kg 47x40x43 cm), Box (30 kg 69x39x42 cm), Bubble wrap, Waste paper, Pressed filler cardboard (55x14x2.3 cm))
1.5August 16, 2021The provision of additional services "Packaging 1" and "Packaging 2"has been discontinued. When trying to create or change an order with the selected additional services "Package 1", "Package 2", an error is displayed.

Introduction

General Description

...

No.Tag / attributeDescriptionType of fieldMandatory (yes/no)
1InfoReportDocument title
yes
1.1OrderShipment (order)
yes
1.1.1NumberClient's shipment number. Order identifier in the IS of the CDEK client.string(30)yes
1.1.2DateDate on which the order has been transferred to the CDEK databasedateyes
1.1.3DispatchNumberCDEK shipment number (assigned when orders are imported). Order identifier in the CDEK IS.integeryes
1.1.4TariffTypeCodeTariff code (for more details, see Appendix No. 1)integeryes
1.1.5WeightEstimated weight (in kilograms)floatyes
1.1.6DeliverySumCost of delivery, in the settlement currency. Default: rubles.floatyes
1.1.7DateLastChangeLast change date for cost of deliverydateno
1.1.8CashOnDelivCash-on-delivery amount to be collected from the receiver in the currency of the receiver's country. Default: rubles.floatno
1.1.9CashOnDelivFactCash-on-delivery amount collected from the receiver in the currency of the receiver's country (default: rubles), subject to possible partial delivery. Available only for orders with the status “Delivered”floatno
1.1.10CashOnDelivTypePayment type of cash-on-delivery. Possible values: cash, cashless. Tag missing if payment information has not gotstrong(10)no
1.1.11DeliveryModeDelivery mode code (for more details, see Appendix No. 1)integeryes
1.1.12PvzCodePickup code specified in order at the time of request, for the delivery mode “to warehouse”string(10)yes
1.1.13DeliveryVariantDelivery option: (COURIER – courier, PVZCDEK – CDEK pickup point, PVZCLIENT – partner’s pickup point)string(10)yes
2.13SendCitySender's city
yes
2.13.1CodeCDEK city codeintegeryes
2.13.2PostCodePostal code of the citystring(6)yes
2.13.3NameCity namestring(50)yes
2.14RecCityReceiver's city
yes
2.14.1CodeCDEK city codeintegeryes
2.14.2PostCodePostal code of the citystring(6)yes
2.14.3NameCity namestring(50)yes
2.15AddedServiceAdditional services for orders
no
2.15.1ServiceCodeAdditional service code (for more details, see Appendix No. 2)integeryes
2.15.2SumValue of service in the settlement currency, default: rubles.floatyes
2.16PackagePackage (all packages are sent with different Package tags)
yes
2.16.1NumberPackage numberstring(20)yes
2.16.2BarCodePackage barcode, package identifierstring(20)yes
2.16.3WeightTotal weight (in kilograms)integerfloatyes
2.16.4VolumeWeightVolumetric weight (in kilograms), calculated by formula: SizeA*SizeB*SizeC/5,000integeryes
2.16.5SizeAPackage dimensions. Length (in centimeters)integeryes
2.16.6SizeBPackage dimensions. Width (in centimeters)integeryes
2.16.7SizeCPackage dimensions. Height (in centimeters)integeryes
2.16.8ItemItems (goods)
yes
2.16.8.1WareKeyIdentifier/item number of the goodsstring(50)yes
2.16.8.2MarkingMarking of itemstringno
2.16.8.3CommentName of the goods (may contain description of the goods: size, color)string(255)yes
2.16.8.4AmountQuantity of the goods transferred for deliveryintegeryes
2.16.8.5DelivAmountQuantity of items of the same type delivered (pcs)integeryes
2.16.8.6CostDeclared value of the goods (per item in the specified the contract currency)floatyes
2.16.8.7PaymentCash on delivery (per item in the recipient country currency)floatyes
2.16.8.8VATRateVAT rate included in the value of the goods (for more details, see Appendix No. 4)string(10)no
2.16.8.9VATSumVAT amount included in the value (payment) of the goods.floatno
2.16.8.10WeightWeight (per item, in kilograms)integerfloatyes


Info
titleInformation

The order information report method and order registration method refer to different modules of system, synchronization between which can take from several seconds to several minutes. We recommend to call order information report method after some time after creating an order.

...

5 For additional services 2, 24, 25 and 32, the parameter value is mandatory and must be passed in the request. For service 2 - insurance in param it is necessary to transfer the amount from which the insurance will be calculated (must be transferred in the currency of mutual settlements). Service 30 is only available for an on-line store contract, so the request must be passed the values of authLogin and secure. For services 24, 25, 32, 54-58, 61-73, 76 a quantity value is transmitted to param, for 74, 75 services a length value is transmitted.

...

5 For additional services 2, 24, 25 and 32, the parameter value is mandatory and must be passed in the request. For service 2 - insurance in param it is necessary to transfer the amount from which the insurance will be calculated (must be transferred in the currency of mutual settlements). Service 30 is only available for an on-line store contract, so the request must be passed the values of authLogin and secure. For services 24, 25, 32, 54-58, 61-73, 76 a quantity value is transmitted to param, for 74, 75 services a length value is transmitted.

...

Service codeAddition to an orderParameterDescription
2Permitted (only for delivery order)INSURANCE

Insurance coverage of a parcel. Extra insurance charge depends on the declared value of a shipment.

Note
titleNote

The service is charged automatically for all orders of the online store and cannot be added by the online store in the AddService tag.


3PermittedDELIVERY ON WEEKENDSCDEK can ship and deliver documents and cargoes on weekends and public holidays.
When documents or cargoes are shipped or delivered on weekends or public holidays, 300 rubles are added to the basic tariff.
5Not permitted, charged automaticallyHEAVY CARGOHeavy cargoes are charged as follows:
if the weight of a package is from 75 to 200 kg, the tariff is increased by 18 rubles per kilogram;
if the weight of a package exceeds 200 kg, the tariff is increased by 25 rubles per kilogram.
The cost of delivery of heavy cargoes can be calculated on an individual basis.
Tariffs on these shipments will be calculated on an individual basis and promptly (within one business day) and may be significantly lower than our basic tariffs.
6Not permitted, charged automaticallyOVERSIZED CARGOIn case of an oversized cargo one of whose sides exceeds 1.5 m, the tariff will be increased by 60 % (unless the cost of delivery is charged on the basis of volumetric weight).
In case of an oversized cargo one of whose sides exceeds 2.2 m, the tariff will be increased by 100 % (unless the cost of delivery is charged on the basis of volumetric weight).
7PermittedDANGEROUS CARGOESIn addition to ordinary documents and cargoes, CDEK is ready to deliver dangerous cargoes (other than prohibited for delivery).
Due to a certain risk, the cost of delivery of hazardous goods is increased by 1.5 times.
8Not permitted, charged automaticallyMORE THAN 15 MINUTES OF WAITING IN THE SENDER'S OFFICEA cargo must be prepared by the time of courier arrival.
According to CDEK rules, a courier can wait for a client to hand over or accept a cargo within 15 minutes.
If the waiting time exceeds 15 minutes, an extra fee of 170 roubles is charged.
Not permitted in the Parcel tariffs.
9Not permitted, charged automaticallyMORE THAN 15 MINUTES OF WAITING IN THE RECEIVER'S OFFICE
10Not permitted, charged automaticallyWAREHOUSE STORAGEOur company can store goods in its warehouse within the first 7 days FREE OF CHARGE.
Starting from the eighth day, the storage fee is charged as follows:
  • standard shipment (1 package with dimensions limited to 25*40*60 cm). Basic tariff: 15 rubles per package for 1 calendar day, including weekends and public holidays;
  • non-standard shipment (1 package with dimensions in excess of 25*40*60cm). Basic tariff: 30 rubles per package for 1 calendar day, including weekends and public holidays.
13Not permitted, to be charged by a CDEK employeeOTHERAdditional fee from the CDEK Credit Control Department.
14Not permitted, charged automaticallyREMOTE AREAIf cargoes are picked up or delivered by a courier from a remote area of the city, an additional fee is charged.
You can get the effective list of remote areas from the Help Desk by phone 8-800-250-04-05 (toll free) or from CDEK managers in office of your city.
15Not permitted, charged automaticallyREPEATED INVITATIONWhen a repeated courier invitation is required for a previously canceled order, or delivery / pickup have failed through the client's fault, an additional fee is charged.
This fee depends on the weight of shipment and cost of delivery in the city.
16PermittedPICKUP IN THE SENDER'S CITYAdditional service that allows a cargo to be picked up in the sender's city, provided that the “from warehouse” delivery mode is chosen (not available for the Parcel tariffs)
17PermittedDELIVERY IN THE RECEIVER'S CITYAdditional service that allows a cargo to be delivered in the receiver's city, provided that the “to warehouse” delivery mode is chosen (only for Long-distance and Long-distance super express tariffs)
20Not permitted, to be charged by a CDEK employeeDEFAULT INTERESTAdditional fee from the CDEK Credit Control Department.
23Not permitted, to be charged by a CDEK employeeCRATINGCDEK offers crating services to provide additional safety for your shipment. The cost of crating for each shipment is calculated on an individual basis. In other words, CDEK offers a customized package for your cargo.
24PermittedPACKAGE 1The price of 310*215*280 mm box is 30 rubles (for cargoes up to 10 kg).
25Available only through the personal account and the call centerPACKAGE 2The price of 430*310*28 0mm box is 45 rubles (for cargoes up to 15 kg).
26Available only through the call centerCOURIER LEASINGWhen you need to deliver or accept documents to federal agencies, such as tax authorities, ministries, embassies, courts, supervision services etc., or waiting time for your orders exceeds one hour, our company is willing to provide a courier for you. Price of the service: 170 rubles per hour. Minimum time: 3 hours (510 rubles).
27Available only through the personal account and the call centerSMS NOTIFICATIONCDEK offers the SMS notification service to each client.
A sender will be notified of date and time of delivery via SMS. Price of the service: 5 rubles
30PermittedHOME FITTINGA courier delivers several items (clothing, footwear, etc.) to a buyer for fitting.
32Not permitted, charged automatically depending on terms and conditions of the contractDOCUMENT SCANNINGTo confirm that your goods have been delivered, we can provide you with scanned documents signed by the receiver.
Price of the service: 50 rubles
33Available only through the personal account and the call centerACCESS BY STAIRS

The service is provided if oversized and heavy cargoes (heavier than 10 kg) need to be lifted to a floor.
This service has two options: “Access by Stairs” and “Access by Elevator”.
The price of the “Access by Stairs” service (no elevator is available)
for cargoes up to and including 30 kg — 50rubles per floor
for 31-50 kg — 70 rubles per floor
for 51-100 kg — 100 rubles per floor
for 101-150 kg — 130 rubles per floor
for cargoes heavier than 150 kg — 150 rubles per floor


The price of the Access by Elevator service:
for cargoes up to and including 30 kg — 50 rubles
for 31-50 kg — 70 rubles
for 51-100 kg — 100 rubles
for 101-150 kg — 130 rubles
for cargoes heavier than 100 kg — 150 rubles.

34Available only through the personal account and the call centerACCESS BY ELEVATOR
35Not permitted, charged automaticallyNOTIFICATION CALLThe Notification Call service is a preliminary call to receivers by operators of the call center prior to delivery. Price of the service: 15 rubles per order.
36PermittedPARTIAL DELIVERY

Upon delivery, a buyer may refuse to accept one or several items and purchase only part of his/her order.

Info
titleInformation

The service cannot be enabled if there’s only one item in the order.


37PermittedINSPECTION OF CONTENTSA buyer can inspect contents of his/her order before paying for it (opening a parcel).
40Not permitted, charged automaticallySPECIAL THERMAL CONDITIONSDirections that support delivery with special thermal conditions: Kemerovo–Novokuznetsk, Novosibirsk–Krasnoyarsk, Novosibirsk–Kemerovo, Novosibirsk–Tomsk, Novosibirsk–Omsk, Novosibirsk–Barnaul, Barnaul–Gorno-Altaysk AND OPPOSITE DIRECTIONS!
41Not permitted, charged automaticallyRETURN OF DOCUMENTSThe CDEK Delivery Service can return accompanying documents marked by the receiver, as well as return the goods to online stores and other sales outlets.
42Not permitted, charged automaticallyAGENCY COMMISSIONOur company can collect money from clients for goods and cash services.
48PermittedREVERSEA return delivery order from the receiver to the sender, for example, signed documents.
54PermittedCOURIER PACKAG A2The price 50 rubles
55PermittedSECURE PACKAGE A2The price 30 rubles
56PermittedSECURE PACKAGE A3The price 20 rubles
57PermittedSECURE PACKAGE A4The price 15 rubles
58PermittedSECURE PACKAGE A5The price 15 rubles
59PermittedNOTIFY ORDER CREATEDUsed when creating an order.
Recipient countries: Russia, Kazakhstan, Belarus
60PermittedNOTIFY ORDER DELIVERYUsed when creating an order.
Recipient countries: Russia, Kazakhstan, Belarus
61PermittedBox XS (0.5 kg 17x12x9 cm)A box made of three-layer corrugated cardboard with dimensions 170 * 125 * 95 mm. The maximum capacity is 0.5 kg.
The cost of 1 piece is 20 rubles.
Available for all tariffs from the warehouse.
62PermittedBox S (2 kg 21x20x11 cm)A box made of three-layer corrugated cardboard with dimensions of 216 * 200 * 110 mm. The maximum capacity is 2 kg.
The cost of 1 piece is 40 rubles.
Available for all tariffs from the warehouse.
63PermittedBox M (5 kg 33x25x15 cm)A box made of three-layer corrugated cardboard with a size of 330 * 250 * 155 mm. The maximum capacity is 5 kg.
The cost of 1 piece is 60 rubles.
Available for all tariffs from the warehouse.
64PermittedBox L (12 kg 34x33x26 cm)A box made of three-layer corrugated cardboard measuring 340 * 330 * 264 mm. The maximum capacity is 12 kg.
The cost of 1 piece is 70 rubles.
Available for all tariffs from the warehouse.
65PermittedBox (0.5 kg 17x12x10 cm)A box made of three-layer corrugated cardboard with dimensions 170 * 120 * 100 mm. The maximum capacity is 0.5 kg.
The cost of 1 piece is 20 rubles.
Available for all tariffs from the warehouse.
66PermittedBox (1 kg 24x17x10 cm)A box made of three-layer corrugated cardboard with dimensions of 240 * 170 * 100 mm. The maximum capacity is 1 kg.
The cost of 1 piece is 30 rubles.
Available for all tariffs from the warehouse.
67PermittedBox (2 kg 34x24x10 cm)A box made of three-layer corrugated cardboard measuring 340 * 240 * 100 mm. The maximum capacity is 2 kg.
The cost of 1 piece is 40 rubles.
Available for all tariffs from the warehouse.
68PermittedBox (3 kg 24x24x21 cm)A box made of three-layer corrugated cardboard with dimensions of 240 * 240 * 210 mm. The maximum capacity is 3 kg.
The cost of 1 piece is 50 rubles.
Available for all tariffs from the warehouse.
69PermittedBox (5 kg 40x24x21 cm)A box made of three-layer corrugated cardboard measuring 400 * 240 * 210 mm. The maximum capacity is 5 kg.
The cost of 1 piece is 60 rubles.
Available for all tariffs from the warehouse.
70PermittedBox (10 kg 40x35x28 cm)A box made of three-layer corrugated cardboard measuring 400 * 350 * 280 mm. The maximum capacity is 10 kg.
The cost of 1 piece is 70 rubles.
Available for all tariffs from the warehouse.
71PermittedBox (15 kg 60x35x29 cm)A box made of three-layer corrugated cardboard with dimensions of 600 * 350 * 290 mm. The maximum capacity is 15 kg.
The cost of 1 piece is 100 rubles.
Available for all tariffs from the warehouse (except for the "warehouse-parcel terminal" mode).
72PermittedBox (20 kg 47x40x43 cm)A box made of three-layer corrugated cardboard with a size of 470 * 400 * 430 mm. The maximum capacity is 20 kg.
The cost of 1 piece is 120 rubles.
Available for all tariffs from the warehouse (except for the "warehouse-parcel terminal" mode).
73PermittedBox (30 kg 69x39x42 cm)A box made of three-layer corrugated cardboard with dimensions of 690 * 390 * 420 mm. The maximum capacity is 30 kg.
The cost of 1 piece is 140 rubles.
Available for all tariffs from the warehouse (except for the "warehouse-parcel terminal" mode).
74PermittedBubble wrapHigh pressure polyethylene, two layers. It is an additional packaging material for packing shipments into transport packaging.
1 meter - 30 rubles.
Available for all tariffs from the warehouse.
75PermittedWaste paperWrapping paper (waste paper, class E). Width 0.42 m.Designed for packing various types of shipments (cargo) and filling voids inside the package
1 meter - 15 rubles.
Available for all tariffs from the warehouse.
76PermittedFiller pressed cardboard (55x14x2.3 cm)Protective insert made of sheet compressed cardboard. It is applied for:
- inner lathing inside the corrugated box
- wrapping and separating attachments inside the corrugated box
- filling voids.
The cost of 1 piece is 20 rubles.
Available for all tariffs from the warehouse.

...