Список заказов на удаление
№
|
Тэг/Атрибут
|
Описание
|
Тип поля
|
Обяз. для заполн.
|
1.
|
DeleteRequest
|
Заголовок документа
|
|
да
|
1.1.
|
Number
|
Номер акта приема-передачи
|
varchar(30)
|
да
|
1.2.
|
Date
|
Дата документа (дата заказа)
|
date
|
да
|
1.3.
|
Account
|
Идентификатор ИМ, передаваемый СДЭКом.
|
varchar(255)
|
да
|
1.4.
|
Secure
|
Ключ (см. Протокол обмена)
|
varchar(255)
|
да
|
1.5.
|
OrderCount
|
Общее количество заказов для удаления в документе
|
number
|
да
|
2.
|
Order
|
Отправление (заказ)
|
|
да
|
2.1.
|
Number
|
Номер отправления клиента
|
varchar(30)
|
да
|
Пример:
Документ содержит данные для удаления двух заказов.
<DeleteRequest Number="236" Date="2010-10-14" Account=”abc123” Secure=”abcd1234” OrderCount=”2”>
Number="5403" />
Number="5404" />
-
Отчет «Статусы заказов»
Описание передаваемых данных*:
№
|
Тэг/Атрибут
|
Описание
|
Тип поля
|
Обяз. для заполн.
|
1.
|
StatusReport
|
Заголовок документа
|
|
да
|
1.1.
|
Date
|
Дата запроса
|
date
|
да
|
1.2.
|
Account
|
Идентификатор ИМ, передаваемый СДЭКом.
|
varchar(255)
|
да
|
1.3.
|
Secure
|
Ключ (см. Протокол обмена)
|
varchar(255)
|
да
|
1.4.
|
ShowHistory
|
Атрибут, указывающий на необходимость загружать историю заказов (1-да, 0-нет)
|
number
|
нет
|
1.5.
|
ChangePeriod**
|
Период, за который произошло изменение статуса заказа.
|
|
нет
|
1.5.1.
|
DateFirst
|
Дата начала запрашиваемого периода
|
date
|
да
|
1.5.2.
|
DateLast
|
Дата окончания запрашиваемого периода
|
date
|
нет
|
1.6.
|
Order**
|
Отправление (заказ)
|
|
нет
|
1.6.1.
|
DispatchNumber***
|
Номер отправления СДЭК(присваивается при импорте заказов)
|
number
|
да
|
1.6.2.
|
Number***
|
Номер отправления клиента
|
varchar(30)
|
да
|
1.6.3.
|
Date***
|
Дата акта приема-передачи, в котором был передан заказ
|
date
|
да
|
*При использовании POST запроса.
**Запрос должен содержать хотя бы один из тэгов ChangePeriod или Order.
Если указан тэг ChangePeriod и список заказов в тэге Order, то результат будет содержать информацию по заказам, которые изменили статус в указанный период.
Если указан тэг ChangePeriod и отсутствует список список Order, то результат будет содержать информацию по всем заказам, которые изменили статус в указанный период.
Если тэг ChangePeriod не передан, присутствует только Order, передается информация по всему списку запрашиваемых заказов.
***Идентификация заказа осуществляется либо по DispatchNumber, либо по двум параметрам Number, Date. Если в запросе есть значение атрибута DispatchNumber, то атрибуты Number, Date игнорируются.
Описание получаемых данных
№
|
Тэг/Атрибут
|
Описание
|
Тип поля
|
Обязат. для заполн.
|
1.
|
StatusReport
|
Заголовок документа
|
|
да
|
1.1.
|
DateFirst
|
Дата и время начала периода изменений по статусам заказа
|
datetime
|
да
|
1.2.
|
DateLast
|
Дата и время окончания периода изменений по статусам заказа
|
datetime
|
да
|
2.
|
Order
|
Отправление (Заказ)
|
|
да
|
2.1.
|
ActNumber
|
Номер акта приема-передачи
|
varchar(30)
|
да
|
2.2.
|
Number
|
Номер отправления клиента
|
varchar(30)
|
да
|
2.3.
|
DispatchNumber
|
Номер отправления СДЭК (присваивается при импорте заказов)
|
number
|
да
|
2.4.
|
DeliveryDate
|
Дата доставки
|
datetime
|
нет
|
2.5.
|
RecipientName
|
Получатель при доставке
|
varchar(50)
|
нет
|
2.6.
|
ReturnDispatchNumber
|
Номер возвратного отправления (номер накладной, в которой возвращается товар интернет-магазину в случае статусов «Не вручен», «Вручен» - «Частичная доставка»)
|
number
|
нет
|
2.7
|
Status
|
Текущий статус заказа
|
|
да
|
2.7.1
|
Date
|
Дата статуса
|
datetime
|
да
|
2.7.2
|
Code
|
Идентификатор статуса
(см. Приложение, таблица 2)
|
number
|
да
|
2.7.3
|
Description
|
Название статуса
|
varchar(100)
|
да
|
2.7.4
|
CityCode
|
Город изменения статуса, код города по базе СДЭК (см. файл «City_XXX_YYYYMMDD.xls»)
|
number
|
да
|
2.7.5
|
State*
|
История изменений статусов
|
|
да
|
2.7.5.1
|
Date
|
Дата статуса
|
datetime
|
да
|
2.7.5.2
|
Code
|
Идентификатор статуса
(см. Приложение, таблица 2)
|
number
|
да
|
2.7.5.3
|
Description
|
Название статуса
|
varchar(100)
|
да
|
2.7.5.4
|
CityCode
|
Город изменения статуса
|
number
|
да
|
2.8
|
Reason
|
Текущий дополнительный статус
|
|
да
|
2.8.1
|
Date
|
Дата дополнительного статуса
|
datetime
|
да
|
2.8.2
|
Code
|
Идентификатор дополнительного статуса
(см. Приложение, таблица 3)
|
number
|
нет
|
2.8.3
|
Description
|
Название дополнительного статуса
|
varchar(100)
|
нет
|
2.9
|
DelayReason
|
Текущая причина задержки
|
|
да
|
2.9.1
|
Date
|
Дата причины задержки
|
datetime
|
да
|
2.9.2
|
Code
|
Идентификатор причины задержки
(см. Приложение, таблица 4)
|
number
|
нет
|
2.9.3
|
Description
|
Причина задержки
|
varchar(50)
|
нет
|
2.9.4
|
State*
|
История причин задержек
|
|
да
|
2.9.4.1
|
Date
|
Дата причины задержки
|
datetime
|
да
|
2.9.4.2
|
Code
|
Идентификатор причины задержки
(см. Приложение, таблица 4)
|
number
|
нет
|
2.9.4.3
|
Description
|
Причина задержки
|
varchar(50)
|
нет
|
2.10
|
Package*
|
Упаковка
|
|
нет
|
2.10.1
|
Number
|
Номер упаковки
|
number
|
да
|
2.10.2
|
Item**
|
Вложение
|
|
да
|
2.10.2.1
|
WareKey
|
Идентификатор вложения
|
varchar(20)
|
да
|
2.10.2.2
|
DelivAmount
|
Количество доставленных единиц вложения
|
number
|
да
|
2.11
|
Attempt***
|
Время доставки из расписания на доставку
|
|
нет
|
2.11.1
|
ID
|
Идентификационный номер расписания по базе ИМ
|
number
|
да
|
2.11.2
|
ScheduleCode
|
Идентификатор причины задержки
(см. Приложение, таблица 4)
|
number
|
да
|
2.11.3
|
ScheduleDescription
|
Причина задержки
|
varchar(50)
|
да
|
2.12
|
Call
|
История прозвонов получателя
|
|
нет
|
2.12.1
|
CallGood
|
История удачных прозвонов
|
|
нет
|
2.12.1.1
|
Good
|
Удачный прозвон
|
|
да
|
2.12.1.1.1
|
Date
|
Дата прозвона
|
date
|
да
|
2.12.1.1.2
|
DateDeliv
|
Дата, на которую договорились о доставке/самозаборе
|
date
|
да
|
2.12.2
|
CallFail
|
История неудачных прозвонов
|
|
нет
|
2.12.2.1
|
Fail
|
Неудачный прозвон
|
|
да
|
2.12.2.1.1
|
Date
|
Дата прозвона
|
date
|
да
|
2.12.2.1.2
|
ReasonCode
|
Идентификатор причины неудачного прозвона (см. Приложение, таблица 6)
|
number
|
да
|
2.12.2.1.3
|
ReasonDescription
|
Причина неудачного прозвона
|
varchar(255)
|
да
|
2.12.3
|
CallDelay
|
История переносов прозвона
|
|
нет
|
2.12.3.1
|
Delay
|
Перенос прозвона
|
|
да
|
2.12.3.1.1
|
Date
|
Дата прозвона
|
date
|
да
|
2.12.3.1.2
|
DateNext
|
Дата, на которую перенесен прозвон
|
date
|
да
|
* Тэг State присутствует только при значении параметра showhistory = 1 (см. Протокол обмена).
** Тэги Package, Item присутствуют только в конечном статусе «Вручен» в случае частичной доставки.
***Тэг Attempt присутсвует только в случае, если по условиям договора, ИМ самостоятельно предоставляет расписание доставки для СДЭК. Тэг содержит данные по неудачным попыткам доставки в разрезе предоставленного ИМ расписания доставки.
Пример:
1.Документ содержит передаваемые данные для отчета «Статусы заказов»: все изменения статуса заказов с 2013-07-16 по 2013-07-17.
Date="2013-07-17" Account="123" Secure="123" ShowHistory="1">
DateFirst="2013-07-16" DateLast="2013-07-17"/>
2.Документ содержит передаваемые данные для отчета «Статусы заказов»: все изменения статуса указанных заказов с 2013-07-16 по 2013-07-17.
Date="2013-07-17" Account="123" Secure="123" ShowHistory="1">
DateFirst="2013-07-16" DateLast="2013-07-17"/>
Number="6346860" Date="2013-07-04" />
Number="6346869" Date="2013-07-16" />
Отчет содержит данные о доставке по двум заказам. Заказ с номером отправления 6346860 вручен с частичной доставкой(вложения с идентификаторами 25000050368, 25000348563 вручены, вложения 25000373314, 25000390270 будут возвращены ИМ), заказ 6346869 — в статусе «возвращен на склад доставки» после неудачной попытки доставки по причине «Контактное лицо отсутствует».
Параметр showhistory=1: в отчете отображается история заказа с даты DateFirst.
DateFirst="2013-07-16T00:00:00">
ActNumber="236"
Number="6346860"
DispatchNumber="1001013928"
DeliveryDate="2013-07-16T14:23:00"
RecipientName="Иванов И.">
Date="2013-07-17T00:00:00"
Code="4"
Description="Вручен" CityCode=”270”>
Date="2013-07-16T08:12:00" Code="8" Description="Отправлен в г.-получатель" CityCode=”44” />
Date="2013-07-16T09:40:00" Code="10" Description="Принят на склад доставки" CityCode=”270” />
Date="2013-07-16T14:23:00" Code="4" Description="Вручен" CityCode=”270” />
Status>
<Reason Date="2013-07-16T14:23:00" Code="20" Description="Частичная доставка" />
Number="1">
WareKey="25000050368" DelivAmount="1"/>
WareKey="25000348563" DelivAmount="1"/>
ActNumber="236"
Number="6346869"
DispatchNumber="1001013929" >
Date="2013-07-16T18:40:00"
Code="11"
Description="Возвращен на склад доставки" CityCode=”44”>
<State Date="2013-07-16T08:10:00" Code="10" Description="Принят на склад доставки" CityCode=”44” />
<State Date="2013-07-16T08:23:00" Code="11" Description="Выдан на доставку" CityCode=”44” />
<State Date="2013-07-16T18:40:00" Code="18" Description="Возвращен на склад доставки" CityCode=”44” />
Status>
<DelayReason Date="2013-07-16T18:40:00" Code="12" DelayDescription="Контактное лицо отсутствует">
ID="1" ScheduleCode="4" ScheduleDescription="Перенос. Контактное лицо отсутствует"/>
-
|