Page tree

Versions Compared

Key

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

...

Info

Мы запустили доставку посылок в постаматы СДЭК! Уже сейчас вы можете формировать отправления до постаматов. Детали расширения протокола здесь.
Выдача посылок работает как с предоплатой, так и с наложенным платежом , с безналичной оплатой на месте.

...

  • код тарифа, по которому был доставлен заказ;
  • стоимость выставленных услуг СДЭК по заказу (т.е. сумму на которую будет выставлен счет);
  • дата последнего изменения суммы заказа;
  • способ передачи заказа получателю (курьер, самозабор);
  • тип оплаты наложенного платежа.

11. Список регионов – используется для получения детальной информации о регионах.

Для получения списка регионов необходимо отправить запрос на сервер СДЭК.

12. Список городов – используется для получения детальной информации о городах.

...

3.2. Перечень методов API


Метод

Путь к методу (боевая версия)

Путь к методу (тестовая версия)
1Получение списка ПВЗhttps://integration.cdek.ru/pvzlist/v1/xml

https://integration.edu.cdek.ru/pvzlist/v1/xml

2

Регистрация заказ

2.1Заказ от ИМ

https://integration.cdek.ru/new_orders.php

https://integration.edu.cdek.ru/new_orders.php

2.2Заказ на доставку

https://integration.cdek.ru/addDelivery

https://integration.cdek.ru/addDeliveryRaw (для передачи контента в теле запроса)

https://integration.edu.cdek.ru/addDelivery

https://integration.edu.cdek.ru/addDeliveryRaw (для передачи контента в теле запроса)

3Изменение заказа

http://integration.cdek.ru/update

http://integration.cdek.ru/updateRaw (для передачи контента в теле запроса)

http://integration.edu.cdek.ru/update

http://integration.edu.cdek.ru/updateRaw (для передачи контента в теле запроса)

4Удаление заказа

https://integration.cdek.ru/delete_orders.php

https://integration.edu.cdek.ru/delete_orders.php

5Печать квитанции к заказуhttps://integration.cdek.ru/orders_print.php

https://integration.edu.cdek.ru/orders_print.php

6

Регистрация заявки на  вызова курьера

https://integration.cdek.ru/call_courier.php

https://integration.edu.cdek.ru/call_courier.php

7

Регистрация информации о результате прозвона

https://integration.cdek.ru/new_schedule.php

https://integration.edu.cdek.ru/new_schedule.php

8Печать ШК-мест

https://integration.cdek.ru/ordersPackagesPrint

https://integration.cdek.ru/ordersPackagesPrintRaw (для передачи контента в теле запроса)

https://integration.edu.cdek.ru/ordersPackagesPrint

https://integration.edu.cdek.ru/ordersPackagesPrintRaw (для передачи контента в теле запроса)

9Отчет "Статусы заказов"https://integration.cdek.ru/status_report_h.php

https://integration.edu.cdek.ru/status_report_h.php

10Отчет "Информация по заказам"https://integration.cdek.ru/info_report.php

https://integration.edu.cdek.ru/info_report.php

11Список регионов

https://integration.cdek.ru/v1/location/regions?

https://integration.edu.cdek.ru/v1/location/regions?

12Список городов

https://integration.cdek.ru/v1/location/cities?

https://integration.edu.cdek.ru/v1/location/cities?

13Расчет стоимости по тарифам с приоритетомhttp://api.cdek.ru/calculator/calculate_price_by_json.phphttp://api.edu.cdek.ru/calculator/calculate_price_by_json.php
14Расчет стоимости по тарифам без приоритетаhttp://api.cdek.ru/calculator/calculate_tarifflist.phphttp://api.edu.cdek.ru/calculator/calculate_tarifflist.php

3.3. Перевод ошибок интеграции

...

Сервер СДЭК вернет результат в виде XML :

Тэг/Атрибут

Описание

Тип поля

Обяз.

1

PvzList

Заголовок документа


да

1.1

Pvz

ПВЗ


да

1.1.1

Code

Код

string(10)

да

1.1.2PostalCodeПочтовый индексstring (6)да
1.1.3

Name

Название

string(50)

да

1.1.4

CountryCode

Код страны

integer(9)

да

1.1.5countryCodeIsoКод страны в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”)integer(2)да
1.1.6

CountryName

Название страны

string(50)

да

1.1.7

RegionCode

Код региона

integer(9)

да

1.1.8

RegionName

Название региона

string(50)

да

1.1.9

CityCode

Код города по базе СДЭК (Список городов)

integer

да

1.1.10

City

Название города

string(50)

да

1.1.11

WorkTime

Режим работы, строка вида «пн-пт 9-18, сб 9-16»

string(100)

да

1.1.12

Address

Адрес (улица, дом, офис) в указанном городе

string(255)

да

1.1.13

FullAddress

Полный адрес с указанием страны, региона, города, и т.д.

string(255)

да

1.1.14AddressCommentОписание местоположенияstring(255)да
1.1.15

Phone

Телефон

phone

да

1.1.16PhoneDetailListПеречень всех номеров телефонов офиса[0].numberда
1.1.17EmailАдрес электронной почтыstring(255)да
1.1.18

Note

Примечание по ПВЗ

string(255)

да

1.1.19

coordX

Координаты местоположения (долгота) в градусах

float

да

1.1.20

coordY

Координаты местоположения (широта) в градусах

float

да

1.1.21

Type

Тип ПВЗ:
PVZ- Пункт выдачи заказов, POSTAMAT- постамат СДЭК

string(8)

да

1.1.22

ownerCode

Принадлежность ПВЗ компании: CDEK — ПВЗ принадлежит компании СДЭК, InPost — ПВЗ принадлежит компании InPost.

string(6)

да

1.1.23

IsDressingRoom

Есть ли примерочная

string(4)

да

1.1.24

HaveCashless

Есть терминал оплаты

string(4)

да

1.1.25HaveCashЕсть приём наличныхstring(4)да
1.1.26AllowedCodРазрешен наложенный платеж в ПВЗstring(4)да
1.1.27TakeOnlyЯвляется ли ПВЗ только пунктом выдачи или также осуществляет приём грузовstring(4)да
1.1.28

NearestStation

Ближайшая станция/остановка транспорта

string(50)

да

1.1.29

MetroStation

Ближайшая станция метро

string(50)

да

1.1.30

Site

Ссылка на данный ПВЗ на сайте СДЭК

string(255)

нет

1.1.31

OfficeImage

Все фото офиса (кроме фото как доехать).



1.1.31.1

url

Все фотографии отдельным тегом с атрибутом url. Отображается ссылка на картинку. <OfficeImage url="http://dfdfdf/images/22/47_1_SUR2"/>

string(255)

да

1.1.32

WorkTimeY

График работы на неделю. Вложенный тег с атрибутами day и period.


да

1.1.32.1

day

Порядковый номер дня начиная с единицы. Понедельник = 1, воскресенье = 7.

integer (1)

да

1.1.32.2

periods

Период работы в эти дни. Если в этот день не работают, то не отображать.

string(20)

да

1.1.33WorkTimeExceptionsИсключения в графике работы офиса
да
1.1.33.1DateДатаdatetimeда
1.1.33.2TimeПериод работы в указанную дату. Если в этот день не работают, то не отображается.string(20)да
1.1.33.3IsWorkingПризнак рабочего/нерабочего дня в указанную датуstring(4)да

1.1.34

WeightLimit

Ограничения по весу для выдачи в ПВЗ (тэг существует только при наличии ограничений)


нет

1.1.34.1.

WeightMin

Минимальный вес (в кг.), принимаемый в ПВЗ (> WeightMin)

float

нет

1.1.34.2.

WeightMax

Максимальный вес (в кг.), принимаемый в ПВЗ (<=WeightMax)

float

нет

1.1.35DimensionsПеречень максимальных размеров ячеек постамата[ ]
1.1.35.1widthШирина (см)floatда, если Type= POSTAMAT или ALL
1.1.35.2heightВысота (см)floatда, если Type= POSTAMAT или ALL
1.1.35.3depthГлубина (см)floatда, если Type= POSTAMAT или ALL
1.1.36FulfillmentНаличие зоны фулфилментаstring(4)нет
1.1.37isHandoutЯвляется пунктом выдачиbooleanда
1.1.38IsReceptionЯвляется пунктом приёмаbooleanда


Пример. Список ПВЗ

Code Block
titlePVZList
Запрос списка ПВЗ в городе Новосибирске, в которых разрешен прием наложенного платежа
http://integration.cdek.ru/pvzlist/v1/xml?weightmax=50&cityid=270&allowedcod=1

...

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1

DeliveryRequest

Заголовок документа


да

1.1

Number

Номер акта приема-передачи/ТТН (сопроводительного документа при передаче груза СДЭК, формируется в системе ИМ).  Идентификатор реестра грузов в ИС клиента СДЭК. По умолчанию можно использовать 1.

string(30)

да

1.2

Date

Дата документа (дата заказа)

Date time/date

да

1.3

Account

Идентификатор ИМ (логин)

string(255)

да

1.4

Secure

Ключ

string(255)

да

1.5

OrderCount

Общее количество заказов в документе

integer

да

1.6

Order

Отправление (заказ)


да

1.6.1

Number

Номер отправления клиента (уникален в пределах заказов одного клиента). Идентификатор заказа в ИС Клиента.

string(40)

да

1.6.2

SendCityCode1

Код города отправителя из базы СДЭК (Список городов)

integer

да

1.6.3

RecCityCode1

Код города получателя из базы СДЭК (Список городов)

integer

да

1.6.4

SendCityPostCode1

Почтовый индекс города отправителя

string(6)

да

1.6.5

RecCityPostCode1

Почтовый индекс города получателя

string(6)

да

1.6.6

SendCountryCode1

Код страны отправителя для идентификации страны в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”). По умолчанию - RU.

string(2)

нет

1.6.7

RecCountryCode1

Код страны получателя для идентификации страны в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”). По умолчанию - RU.

string(2)

нет

1.6.8

SendCityName1

Наименование города отправителя

string(255)

нет

1.6.9

RecCityName1

Наименование города получателя

string(255)

нет

1.6.10RecipientINNИНН получателя. Используется для международных заказовstring(12)нет
1.6.11DateInvoiceДата инвойса. Используется для международных заказовDate time/dateда, если заказ - международный
1.6.12ShipperName

Грузоотправитель. Используется при печати накладной. Используется для международных заказов

string (255)да, если заказ - международный
1.6.13ShipperAddressАдрес грузоотправителя. Используется при печати накладной. Используется для международных заказовstring (255)да, если заказ - международный
1.6.14PassportДанные паспорта получателя. Используется для международных заказов
нет
1.6.14.1SeriesСерия паспорта получателяstring (255)нет
1.6.14.2NumberНомер паспорта получателяstring (255)нет
1.6.14.3IssueDateДата выдачи паспорта получателяDate time/dateнет
1.6.14.4IssuedByКем выдан паспорт получателяstring (255)нет
1.6.14.5DateBirthДата рождения получателяDate time/dateнет

1.6.15

Sender

Отправитель. Обязательно указывать, если отличается от Клиента ИМ. Если ИМ является отправителем, тэг Sender - отсутствует.


нет

1.6.15.1

Company

Наименование компании отправителя

string(128)

нет

1.6.15.2

Name

Контактное лицо отправителя

string(128)

нет

1.6.15.3

Address1

Адрес отправителя


нет

1.6.15.3.1

Street

Улица

string(50)

да

1.6.15.3.2

House

Дом

string(30)

нет

1.6.15.3.3

Flat

Квартира/офис

string(10)

нет

1.6.15.4

Phone

Телефон отправителя (передается отдельным тегом)

phone

нет

1.6.16

RecipientName

Получатель (ФИО). Минимум 3 символа.

string(128)

да

1.6.17

RecipientEmail

E-mail получателя для рассылки уведомлений о движении заказа, для связи в случае недозвона.

еmail

нет

1.6.18

Phone

Телефон получателя

phone

да

1.6.19

TariffTypeCode7

Код типа тарифа (подробнее см. приложение 1)

integer

да

1.6.20

DeliveryRecipientCost2

Доп. сбор за доставку, которую ИМ берет с получателя (в валюте страны получателя).

Если доп. сбор зависит от стоимости заказа, то данную информацию необходимо передавать в блоке DeliveryRecipientCostAdv. В этом случае в данном теге (DeliveryRecipientCost) передается стоимость доставки, когда сумма заказа превысила максимальный порог.

float

нет

1.6.21

DeliveryRecipientVATRateСтавка НДС, включенная в доп. сбор за доставку (подробнее см. приложение 4). Если значение не передано, то берется значение по умолчанию "Без НДС"string(10)нет

1.6.22

DeliveryRecipientVATSumСумма НДС, включенная в доп. сбор за доставку.floatнет
1.6.23SellerРеквизиты истинного продавца
нет
1.6.23.1AddressАдрес истинного продавца. Используется при печати инвойсов для отображения адреса настоящего продавца товара, либо торгового названия. Используется для международных заказовstring (255)да, если заказ - международный
1.6.23.2NameНаименование истинного продавцаstring (255)да, если указан ИНН
1.6.23.3INNИНН истинного продавцаstring (20)нет
1.6.23.4PhoneТелефон истинного продавцаphoneда, если указан ИНН
1.6.23.5OwnershipFormКод формы собственности (подробнее см. приложение 10)integerда, если указан ИНН

1.6.24

Comment3

Комментарий особые отметки по заказу

string(255)

нет

1.6.25

Address1

Адрес доставки. В зависимости от режима доставки необходимо указывать либо атрибуты «Street», «House», «Flat» - доставка до адресата получателя, либо «PvzCode» - самозабор


да

1.6.25.1

Street

Улица получателя. Рекомендуем по возможности не указывать префиксы значений, вроде «ул.»

string(50)

да

1.6.25.2

House

Дом, корпус, строение получателя.  Рекомендуем по возможности не указывать префиксы значений, вроде «дом»

string(30)

нет

1.6.25.3

Flat

Квартира/Офис получателя. Рекомендуем по возможности не указывать префиксы значений, вроде «кв.»

string(10)

нет

1.6.25.4

PvzCode

Код ПВЗ. Атрибут необходим для заказов с режимом доставки «до склада» и при условии, что не заказана дополнительная услуга "Доставка в городе получателе"(AddService="17", подробнее см. приложение 2), и для заказов с режимом "до постамата" 
Если указанный ПВЗ в момент создания заказа закрыт, то заказ будет принят на другой открытый ПВЗ, находящийся рядом с выбранным. Если указанный постамат в момент создания заказа закрыт, то заказ будет принят на другой открытый постамат или ПВЗ, находящийся рядом с выбранным. Получателю при этом уйдет СМС оповещение о замене ПВЗ/постамата. Если в городе все ПВЗ/постаматы в соответствии с выбранной услугой и тарифом закрыты, то регистрация заказа невозможна, будет возвращено соответствующее сообщение об ошибке.

string(10)

да, если режим доставки "до склада" или "до постамата"

1.6.26

Package

Упаковка (все упаковки передаются в разных тэгах Package)


да

1.6.26.1

Number

Номер упаковки (можно использовать порядковый номер упаковки заказа или номер заказа), уникален в пределах заказа. Идентификатор заказа в ИС Клиента.

string(20)

нет

1.6.26.2

BarCode

Штрих-код упаковки, идентификатор грузоместа (если есть, иначе передавать значение номера упаковки Packege.Number). Параметр используется для оперирования грузом на складах СДЭК), уникален в пределах заказа. Идентификатор грузоместа в ИС Клиента.

string(20)

да

1.6.26.3

Weight7

Общий вес (в граммах)

integer

да

1.6.26.4

SizeA4  

Габариты упаковки. Длина (в сантиметрах)

integer

да, если указаны остальные габариты, в пределах от 1 до 1500
или
если заказ до постамата
или
Общий вес >= 100 гр

1.6.26.5

SizeB4  

Габариты упаковки. Ширина (в сантиметрах)

integer

да, если указаны остальные габариты, в пределах от 1 до 1500
или
если заказ до постамата
или
Общий вес >= 100 гр

1.6.26.6

SizeC4  

Габариты упаковки. Высота (в сантиметрах)

integer

да, если указаны остальные габариты, в пределах от 1 до 1500
или
если заказ до постамата
или
Общий вес >= 100 гр

1.6.26.7

Item9

Вложение (товар). Максимум 126 позиций.


да

1.6.26.7.1AmountКоличество единиц одноименного товара (в штуках).
Максимальное количество - 999.
integerда
1.6.26.7.2

WareKey

Идентификатор/артикул товара/вложения.

string(50)

да

1.6.26.7.3Marking8

Маркировка товара/вложения.
Если для товара/вложения указана маркировка, Amount не может быть больше 1.

Для корректного отображения маркировки товара в чеке требуется передавать РАЗОБРАННЫЙ тип маркировки, который может выглядеть следующим образом: 

1) Массив байт закодированный в формате base64 

Пример: RE0DSU3xvJVMTFdHY3FUbVdSQkZI

2) Массив в виде строки, с пробелами или без:

Пример 1: 44 4D 04 3D 02 64 1E D1 3E 69 55 72 54 54 4E 2B 65 54 4D 63 74

Пример 2: 444D043D02641ED13E69557254544E2B65544D6374

stringнет
1.6.26.7.4

Cost

Объявленная стоимость товара (за единицу товара в валюте взаиморасчетов, значение >=0). С данного значения рассчитывается страховка.

float

да

1.6.26.7.5

Payment

Оплата за товар при получении (за единицу товара в валюте страны получателя, значение >=0) — наложенный платеж, в случае предоплаты значение = 0.

float

да

1.6.26.7.6PaymentVATRateСтавка НДС, включенная в стоимость товара (подробнее см. приложение 4). Если значение не передано, то берется значение по умолчанию "Без НДС"string(10)нет
1.6.26.7.7PaymentVATSumСумма НДС, включенного в стоимость (payment) товара.floatнет
1.6.26.7.8WeightВес (за единицу товара, в граммах)integerда
1.6.26.7.9CommentНаименование товара (может также содержать описание товара: размер, цвет)string(255)да
1.6.26.7.10WeightBrutto

Вес брутто (за единицу товара, в граммах). Используется для международных заказов

integerда, если заказ - международный
1.6.26.7.11CommentExНаименование товара  на английском (может также содержать описание товара: размер, цвет). Используется для международных заказовstring(255)нет
1.6.26.7.12Link

Ссылка на сайт интернет-магазина с описанием товара. Используется для международных заказов

string(255)нет
1.6.27DeliveryRecipientCostAdvДоп. сбор за доставку (которую ИМ берет с получателя), в зависимости от суммы заказа
Возможно указать несколько порогов

нет
1.6.27.1ThresholdПорог стоимости товара (действует по условию меньше или равно), в целых единицах валютыintegerда
1.6.27.2SumДоп. сбор за доставку товаров, общая стоимость которых попадает в интервалfloatда
1.6.27.3VATRateСтавка НДС, включенная в доп. сбор за доставку (подробнее см. приложение 4). Если значение не передано, то берется значение по умолчанию "Без НДС"string(10)нет
1.6.27.4VATSumСумма НДС, включенная в доп. сбор за доставку.floatнет
1.6.28AddServiceДополнительные услуги
нет
1.6.28.1

ServiceCode

Тип дополнительной услуги (подробнее см. приложение 2)integerда
1.6.28.2CountКоличество упаковок для дополнительных услуг с кодами 24, 54-58, 61-73, 76 integerнет
1.6.28.3LengthДлина упаковки для дополнительных услуг с кодами 74, 75floatнет
1.6.29Schedule5Расписание времени доставки (deprecated, рекомендуется использовать отдельный метод new_schedule)
нет

1.6.29.1

Attempt

Время доставки (в один день возможен один временной интервал не менее 3 часов)


да

1.6.29.1.1

ID

Идентификационный номер расписания по базе ИМ. По умолчанию можно использовать 1

integer

да

1.6.29.1.2

Date

Дата доставки (только дата, в формате «YYYY-MM-DD», без времени) согласованная с получателем

date

да

1.6.29.1.3

Comment

Комментарий

string(255)

нет

1.6.29.1.4

TimeBeg

Начало временного диапазона доставки (время получателя)

time

да

1.6.29.1.5

TimeEnd

Окончание временного диапазона доставки (время получателя)

time

да

1.6.29.1.6

Address

Новый адрес доставки (если требуется изменить). В зависимости от режима доставки необходимо указывать либо атрибуты «Street», «House», «Flat» - доставка до адресата получателя, либо «PvzCode» - самозабор


нет

1.6.29.1.6.1

Street

Улица получателя. Рекомендуем по возможности не указывать префиксы значений вроде «ул.»

string(50)

да

1.6.29.1.6.2

House

Дом, корпус, строение получателя.  Рекомендуем по возможности не указывать префиксы значений вроде «дом»

string(30)

да

1.6.29.1.6.3

Flat

Квартира/Офис получателя.  Рекомендуем по возможности не указывать префиксы значений вроде «кв.»

string(10)

нет

1.6.29.1.6.4

PvzCode

Код ПВЗ, необходим только для заказов с режимом доставки «до склада» и при условии, что не заказана дополнительная услуга "Доставка в городе получателе".

string(10)

да

1.7CallCourier6Вызов курьера
нет

1.7.1

Call

Ожидание курьера


да

1.7.1.1

Date

Дата ожидания курьера

date

да

1.7.1.2

TimeBeg

Время начала ожидания курьера

time

да

1.7.1.3

TimeEnd

Время окончания ожидания курьера

time

да

1.7.1.4

LunchBeg

Время начала обеда, если входит во временной диапазон [TimeBeg; TimeEnd]

time

нет

1.7.1.5

LunchEnd

Время окончания обеда, если входит во временной диапазон [TimeBeg; TimeEnd]

time

нет

1.7.1.6

SendCityCode1

Код города отправителя из базы СДЭК (Список городов)

integer

да

1.7.1.7

SendCityPostCode1

Почтовый индекс города отправителя

string(6)

да

1.7.1.8

SendCountryCode1

Код страны отправителя для идентификации страны в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”)

string(2)

нет

1.7.1.9

SendCityName1

Наименование города отправителя

string(255)

нет

1.7.1.10

SendPhone

Контактный телефон отправителя

phone

да

1.7.1.11

SenderName

Отправитель (ФИО)

string(255)

да

1.7.1.12

Comment

Комментарий для курьера

string(255)

нет

1.7.1.13

SendAddress1

Адрес отправителя


да

1.7.1.13.1

Street

Улица отправителя. Рекомендуем по возможности не указывать префиксы значений, вроде «ул.»

string(50)

да

1.7.1.13.2

House

Дом, корпус, строение отправителя.  Рекомендуем по возможности не указывать префиксы значений, вроде «дом»

string(30)

да

1.7.1.13.3

Flat

Квартира/Офис отправителя.  Рекомендуем по возможности не указывать префиксы значений, вроде «кв.»

string(10)

да

...

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1

DeliveryRequest

Заголовок документа


да

1.1

Number

Номер акта приема-передачи/ТТН.  Идентификатор реестра грузов в ИС клиента СДЭК. По умолчанию можно использовать 1.

string(30)

да

1.2

Date

Дата документа (дата заказа)

Date time/date

да

1.3

Account

Идентификатор Клиента (логин)

string(255)

да

1.4

Secure

Ключ

string(255)

да

1.5

OrderCount

Общее количество заказов в документе

integer

да

1.6

Order

Отправление (заказ)


да

1.6.1

SendCityCode1

Код города отправителя из базы СДЭК (Список городов)

integer

да

1.6.2

RecCityCode1

Код города получателя из базы СДЭК (Список городов)

integer

да

1.6.3

SendCityPostCode1

Почтовый индекс города отправителя

string(6)

да

1.6.4

RecCityPostCode1

Почтовый индекс города получателя

string(6)

да

1.6.5

SendCountryCode1

Код страны отправителя для идентификации страны в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”). По умолчанию - RU.

string(2)

нет

1.6.6

RecCountryCode1

Код страны получателя для идентификации страны в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”). По умолчанию - RU.

string(2)

нет

1.6.7

SendCityName1

Наименование города отправителя

string(255)

нет

1.6.8

RecCityName1

Наименование города получателя

string(255)

нет

1.6.9

Sender

Отправитель


да

1.6.91

Company

Наименование компании отправителя

string(128)

нет

1.6.9.2

Name

Контактное лицо отправителя

string(128)

да

1.6.9.3

Address1

Адрес забора груза


да

1.6.9.3.1

Street

Улица

string(50)

да

1.6.9.3.2

House

Дом

string(30)

нет

1.6.9.3.3

Flat

Квартира/офис

string(10)

нет

1.6.9.4

Phone

Телефон отправителя (передается отдельным тегом)

phone

да

1.6.10RecipientCompanyНаименование компании получателяstring(128)да

1.6.11

RecipientName

Получатель (ФИО). Минимум 3 символа.

string(128)

да

1.6.12

RecipientEmail

E-mail получателя для рассылки уведомлений о движении заказа, для связи в случае недозвона.

еmail

нет

1.6.13

Phone

Телефон получателя

phone

да

1.6.14

TariffTypeCode7

Код типа тарифа (подробнее см. приложение 1)

integer

да

1.6.15

Comment3

Комментарий особые отметки по заказу

string(255)

нет

1.6.16

Address1

Адрес доставки. В зависимости от режима доставки необходимо указывать либо атрибуты «Street», «House», «Flat» - доставка до адресата получателя, либо «PvzCode» - самозабор


да

1.6.16.1

Street

Улица получателя. Рекомендуем по возможности не указывать префиксы значений, вроде «ул.»

string(50)

да

1.6.16.2

House

Дом, корпус, строение получателя.  Рекомендуем по возможности не указывать префиксы значений, вроде «дом»

string(30)

нет

1.6.16.3

Flat

Квартира/Офис получателя. Рекомендуем по возможности не указывать префиксы значений, вроде «кв.»

string(10)

нет

1.6.16.4

PvzCode

Код ПВЗ. Атрибут необходим для заказов с режимом доставки «до склада» и при условии, что не заказана дополнительная услуга "Доставка в городе получателе"(AddService="17", подробнее см. приложение 2), и для заказов с режимом "до постамата" 
Если указанный ПВЗ в момент создания заказа закрыт, то заказ будет принят на другой открытый ПВЗ, находящийся рядом с выбранным. Если указанный постамат в момент создания заказа закрыт, то заказ будет принят на другой открытый постамат или ПВЗ, находящийся рядом с выбранным.Получателю при этом уйдет СМС оповещение о замене ПВЗ/постамата. Если в городе все ПВЗ/постаматы в соответствии с выбранной услугой и тарифом закрыты, то регистрация заказа невозможна, будет возвращено соответствующее сообщение об ошибке.

string(10)

да, если режим доставки "до склада" иди "до постамата"

1.6.17

Package

Упаковка (все упаковки передаются в разных тэгах Package)


да

1.6.17.1

Number

Номер упаковки (можно использовать порядковый номер упаковки заказа или номер заказа), уникален в пределах заказа. Идентификатор заказа в ИС Клиента.

string(20)

нет

1.6.17.2

BarCode

Штрих-код упаковки, идентификатор грузоместа (если есть, иначе передавать значение номера упаковки Packege.Number). Параметр используется для оперирования грузом на складах СДЭК), уникален в пределах заказа. Идентификатор грузоместа в ИС Клиента.

string(20)

да

1.6.17.3

Weight7

Общий вес (в граммах)

integer

нет

1.6.17.4

SizeA4  

Габариты упаковки. Длина (в сантиметрах)

integer

да, если указаны остальные габариты, в пределах от 1 до 1500
или
если заказ до постамата
или
Общий вес >= 100 гр

1.6.17.5

SizeB4  

Габариты упаковки. Ширина (в сантиметрах)

integer

да, если указаны остальные габариты, в пределах от 1 до 1500
или
если заказ до постамата
или
Общий вес >= 100 гр

1.6.17.6

SizeC4  

Габариты упаковки. Высота (в сантиметрах)

integer

да, если указаны остальные габариты, в пределах от 1 до 1500
или
если заказ до постамата
или
Общий вес >= 100 гр

1.6.17.7CommentОписаниеstring(255)да
1.6.18AddServiceДополнительные услуги
нет
1.6.18.1

ServiceCode

Тип дополнительной услуги (подробнее см. приложение 2)integerда
1.6.18.2CostОбъявленная стоимость отправления (заказа) для дополнительной услуги с кодом 2floatнет
1.6.18.3CountКоличество упаковок для дополнительных услуг c кодами 24, 54-58, 61-73, 76integerнет
1.6.18.4LengthДлина упаковки в метрах для дополнительных услуг c кодами 74, 75floatнет

...


Сервер СДЭК вернет результат в виде XML :

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1ResponseЗаголовок документа
да
1.1OrderЗаказ
да
1.1.1DispatchNumber

Номер заказа СДЭК

Возвращается в случае успешного создания заказа или при возникновении ошибки
ErrorCode="ERR_ORDER_DUBL_EXISTS"

integerнет
1.1.2NumberНомер заказа ИМstring(40)да
1.1.3ErrorCodeКод ошибкиstring(255)нет
1.1.4Msg

Фиксированный текст "Добавлено заказов"

Описание ошибки (при ее возникновении)

string(255)да
1.2CallВызов курьера
нет
1.2.1NumberНомер заявкиstring(30)да
1.2.2ErrorCodeКод ошибкиstring(255)нет
1.2.3Msg

Фиксированный текст "Добавлено заказов"

Описание ошибки (при ее возникновении)

string(255)да


Пример 1. Регистрация заказа типа “интернет-магазин”

...

4.3.1. Описание передаваемых полей запроса


Тэг/Атрибут

Описание

Тип поля

Обязательность для заполнения

1

UpdateRequest

Заголовок документа


да

1.1

Number

Номер акта приема-передачи. Идентификатор заказа в ИС клиента СДЭК.

string(30)

да

1.2

Date

Дата документа (дата заказа)

Date time/date

да

1.3

Account

Идентификатор ИМ (логин)

string(255)

да

1.4

Secure

Ключ

string(255)

да

1.5

OrderCount

Общее количество заказов в документе

integer

да

1.6

Order

Отправление (заказ)


да

1.6.1

Number1

Номер отправления клиента (уникален в пределах заказов одного клиента). Идентификатор заказа в ИС Клиента.

string(40)

да

1.6.2DispatchNumber1Номер заказа СДЭКintegerда

1.6.3

DeliveryRecipientCost

Доп. сбор за доставку, которую ИМ берет с получателя (в валюте страны получателя)

float

нет

1.6.4

DeliveryRecipientVATRate

Ставка НДС, включенная в доп. сбор за доставку (подробнее см. приложение 4)

string(10)

нет

1.6.5

DeliveryRecipientVATSum

Сумма НДС, включенная в доп. сбор за доставку.

float

нет

1.6.6RecipientNameПолучатель (ФИО). Минимум 3 символа.string(128)нет
1.6.7PhoneТелефон получателяphoneнет
1.6.8RecipientINNИНН получателя. Только для международных заказовstring(12)нет
1.6.9RecipientEmailE-mail получателя для рассылки уведомлений о движении заказа, для связи в случае недозвона.еmailнет
1.6.10.DateInvoiceДата инвойса. Только для международных заказовDate time/dateнет
1.6.11PassportДанные паспорта получателя. Только для международных заказов (необязательно)
нет
1.6.11.1SeriesСерия паспорта получателяstring(255)нет
1.6.11.2NumberНомер паспорта получателяstring(255)нет
1.6.11.3IssueDateДата выдачи паспорта получателяDate time/dateнет
1.6.11.4IssuedByКем выдан паспорт получателяstring(255)нет
1.6.11.5DateBirthДата рождения получателяDate time/dateнет
1.6.12AddressАдрес доставки. В зависимости от режима доставки необходимо указывать либо атрибуты «Street», «House», «Flat» - доставка до адресата получателя, либо «PvzCode» - самозабор
нет
1.6.12.1StreetУлица получателя. Рекомендуем по возможности не указывать префиксы значений, вроде «ул.»string(50)да
1.6.12.2HouseДом, корпус, строение получателя.  Рекомендуем по возможности не указывать префиксы значений, вроде «дом»string(30)да
1.6.12.3FlatКвартира/Офис получателя. Рекомендуем по возможности не указывать префиксы значений, вроде «кв.»string(10)нет
1.6.12.4PvzCodeКод ПВЗ. Атрибут необходим для заказов с режимом доставки «до склада» и при условии, что не заказана дополнительная услуга "Доставка в городе получателе"(AddService="17", подробнее см. приложение 2), и для заказов с режимом "до постамата" 
Если указанный ПВЗ в момент создания заказа закрыт, то заказ будет принят на другой открытый ПВЗ, находящийся рядом с выбранным. Если указанный постамат в момент создания заказа закрыт, то заказ будет принят на другой открытый постамат или ПВЗ, находящийся рядом с выбранным.Получателю при этом уйдет СМС оповещение о замене ПВЗ/постамата. Если в городе все ПВЗ/постаматы в соответствии с выбранной услугой и тарифом закрыты, то регистрация заказа невозможна, будет возвращено соответствующее сообщение об ошибке.
string(10)да, если режим доставки "до склада" или "до постамата"
1.6.13DeliveryRecipientCostAdvДоп. сбор за доставку (которую ИМ берет с получателя), в зависимости от суммы заказа
Возможно указать несколько порогов

нет
1.6.13.1ThresholdПорог стоимости товара (действует по условию меньше или равно), в целых единицах валютыintegerда
1.6.13.2SumДоп. сбор за доставку товаров, общая стоимость которых попадает в интервалfloatда
1.6.13.3VATRateСтавка НДС, включенная в доп. сбор за доставку (подробнее см. приложение 4). Если значение не передано, то берется значение по умолчанию "Без НДС"string(10)нет
1.6.13.4VATSumСумма НДС, включенная в доп. сбор за доставку.floatнет

1.6.14

Package

Упаковка (все упаковки передаются в разных тэгах Package)


нет

1.6.14.1

Number

Номер упаковки (можно использовать порядковый номер упаковки заказа или номер заказа), уникален в пределах заказа. Идентификатор заказа в ИС Клиента.

string(20)

да

1.6.14.2

BarCode

Штрих-код упаковки, идентификатор грузоместа (если есть, иначе передавать значение номера упаковки Package.Number). Параметр используется для оперирования грузом на складах СДЭК), уникален в пределах заказа. Идентификатор грузоместа в ИС Клиента.

string(20)

да

1.6.14.3

Weight

Общий вес (в граммах)

integer

да

1.6.14.4

SizeA

Габариты упаковки. Длина (в сантиметрах)

integer

да, если указаны остальные габариты, в пределах от 1 до 1500
или
если заказ до постамата
или
Общий вес >= 100 гр

1.6.14.5

SizeB

Габариты упаковки. Ширина (в сантиметрах)

integer

да, если указаны остальные габариты, в пределах от 1 до 1500
или
если заказ до постамата
или
Общий вес >= 100 гр

1.6.14.6

SizeC

Габариты упаковки. Высота (в сантиметрах)

integer

да, если указаны остальные габариты, в пределах от 1 до 1500
или
если заказ до постамата
или
Общий вес >= 100 гр

1.6.14.7

Item

Вложение (товар). Максимум 126 уникальных позиций.


да

1.6.14.7.1AmountКоличество единиц одноименного товара (в штуках)integerда

1.6.14.7.2

WareKey

Идентификатор/артикул товара/вложения.

string(50)

да

1.6.14.7.3Marking

Маркировка товара/вложения.
Если для товара/вложения указана маркировка, Amount не может быть больше 1.

Для корректного отображения маркировки товара в чеке требуется передавать РАЗОБРАННЫЙ тип маркировки, который может выглядеть следующим образом: 

1) Массив байт закодированный в формате base64 

Пример: RE0DSU3xvJVMTFdHY3FUbVdSQkZI

2) Массив в виде строки, с пробелами или без:

Пример 1: 44 4D 04 3D 02 64 1E D1 3E 69 55 72 54 54 4E 2B 65 54 4D 63 74

Пример 2: 444D043D02641ED13E69557254544E2B65544D6374

stringнет

1.6.14.7.4

Cost

Объявленная стоимость товара (за единицу товара в валюте взаиморасчетов, значение >=0). С данного значения рассчитывается страховка.

float

да

1.6.14.7.5

Payment

Оплата за товар при получении (за единицу товара в валюте страны получателя, значение >=0) — наложенный платеж, в случае предоплаты значение = 0.

float

да

1.6.14.7.6

PaymentVATRate

Ставка НДС, включенная в стоимость товара (подробнее см. приложение 4)

string(10)

да

1.6.14.7.7

PaymentVATSum

Сумма НДС, включенного в стоимость (payment) товара.

float

да

1.6.14.7.8WeightВес (за единицу товара, в граммах)integerда
1.6.14.7.9CommentНаименование товара (может также содержать описание товара: размер, цвет)string(255)да
1.6.14.7.10WeightBruttoВес брутто (за единицу товара, в граммах). Только для международных заказовintegerнет
1.6.14.7.11CommentExНаименование товара  на английском (может также содержать описание товара: размер, цвет). Только для международных заказовstring(255)нет
1.6.14.7.12LinkСсылка на сайт интернет-магазина с описанием товара. Только для международных заказовstring(255)нет

1 Идентификация заказа осуществляется либо по «DispatchNumber», либо по «Number». 

...


Сервер СДЭК вернет результат в виде XML :

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1ResponseЗаголовок документа
да
1.1OrderЗаказ
да
1.1.1DispatchNumberНомер заказа СДЭКintegerда
1.1.2NumberНомер заказа ИМstring(40)да
1.1.3ErrorCodeКод ошибкиstring(255)нет
1.1.4Msg

Фиксированный текст "Изменено заказов"

Описание ошибки (при ее возникновении)

string(255)да


Пример. Изменение заказа

Code Block
languagexml
titleUpdateRequest
<?xml version="1.0" encoding="UTF-8"?>
<updaterequest account="716b2c7e8f2e1a46ff8fd126adaef97d"
    date="2017-05-05 11:20:45" number="soOEl" ordercount="1" secure="928324323f570dd1ee567e71f32a78e7">
    <order deliveryrecipientcost="10.02" deliveryrecipientvatrate="VATX" deliveryrecipientvatsum="0.0" number="177875705">    
        <package barcode="barcode-soOEl00" number="soOEl00" sizea="2.0" sizeb="3.0" sizec="4.0" weight="100.0">
            <item amount="2" comment="comment-soOEl000" cost="8.0" payment="10.0" paymentvatrate="VATX" paymentvatsum="0.0" warekey="warekey-soOEl000" weight="1.0"/>
        </package>
    </order>
</updaterequest>

...

4.4.1. Описание передаваемых полей запроса


Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1

DeleteRequest

Заголовок документа


да

1.1

Number

Номер акта приема-передачи. Идентификатор заказа в ИС клиента СДЭК.

string(30)

да

1.2

Date

Дата документа (дата заказа)

datetime/date

да

1.3

Account

Идентификатор ИМ (логин)

string(255)

да

1.4

Secure

Ключ

string(255)

да

1.5

OrderCount

Общее количество заказов для удаления в документе

integer

да

2

Order

Отправление (заказ)


да

2.1

 Number1

Номер отправления клиента. Идентификатор заказа в ИС клиента СДЭК.

string(40)

да

2.2DispatchNumber1Номер заказа СДЭКintegerда

1 Идентификация заказа осуществляется либо по «DispatchNumber», либо по «Number». 

...


Сервер СДЭК вернет результат в виде XML :

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1ResponseЗаголовок документа
да
1.1OrderЗаказintegerда
1.1.1DispatchNumberНомер заказа СДЭКintegerда
1.1.2NumberНомер акта приема-передачи. Идентификатор заказа в ИС клиента СДЭК.string(40)да
1.1.3ErrorCodeКод ошибкиstring(255)нет
1.1.4Msg

Фиксированный текст "Удалено заказов X", где Х - количество удаленных заказов

Описание ошибки (при ее возникновении)

string(255)да


Пример. Удаление заказа

Code Block
languagexml
titleDeleteRequest
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<deleterequest number="123" ordercount="1" account="716b2c7e8f2e1a46ff8fd126adaef97d" date="2017-04-18 13:41:51" secure="ddb5b74a058c60bef584d797b1e4d167">
	<order number="number-8ZSO90"/>
</deleterequest>

...

4.5.1. Описание передаваемых полей запроса

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1

OrdersPrint

Заголовок документа


да

1.1

Date

Дата документа (дата вызова)

datetime/date

да

1.2

Account

Идентификатор ИМ (логин)

string(255)

да

1.3

Secure

Ключ

string(255)

да

1.4

OrderCount

Общее количество передаваемых в документе заказов

integer

да

1.5CopyCountЧисло копий одной квитанции на листе. Рекомендовано указывать не менее 2, одна приклеивается на груз, вторая остается у отправителя.integerнет

1.6

Order

Отправление (заказ)


да

1.6.1

DispatchNumber1

Номер отправления СДЭК (присваивается при импорте заказов). Идентификатор заказа в ИС клиента СДЭК.

integer

да

1.6.2

Number1

Номер отправления клиента. Идентификатор заказа в ИС клиента СДЭК.

string(30)

да

1.6.3

Date1

Дата акта приема-передачи, в котором был передан заказ

date

да

1 Идентификация заказа осуществляется либо по «DispatchNumber», либо по двум параметрам «Number», «Date». Если в запросе есть значение атрибута «DispatchNumber», то атрибуты «Number», «Date» игнорируются.

...


В ответ сервер СДЭК вернет pdf-файл.
В случае ошибки результат вернется в виде XML :

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1ResponseЗаголовок документа
да
1.1OrderЗаказ
да
1.1.1ErrorCodeКод ошибкиstring(255)нет
1.1.2Msg

Описание ошибки

string(255)да


Пример. Печать квитанции к заказу

...

4.6.1 Описание передаваемых данных


Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1

CallCourier

Заголовок документа


да

1.2

Date

Дата документа (дата вызова)

datetime/date

да

1.3

Account

Идентификатор ИМ (логин)

string(255)

да

1.4

Secure

Ключ

string(255)

да

1.5

CallCount

Общее количество заявок для вызова курьера в документе

integer

да

1.6

Call

Ожидание курьера


да

1.6.1

Date

Дата ожидания курьера

date

да

1.6.2

TimeBeg

Время начала ожидания курьера

time

да

1.6.3

TimeEnd

Время окончания ожидания курьера

time

да

1.6.4

LunchBeg

Время начала обеда, если входит во временной диапазон [TimeBeg; TimeEnd]

time

нет

1.6.5

LunchEnd

Время окончания обеда, если входит во временной диапазон [TimeBeg; TimeEnd]

time

нет

1.6.6

SendCityCode1

Код города отправителя из базы СДЭК (Список городов)

integer

да, если не задан DispatchNumber

1.6.7

SendCityPostCode1

Почтовый индекс города отправителя

string(6)

да

1.6.8

SendCountryCode1

Код страны отправителя для идентификации страны в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”)

string(2)

нет

1.6.9

SendCityName1

Наименование города отправителя

string(255)

нет

1.6.10

SendPhone

Контактный телефон отправителя

phone

да, если

  1. не задан DispatchNumber

  2.  DispatchNumber задан и  номер телефона не указан в накладной

1.6.11

SenderName

Отправитель (ФИО)

string(255)

да, если

  1. не задан DispatchNumber

  2. DispatchNumber задан и ФИО не указаны в накладной

1.6.12

Weight

Общий вес, в граммах. Целое число, однако клиенты могут передать число с точкой, в этом случае произойдет округление, если передано не число - в накладную запишется дефолтное значение - 0.49 кг

string

да, если не задан DispatchNumber

1.6.13

Comment

Описание груза

string(255)

да, если не задан DispatchNumber

1.6.14

DispatchNumber2

Номер привязанного заказа

string(10)

нет

1.6.15

Address1

Адрес отправителя


да

1.6.15.1

Street

Улица отправителя (рекомендуется по возможности не указывать префиксы значений, вроде «ул.»)

string(50)

да

1.6.15.2

House

Дом, корпус, строение отправителя (рекомендуется по возможности не указывать префиксы значений, вроде «дом»)

string(30)

да

1.6.15.3

Flat

Квартира/Офис отправителя (рекомендуется по возможности не указывать префиксы значений, вроде «кв.»)

string(10)

да

Идентификация города отправителя и города получателя (в случае режима "до двери") производится по следующему алгоритму в порядке приоритетности:

...


Сервер СДЭК вернет результат в виде XML :

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1ResponseЗаголовок документа
да
1.1CallОжидание курьера
да
1.1.1NumberНомер заявкиstring(30)да
1.1.2ErrorCodeКод ошибкиstring(255)нет
1.1.3Msg

Фиксированный текст "Добавлено заказов"

Описание ошибки (при ее возникновении)

string(255)да


Пример. Регистрация заявки на вызов курьера

...

4.7.1. Описание входных параметров


Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1

ScheduleRequest

Заголовок документа.


да

1.1

Date

Дата документа (дата вызова)

datetime/date

да

1.2

Account

Идентификатор ИМ (логин)

string(255)

да

1.3

Number

Номер акта приема-передачи/ТТН.  Идентификатор реестра грузов в ИС клиента СДЭК. По умолчанию можно использовать 1

string(30)

да

1.4

Secure

Ключ

string(255)

да

1.5

OrderCount

Общее количество заявок для прозвона

integer

да

1.6

Order

Отправление (заказ)


да

1.6.1

DispatchNumber1

Номер отправления СДЭК (присваивается при импорте заказов). Идентификатор заказа в ИС клиента СДЭК

integer

да

1.6.2

Number1

Номер отправления клиента (уникален в пределах заказов одного клиента). Идентификатор заказа в ИС Клиента

string(40)

да

1.6.3

Date1

Дата документа (дата заказа)

datetime/date

да

1.6.4

Attempt

Время доставки.


да

1.6.4.1

ID

Идентификационный номер расписания по базе ИМ. По умолчанию можно использовать 1

integer

да

1.6.4.2

Date

Дата доставки (только дата, в формате «YYYY-MM-DD», без времени) согласованная с получателем

date

да

1.6.4.3

Comment

Комментарий

string(255)

нет

1.6.4.4

TimeBeg

Начало временного диапазона доставки (время получателя)

time

да

1.6.4.5

TimeEnd

Окончание временного диапазона доставки (время получателя)

time

да

1.6.4.6

Address

Новый адрес доставки (если требуется изменить). В зависимости от режима доставки необходимо указывать либо атрибуты «Street», «House», «Flat» - доставка до адресата получателя, либо «PvzCode» - самозабор


нет

1.6.4.6.1

Street

Улица получателя. Рекомендуем по возможности не указывать префиксы значений вроде «ул.»

string(50)

да

1.6.4.6.2

House

Дом, корпус, строение получателя.  Рекомендуем по возможности не указывать префиксы значений вроде «дом»

string(30)

да

1.6.4.6.3

Flat

Квартира/Офис получателя.  Рекомендуем по возможности не указывать префиксы значений вроде «кв.»

string(10)

нет

1.6.4.6.4

PvzCode

Код ПВЗ, необходим только для заказов с режимом доставки «до склада» и при условии, что не заказана дополнительная услуга "Доставка в городе получателе".

string(10)

да, если режим доставки "до склада"

1 Идентификация заказа осуществляется либо по «DispatchNumber», либо по двум параметрам «Number», «Date». Если в запросе есть значение атрибута «DispatchNumber», то атрибуты «Number», «Date» игнорируются.

...

Сервер СДЭК вернет результат в виде XML :

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1ResponseЗаголовок документа
да
1.1ScheduleRequestОжидание курьера
да
1.1.1NumberНомер заявкиstring(40)нет
1.1.2DispatchNumberНомер заказа СДЭКintegerда
1.1.3ErrorCodeКод ошибкиstring(255)нет
1.1.4Msg

Фиксированный текст либо

Описание ошибки (при ее возникновении)

string(255)да


Пример. Регистрация информации о результате прозвона

...

4.8.1. Описание передаваемых данных

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1

OrdersPackagesPrint

Заголовок документа


да

1.1

Date

Дата документа

datetime/date

да

1.2

Account

Идентификатор ИМ (логин)

string(255)

да

1.3

Secure

Ключ

string(255)

да

1.4

OrderCount

Общее количество передаваемых в документе заказов

integer

да

1.5

CopyCount

Число копий. По умолчанию 1

integer

нет

1.6PrintFormatФормат печати, допустимые значения: A4, A5, A6 (A - буква латинского алфавита). По умолчанию A4string(2)нет

1.7

Order

Отправление (заказ)


да

1.7.1

DispatchNumber1

Номер отправления СДЭК (присваивается при импорте заказов). Идентификатор заказа в ИС клиента СДЭК

integer

да

1.7.2

Number1

Номер отправления клиента. Идентификатор заказа в ИС клиента СДЭК

string(40)

да

1.7.3

Date1

Дата акта приема-передачи, в котором был передан заказ

date

да

1 Идентификация заказа осуществляется либо по «DispatchNumber», либо по двум параметрам «Number», «Date». Если в запросе есть значение атрибута «DispatchNumber», то атрибуты «Number», «Date» игнорируются.

...

В ответ сервер СДЭК вернет pdf-файл.
В случае ошибки результат вернется в виде XML:

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1ResponseЗаголовок документа
да
1.1OrderЗаказ
да
1.1.1ErrorCodeКод ошибкиstring(255)нет
1.1.2Msg

Описание ошибки

string(255)да


Пример. Печать ШК-места

Code Block
languagexml
titleOrdersPackagesPrint
<?xml version="1.0" encoding="UTF-8"?>
<OrdersPackagesPrint Account="60cacd45b1b2820ad7a233b60b6adec4" Date="2017-09-29" Number="2017.09.29S-7KL" OrderCount="1" Secure="secure" printFormat="A6">
    <Order Number="43459667" Date="2017-09-29"/>
</OrdersPackagesPrint>

...

4.9.1. Описание передаваемых данных


Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1

StatusReport

Заголовок документа


да

1.1

Date

Дата запроса

datetime/date

да

1.2

Account

Идентификатор Клиента (логин)

string(255)

да

1.3

Secure

Ключ

string(255)

да

1.4

ShowHistory

Атрибут, указывающий на необходимость загружать историю заказов (1-да, 0-нет)

boolean

нет

1.5

ShowReturnOrder

Атрибут, указывающий на необходимость загружать список возвратных заказов (1-да, 0-нет)

boolean

нет

1.6

ShowReturnOrderHistory

Атрибут, указывающий на необходимость загружать историю возвратных заказов (1-да, 0-нет)

boolean

нет

1.7

ChangePeriod1

Период, за который произошло изменение  статуса заказа.


нет

1.7.1

DateFirst3

Дата начала запрашиваемого периода

datetime/date

да

1.7.2

DateLast3

Дата окончания запрашиваемого периода

datetime/date

нет

1.8

Order1

Отправление (заказ)


нет

1.8.1

DispatchNumber2

Номер отправления СДЭК (присваивается при импорте заказов). Идентификатор заказа в ИС СДЭК.

integer

да

1.8.2

Number2

Номер отправления клиента. Идентификатор заказа в ИС клиента СДЭК.

string(40)

да

1.8.3

Date2

Дата акта приема-передачи, в котором был передан заказ

date

да


1 Запрос должен содержать хотя бы один из тэгов  ChangePeriod или Order:

...


Сервер СДЭК вернет результат в виде XML :

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1

StatusReport

Заголовок документа


да

1.1

DateFirst

Дата и время начала периода изменений по статусам заказа

datetime/date

да

1.2

DateLast

Дата и время окончания периода изменений по статусам заказа

datetime/date

да

2

Order

Отправление (Заказ)


да

2.1

ActNumber

Номер акта приема-передачи

string(30)

да

2.2

Number

Номер отправления клиента. Идентификатор заказа в ИС клиента СДЭК.

string(30)

да

2.3

DispatchNumber

Номер отправления СДЭК (присваивается при импорте заказов). Идентификатор заказа в ИС СДЭК.

integer

да

2.4

DeliveryDate

Дата доставки

datetime

нет

2.5

RecipientName

Получатель при доставке (заполнено только в статусе заказа "Вручен")

string(50)

нет

2.6

ReturnDispatchNumber

Номер возвратного отправления (номер накладной, в которой возвращается товар ИМ в случае статусов «Не вручен», «Вручен» - «Частичная доставка»)

integer

нет

2.7ReverseDispatchNumberНомер реверсной накладной (номер накладной, в которой возвращается груз при наличии доп.услуги №48 "РЕВЕРС")integerнет

2.8

Status

Текущий статус заказа


да

2.8.1

Date

Дата статуса. Указано среднее время по Гринвичу.

datetime

да

2.8.2

Code

Код статуса (подробнее см. приложение 5)

integer

да

2.8.3

Description

Название статуса

string(100)

да

2.8.4

CityCode

Город изменения статуса, код города по базе СДЭК (Список городов)

integer

да

2.8.5

CityName

Наименование города изменения статуса

string(100)

да

2.8.6

State1

История изменений статусов


да

2.8.6.1

Date

Дата статуса

datetime

да

2.8.6.2

Code

Код статуса (подробнее см. приложение 5)

integer

да

2.8.6.3

Description

Название статуса

string(100)

да

2.8.6.4

CityCode

Город изменения статуса, код города по базе СДЭК (Список городов)

integer

да

2.8.6.5

CityName

Наименование города изменения статуса

string(100)

да

2.9

Reason

Текущий дополнительный статус


да

2.9.1

Date

Дата дополнительного статуса

datetime

да

2.9.2

Code

Код дополнительного статуса (подробнее см. приложение 6)

integer

нет

2.9.3

Description

Название дополнительного статуса

string(100)

нет

2.10

DelayReason

Текущая причина задержки


да

2.10.1

Date

Дата причины задержки

datetime

да

2.10.2

Code

Код причины задержки (подробнее см. приложение 7)

integer

нет

2.10.3

Description

Причина задержки

string(50)

нет

2.10.4

State1

История причин задержек


да

2.10.4.1

Date

Дата причины задержки

datetime

да

2.10.4.2

Code

Код причины задержки (подробнее см. приложение 7)

integer

нет

2.10.4.3

Description

Причина задержки

string(50)

нет

2.11

Package2

Упаковка


нет

2.11.1

Number

Номер упаковки. Идентификатор заказа в ИС клиента СДЭК.

string(20)

да

2.11.2

BarCode

Штрих-код упаковки, идентификатор грузоместа

string(20)

да

2.11.3

Item2

Вложение


да

2.11.3.1

WareKey

Идентификатор/артикул товара/вложения.

string(20)

да

2.11.3.2MarkingМаркировка товара/вложения.stringнет

2.11.3.3

DelivAmount

Количество доставленных единиц вложения. По умолчанию равно количеству переданного на доставку товара.

integer

да

2.11.3.4Amount

Количество переданных а доставку единиц товара

integer

да

2.12

Attempt3

Время доставки из расписания на доставку


нет

2.12.1

ID

Идентификационный номер расписания по базе ИМ

integer

да

2.12.2

ScheduleCode

Код причины задержки (подробнее см. приложение 7)

integer

да

2.12.3

ScheduleDescription

Причина задержки

string(50)

да

2.13

Call

История прозвонов получателя


нет

2.13.1

CallGood

История удачных прозвонов


нет

2.13.1.1

Good

Удачный прозвон


да

2.13.1.1.1

Date

Дата удачного прозвона

date

да

2.13.1.1.2

DateDeliv

Дата, на которую договорились о доставке/самозаборе

date

да

2.13.2

CallFail

История неудачных прозвонов


нет

2.13.2.1

Fail

Неудачный прозвон


да

2.13.2.1.1

Date

Дата прозвона

date

да

2.13.2.1.2

ReasonCode

Код причины неудачного прозвона (подробнее см. приложение 8)

integer

да

2.13.2.1.3

ReasonDescription

Причина неудачного прозвона

string(255)

да

2.13.3

CallDelay

История переносов прозвона


нет

2.13.3.1

Delay

Перенос прозвона


да

2.13.3.1.1

Date

Дата прозвона

date

да

2.13.3.1.2

DateNext

Дата, на которую перенесен прозвон

date

да

3

ReturnOrder

Возвратное отправление


нет

3.1

ActNumber

Номер акта приема-передачи

string(30)

да

3.2

Number

Номер отправления клиента. Идентификатор заказа в ИС клиента СДЭК.

string(30)

да

3.3

DispatchNumber

Номер возвратной накладной СДЭК (присваивается при согласовании возвратной ведомости). Идентификатор заказа в ИС СДЭК.

integer

да

3.4

DeliveryDate

Дата доставки

datetime

нет

3.5

RecipientName

Получатель при доставке

string(50)

нет

3.6

Status

Текущий статус заказа


да

3.6.1

Date

Дата статуса

datetime

да

3.6.2

Code

Код статуса (подробнее см. приложение 5)


integer

да

3.6.3

Description

Название статуса

string(100)

да

3.6.4

CityCode

Город изменения статуса, код города по базе СДЭК (Список городов)

integer

да

3.6.5

CityName

Наименование города изменения статуса

string(100)

да

3.6.6

State1

История изменений статусов


да

3.6.6.1

Date

Дата статуса

datetime

да

3.6.6.2

Code

Код статуса (подробнее см. приложение 5)

integer

да

3.6.6.3

Description

Название статуса

string(100)

да

3.6.6.4

CityCode

Город изменения статуса

integer

да

3.6.6.5

CityName

Наименование города изменения статуса

string(100)

да

3.7

Reason

Текущий дополнительный статус


да

3.7.1

Date

Дата дополнительного статуса

datetime

да

3.7.2

Code

Код дополнительного статуса (подробнее см. приложение 6)

integer

нет

3.7.3

Description

Название дополнительного статуса

string(100)

нет

3.8

DelayReason

Текущая причина задержки


да

3.8.1

Date

Дата причины задержки

datetime

да

3.8.2

Code

Код причины задержки (подробнее см. приложение 7)

integer

нет

3.8.3

Description

Причина задержки

string(50)

нет

1 Тэг «State» присутствует только при значении параметра «ShowHistory = 1 (см. описание передаваемых данных).

...

Тэг/АтрибутОписаниеТип поляОбяз. для заполн.
1InfoRequestЗаголовок документа
да
1.1DateДата запросаdatetime/dateда
1.2AccountИдентификатор Клиента (логин)string(255)да
1.3SecureКлючstring(255)да
1.4ChangePeriodПериод, за который произошло изменение стоимости услуги доставки
нет
1.4.1DateBegДата начала запрашиваемого периодаdateнет
1.4.2DateEndДата окончания запрашиваемого периодаdateнет
1.5OrderОтправление (заказ)
нет
1.5.1DispatchNumber1Номер отправления СДЭК (присваивается при импорте заказов). Идентификатор заказа в ИС СДЭК.Integerда
1.5.2Number1Номер отправления клиента. Идентификатор заказа в ИС клиента СДЭК.string(30)да
1.5.3Date1Дата акта приема-передачи, в котором был передан заказdateда

...


Сервер СДЭК вернет результат в виде XML :


Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1

InfoReport

Заголовок документа


да

1.1

Order

Отправление (Заказ)


да

1.1.1

Number

Номер отправления клиента. Идентификатор заказа в ИС клиента СДЭК.

string(30)

да

1.1.2

Date

Дата, в которую был передан заказ в базу СДЭК

date

да

1.1.3

DispatchNumber

Номер отправления СДЭК (присваивается при импорте заказов). Идентификатор заказа в ИС СДЭК.

integer

да

1.1.4

TariffTypeCode

Код тарифа (подробнее см. приложение 1)

integer

да

1.1.5

Weight

Расчетный вес (в килограммах)

Warning

Обращаем внимание, что единица измерения значения данного поля (кг) отличается от единицы измерения веса (гр) в методах создания и обновления заказа.


float

да

1.1.6

DeliverySum

Стоимость услуги доставки, в валюте взаиморасчетов, по умолчанию руб.

float

да

1.1.7

DateLastChange

Дата последнего изменения суммы по услуге доставки

date

нет

1.1.8

CashOnDeliv

Сумма наложенного платежа, которую необходимо было взять с получателя в валюте страны получателя, по умолчанию руб.

float

нет

1.1.9

CashOnDelivFact

Сумма наложенного платежа, которую взяли с получателя, в валюте страны получателя, по умолчанию руб. с учетом частичной доставки. Доступно только для накладных в статусе «Вручен»

float

нет

1.1.10CashOnDelivTypeТип оплаты наложенного платежа. Принимает значения: cash - наличный расчет, cashless - безналичный расчет. Тэг отсутствует, если информация о платеже еще не поступилаstring(10)нет

1.1.11

deliveryMode

Код режима доставки (подробнее см. приложение 1)

integer

да

1.1.12

PvzCode

Код ПВЗ, указанный в заказе на момент запроса при режиме доставке «до склада»

string(10)

нет

1.1.13

deliveryVariant

Вариант доставки (COURIER – курьером, PVZCDEK – ПВЗ СДЭК, PVZCLIENT – ПВЗ партнера, POSTAMAT - постамат СДЭК)

string(10)

да

1.1.14

SendCity

Город отправителя


да

1.1.14.1

Code

Код города по базе СДЭК (Список городов)

integer

да

1.1.14.2

PostCode

Почтовый индекс города

string(6)

да

1.1.14.3

Name

Название города

string(50)

да

1.1.15

RecCity

Город получателя


да

1.1.15.1

Code

Код города по базе СДЭК (Список городов)

integer

да

1.1.15.2

PostCode

Почтовый индекс города

string(6)

да

1.1.15.3

Name

Название города

string(50)

да

1.1.16

AddedService

Дополнительные услуги к заказам


нет

1.1.16.1

ServiceCode

Код дополнительной услуги (подробнее см. приложение 2)

integer

да

1.1.16.2

Sum

Сумма услуги в валюте взаиморасчетов, по умолчанию руб.

float

да

1.1.17

Package

Упаковка (все упаковки передаются в разных тэгах Package)


да

1.1.17.1

Number

Номер упаковки

string(20)

да

1.1.17.2

BarCode

Штрих-код упаковки, идентификатор грузоместа

string(20)

да

1.1.17.3

Weight

Общий вес (в килограммах)

Warning

Обращаем внимание, что единица измерения значения данного поля (кг) отличается от единицы измерения веса (гр) в методах создания и обновления заказа.


integer

да

1.1.17.4

VolumeWeight

Объемный вес (в килограммах), рассчитанный по формуле SizeA*SizeB*SizeC/5000

integer

да

1.1.17.5

SizeA  

Габариты упаковки. Длина (в сантиметрах)

integer

да

1.1.17.6

SizeB 

Габариты упаковки. Ширина (в сантиметрах)

integer

да

1.1.17.7

SizeC

Габариты упаковки. Высота (в сантиметрах)

integer

да

1.1.17.8

Item

Вложение (товар)


да

1.1.17.8.1

WareKey

Идентификатор/артикул товара/вложения

string(50)

да

1.1.17.8.2MarkingМаркировка товара/вложенияstringнет
1.1.17.8.3CommentНаименование товара (может также содержать описание товара: размер, цвет)string(255)да
1.1.17.8.4AmountКоличество переданного на доставку товараintegerда
1.1.17.8.5DelivAmountКоличество врученных единиц одноименного товара (в штуках)integerда

1.1.17.8.6

Cost

Объявленная стоимость товара (за единицу товара в валюте договора)

float

да

1.1.17.8.7

Payment

Оплата за товар при получении (за единицу товара в валюте страны получателя)

float

да

1.1.17.8.8VATRateСтавка НДС, включенная в стоимость товара (подробнее см. приложение 4)string(10)нет
1.1.17.8.9VATSumСумма НДС, включенного в стоимость товараfloatнет
1.1.17.8.10Weight

Вес (за единицу товара, в килограммах)

Warning

Обращаем внимание, что единица измерения значения данного поля (кг) отличается от единицы измерения веса (гр) в методах создания и обновления заказа.


integerда


Пример. Отчет "Информация по заказам" 

Code Block
languagexml
firstline1
titleInfoRequest
<?xml version="1.0" encoding="utf-8"?>
<InfoRequest Date="2018-08-10T00:00:00" Account="account" Secure="secure" ShowHistory="1" ShowReturnOrder="1">
	<Order DispatchNumber="1000000000"/>
</InfoRequest>

...

Сервер СДЭК вернет результат с полями:

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1

regionUuid

Идентификатор сущности в ИС СДЭК

UUID

да

2

regionName

Название региона

string(255)

да

3

prefix

Префикс (возможные значения: обл, край, респ, АО, Аобл, г)

string(20)

нет

4

regionCode

Код региона в ИС СДЭК

String(10)

нет

5

regionFiasGuid

Код региона по ФИАС

UUID

нет

6

countryName

Название страны

string(255)

да

7

countryCode

Код страны

string

нет

8

countryCodeExt

Код ОКСМ

string

нет


Пример 1. Список субъектов РФ в JSON

...

4.13.1.1. Описание передаваемых данных

ПараметрОписаниеТип поляОбяз. для заполнения
1versionВерсия используемого API - “1.0”stringда
2authLogin1Идентификатор ИМ (логин)stringнет
3secure1Ключstringнет
4dateExecute2Планируемая дата отправки заказа в формате “ГГГГ-ММ-ДД”dateнет
5langЛокализация названий городов. По умолчанию "rus"string(3)нет
6senderCountryCode3Код страны отправителя в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”). По умолчанию - ru.string(2)нет
7receiverCountryCode3Код страны получателя в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”). По умолчанию - ru.string(2)нет
8senderCityId3Код города отправителя из базы СДЭК (Список городов)integerда
9senderCity3Наименование города отправителяstringнет
10senderCityPostCode3Индекс города отправителя из базы СДЭК (Список городов)integerда
11receiverCityId3Код города получателя из базы СДЭК (Список городов)integerда
12receiverCityPostCode3Индекс города получателя из базы СДЭК (Список городов)integerда
13receiverCity3Наименование города получателяstringнет
14senderLongitude3Долгота города отправителяfloatнет
15receiverLongitude3Долгота города получателяfloatнет
16senderLatitude3Широта города отправителяfloatнет
17receiverLatitude3Широта города получателяfloatнет
18tariffId4Код выбранного тарифа (подробнее см. приложение 1)integerда
19tariffList4Список тарифов
да
19.1priorityЗаданный приоритетintegerда
19.2idКод тарифа (подробнее см. приложение 1)integerда
20modeIdРежим доставки (подробнее см. приложение 1)integerнет
21goodsГабаритные характеристики упаковки
да
21.1weightВес упаковки (в килограммах)floatда
21.2lengthДлина упаковки (в сантиметрах)integerда
21.3widthШирина упаковки (в сантиметрах)integerда
21.4heightВысота упаковки (в сантиметрах)integerда
22servicesСписок передаваемых дополнительных услуг (подробнее см. приложение 2)
нет
22.1idИдентификатор номера дополнительной услугиintegerда
22.2param5Параметр дополнительной услуги, если необходимоintegerнет


1
 При использовании тарифов для обычной доставки авторизация не обязательна и параметры authLogin и secure можно не передавать. 

...

Сервер СДЭК вернет результат с полями:


ПараметрОписаниеТип поля
1error

Массив ошибок при их возникновении (подробнее см. приложение 9)


1.1codeКод ошибкиinteger
1.2textТекст ошибкиstring
2priceСумма за доставку в рубляхdouble
3deliveryPeriodMinМинимальное время доставки в рабочих дняхinteger
4deliveryPeriodMaxМаксимальное время доставки в рабочих дняхinteger
5deliveryDateMinУстаревшее поле. Некорректно использовать в качестве планируемой даты доставки.
Минимальная дата доставки, формате 'ГГГГ-ММ-ДД', например “2018-07-29”
string
6deliveryDateMaxУстаревшее поле. Некорректно использовать в качестве планируемой даты доставки.
Максимальная дата доставки, формате 'ГГГГ-ММ-ДД', например “2018-07-30”
string
7tariffIdКод тарифа, по которому рассчитана сумма доставкиinteger
8cashOnDeliveryОграничение оплаты наличными, появляется только если оно естьfloat
9priceByCurrencyЦена в валюте взаиморасчетов. Валюта определяется по authLogin и secure.float
10currencyВалюта интернет-магазина (подробнее см. приложение 3)string
11percentVATРазмер ставки НДС для данного клиента. Появляется в случае, если переданы authLogin и secure, по ним же определяется ставка ИМ. Если ставка НДС не предусмотрена условиями договора, данный параметр не будет отображен.integer
12servicesСписок передаваемых дополнительных услуг (подробнее см. приложение 2)
12.1idИдентификатор переданной услугиinteger
12.2titleЗаголовок услугиstring
12.3priceСтоимость услуги без учета НДС в рубляхfloat
12.4rateПроцент для расчета дополнительной услугиfloat


Пример. Расчет стоимости доставки

...

4.13.2.1. Описание передаваемых данных

ПараметрОписаниеТип поляОбяз. для заполнения
1versionВерсия используемого API - “1.0”stringда
2authLogin1Идентификатор ИМ (логин)stringнет
3secure1Ключstringнет
4dateExecute2Планируемая дата отправки заказа в формате “ГГГГ-ММ-ДД”dateнет
5langЛокализация названий городов. По умолчанию "rus"string(3)нет
6senderCountryCode3Код страны отправителя в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”). По умолчанию - ru.string(2)нет
7receiverCountryCode3Код страны получателя в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”). По умолчанию - ru.string(2)нет
8senderCityId3Код города отправителя из базы СДЭК (Список городов)integerда
9senderCity3Наименование города отправителяstringнет
10senderCityPostCode3Индекс города отправителя из базы СДЭК (Список городов)integerда
11receiverCityId3Код города получателя из базы СДЭК (Список городов)integerда
12receiverCity3Наименование города получателяstringнет
13receiverCityPostCode3Индекс города получателя из базы СДЭК (Список городов)integerда
14senderLongitude3Долгота города отправителяfloatнет
15receiverLongitude3Долгота города получателяfloatнет
16senderLatitude3Широта города отправителяfloatнет
17receiverLatitude3Широта города получателяfloatнет
18currencyВалюта, в которой необходимо рассчитать стоимость доставки. По умолчанию - RUBstringнет
19tariffId4Код выбранного тарифа (подробнее см. приложение 1)integerда, если не указан tariffList
20tariffList4Список тарифов
да, если не указан tariffId
20.1idКод тарифа (подробнее см. приложение 1)integerнет
21goodsГабаритные характеристики упаковки
да
21.1weightВес упаковки (в килограммах)floatда
21.2lengthДлина упаковки (в сантиметрах)integerда
21.3widthШирина упаковки (в сантиметрах)integerда
21.4heightВысота упаковки (в сантиметрах)integerда
22servicesСписок передаваемых дополнительных услуг (подробнее см. приложение 2)
нет
22.1idИдентификатор номера дополнительной услугиintegerда
22.2param5Параметр дополнительной услуги, если необходимоintegerнет

1 При использовании тарифов для обычной доставки авторизация не обязательна и параметры authLogin и secure можно не передавать.

...

ПараметрОписаниеТип поля
1tariffIdКод тарифа, по которому рассчитана сумма доставкиinteger
2statusСтатус ответа (true - успешный, false - не успешный)string
3resultСтоимость и время доставки по тарифу
3.1error

Массив ошибок при их возникновении (подробнее см. приложение 9)


3.1.1codeКод ошибкиinteger
3.1.2textТекст ошибкиstring
3.2priceСумма за доставку в рубляхdouble
3.3deliveryPeriodMinМинимальное время доставки в рабочих дняхinteger
3.4deliveryPeriodMaxМаксимальное время доставки в рабочих дняхinteger
3.5cashOnDeliveryОграничение оплаты наличными, появляется только если оно естьfloat
3.6priceByCurrencyЦена в валюте, которая была передана в запросе.float
3.7currencyВалюта, переданная в запросе.string
3.8percentVATРазмер ставки НДС для данного клиента. Появляется в случае, если переданы authLogin и secure, по ним же определяется ставка ИМ. Если ставка НДС не предусмотрена условиями договора, данный параметр не будет отображен.integer
3.9servicesСписок передаваемых дополнительных услуг (подробнее см. приложение 9)
3.9.1idИдентификатор переданной услугиinteger
3.9.2titleЗаголовок услугиstring
3.9.3priceСтоимость услуги без учета НДС в рубляхfloat
3.9.4rateПроцент для расчета дополнительной услугиfloat

...

Info

В калькуляторе при расчете стоимости есть возможность указать все перечисленные ниже дополнительные услуги, кроме следующих: ожидание более 15 мин. у отправителя, хранение на складе, прочее, забор в городе отправителе, доставка в городе получателе, пеня, обрешетка груза, аренда курьера, тепловой режим, агентское вознаграждение.


Код услуги

Добавление в заказе

Название

Описание

2

Разрешено (только для типа заказа "доставка" и заказам до постамата)

СТРАХОВАНИЕ

Обеспечение страховой защиты посылки. Размер дополнительного сбора страхования вычисляется от размера объявленной стоимости отправления.

Note

Услуга начисляется автоматически для всех заказов типа "интернет-магазин", не разрешена для самостоятельной передачи в тэге AddService.


3

Разрешено (Исключение - заказы до постамата)

ДОСТАВКА В ВЫХОДНОЙ ДЕНЬ

Компания СДЭК осуществляет доставку и отправление документов и грузов в выходные и нерабочие дни.

При доставке или отправлении документов или грузов в выходной день к базовому тарифу добавляется 300 руб.

5

Запрещено, начисляется автоматически

ТЯЖЕЛЫЙ ГРУЗ

При отправке тяжелых грузов,

  • если вес 1 места составляет от 75 до 200 кг, то тариф увеличивается на 18 руб за каждый килограмм,

  • если вес 1 места более 200 кг, то тариф увеличивается на 25 руб. за каждый килограмм.

Также возможен индивидуальный расчет стоимости доставки тяжелых грузов.

Тарифы на такие отправления будут рассчитаны индивидуально и в короткие сроки (не более 1 рабочего дня) и могут быть значительно дешевле наших базовых тарифов.

6

Запрещено, начисляется автоматически

НЕГАБАРИТНЫЙ ГРУЗ

При доставке негабаритного отправления, размер одной из сторон которого превышает 1,5 м, тариф увеличивается на 60 % (если отправление рассчитывается не по объемному весу).
При доставке негабаритного отправления, размер одной из сторон которого превышает 2,2 м, тариф увеличивается на 100 % (если отправление рассчитывается не по объемному весу).

7

Разрешено

ОПАСНЫЙ ГРУЗ

Кроме обычных документов и грузов, компания СДЭК готова доставить отправления, содержащие опасные грузы (кроме запрещенных к перевозке).

В связи с определенным риском стоимость доставки грузов, относящихся к категории опасных, увеличивается в 1,5 раза.

8

Запрещено, начисляется автоматически

Разрешено

ОЖИДАНИЕ БОЛЕЕ 15 МИН. У ОТПРАВИТЕЛЯ

К приезду курьера Отправление должно быть подготовлено.

По правилам компании СДЭК курьер может ожидать передачи или получения отправления не более 15 минут.

В случаях, когда курьер дожидается приема или передачи Отправления более 15 минут, взимается дополнительный сбор в размере 170 рублей.

Не допускается на тарифах Посылка.

9

Запрещено, начисляется автоматически

Разрешено

ОЖИДАНИЕ БОЛЕЕ 15 МИН. У ПОЛУЧАТЕЛЯ

10

Запрещено, начисляется автоматически

Разрешено

ХРАНЕНИЕ НА СКЛАДЕ

При необходимости наша компания предоставляет возможность хранения груза на складе

Для клиентов с типом договора "Интернет-магазин" хранение первые 14 дней — БЕСПЛАТНО, для остальных клиентов хранение первые 7 дней — БЕСПЛАТНО.

Начиная с пятнадцатых / восьмых суток, плата за хранение осуществляется по следующим тарифам:

  • стандартного отправления (1 место размером до 25*40*60см) - основной тариф 15 руб./место за 1 календарный день, включая выходные и праздничные дни;

  • не стандартного отправления (1 место размером более 25*40*60см ) - основной тариф 30 руб./место за 1 календарный день, включая выходные и праздничные дни.

13

Запрещено, начисляется сотрудником СДЭК

ПРОЧЕЕ

Дополнительный сбор от кредитного контроля СДЭК

.

14

Запрещено, начисляется автоматически

УДАЛЕННЫЙ РАЙОН

В случаях, когда забор или доставка груза курьером осуществляется из удаленного района города, взимается дополнительная плата

15

Запрещено, начисляется автоматически

.

Установленный перечень удаленных районов Вы можете узнать по телефону единой справочной службы 8-800-250-04-05 (звонок бесплатный) или у менеджеров компании в офисе Вашего города.

15

Разрешено

ПОВТОРНАЯ ПОЕЗДКА

Когда требуется повторный вызов курьера по ранее аннулированному заказу либо доставка/забор не были осуществлены по вине клиента, начисляется дополнительный сбор.

Размер сбора зависит от веса отправления и стоимости доставки по городу.

16

Разрешено

ЗАБОР В ГОРОДЕ ОТПРАВИТЕЛЕ

Дополнительная услуга забора груза в городе отправителя, при условии, что тариф доставки с режимом «от склада» (

не доступна для тарифов Посылка)

только для тарифов "Экономичный экспресс" (склад-склад, склад-дверь), "Магистральный экспресс" (склад-склад, склад-дверь), "Магистральный супер-экспресс" (склад-склад, склад-дверь).

17

Разрешено (Исключение - заказы до постамата)

ДОСТАВКА В ГОРОДЕ ПОЛУЧАТЕЛЕ

Дополнительная услуга доставки груза в городе получателя, при условии, что тариф доставки с режимом «до

склада»

склада» (только для тарифов

«Магистральный», «Магистральный супер-экспресс»)

20

Запрещено, начисляется сотрудником СДЭК

ПЕНЯ

Дополнительный

"Экономичный экспресс" (склад-склад, дверь-склад), "Магистральный экспресс" (склад-склад, дверь-склад), "Магистральный супер-экспресс" (склад-склад, дверь-склад).

20

Запрещено, начисляется сотрудником СДЭК

ПЕНЯ

Дополнительный сбор от кредитного контроля СДЭК.

23

Запрещено, начисляется сотрудником СДЭК

Разрешено

ОБРЕШЕТКА ГРУЗА

Для большей сохранности Вашего Отправления компания СДЭК предлагает услуги по обрешетке груза.

Деревянный каркас, (доска, брус) вокруг отправления, с боковыми вставками из деревянных реек.

Стоимость обрешетки для каждого Отправления рассчитывается индивидуально. Т.е. это индивидуальная упаковка груза.
Расчет стоимости производится по самой длинной стороне груза

24

Разрешено

Запрещено

УПАКОВКА 1

Стоимость коробки размером 310*215*280мм — 30 руб. (для грузов до 10 кг).

25

Доступно только в ЛК и при оформлении через Call-центр (

Запрещено

для заказов до постамата)

УПАКОВКА 2

Стоимость коробки размером 430*310*280мм — 45 руб. (для грузов до 15 кг).

26

Только при оформлении через Call-центр
(Запрещено для заказов до постамата)

Разрешено

АРЕНДА КУРЬЕРА

Когда необходимо доставить или принять документы в Федеральные службы, такие как: налоговые органы, министерства, посольства, суды, службы надзора и т.д., а также по заказам, требующим ожидания более часа, наша компания готова предоставить курьера.
Стоимость услуги 170 руб./ час, минимальная оплата за 3 часа (510 руб).

27

Доступно только в ЛК и при оформлении через Call-центр
(Запрещено для заказов до постамата)

СМС УВЕДОМЛЕНИЕ

Компания СДЭК предлагает каждому клиенту оформить услугу "смс-уведомление о доставке".

Отправителю высылается сообщение с датой и временем доставки. Стоимость услуги 10 рублей.

Отправитель получает смс-сообщение с информацией о дате/времени доставки и ФИО получателя. При режиме доставки до склада и указании мобильного телефона получателя всем клиентам Компания "СДЭК" предоставляет бесплатную услугу "Смс-уведомление о приходе груза на склад". Получателю будет отправлено смс-сообщение с информацией об адресе забора отправления и времени работы офиса.

30

Разрешено (Исключение - заказы до постамата)

ПРИМЕРКА НА ДОМУ

Курьер доставляет покупателю несколько единиц товара (одежда, обувь и пр.) для примерки. 

32

Запрещено, начисляется автоматически в зависимости от условий договора

Разрешено

СКАН ДОКУМЕНТОВ

Для подтверждения факта доставки мы можем предоставить Вам скан документов с подписью получателя. Стоимость услуги 50 руб.

33

Доступно только в ЛК и при оформлении через Call-центр
(Запрещено для заказов до постамата)

ПОДЪЕМ НА ЭТАЖ РУЧНОЙ

Услуга предоставляется при необходимости подъема на этаж крупногабаритных и тяжелых отправлений (весом от 10 кг).

Разделяется на 2 вида: «Подъем на этаж ручной» и «Подъем на этаж лифтом».

Стоимость услуги «Подъем на этаж ручной» (без лифта)

  • для веса до 30 кг включительно — 50 руб. каждый этаж

  • для веса 31-50 кг — 70 руб. каждый этаж

  • для веса 51-100 кг — 100 руб. каждый этаж

  • для веса 101-150 кг — 130 руб. каждый этаж

  • для веса свыше 150 кг — 150 руб. каждый этаж

Стоимость услуги «Подъем на этаж лифтом»:

  • для веса до 30 кг включительно — 50 руб.

  • для веса 31-50 кг — 70 руб.

  • для веса 51-100 кг — 100 руб.

  • для веса 101-150 кг — 130 руб.

  • для веса свыше 100 кг — 150 руб.

34

Доступно только в ЛК и при оформлении через Call-центр
(Запрещено для заказов до постамата)

ПОДЪЕМ НА ЭТАЖ ЛИФТОМ

35

Запрещено, начисляется автоматически

ПРОЗВОН

Услуга для ИМ "Прозвон" включает в себя предварительный прозвон получателей перед доставкой операторами call-центра. Стоимость услуги 15 руб. 1 заказ.

36

Разрешено (Исключение - заказы до постамата)

ЧАСТИЧНАЯ ДОСТАВКА

Во время доставки товара покупатель может отказаться от одной или нескольких позиций, и выкупить только часть заказа

Info

Если в заказе указано одно вложение, услуга не подключается.


37

Разрешено (Исключение - заказы до постамата)

ОСМОТР ВЛОЖЕНИЯ

Проверка покупателем содержимого заказа до его оплаты (вскрытие посылки).

40

Запрещено, начисляется автоматически

Разрешено

ТЕПЛОВОЙ РЕЖИМ

Направления, по которым возможна доставка с тепловым режимом: Кемерово-Новокузнецк, Новосибирск-Красноярск, Новосибирск-Кемерово, Новосибирск-Томск, Новосибирск-Омск, Новосибирск-Барнаул, Барнаул-Горно-Алтайск И В ОБРАТНЫХ НАПРАВЛЕНИЯХ!

41

42

Запрещено, начисляется автоматически

АГЕНТСКОЕ ВОЗНАГРАЖДЕНИЕ

Наша компания оказывает услуги по приему  денежных средств

42

Запрещено, начисляется автоматически

ВОЗВРАТ ДОКУМЕНТОВ

Служба доставки «СДЭК» предоставляет услугу обратной доставки сопроводительных документов с отметками получателя, а также возврат товаров для ИМ и других торговых предприятий.

АГЕНТСКОЕ ВОЗНАГРАЖДЕНИЕ

Наша компания оказывает услуги по приему  денежных средств от клиента за товар и РКО

48

Разрешено (Исключение - заказы до постамата)

РЕВЕРС

Обратный заказ на доставку от получателя до отправителя. Например, подписанные документы.

54РазрешеноПАКЕТ КУРЬЕРСКИЙ А2
Стоимость —

Размер пакета - 495х580+50,
Вес - до 5 кг,
Стоимость -  50 руб.

 

3-х слойный полиэтилен, 55

РазрешеноСЕЙФ ПАКЕТ А2Стоимость — 30 руб. 56РазрешеноСЕЙФ ПАКЕТ А3Стоимость — 20 руб. 57РазрешеноСЕЙФ ПАКЕТ А4Стоимость — 15 руб. 58РазрешеноСЕЙФ ПАКЕТ А5Стоимость — 15 руб. 

мкм, ширина клапана 50/40, клеевой клапан, с системой защиты от вскрытия, уникальный номер ШК, для идентификации. Внутреннее покрытие черное, защищает от сквозного просвечивания.

Для вложений весом не более 2 кг (А4) и 5 кг (А2):

  • Детские мягкие игрушки,
  • Кожгалантерея: перчатки, сумки,
  • Одежда, 
  • Обувь (в коробке), 
  • Рюкзаки. 

Текстиль: постельные и кухонные принадлежности в упаковке производителя.

55РазрешеноСЕЙФ ПАКЕТ А2

Размер пакета - 495х590+50,
Вес - до 5 кг,
Стоимость -  40 руб.

3-х слойный полиэтилен, 60 мкм, ширина клапана 50/50/40/40, индикаторная лента для защиты от несанкционированного вскрытия, уникальный номер ШК, для идентификации. Внутреннее покрытие черное, защищает от сквозного просвечивания.

  • Ювелирные украшения, бижутерия и др.
56РазрешеноСЕЙФ ПАКЕТ А3

Размер пакета - 335х460+50,
Вес - до 3 кг,
Стоимость -  30 руб.

3-х слойный полиэтилен, 60 мкм, ширина клапана 50/50/40/40, индикаторная лента для защиты от несанкционированного вскрытия, уникальный номер ШК, для идентификации. Внутреннее покрытие черное, защищает от сквозного просвечивания.

  • Ювелирные украшения, бижутерия и др.
57РазрешеноСЕЙФ ПАКЕТ А4

Размер пакета - 245х350+50,
Вес - до 2 кг,
Стоимость -  25 руб.

3-х слойный полиэтилен, 60 мкм, ширина клапана 50/50/40/40, индикаторная лента для защиты от несанкционированного вскрытия, уникальный номер ШК, для идентификации. Внутреннее покрытие черное, защищает от сквозного просвечивания.

  • Ювелирные украшения, бижутерия и др.
58РазрешеноСЕЙФ ПАКЕТ А5

Размер пакета - 148х210+50,
Вес - до 0,5 кг,
Стоимость -  25 руб.

3-х слойный полиэтилен, 60 мкм, ширина клапана 50/50/40/40, индикаторная лента для защиты от несанкционированного вскрытия, уникальный номер ШК, для идентификации. Внутреннее покрытие черное, защищает от сквозного просвечивания.

  • Ювелирные украшения, бижутерия и др.
59РазрешеноУВЕДОМЛЕНИЕ О СОЗДАНИИ ЗАКАЗА В СДЭКПрименяется при создании заказа.
Страны города получателя: Россия, Казахстан, Беларусь
60РазрешеноУВЕДОМЛЕНИЕ О ПРИЕМЕ ЗАКАЗА НА ДОСТАВКУПрименяется при создании заказа.
Страны города получателя: Россия, Казахстан, Беларусь
61РазрешеноКоробка XS (0,5 кг 17х12х9 см)Коробка из трехслойного гофрокартона размером 170*125*95 мм. Максимальная вместимость - 0,5 кг.
Стоимость 1 штуки - 20 рублей.
Доступна для всех тарифов от склада.
62РазрешеноКоробка S (2 кг 21х20х11 см)Коробка из трехслойного гофрокартона размером 216*200*110 мм. Максимальная вместимость - 2 кг.
Стоимость 1 штуки - 40 рублей.
Доступна для всех тарифов от склада.
63РазрешеноКоробка M (5 кг 33х25х15 см)Коробка из трехслойного гофрокартона размером 330*250*155 мм. Максимальная вместимость - 5 кг.
Стоимость 1 штуки - 60 рублей.
Доступна для всех тарифов от склада.
64РазрешеноКоробка L (12 кг 34х33х26 см)Коробка из трехслойного гофрокартона размером 340*330*264 мм. Максимальная вместимость - 12 кг.
Стоимость 1 штуки - 70 рублей.
Доступна для всех тарифов от склада.
65РазрешеноКоробка (0,5 кг 17х12х10 см)Коробка из трехслойного гофрокартона размером 170*120*100 мм. Максимальная вместимость - 0,5 кг.
Стоимость 1 штуки -
20
30 рублей.
Доступна для всех тарифов от склада.
66РазрешеноКоробка (1 кг 24х17х10 см)Коробка из трехслойного гофрокартона размером 240*170*100 мм. Максимальная вместимость - 1 кг.
Стоимость 1 штуки -
30
40 рублей.
Доступна для всех тарифов от склада.
67РазрешеноКоробка (2 кг 34х24х10 см)Коробка из трехслойного гофрокартона размером 340*240*100 мм. Максимальная вместимость - 2 кг.
Стоимость 1 штуки -
40
60 рублей.
Доступна для всех тарифов от склада.
68РазрешеноКоробка (3 кг 24х24х21 см)Коробка из трехслойного гофрокартона размером 240*240*210 мм. Максимальная вместимость - 3 кг.
Стоимость 1 штуки -
50
70 рублей.
Доступна для всех тарифов от склада.
69РазрешеноКоробка (5 кг 40х24х21 см)Коробка из трехслойного гофрокартона размером 400*240*210 мм. Максимальная вместимость - 5 кг.
Стоимость 1 штуки -
60
80 рублей.
Доступна для всех тарифов от склада.
70РазрешеноКоробка (10 кг 40х35х28 см)Коробка из трехслойного гофрокартона размером 400*350*280 мм. Максимальная вместимость - 10 кг.
Стоимость 1 штуки -
70
130 рублей.
Доступна для всех тарифов от склада.
71РазрешеноКоробка (15 кг 60х35х29 см)Коробка из трехслойного гофрокартона размером 600*350*290 мм. Максимальная вместимость - 15 кг.
Стоимость 1 штуки -
100
150 рублей.
Доступна для всех тарифов от склада (кроме режима "склад-постамат").
72РазрешеноКоробка (20 кг 47х40х43 см)Коробка из трехслойного гофрокартона размером 470*400*430 мм. Максимальная вместимость - 20 кг.
Стоимость 1 штуки -
120
180 рублей.
Доступна для всех тарифов от склада (кроме режима "склад-постамат").
73РазрешеноКоробка (30 кг 69х39х42 см)Коробка из трехслойного гофрокартона размером 690*390*420 мм. Максимальная вместимость - 30 кг.
Стоимость 1 штуки -
140
220 рублей.
Доступна для всех тарифов от склада (кроме режима "склад-постамат").
74РазрешеноВоздушно-пузырчатая пленка
Полиэтилен высокого давления, двухслойный.
Стоимость за 1 метр - 50 рублей.

Является дополнительным упаковочным материалом для упаковки отправлений в транспортную упаковку: деревянная обрешетка, гофрокороб, тубусы, пакеты курьерские и т.


1 метр - 30 рублей.
Доступна для всех тарифов от склада

д.
Функциональное назначение материала:
- амортизация, защита от вибрации, механических ударов, трения и повреждений при падении;
- заполнение пустот, внутри упаковки;
- защита от пыли, грязи и влаги.

75РазрешеноМакулатурная бумагаУпаковочная бумага (макулатурная, класса Е). Ширина 0,42 м. Предназначена для упаковки различных видов отправлений (грузов) и заполнения пустот внутри упаковки
Стоимость за 1 метр -
15
30 рублей.
Доступна для всех тарифов от склада.
76РазрешеноПрессованный картон "филлер" (55х14х2,3 см)

Размер - 550х140х23 мм, 
Стоимость - 40 руб.

Вставка защитная из листового прессованного картона "филлер". ЭКО материал.
Применяется для:

- внутренней обрешетки внутри гофрокороба;
- оборачивания и разделения вложений внутри гофрокороба;
- заполнения пустот.

Стоимость 1 штуки - 20 рублей.
Доступна для всех тарифов от склада

Состав материала:
Биоразлагаемый материал, выполнен из вторично переработанной макулатуры и воды.

Особенность материала:
Высокая надежность и сопротивляемость механическим нагрузкам, за счет прочности объемной конструкции "филлера"
Защита предметов любой формы. Удобно создавать во круг предмета защитный "чехол", скрепляя между собой "ячейки" в замок.


* Стоимость услуг может быть не актуальной, поэтому рекомендуем смотреть актуальную информацию на сайте нашей компании.

...