Формат обмена данными «СДЭК» - Интернет-Магазин (Доставка внутри страны) Спецификация требований Версия 1.3.5 (стр. 1 )

Формат обмена данными

«СДЭК» - Интернет-Магазин

(Доставка внутри страны)

Спецификация требований

Версия 1.3.5

Версия	Дата	Изменения	Автор
1.	01.10.2010	1.  Документ DeliveryRequest «Список заказов на доставку». 2.  Отчет StatusReport «Статусы заказов»
1.1	01.10.2011	1.  Отчет StatusReport : добавление тэга State истории изменений статусов. 2.  Документ DeliveryRequest: добавление тэга CallCourier «Вызов курьера». 3.  Добавление документа ScheduleRequest «Прозвон получателя». 4.  Добавление документа CallCourier «Вызов курьера». 5.  Добавление документа DeleteRequest «Список заказов на удаление».
1.2	11.01.2012	1.  Документ DeliveryRequest: ·  добавление тэга AddService дополнительных услуг; ·  возможность идентификации города по почтовому индексу в атрибутах SendCityPostCode, RecCityPostCode. 2.  Отчет StatusReport: добавлены атрибуты Status. CityCode, State. CityCode код города, в котором произошло изменение статуса заказа.
10.09.2012	Добавление документа OrdersPrint «Печатная форма квитанции к заказу».
01.10.2012	Добавление отчета InfoRequest «Информация по заказам».
01.10.2012	Список «Коды ошибок».
11.12.2012	1.  Добавление документа «Список ПВЗ». 2.  Документ «Список заказов на доставку»: добавление атрибута «код ПВЗ».
14.12.2012	Изменение правила загрузки документа «Список заказов на доставку»: может быть частичная загрузка заказов без ошибок. Ранее при наличии ошибки по одному из заказов в списке, весь документ аннулировался.
19.07.2013	Отчет StatusReport: добавлена возможность формирования POST запроса с указанием конкретного списка посылок.
1.3.	19.08.2013	1.  Атрибут «Address»: разделение на атрибуты, содержащие отдельно значения улицы, дома, офиса/квартиры (Street, House, Flat). Изменения касаются документов DeliveryRequest, ScheduleRequest, CallCourier. 2.  Документ DeliveryRequest: атрибуты габаритов груза SizeA, SizeB, SizeC перенесены в тэг упаковки Package.
04.09.2013	Обновлен список причин задержек доставки (приложение, таблица 4).
01.11.2013	1.  Документ «Список пунктов выдачи заказов (ПВЗ)»: добавление тэга WeightLimit (ограничения по весу накладной для выдачи на ПВЗ). 2.  Отчет StatusReport: добавлена информация по возвратной накладной (номер наклданой ReturnDispatchNumber).
05.12.2013	Отчет StatusReport: добавлен отчет по прозвонам получателя, тэг Call.
1.3.1	28.01.2014	1.  Документ «Список пунктов выдачи заказов (ПВЗ)»: добавление тэга Note – примечание, в котором может быть указана уточняющая информация для клиента (о местонахождении ПВЗ и т. п.) 2.  Документ «Список заказов на доставку»: добавление атрибута RecipientEmail – адрес электронной почты получателя.
1.3.2	31.03.2014	1.  Документ «Список пунктов выдачи заказов (ПВЗ)»: добавление тэгов СoordX, СoordY – координаты местонахождения ПВЗ. 2.  Добавлен новый параметр Сitypostcode в GET запрос — получение реестра ПВЗ по почтовому индексу 3.  В ответ о создании заказа введен тег DispatchNumber – номер накладной СДЭК.
1.3.3	13.08.2014	1.  Обновлен список дополнительных статусов доставки (см. Приложение, таблица 4). 2.  Документ «Список заказов на доставку»: добавление атрибутов «валюта». 3.  Документ «Информация по заказам»: добавление атрибутов CashOnDeliv, CachOnDelivFact, содержащее сумму Наложенного платежа (сколько надо взять с получателя при доставке) и наложенного платежа по факту доставки (сколько заплатил получатель при доставке, с учетом частичной доставки).
1.3.4	28.11.2014	В отчете InfoRequest «Информация по заказам» отображаются все дополнительные услуги накладной (см. Приложение, таблица 5). Примечание: При оформлении заказа могут быть задействованы не все перечисленные доп. услуги.
1.3.5	24.02.2015	Документ «Список заказов на доставку»: добавление атрибутов валюты наложенного платежа и объявленной стоимости

Содержание

1. Общее описание.......................................................................................................................... 5

2. Протокол обмена......................................................................................................................... 5

3. Список пунктов выдачи заказов (ПВЗ).......................................................................................... 9

4. Список заказов на доставку....................................................................................................... 10

5. Прозвон получателя.................................................................................................................. 15

6. Вызов курьера........................................................................................................................... 16

7. Список заказов на удаление....................................................................................................... 17

8. Отчет «Статусы заказов»............................................................................................................ 18

9. Отчет «Информация по заказам»............................................................................................... 23

10. Печатная форма квитанции к заказу......................................................................................... 26

11. Коды ошибок............................................................................................................................ 26

12. Приложение.............................................................................................................................. 27

1. Общее описание

В документе представлен порядок и формат обмена данными между Компанией «СДЭК» и клиентом Интернет-Магазином (далее ИМ).

Ответы на часто-задаваемый вопросы можно увидеть тут: http://www. cdek. ru/faq/

Запросы на генерацию учетной записи, вопросы и пожелания клиентов принимаем на email *****@***ru.

2. Протокол обмена

2.1. Обмен данными осуществляется по протоколу HTTP.

Адрес сервера СДЭК для отправки запросов:

http://gw. edostavka. ru:11443

Резервный сервер для запросов: http://lk. cdek. ru:11443, можно использовать при не доступности основного.

Данные передаются в формате XML, при этом необходимо учитывать, что в значениях полей нельзя использовать символы разметки XML ( < > & " ' ), кодировка UTF-8.

2.2. Идентификация ИМ осуществляется двумя параметрами: учетная запись account и секретный код secure_password.

Для обеспечения безопасности при передаче/запросе данных ИМ должен передавать значение поля secure, вычисляемое по алгоритму:

secure = md5(date.'&'.secure_password), где

secure_password — секретный код, предоставляемый СДЭКом,

date — дата документа (для всех запросов - значение параметра Date xml-запроса, кроме запроса «Статусы заказов» в формате get-запроса, где используется значение параметра DateFirst).

Во всех модулях дата_время передается в формате UTC( 0000-00-00T00:00:00 ), если иное не указано в описании.

Важно: Учетная запись для интеграции не совпадает с учетной записью доступа в Личный Кабинет.

Важно: формат и значение параметра «Date» («DateFirst») должно быть одно и тоже как в запросе, так и при хешировании поля secure, иначе в ответ вы получите сообщение, что ИМ не идентифицирован. Т. е. если параметр Date в запросе указано в формате UTC(0000-00-00T00:00:00), то и при хешировании должно быть то же самое значение. Если время не важно, то можно использовать только дату при формировании параметра Date в запросе. Во всех ответных данных используется полный формате UTC(0000-00-00T00:00:00).

Учетная запись и секретный код назначаются СДЭК-ом по запросу ИМ на email *****@***ru.

2.3. На этапе тестирования интернет-магазину назначается тестовая учетная запись. При тестировании заказы клиента не отображаются в личном кабинете клиента на сайте www. cdek. ru. По завершению отладки ИМ сообщает о готовности переключиться на реальную учетную запись, при этом у клиента обязательно должен быть договор со СДЭК.

2.4. ИМ имеет возможность получать уведомления о результате отправки данных на электронную почту. Уведомления содержат информацию как об удачной загрузке заказов, так и об ошибках передачи данных. Список e-mail адресов передается СДЭКу вместе с запросом на учетную запись.

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