Список заказов на доставку
№
|
Тэг/Атрибут
|
Описание
|
Тип поля
|
Обяз. для заполн.
|
1.
|
DeliveryRequest
|
Заголовок документа
|
|
да
|
1.1.
|
Number
|
Номер акта приема-передачи/ТТН (сопроводительного документа при передаче груза СДЭК, формируется в системе ИМ), так же используется для удаления заказов
|
varchar(30)
|
да
|
1.2.
|
Date
|
Дата документа (дата заказа)
|
date
|
да
|
1.3.
|
Account
|
Идентификатор ИМ, передаваемый СДЭКом.
|
varchar(255)
|
да
|
1.4.
|
Secure
|
Ключ (см. Протокол обмена)
|
varchar(255)
|
да
|
1.5.
|
OrderCount
|
Общее количество заказов в документе
|
number
|
да
|
1.6.
|
Order
|
Отправление (заказ)
|
|
да
|
1.6.1.
|
Number
|
Номер отправления клиента (должен быть уникален в пределах акта приема-передачи)
|
varchar(30)
|
да
|
1.6.2.
|
SendCityCode**
|
Код города отправителя из базы СДЭК (см. файл «City_XXX_YYYYMMDD.xls»)
|
number
|
да
|
1.6.3.
|
RecCityCode**
|
Код города получателя из базы СДЭК (см. файл «City_XXX_YYYYMMDD.xls»)
|
number
|
да
|
1.6.4.
|
SendCityPostCode**
|
Почтовый индекс города отправителя
|
varchar(6)
|
да
|
1.6.5.
|
RecCityPostCode**
|
Почтовый индекс города получателя
|
varchar(6)
|
да
|
1.6.6.
|
RecipientName
|
Получатель (ФИО)
|
varchar(128)
|
да
|
1.6.7.
|
RecipientEmail
|
Email получателя для рассылки уведомлений о движении заказа, для связи в случае недозвона.
|
varchar(255)
|
нет
|
1.6.8.
|
Phone
|
Телефон получателя
|
varchar(50)
|
да
|
1.6.9.
|
TariffTypeCode
|
Код типа тарифа (см. Приложение, таблица 1)
|
number
|
да
|
1.6.10.
|
DeliveryRecipientCost*
|
Доп. сбор за доставку, которую ИМ берет с получателя (в указанной валюте)
|
real
|
нет
|
1.6.11.
|
RecipientCurrency*******
|
Код валюты наложенного платежа: доп. сбора за доставку и оплата за товар, которые надо взять с получателя (см. Приложение, таблица 7). Если параметр не указан, то считается в рублях.
|
varchar(10)
|
нет
|
1.6.12.
|
ItemsCurrency
|
Код валюты объявленной стоимости заказа (всех вложений) (см. Приложение, таблица 7). Если параметр не указан, то считается в рублях.
|
varchar(10)
|
нет
|
1.6.13.
|
Comment
|
Комментарий по заказу
|
varchar(255)
|
нет
|
1.6.14.
|
SellerName
|
Истинный продавец. Используется при печати заказов для отображения настоящего продавца товара, либо торгового названия
|
varchar(255)
|
нет
|
1.6.15.
|
Address
|
Адрес доставки. В зависимости от режима доставки необходимо указывать либо атрибуты (Street, House, Flat), либо PvzCode
|
|
да
|
1.6.15.1
|
Street
|
Улица
|
varchar(50)
|
да
|
1.6.15.2
|
House
|
Дом, корпус, строение
|
varchar(30)
|
да
|
1.6.15.3
|
Flat
|
Квартира/Офис
|
varchar(10)
|
да
|
1.6.15.4
|
PvzCode
|
Код ПВЗ (см. «Список пунктов выдачи заказов (ПВЗ)»). Атрибут необходим только для заказов с режим доставки «до склада»
|
varchar(10)
|
да
|
1.6.16.
|
Package
|
Упаковка (все упаковки передаются в разных тэгах Package)
|
|
да
|
1.6.16.1
|
Number
|
Номер упаковки (можно использовать порядковый номер упаковки заказа), уникален в пределах заказа
|
varchar(20)
|
да
|
1.6.16.2
|
BarCode
|
Штрих-код упаковки (если есть, иначе передавать значение номера упаковки Packege.Number. Параметр используется для оперирования грузом на складах СДЭК), уникален в пределах заказа
|
varchar(20)
|
да
|
1.6.16.3
|
Weight
|
Общий вес (в граммах)
|
number
|
да
|
1.6.16.4
|
SizeA****
|
Габариты упаковки. Длина (в сантиметрах)
|
number
|
нет
|
1.6.16.5
|
SizeB****
|
Габариты упаковки. Ширина (в сантиметрах)
|
number
|
нет
|
1.6.16.6
|
SizeC****
|
Габариты упаковки. Высота (в сантиметрах)
|
number
|
нет
|
1.6.16.7
|
Item
|
Вложение (товар)
|
|
да
|
1.6.16.7.1
|
WareKey
|
Идентификатор/артикул товара (Уникален в пределах упаковки Package).
|
varchar(20)
|
да
|
1.6.16.7.2
|
Cost
|
Объявленная стоимость товара (за единицу товара в указанной валюте, значение >=0). С данного значения рассчитывается страховка.
|
real
|
да
|
1.6.16.7.3
|
Payment
|
Оплата за товар при получении (за единицу товара в указанной валюте, значение >=0) — наложенный платеж, в случае предоплаты значение = 0.
|
real
|
да
|
1.6.16.7.4
|
Weight
|
Вес (за единицу товара, в граммах)
|
number
|
да
|
1.6.16.7.5
|
Amount
|
Количество единиц товара (в штуках)
|
number
|
да
|
1.6.16.7.6
|
Comment
|
Наименование товара (может также содержать описание товара: размер, цвет)
|
varchar(255)
|
да
|
1.6.17.
|
AddService******
|
Дополнительные услуги
|
|
нет
|
1.6.17.1
|
ServiceCode
|
Тип дополнительной услуги (см. Приложение, таблица 5).
|
number
|
да
|
1.6.17
|
Schedule***
|
Расписание времени доставки
|
|
нет
|
1.6.17.1
|
Attempt
|
Время доставки. В один день возможен один временной интервал не менее 3 часов.
|
|
да
|
1.6.17.1.1
|
ID
|
Идентификационный номер расписания по базе ИМ
|
varchar(20)
|
да
|
1.6.17.1.2
|
Date
|
Дата доставки
|
date
|
да
|
1.6.17.1.3
|
TimeBeg
|
Начало временного диапазона доставки(время получателя)
|
time
|
да
|
1.6.17.1.4
|
TimeEnd
|
Окончание временного диапазона доставки (время получателя)
|
time
|
да
|
1.6.17.1.5
|
RecipientName
|
Новый получатель (если требуется изменить)
|
varchar(128)
|
нет
|
1.6.17.1.6
|
Phone
|
Новый номер телефона получателя (если требуется изменить)
|
varchar(50)
|
нет
|
1.6.17.1.7
|
Address
|
Новый адрес доставки (если требуется изменить). В зависимости от режима доставки необходимо указывать либо атрибуты (Street, House, Flat), либо PvzCode
|
|
нет
|
1.6.17.1.8.1
|
Street
|
Улица
|
varchar(50)
|
да
|
1.6.17.1.8.2
|
House
|
Дом, корпус, строение
|
varchar(30)
|
да
|
1.6.17.1.8.3
|
Flat
|
Квартира/Офис
|
varchar(10)
|
нет
|
1.6.17.1.8.4
|
PvzCode
|
Код ПВЗ (см. «Список пунктов выдачи заказов (ПВЗ)»). Атрибут необходим только для заказов с режимом доставки «до склада»
|
varchar(10)
|
да
|
1.6.17.1.9
|
Comment
|
Комментарий
|
varchar(255)
|
нет
|
1.7.
|
CallCourier*****
|
Вызов курьера
|
|
нет
|
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
|
SendCityCode
|
Код города отправителя из базы СДЭК
|
number
|
да
|
1.7.1.7
|
SendAddress
|
Адрес отправителя
|
|
да
|
1.7.1.7.1
|
Street
|
Улица
|
varchar(50)
|
да
|
1.7.1.7.2
|
House
|
Дом, корпус, строение
|
varchar(30)
|
да
|
1.7.1.7.3
|
Flat
|
Квартира/Офис
|
varchar(10)
|
да
|
1.7.1.8
|
SendPhone
|
Контактный телефон отправителя
|
varchar(255)
|
да
|
1.7.1.9
|
SenderName
|
Отправитель (ФИО)
|
varchar(255)
|
да
|
1.7.1.10
|
Comment
|
Комментарий
|
varchar(255)
|
нет
|
* В случае, если услуги доставки СДЭК оплачивает не получатель, а ИМ, в стоимость заказа может быть включена стоимость доставки, которую ИМ берет с получателя, например, в качестве компенсации своих расходов. Эта сумма может отличаться от стоимости доставки по тарифам СДЭК. Значение параметра отображается в квитанции к заказу в поле «Стоимость доставки», но при этом входит в сумму наложенного платежа и обрабатывается как наложенный платеж.
** Идентификация города возможно двумя способами:
-
По уникальному коду города базы СДЭК (ID города). Коды городов базы СДЭК передаются ИМ предварительно. Значения передаются в атрибутах SendCityCode, RecCityCode.
-
По почтовому индексу города. Значения передаются в атрибутах SendCityPostCode, RecCityPostCode.
ВАЖНО! Необходимо передавать значения только по одному из вышеописанных способов. Если будут присутствовать все поля с заполненными данными, то идентификация города осуществляется по коду города SendCityCode, RecCityCode. Почтовый индекс города SendCityPostCode, RecCityPostCode при этом игнорируется.
*** В договоре с ИМ определяется условие кто именно, ИМ или СДЭК, запрашивает у получателя расписание для доставки/забора отправления. В случае, если ИМ самостоятельно запрашивает расписание данные передаются в тэге Schedule. Расписание может быть передано позже, при необходимости (см. документ «Прозвон получателя»). На одну дату по одному заказу может быть только одно расписание. Расписание может иметь несколько дней доставки.
**** Габариты упаковки необходимо указывать, если упаковка представляет собой коробку. С учетом габаритов вычисляется объемный вес по формуле SizeА * SizeВ * SizeС/5000. Расчет стоимости доставки идет из максимального значения между фактическим и объемным весом.
***** Вызов курьера осуществляется один на акт передачи и не более одного вызова курьера в день на один адрес.
****** Для добавления заказа доступны не все доп. услуги из списка (см. таблицу 5). В таблице 5 приведены все доп. услуги, которые могут быть в конечном варианте заказа (запрашивать конечное состояние можно при переходе заказа в конечный статус).
******* Валюта наложенного платежа должна совпадать с валютой договора (валютой взаиморасчетов) иначе будет сообщение об ошибке ErrorCode="ERR_CURRCASH_NOTVALID" Msg="Валюта наложенного платежа должна совпадать с валютой договора".
Пример:
Файл содержит данные по двум заказам.
Первый заказ: Используется тариф до склада СДЭК (ПВЗ), осуществляется самозабор получателем. В заказе указана только сумма сколько взять за сами товары, за доставку с получателя ничего не взымается.
Второй заказ: Используется тарифа до двери получателя — осуществляется курьерская доставка. В заказе указана сумма сколько взять с получателя за доставку, т. е. данная сумма будет суммироваться как часть наложенного платежа, при этом она не обязана быть равна сумме за доставку, которую СДЭК выставляет в счете самому ИМ. В заказе не указана стоимость сколько взять с получателя, т. е. считается что товар или бесплатный или была произведена предоплата продавцу.
Number="236" Date="2010-10-14" Account="abc123" Secure="abcd1234" OrderCount="2">
Number="5403"
DeliveryRecipientCost="0"
SendCityCode="270"
RecCityCode="44"
RecipientName="Васина Юлия Александровна"
Phone="7810999, 9295849151"
Comment="Офис группы компаний Ланит. При приезде позвонить на мобильный телефон."
TariffTypeCode="5"
RecientCurrency="RUB"
ItemsCurrency="RUB">
<Address PvzCode="MSK2" />
Number="1" BarCode="101" Weight="630">
WareKey="25000050368" Cost="49" Payment="49" Weight="68" Amount="1" Comment="Дидактические игры-занятия в ДОУ Ст.возраст Вып. 1"/>
WareKey="25000348563" Cost="79" Payment="79" Weight="95" Amount="1" Comment="ДошкВоспитаниеИРазвитие(Айрис-Пр.) (о) Сюжетно-роле"/>
WareKey="25000373314" Cost="79" Payment="79" Weight="135" Amount="1" Comment="ДошкВоспитаниеИРазвитие(Айрис-Пр.) (о) Метод.работа"/>
WareKey="25000390270" Cost="79" Payment="79" Weight="219" Amount="1" Comment="Дошкольники_УчимРазвиваемВоспитываем Родительские "/>
ServiceCode="30">
ID="1" Date="2010-10-15" TimeBeg="09:00:00" TimeEnd="13:00:00" />
ID="2" Date="2010-10-16" TimeBeg="14:00:00" TimeEnd="18:00:00" RecipientName="Прокопьев Анатолий Сергеевич" />
Number="5404"
DeliveryRecipientCost="150"
SendCityCode="270"
RecCityCode="44"
RecipientName="Lubomir Dmitry Vladimirovich"
Phone="9197747341"
TariffTypeCode="11"
SaleName="Ruston"
RecientCurrency="RUB"
ItemsCurrency="RUB">
Phone="9197747341"
Comment="Офис группы компаний Ланит. При приезде позвонить на мобильный телефон."
TariffTypeCode="11">
<Address Street="Боровая" House="д. 7, стр. 2" Flat="оф.10" />
Number="1" BarCode="102" Weight="810">
WareKey="25000358171" Cost="164" Payment="0" Weight="158" Amount="1" Comment="ХочуУчиться Логика (Беденко М.В.)"/>
WareKey="25000428787" Cost="107" Payment="0" Weight="194" Amount="1" Comment="ЛомоносовскаяШкола(о) Считаю и решаю Д/детей 5-6 л"/>
WareKey="33000002164" Cost="107" Payment="0" Weight="174" Amount="1" Comment="ЛомоносовскаяШкола(о) Говорю красиво Д/детей 6-7 л"/>
WareKey="33000002165" Cost="107" Payment="0" Weight="174" Amount="1" Comment="ЛомоносовскаяШкола(о) Говорю красиво Д/детей 6-7 л"/>
>
Number="2" BarCode="103" Weight="740">
WareKey="25000086458" Cost="427" Payment="0" Weight="323" Amount="2" Comment="Перемены Рук-во к личной трансформации и новые спо"/>
WareKey="25000377899" Cost="238" Payment="0" Weight="310" Amount="1" Comment="Коэльо П.(АСТ)(тв)(цв.) Вероника решает умереть"/>
ServiceCode="29">
ServiceCode="30">
ID="3" Date="2010-10-15" TimeBeg="19:00:00" TimeEnd="22:00:00"/>
-
|