Мы предлагаем воспользоваться простым и быстрым доступом к функциям нашей системы, которые включают в себя расчет стоимости доставки, отслеживание посылок



Интеграционный гид DPDВерсия: 1.18Март 2017 г.

Оглавление TOC \o "1-3" \h \z \u Интеграционный гид DPD PAGEREF _Toc475021206 \h 1Оглавление PAGEREF _Toc475021207 \h 2История обновлений PAGEREF _Toc475021208 \h 9Введение PAGEREF _Toc475021209 \h 11I.Области интеграции PAGEREF _Toc475021210 \h 121.Запрос географии обслуживания PAGEREF _Toc475021211 \h 122.Расчёт стоимости доставки PAGEREF _Toc475021212 \h 123.Создание заказа на доставку PAGEREF _Toc475021213 \h 124.Изменение заказа на доставку PAGEREF _Toc475021214 \h 135.Отслеживание статуса доставки PAGEREF _Toc475021215 \h 136.Отчеты PAGEREF _Toc475021216 \h 137.Печать наклейки PAGEREF _Toc475021217 \h 148.Отмена заказа PAGEREF _Toc475021218 \h 149.Справочная информация PAGEREF _Toc475021219 \h 1410.Предикт PAGEREF _Toc475021220 \h 14II.Пример схемы взаимодействия PAGEREF _Toc475021221 \h 15III.Этапы интеграции PAGEREF _Toc475021222 \h 17IV.Руководство разработчика PAGEREF _Toc475021223 \h 181.Веб-служба «География DPD» PAGEREF _Toc475021224 \h 181.1.Описание PAGEREF _Toc475021225 \h 181.2.Расположение PAGEREF _Toc475021226 \h 181.3.Доступные методы PAGEREF _Toc475021227 \h 181.4.Алгоритм PAGEREF _Toc475021228 \h 181.5.Сообщения PAGEREF _Toc475021229 \h 191.5.1.Параметры входного сообщения getCitiesCashPay PAGEREF _Toc475021230 \h 191.5.2.Параметры ответа getCitiesCashPay PAGEREF _Toc475021231 \h 191.5.3.Параметры входного сообщения getParcelShops PAGEREF _Toc475021232 \h 191.5.4.Параметры выходного сообщения getParcelShops PAGEREF _Toc475021233 \h 201.5.4.1.Описание типа address PAGEREF _Toc475021234 \h 201.5.4.2.Описание типа geoCoordinates PAGEREF _Toc475021235 \h 211.5.4.3.Описание типа limits PAGEREF _Toc475021236 \h 211.5.4.4.Описание типа schedule PAGEREF _Toc475021237 \h 211.5.4.5.Описание типа timetable PAGEREF _Toc475021238 \h 211.5.4.6.Описание типа terminal PAGEREF _Toc475021239 \h 211.5.4.7.Описание типа service PAGEREF _Toc475021240 \h 221.5.5.Описание атрибутов ответного сообщения getParcelShops PAGEREF _Toc475021241 \h 221.5.5.1.Список возможных типов подразделения PAGEREF _Toc475021242 \h 221.5.5.2.Список возможный состояний пункта PAGEREF _Toc475021243 \h 221.5.5.3.Возможные варианты операций PAGEREF _Toc475021244 \h 221.5.5.4.Описание типа extraService PAGEREF _Toc475021245 \h 22Параметры входного сообщения getTerminalsSelfDelivery2 PAGEREF _Toc475021246 \h 221.5.6.Параметры выходного сообщения getTerminalsSelfDelivery2 PAGEREF _Toc475021247 \h 221.5.7.Параметры входного сообщения getStoragePeriod PAGEREF _Toc475021248 \h 231.5.8.Параметры выходного сообщения getStoragePeriod PAGEREF _Toc475021249 \h 231.5.8.1.Описание типа service PAGEREF _Toc475021250 \h 231.5.9.Параметры исходящего сообщения при ошибках getStoragePeriod PAGEREF _Toc475021251 \h 231.5.9.1.Справочник сообщений об ошибках PAGEREF _Toc475021252 \h 241.6Опции PAGEREF _Toc475021253 \h 242.Веб-служба «Расчёт стоимости» PAGEREF _Toc475021254 \h 252.1.Описание PAGEREF _Toc475021256 \h 252.2.Расположение PAGEREF _Toc475021257 \h 252.3.Доступные методы PAGEREF _Toc475021258 \h 252.4.Алгоритмы PAGEREF _Toc475021259 \h 252.4.1.Рассчитать общую стоимость доставки по России PAGEREF _Toc475021260 \h 252.4.2.Рассчитать стоимость доставки по параметрам посылок PAGEREF _Toc475021261 \h 252.4.3.Рассчитать стоимость доставки по международным направлениям PAGEREF _Toc475021262 \h 262.5.Сообщения PAGEREF _Toc475021263 \h 262.5.1.Параметры входного сообщения для getServiceCost2 PAGEREF _Toc475021264 \h 262.5.2.Параметры входного сообщения для getServiceCostByParcels2 PAGEREF _Toc475021265 \h 282.5.3Параметры входного сообщения для getServiceCostInternational PAGEREF _Toc475021266 \h 292.5.4Параметры ответа при ошибке PAGEREF _Toc475021267 \h 302.5.5Параметры ответа при успешном запросе PAGEREF _Toc475021268 \h 312.6Типы PAGEREF _Toc475021269 \h 312.6.1Описание типа parcel PAGEREF _Toc475021270 \h 313.Веб-служба «Создание заказа» PAGEREF _Toc475021271 \h 323.1.Описание PAGEREF _Toc475021275 \h 323.2.Расположение PAGEREF _Toc475021276 \h 323.3.Доступные методы PAGEREF _Toc475021277 \h 323.4.Алгоритмы PAGEREF _Toc475021278 \h 333.4.1.Создание заказа на доставку PAGEREF _Toc475021279 \h 333.4.2.Создание адреса с кодом PAGEREF _Toc475021280 \h 333.4.3.Изменение адреса с кодом PAGEREF _Toc475021281 \h 333.5.Сообщения PAGEREF _Toc475021282 \h 333.5.1.Параметры входного сообщения createOrder PAGEREF _Toc475021283 \h 333.5.2.Параметры входного сообщения getOrderStatus PAGEREF _Toc475021284 \h 353.5.3.Параметры ответного сообщения createOrder \ getOrdersStatus PAGEREF _Toc475021285 \h 363.5.4.Параметры входного сообщения createAddress \ updateAddress PAGEREF _Toc475021286 \h 363.5.5.Параметры ответного сообщения createAddress \ updateAddress PAGEREF _Toc475021287 \h 373.5.6.Параметры входного сообщения getInvoiceFile PAGEREF _Toc475021288 \h 373.5.7.Параметры ответного сообщения getInvoiceFile PAGEREF _Toc475021289 \h 373.5.8.Параметры входного сообщения getRegisterFile PAGEREF _Toc475021290 \h 373.5.9.Параметры ответного сообщения getRegisterFile PAGEREF _Toc475021291 \h 383.5.10.Параметры ответа при ошибке PAGEREF _Toc475021292 \h 383.5.11.Параметры входного сообщения addAirwayBill PAGEREF _Toc475021293 \h 383.5.12.Параметры выходного сообщения addAirwayBill PAGEREF _Toc475021294 \h 393.6.Типы PAGEREF _Toc475021295 \h 403.6.1.Описание типа address PAGEREF _Toc475021296 \h 403.6.2.Описание типа dataInternational PAGEREF _Toc475021297 \h 413.6.3.Описание типа extraService PAGEREF _Toc475021298 \h 413.6.4.Описание типа parameter PAGEREF _Toc475021299 \h 423.6.5.Описание типа parcel PAGEREF _Toc475021300 \h 423.6.6.Описание типа unitLoad PAGEREF _Toc475021301 \h 423.7.Варианты доставки PAGEREF _Toc475021302 \h 423.8.Интервалы времени приёма PAGEREF _Toc475021303 \h 433.9.Интервалы времени доставки PAGEREF _Toc475021304 \h 433.10.Варианты формы оплаты PAGEREF _Toc475021305 \h 433.11.Услуги DPD PAGEREF _Toc475021306 \h 433.12.Опции PAGEREF _Toc475021307 \h 433.13. Справочник параметров PAGEREF _Toc475021308 \h 453.14.Статусы создания заказа PAGEREF _Toc475021309 \h 463.15.Статусы создания и изменения адреса PAGEREF _Toc475021310 \h 464.Веб-служба «Изменение заказа» PAGEREF _Toc475021311 \h 474.1.Описание PAGEREF _Toc475021316 \h 474.2.Расположение PAGEREF _Toc475021317 \h 474.3.Доступные методы PAGEREF _Toc475021318 \h 474.4.Алгоритмы PAGEREF _Toc475021319 \h 474.4.1.Изменение заказа с добавлением посылок PAGEREF _Toc475021320 \h 474.4.2.Изменение заказа с удалением посылок PAGEREF _Toc475021321 \h 474.5.Сообщения PAGEREF _Toc475021322 \h 474.5.1.Параметры входного сообщения addParcels \ removeParcels PAGEREF _Toc475021323 \h 474.5.2.Параметры ответного сообщения для addParcels \ removeParcels PAGEREF _Toc475021324 \h 484.6.Типы PAGEREF _Toc475021325 \h 484.6.1.Описание типа parcel PAGEREF _Toc475021326 \h 484.6.2.Описание типа parcelStatus PAGEREF _Toc475021327 \h 494.7.Статусы PAGEREF _Toc475021328 \h 494.7.1.Статусы изменения заказа PAGEREF _Toc475021329 \h 494.7.2.Статусы добавления \ удаления посылки PAGEREF _Toc475021330 \h 495.Веб-служба «Отслеживание статуса» PAGEREF _Toc475021331 \h 505.1.Описание PAGEREF _Toc475021337 \h 505.2.Расположение PAGEREF _Toc475021338 \h 505.3.Доступные методы PAGEREF _Toc475021339 \h 505.4.Алгоритмы PAGEREF _Toc475021340 \h 515.4.1.Алгоритм работы с методом getStatesByClient. PAGEREF _Toc475021341 \h 515.4.2.Алгоритм работы с методами getStatesByClientOrder, getStatesByDPDOrder, getStatesByClientParcel PAGEREF _Toc475021342 \h 525.4.3.getStatesByClient PAGEREF _Toc475021343 \h 525.4.4.confirm PAGEREF _Toc475021344 \h 525.4.5.getStatesByClientOrder PAGEREF _Toc475021345 \h 525.4.6.getEvents PAGEREF _Toc475021346 \h 535.4.7.getStatesByClientParcel PAGEREF _Toc475021347 \h 535.4.8.getStatesByDPDOrder PAGEREF _Toc475021348 \h 545.5.Исходящие сообщения PAGEREF _Toc475021349 \h 545.5.1.getStatesByClientResponse PAGEREF _Toc475021350 \h 545.5.2getEventsResponse PAGEREF _Toc475021351 \h 565.5.2confirmResponse PAGEREF _Toc475021352 \h 615.5.3getStatesByClientOrderResponse PAGEREF _Toc475021353 \h 615.5.4getStatesByClientParcelResponse PAGEREF _Toc475021354 \h 615.5.5getStatesByDPDOrderResponse PAGEREF _Toc475021355 \h 615.6.Состояния PAGEREF _Toc475021356 \h 615.6.1Посылка PAGEREF _Toc475021357 \h 616.Веб-служба «Отчеты» PAGEREF _Toc475021358 \h 636.1Описание PAGEREF _Toc475021359 \h 636.2Расположение PAGEREF _Toc475021360 \h 636.3Доступные методы PAGEREF _Toc475021361 \h 636.4Алгоритмы PAGEREF _Toc475021362 \h 636.5Сообщения PAGEREF _Toc475021363 \h 636.5.1Параметры входного сообщения метода getWaybill PAGEREF _Toc475021364 \h 636.5.2Параметры входного сообщения метода getNLAmount PAGEREF _Toc475021365 \h 636.5.3Параметры входного сообщения метода getNLInvoice PAGEREF _Toc475021366 \h 646.5.4Параметры ответного сообщения метода getNLAmount PAGEREF _Toc475021367 \h 646.5.5Параметры ответного сообщения метода getNLInvoice PAGEREF _Toc475021368 \h 646.5.6Параметры ответного сообщения метода getWillBill PAGEREF _Toc475021369 \h 656.6Ограничение на частоту вызовов PAGEREF _Toc475021370 \h 657.Веб-служба «Печать Наклейки» PAGEREF _Toc475021371 \h 667.1.Описание PAGEREF _Toc475021372 \h 667.2.Расположение PAGEREF _Toc475021373 \h 667.3.Доступные методы PAGEREF _Toc475021374 \h 667.4.Алгоритмы PAGEREF _Toc475021375 \h 667.4.1.Формат файла PAGEREF _Toc475021376 \h 667.4.2.Формат области печати PAGEREF _Toc475021377 \h 667.5.Входящие сообщения PAGEREF _Toc475021378 \h 667.5.1.createLabelFile PAGEREF _Toc475021379 \h 667.5.2createParcelLabel PAGEREF _Toc475021380 \h 677.6Исходящие сообщения PAGEREF _Toc475021381 \h 677.6.1createLabelFileResponse PAGEREF _Toc475021382 \h 677.6.2.createParcelLabelResponse PAGEREF _Toc475021383 \h 688.Веб-служба «Отмена заказа» PAGEREF _Toc475021384 \h 718.1.Описание PAGEREF _Toc475021385 \h 718.2.Расположение PAGEREF _Toc475021386 \h 718.3.Доступные методы PAGEREF _Toc475021387 \h 718.4.Алгоритмы PAGEREF _Toc475021388 \h 728.5.Входящие сообщения PAGEREF _Toc475021389 \h 728.6.Параметры ответного сообщения PAGEREF _Toc475021390 \h 728.7.Статусы PAGEREF _Toc475021391 \h 728.8.Текст сообщений об ошибке PAGEREF _Toc475021392 \h 739.«Справочная информация» PAGEREF _Toc475021393 \h 749.1.Веб-служба «Справочная информация» PAGEREF _Toc475021394 \h 749.1.1.Описание PAGEREF _Toc475021395 \h 749.1.2.Расположение PAGEREF _Toc475021396 \h 749.1.3.Доступные методы PAGEREF _Toc475021397 \h 749.1.4.Алгоритмы PAGEREF _Toc475021398 \h 749.1.5.Входящее сообщения (getClientNumByINN) PAGEREF _Toc475021399 \h 749.1.6.Параметры ответного сообщения (getClientNumByINN) PAGEREF _Toc475021400 \h 749.1.7.Входящее сообщения (getClientPredictSms) PAGEREF _Toc475021401 \h 759.1.8.Параметры ответного сообщения (getClientPredictSms) PAGEREF _Toc475021402 \h 759.1.9.Статусы ответов PAGEREF _Toc475021403 \h 759.2.Файловый обмен Справочников ДПД PAGEREF _Toc475021404 \h 769.2.1.Описание PAGEREF _Toc475021405 \h 769.2.2.Расположение PAGEREF _Toc475021406 \h 769.2.3.Доступные отчеты PAGEREF _Toc475021407 \h 7610.Веб-служба «Предикт» PAGEREF _Toc475021408 \h 7710.1.Описание PAGEREF _Toc475021409 \h 7710.2.Расположение PAGEREF _Toc475021410 \h 7710.3.Доступные методы PAGEREF _Toc475021411 \h 7710.4.Алгоритмы PAGEREF _Toc475021412 \h 7810.5.Входящее сообщение метода getShipmentList PAGEREF _Toc475021413 \h 7810.6.Параметры ответного сообщения getShipmentList PAGEREF _Toc475021414 \h 7810.7.Входящее сообщение методов PAGEREF _Toc475021415 \h 7910.8.Параметры ответного сообщения IsAddressChangeable PAGEREF _Toc475021416 \h 8110.9.Параметры ответного сообщения getDeliveryDate PAGEREF _Toc475021417 \h 8110.10.Параметры ответного сообщения getDeliveryIntervalList PAGEREF _Toc475021418 \h 8110.11.Параметры ответного сообщения getParselShopList PAGEREF _Toc475021419 \h 8110.12.Параметры ответного сообщения getAddress PAGEREF _Toc475021420 \h 8210.13.Параметры ответного сообщения getStreetList PAGEREF _Toc475021421 \h 8310.14.Параметры ответного сообщения saveDeliveryDate PAGEREF _Toc475021422 \h 8310.15.Параметры ответного сообщения getWebSite PAGEREF _Toc475021423 \h 8310.16.Параметры ответного сообщения cancelOrder PAGEREF _Toc475021424 \h 8310.17.Параметры ответного сообщения saveAddress PAGEREF _Toc475021425 \h 8310.18.Параметры ответного сообщения saveParcelShop PAGEREF _Toc475021426 \h 8310.19.Параметры ответного сообщения getDeliveryDateList PAGEREF _Toc475021427 \h 8310.20.Статусы сообщений PAGEREF _Toc475021428 \h 83V.Справочник ошибок PAGEREF _Toc475021429 \h 851.Общие ошибки PAGEREF _Toc475021436 \h 852.Ошибки службы «Расчёт стоимости» PAGEREF _Toc475021437 \h 853.Ошибки службы «Создание заказа» PAGEREF _Toc475021438 \h 864.Ошибки службы «Отслеживание статуса» PAGEREF _Toc475021439 \h 895.Ошибки службы «Создание адреса с кодом» PAGEREF _Toc475021440 \h 906.Ошибки службы «Печать Наклейки» PAGEREF _Toc475021441 \h 907.Ошибки службы «Отчеты» PAGEREF _Toc475021442 \h 90VI.Контакты PAGEREF _Toc475021443 \h 91
История обновленийВерсия 1.8
новая веб-служба «Отмена заказа» (CancelOrder).
Версия 1.9
метод getTerminalSelfDelivery2 – расширен список параметров ответного сообщение (отображение координат нахождения терминалов, времени работы терминалов, код КЛАДР населенного пункта нахождения терминала);
веб-служба «Расчет стоимости» - добавлена расшифровка кодов услуг DPD;
добавлены наименования оборотов для каждого метода;
примеры интеграции вынесены в отдельные документы.
Версия 1.10
для методов getNLAmount и getNLInvoice отменены ограничения только ночного запуска. Отчеты можно запускать в любое время суток. Введены ограничения на частоту запуска отчетов;
новый метод getRegisterFile в веб-службе «Создание заказа» - позволяет получать реестр отправок, передаваемых курьеру DPD.
Версия 1.11
метод createOrder – добавлено описание параметров и их значений для различных вариантов оплаты наличными.
метод createOrder – описание параметров и значений для опции ЧСТ; описание параметров для добавления вложений – unitLoad.
Версия 1.12
новая веб-служба «Справочная информация». Метод getClientNumByINN – определение клиентского номера в системе DPD по ИНН (для оформления заказов с оплатой не заказчиками).
Версия 1.13
Добавлен новый метод getParcelShops в веб-службу «География DPD», данный метод позволяет выгружать информацию по пунктам выдачи DPD и постаматам.
Добавлена Веб-служба «Предикт».
Исправлены ошибки в документации
При использовании методов веб-службы «Расчёт стоимости», при неоднозначном указании населенного пункта, в ответ были добавлены параметры о аббревиатуре населенного пункта и индексе.
Добавлены необязательные параметры в метод getRegisterFile для фильтрации количества реестров.
Версия 1.14
В метод getParcelShops добавлены новые поля в выходящие параметры. Теперь сервис показывает возможные виды оплат с временем их работы и возможные опции на данном пункте выдаче(справочник опций которые показываются ограничен, а именно опциями НПП и ОЖД).
Версия 1.15
Добавлен новый метод getEvents в веб-службу «Отслеживание статуса», данный метод позволяет отслеживать заявки клиента.
Добавлен новый метод createParcelLabel в веб-службу «Печать Наклейки», данный метод позволяет получать параметры для формирования интегрированной наклейки.
Добавлен новый метод getServiceCostInternational в веб-службу «Расчёт стоимости», данный метод позволяет рассчитать общую стоимость доставки по международным направлениям.
Добавлен новый метод getWaybill в веб-службу «Отчёты», данный метод позволяет получить сканобраза подписанной получателем накладной.
Версия 1.16
В раздел «Справочная информация» добавлено описание по файловому обмену Справочников ДПД.
Исправлены ошибки в документации
Версия 1.17
Новый метод в веб-службе «Справочная информация». Метод getClientPredictSms– предоставление короткой ссылки на сервис predict без авторизации по номеру заказа DPD или клиентскому номеру заказа.
Исправлены ошибки в документации
Версия 1.18
В метод getParcelShops добавлен новый атрибут в ответное сообщение «brand» - бренд пункта выдачи
Новый метод в веб-службе «Создание заказа». Метод addAirwayBill добавление в международный заказ № авианакладной.
В веб-службе «Создание заказа» в тип unitLoad добавлен обязательный параметр сount количество
В веб-службе «Создание заказа» в тип unitLoad добавлены необязательные параметры vat_percent (процент НДС) и witout_vat  (без ндс)
ВведениеКомпания DPD предоставляет ряд стандартных решений для интеграции своей информационной системы с информационными системами клиентов. Такого рода интеграция позволяет нашим компаниям обмениваться необходимыми данными в реальном времени и исключает обработку данных вручную, что значительно ускоряет и оптимизирует бизнес-процесс. Мы предлагаем воспользоваться простым и быстрым доступом к функциям нашей системы, которые включают в себя расчет стоимости доставки, отслеживание посылок, создание заказов на доставку и получение информации о географии обслуживания.
Базовый принцип взаимодействия представлен на следующем рисунке:

Интеграционный модуль DPD представляет собор набор веб-служб, построенных на базе технологий SOAP и REST и развернутых на серверах приложений Tomcat.
Подробнее про веб-службы и про технологию SOAP можно прочитать, например, здесь:
http://www.webmascon.com/topics/technologies/8a.aspОбласти интеграцииНа данный момент существуют десять областей интеграции с информационной системой DPD:
Запрос географии обслуживания
Расчёт стоимости доставки
Создание заказа на доставку
Изменение заказа
Отслеживание статуса доставки
Отчеты
Печать Наклейки
Отмена заказа
Справочная информация
Предикт
Запрос географии обслуживанияЗапрос географии обслуживания подразумевает получение информации о географии доставки DPD в реальном времени. Эта область интеграции поддерживает два метода:
Получение списка городов, в которых расположены терминалы DPD.
Получение списка городов, в которые осуществляется доставка с наложенным платежом.
Расчёт стоимости доставкиИнтеграция в области расчёта стоимости нужна для того, чтобы ваша информационная система в любой момент могла получить актуальную стоимость доставки и при необходимости предоставить эту стоимость своему клиенту. Входящие в состав области методы позволяют:
Выполнить расчёт стоимости доставки по выбранному направлению и услуге. Это актуально, если вы постоянно пользуетесь одной услугой для доставки. Для расчета стоимости необходимо выбирать лишь направление.
Получить список доступных услуг и их стоимость для выбранного направления.
Выполнить более точный расчет стоимости доставки на основе данных посылок. Это актуально, если вы точно знаете количество, габариты и веса ваших посылок.
Создание заказа на доставкуСоздание заказа на доставку с помощью интеграционного модуля позволяет максимально быстро передать в нашу систему необходимую информацию для формирования отправки. Например, как только пользователь интернет-магазина подтверждает свой заказ, информационная система магазина генерирует онлайн запрос, в котором передает все необходимые сведения: дату вызова курьера, адрес приёма груза, адрес доставки и т.п. Интеграционный модуль DPD примет заявку на создание заказа и в ответном запросе сообщит статус создания заказа, ошибки создания заказа (если заказ не создан) и номер заказа в информационной системе DPD (если заказ создан корректно).
Статус создания заказа может быть следующим: заказ создан корректно, заказ отклонен из-за ошибок, или заказ принят на доработку. Последний статус означает, что мы не смогли автоматически принять заказ (например, потому что наша система не смогла распознать адрес доставки), и ваш запрос будет обработан нашим сотрудником вручную, который уточнит и поправит всю необходимую информацию и завершит процесс создания заказа.
Данная область поддерживает методы:
Создание заказов на доставку.
Проверка статуса создания заказа и получение его номера. Этот метод необходим для тех случаев, когда заказ не был создан автоматически и был позднее доработан сотрудником DPD.
Создание адресов с кодом. Данный метод необходим в случае, если есть адрес, который часто используется в заказе и вместо него проще передавать код адреса.
Изменение адрес с кодом. Данный метод необходим в случае, когда закрепленный за кодом адрес изменился.
Изменение заказа на доставкуИзменение заказа на доставку с помощью интеграционного модуля позволяет максимально оперативно передать в нашу систему изменившуюся информацию для корректировки данных заказа. Изменения данных заказа возможны до момента получения груза на терминале компании.
Статус изменения заказа может быть следующим: заказ изменен успешно, состояние заказа не позволяет выполнять его корректировку. Последний статус означает, что груз уже был получен от клиента компанией.
Данная область поддерживает два метода:
Создание заказов на доставку.
Проверка статуса создания заказа и получение его номера. Этот метод необходим для тех случаев, когда заказ не был создан автоматически и был позднее доработан сотрудником DPD.
Отслеживание статуса доставкиОбласть отслеживания статуса доставки предоставляет две основные возможности: вы можете позволить своему клиенту отслеживать статус его доставки в реальном времени, и вы можете в любое время получать актуальные сведения о статусе всех своих доставок.
Данная область поддерживает три метода:
Получение статусов ваших посылок, изменившихся с момента предыдущего запроса. Необходимо указать ваш клиентский номер.
Получение статусов посылок по указанному заказу. Информация предоставляется как по номеру вашего заказа, так и по номеру заказа DPD.
Получение статусов конкретной посылки. Информация предоставляется по номеру/штрих-коду вашей посылки.
ОтчетыДанная область позволяет получать необходимые Вам отчеты по запросу.
Входящие в состав области методы позволяют получить следующие отчеты:
О предварительной стоимости перевозки отправок за период времени.
Об окончательной стоимости перевозки отправок за период времени с номерами счетов.
Печать наклейкиДанная область предоставляет вам возможность посредством сервиса формировать наклейки DPD по ранее созданному заказу.
Отмена заказаДанная область предоставляет вам возможность посредством сервиса отменять заказы без звонка в Call центр DPD.
Справочная информацияДанная область предоставляет возможность оперативно получить различную информацию, в том числе получить номер клиента по номеру ИНН компании.
ПредиктДанная область предоставляет возможность Изменение заказа на доставку с помощью интеграционного модуля позволяет максимально оперативно передать в нашу систему изменившуюся информацию для корректировки данных заказа. Изменения данных заказа возможны до момента получения груза.
Статус изменения заказа описаны в пункте REF _Ref423964863 \r \h \* MERGEFORMAT 10.20 данного Документа.
Данная область поддерживает методы:
Изменение даты доставки.
Изменение времени доставки.
Изменения адреса доставки.
Пример схемы взаимодействия
Следующая схема описывает взаимодействие с использованием всех областей интеграции на примере клиента - интернет-магазина.


Этапы интеграцииДля запуска интеграционного процесса с DPD вам нужно совершить следующие действия:
Передать данное руководство в ваш IT-департамент.
Разработать клиентскую программу для взаимодействия с выбранными веб-службами.
получить уникальный ключ клиента – для этого необходимо зайти в личный кабинет(MyDPD) по адресу http://www.dpd.ru/ols/order/personal/integrationKey.do2  указав свой логин и пароль. На странице нужно нажать на кнопку «отправить» и ключ будет выслан на указанный e-mail. Если у Вас возникли трудности с получением ключа, обращайтесь в службу поддержки по адресу [email protected];
Протестировать работу веб-служб совместно с сотрудниками информационной поддержки DPD, используя тестовый сервер DPD. Адрес тестового сервера приведен ниже в руководстве разработчика.
Настроить вашу программу на промышленный сервер DPD и начать работать в реальном режиме. Адрес промышленного сервера приведен ниже в руководстве разработчика.
Руководство разработчикаВ данном разделе дано подробное описание методов, имеющихся в веб-службах.
Веб-служба «География DPD»ОписаниеВеб-служба «География DPD» предназначена для получения актуального списка городов, в которые возможна доставка с наложенным платежом, списка терминалов DPD и списка пунктов выдачи посылок (ПВП), а также списка пунктов приема/выдачи посылок с указанием режима работы пункта для самопривоза/самовывоза.
ВНИМАНИЕ: На данный сервис есть ограничение - 7000 запросов в сутки.
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru/services/geography2?wsdlПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/services/geography2?wsdl
Доступные методыМетод Назначение Входящее сообщение Ответное сообщение
getCitiesCashPay
Получить список городов с возможностью доставки с наложенным платежом Параметры входного сообщения Параметры ответа getCitiesCashPaygetParcelShops Получить список пунктов приема/выдачи посылок, имеющих ограничения по габаритам и весу, с указанием режима работы пункта и доступностью выполнения самопривоза/самовывоза.
При работе с методом необходимо проводить получение информации по списку подразделений ежедневно. Параметры входного сообщенияПараметры выходного сообщенияgetTerminalsSelfDelivery2
Получить список подразделений DPD, не имеющих ограничений по габаритам и весу посылок приема/выдачи Параметры входного сообщенияПараметры ответа getTerminalsSelfDelivery2getStoragePeriod
Получить информацию о срок бесплатного хранения на пункте Параметры входного сообщенияПараметры ответа/Параметры ответа при ошибке
АлгоритмПодготавливаем данные для аутентификации входного запроса и вызываем нужный метод.
Обрабатываем результат в соответствии со спецификацией ответных сообщений выбранного метода.
СообщенияПараметры входного сообщения getCitiesCashPayПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
countryCode Код страны Строка Нет RU
Параметры ответа getCitiesCashPayПараметр Описание Тип Пример
city Массив городов с поддержкой доставки с наложенным платежом cityId Идентификатор города Число 195644235
countryCode Код страны Строка RU
countryName Страна Строка Россия
regionCode Код региона Строка 50
regionName Регион Строка Московская обл. (формат ФИАС)
cityCode Код населенного пункта Строка 50017001000
cityName Населенный пункт Строка Люберцы (буквенные обозначения аббревиатур и других знаков)
abbreviation Аббревиатура Строка г
indexMin Минимальный индекс Строка 140000
indexMax Максимальный индекс Строка 143818
Параметры входного сообщения getParcelShopsПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
countryCode Код страны Строка Нет RU
regionCode Код региона Строка Нет 77
cityCode Код города Строка Нет 77011000011
cityName Наименование города Строка Нет Москва (буквенные обозначения аббревиатур и других знаков)
ПРИМЕЧАНИЯ. 1. Поля countryCode, regionCode и cityCode задаются для фильтрации списка. Если коды не заданы, возвращается полный список. Поле cityName анализируется только, если не задан cityCode.
2. Сроки бесплатного хранения зависят от услуги DPD и одинаковы для всех пунктов. Для получения сроков бесплатного хранения необходимо задать поле serviceCode.
Параметры выходного сообщения getParcelShops
Параметр Описание Тип Пример
parcelShop Массив ПВП и пунктов code Код подразделения DPD Строка LED
parcelShopType Тип подразделения.
Варианты типов подразделенийСтрока П
state Состояние подразделения
Варианты состояний Строка Open
address Адрес пункта addressgeoCoordinates Географические координаты по карте Яндекс geoCoordinateslimits Ограничения параметров посылки limitsschedule Массив операций производственного подразделения scheduleextraService Массив опций extraServiceservices Массив услуг servicesbrand Описание типа addressПараметр Описание Тип Пример
countryCode Код страны Строка RU
regionCode Код региона Строка 77
regionName Регион Строка Московская обл. (формат ФИАС)
cityCode Код города Строка 77000000000
cityName Город Строка Москва (без буквенных обозначений аббревиатур и других знаков)
street Наименование улицы Строка Земляной Вал
streetAbbr Аббревиатура улицы Строка ул
houseNo Номер дома Строка 7
building Корпус Строка structure Строение Строка ownership Владение Строка descript Описание проезда Строка Описание типа geoCoordinatesПараметр Описание Тип Пример
latitude Широта Число 53.322927
longitude Долгота Число 83.638803
Описание типа limitsПараметр Описание Тип Пример
maxShipmentWeight Макс. вес отправки в кг Число 30.5
maxWeight Макс. Вес посылки в кг Число 5.5
maxLength Макс. длина в см Число 70
maxWidth Макс. ширина в см Число 70
maxHeight Макс. высота в см Число 50
dimensionSum Сумма габаритов в см Число 200
Описание типа scheduleПараметр Описание Тип Пример
operation Наименование операции
Варианты операцийСтрока SelfDelivery
timetable Массив расписания для операции timetableОписание типа timetableПараметр Описание Тип Пример
weekDays Список дней недели Строка пн,вт,ср,чт,пт
workTime Список времени работы Строка 09:00–20:00
Описание типа terminalПараметр Описание Тип Пример
terminal Массив  подразделений с указанием срока хранения terminalCоde Код пункта приема/выдачи Строка 41W
services Массив услуг
service Описание типа serviceПараметр Описание Тип Пример
serviceCode Код услуги Строка PCL
days Количество дней Число 3
Описание атрибутов ответного сообщения getParcelShopsСписок возможных типов подразделенияП – постамат
ПВП – пункт приема/выдачи посылок
Список возможный состояний пунктаopen (Открыт)
full (Переполнен)
Возможные варианты операцийSelfPickup – прием посылок
SelfDelivery – выдача посылок
Payment - оплата наличными за доставку
PaymentByBankCard - оплата банковской картой
Описание типа extraServiceПараметр Описание Тип Пример
esCode Код опции. См описания опций в разделе «Опции». Строка НПП
Параметры входного сообщения getTerminalsSelfDelivery2Параметр Описание Тип Обязательный Пример
auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
Параметры выходного сообщения getTerminalsSelfDelivery2Параметр Описание Тип Пример
terminal Массив терминалов DPD terminalCode Код терминала DPD Строка M13
terminalName Название терминала DPD Строка Москва
address Адрес пункта addressgeoCoordinates Географические координаты по карте Яндекс geoCoordinatesschedule Массив операций производственного подразделения scheduleextraService Массив опций extraServiceservices Массив услуг servicesПараметры входного сообщения getStoragePeriodПараметр Описание Тип Обязательный Пример
auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
terminalCоde Код подразделения DPD Строка
Список кодов подразделений через запятую Да 03Z,OEL
serviceCode Код услуги Строка
Список кодов услуг через запятую Нет PCL,CSM
Параметры выходного сообщения getStoragePeriodПараметр Описание Тип Пример
terminal Массив  подразделений с указанием срока хранения terminalCоde Код пункта приема/выдачи Строка 03Z
services Массив услуг
serviceП
Описание типа serviceПараметр Описание Тип Пример
serviceCode Код услуги Строка PCL
days Количество дней Число 3
Параметры исходящего сообщения при ошибках getStoragePeriodПараметр Описание Тип Обязательный Пример
status СтатусСтрока Да Ок
errorMessage Сообщение об ошибкеСтрока Да В ответном сообщении при передаче информации может быть возвращен один из следующих статусов:
ОК – информация успешно передана
Код ошибки – информация не может быть обработана по причине, указанной в поле errorMessage.
Справочник сообщений об ошибкахКод ошибки Текст ошибки Примечание
no- terminalCоde-found Не удалось найти указанный код подразделения <Код подразделения DPD> Некорректно указан код подразделения DPD.
Введите верный код услуги и попробуйте повторно.
no- serviceCode-found Не удалось найти указанный код услуги <Код услуги> Некорректно указан код услуги.
Введите верный код услуги и попробуйте повторно.
no- data-found Нет данных для указанных <Код подразделения DPD>, <Код услуги> По указанным параметрам нет данных в системе.
required-value Не заданы значения обязательных полей Проверьте алгоритм заполнения всех обязательных полей входного сообщения.
ОпцииКод опции Описание опции Имя параметра Значение параметра
ОЖД Ожидание на адресе reason_delay причина ожидания на адресе  из Справочника причин ожидания на адресе:
ВНЕШ Проверка на внешние поврежденияПРИМ ПримеркаРАБТ Проверка работоспособностиСООТ Проверка на соответствие
НПП Наложенный платеж sum_npp Максимальная допустимая сумма НПП за заказ (пример: 15000).
Веб-служба «Расчёт стоимости»ОписаниеВеб-служба «Расчёт стоимости» предназначена для расчёта стоимости доставки по тарифам DPD.
ВНИМАНИЕ: На данный сервис есть ограничение – 50.000 запросов в сутки.
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru/services/calculator2?wsdlПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/services/calculator2?wsdlДоступные методыМетод Назначение Входящее сообщение Ответное сообщение
getServiceCost2 Рассчитать общую стоимость доставки по России и странам ТС. Параметры входного сообщения Параметры ответа при ошибке / Параметры ответа при успешном запросеgetServiceCostByParcels2 Рассчитать стоимость доставки по параметрам посылок по России и странам ТС. Параметры входного сообщенияПараметры ответа при ошибке / Параметры ответа при успешном запросеgetServiceCostInternational Рассчитать общую стоимость доставки по международным направлениям Параметры входного сообщенияПараметры ответа при ошибке / Параметры ответа при успешном запросеАлгоритмыРассчитать общую стоимость доставки по РоссииПодготавливаем параметры вызова в соответствии с описанием входного сообщения метода getServiceCost2: пункт отправления и назначения, дату приёма груза, объявленную ценность. Если вы работаете с DPD только по одной услуге, рекомендуется указать код этой услуги во входном сообщении.
Вызываем метод getServiceCost2.
Получаем ответное сообщение с кодом ошибки или с массивом доступных услуг для выбранной доставки и их стоимости. Если услуга была задана во входном сообщении, то при успешном выполнении запроса массив ответного сообщения будет состоять из одного элемента.
Если вы получили код ошибки «too-many-rows», то проанализируйте массивы pickupDups и DeliveryDups во входном сообщении. Выберите ID нужного населенного пункта и повторите запрос.
Рассчитать стоимость доставки по параметрам посылокПодготавливаем параметры вызова в соответствии с описанием входного сообщения метода getServiceCostByParcels2: пункт отправления и назначения, дату приёма груза, объявленную ценность. Если вы работаете с DPD только по одной услуге, рекомендуется указать код этой услуги во входном сообщении.
Вызываем метод getServiceCostByParcels2.
Получаем ответное сообщение с кодом ошибки или с массивом доступных услуг для выбранной доставки и их стоимости. Если услуга была задана во входном сообщении, то при успешном выполнении запроса массив ответного сообщения будет состоять из одного элемента.
Если вы получили код ошибки «too-many-rows», то проанализируйте массивы pickupDups и DeliveryDups во входном сообщении. Выберите ID нужного населенного пункта и повторите запрос.
Рассчитать стоимость доставки по международным направлениямПодготавливаем параметры вызова в соответствии с описанием входного сообщения метода getServiceCostInternational: пункт отправления и назначения, дату приёма груза, объявленную ценность. Если вы работаете с DPD только по одной услуге, рекомендуется указать код этой услуги во входном сообщении.
Вызываем метод getServiceCostInternational .
Получаем ответное сообщение с кодом ошибки или с массивом доступных услуг для выбранной доставки и их стоимости. Если услуга была задана во входном сообщении, то при успешном выполнении запроса массив ответного сообщения будет состоять из одного элемента.
Если вы получили код ошибки «too-many-rows», то проанализируйте массивы Dups и в выходном сообщении. Выберите ID нужного населенного пункта и повторите запрос.
СообщенияПараметры входного сообщения для getServiceCost2Параметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
pickup cityId Идентификатор города отправления Число Нет 49694102
index Индекс Строка Нет 140012
cityName Город отправления Строка Нет Москва (буквенные обозначения аббревиатур и других знаков)
regionCode Код региона отправления Строка Нет 77
countryCode Код страны отправления Строка Нет RU
delivery cityId Идентификатор города доставки Число Нет 49265227
index Индекс Строка Нет 140012
cityName Город доставки Строка Нет
Челябинск (буквенные обозначения аббревиатур и других знаков)
regionCode Код региона доставки Строка Нет 74
countryCode Код страны доставки Строка Нет RU
selfPickup Самопривоз на терминал. boolean Да false
selfDelivery Доставка до терминала. Самовывоз с терминала. boolean Да true
weight Вес отправки, кг Число Да 5
volume Объём, м3 Число Нет 0.05
serviceCode Список кодов услуг DPD. Если параметр задан, то сервис возвращает стоимость только заданных услуг. Если он не задан – всех доступных услуг. СтрокаСписок кодов услуг через запятую Нет BZP,ECN
pickupDate Предполагаемая дата приёма груза. Стоимость будет считаться на заданную дату. Если параметр не задан – будет считаться на текущую дату. Дата Нет 2014-05-21
maxDays Максимально допустимый срок. Если параметр задан, то все услуги с большим сроком не будут показываться. Параметр не имеет смысла, если задавать конкретную услугу. Целое число Нет 2
maxCost Максимально допустимая стоимость. Если параметр задан, то все услуги с большей стоимостью не будут показываться. Параметр не имеет смысла, если задавать конкретную услугу. Число Нет 1000
declaredValue Объявленная ценность груза Число Нет 1000 (после запятой не более 2-х знаков)
Важно: нужно обязательно задать либо cityID, либо cityName, как в случае города отправления, так и в случае города доставки.
Параметры входного сообщения для getServiceCostByParcels2Параметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
pickup cityId Идентификатор города отправления Число Нет 49694102
cityName Город отправления Строка Нет Москва (буквенные обозначения аббревиатур и других знаков)
regionCode Код региона отправления Строка Нет 77
countryCode Код страны отправления Строка Нет RU
delivery cityId Идентификатор города доставки Число Нет 49265227
index Индекс Строка Нет 140012
cityName Город доставки Строка Нет
Челябинск (буквенные обозначения аббревиатур и других знаков)
regionCode Код региона доставки Строка Нет 74
countryCode Код страны доставки Строка Нет RU
selfPickup Доставка от терминала boolean Да false
selfDelivery Доставка до терминала boolean Да true
serviceCode Список кодов услуг DPD. Если параметр задан, то сервис возвращает стоимость только заданных услуг. Если он не задан – всех доступных услуг. СтрокаСписок кодов услуг через запятую Нет BZP, ECN
pickupDate Предполагаемая дата приёма груза. Стоимость будет считаться на заданную дату. Если параметр не задан – будет считаться на текущую дату. Дата Нет 2014-05-21
maxDays Максимально допустимый срок. Если параметр задан, то все услуги с большим сроком не будут показываться. Параметр не имеет смысла, если задавать конкретную услугу. Целое число Нет 2
maxCost Максимально допустимая стоимость. Если параметр задан, то все услуги с большей стоимостью не будут показываться. Параметр не имеет смысла, если задавать конкретную услугу. Число Нет 1000
declaredValue Объявленная ценность груза Число Нет 1000 (после запятой не более 2-х знаков)
parcel Список посылок с параметрами для расчета parcelДа Параметры входного сообщения для getServiceCostInternationalПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
pickup countryName Наименование страны отправления Строка Да Россия
cityName Город отправления Строка Нет Москва (буквенные обозначения аббревиатур и других знаков)
cityId Идентификатор города отправления Число Нет 49694102
delivery countryName Наименование страны отправления Строка Да Россия
cityName Город отправления Строка Нет Москва (буквенные обозначения аббревиатур и других знаков)
cityId Идентификатор города отправления Число Нет 49694102
selfPickup Самопривоз на терминал. boolean Да false
selfDelivery Доставка до терминала. Самовывоз с терминала. boolean Да true
weight Вес посылки, кг Число Да 5
length Длина посылки, см Число Да 20
width Ширина посылки, см Число Да 20
height Высота посылки, см Число Да 20
declaredValue Объявленная ценность груза Число Нет 1000 (после запятой не более 2-х знаков)
Insurance Дополнительное страховане Boolean Нет False
Важно: нужно обязательно задать либо cityID, либо cityName, как в случае города отправления в случае, когда страна = Россия.
Дополнительное страхование берется с объявленной ценности, поэтому Insurance = true только если declaredValue >0
Самовывоз/Самопривоз можно ставить true только если страна отправления/назначения равна Россия.
Максимальная величина объявленной ценности не должна быть больше 75 000 рублей.
Параметры ответа при ошибкеПараметр Описание Тип Пример
сode Код ошибки Строка too-many-rows
message Сообщение об ошибке Строка Неоднозначно задан населенный пункт
deliveryDups Массив дублирующихся городов доставки cityId Идентификатор города Число 195901073
countryCode Код страны Строка RU
countryName Страна Строка Россия
regionCode Код региона Строка 71
regionName Регион Строка Тульская обл. (формат ФИАС)
cityCode Код населенного пункта Строка RU71017001000
cityName Населенный пункт Строка Новомосковск (буквенные обозначения аббревиатур и других знаков)
abbreviation Аббревиатура Строка г
indexMin Минимальный индекс Строка 301650
indexMax Максимальный индекс Строка 301650
pickupDups Массив дублирующихся городов забора cityId Идентификатор города Число 232636063
countryCode Код страны Строка RU
countryName Страна Строка Россия
regionCode Код региона Строка 50
regionName Регион Строка Московская обл. (формат ФИАС)
cityCode Код населенного пункта Строка RU50026000002
cityName Населенный пункт Строка Каменка (буквенные обозначения аббревиатур и других знаков)
abbreviation Аббревиатура Строка д
indexMin Минимальный индекс Строка 142167
indexMax Максимальный индекс Строка 142167
Параметры ответа при успешном запросеПараметр Описание Тип Пример
serviceСode Код услуги DPD Строка ECN
serviceName Название услуги Строка DPD ECONOMY
cost Стоимость услуги Число 2,651.46
days Срок доставки, дней Целое число 2
weight Вес отправки, кг Число 5
volume1 Объём, м3 Число 0.05
ТипыОписание типа parcelПараметр Описание Тип Обязательный Пример
weight Вес посылки, кг Число Да 5
length Длина посылки, см Число Да 20
width Ширина посылки, см Число Да 20
height Высота посылки, см Число Да 20
quantity Количество посылок Число Нет 3
Веб-служба «Создание заказа»ОписаниеВеб-служба «Создание заказа» предназначена для создания заказов на доставку в информационной системе DPD.
Для разбора адреса мы используем систему IQsystem.
Чтобы её подключить к Вашему клиентскому номеру, обратитесь на [email protected]ВНИМАНИЕ: На метод getOrderStatus есть ограничение – 50.000 запросов в сутки.
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru/services/order2?wsdlПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/services/order2?wsdlДоступные методыМетод Назначение Входящее сообщение Ответное сообщение
createOrder Создать заказ на доставку Параметры входного сообщения CreateOrderПараметры ответа при ошибке /
Параметры ответного сообщенияgetOrderStatus Получить статус создания заказа Параметры входного сообщения getOrderStatusПараметры ответа при ошибке /
Параметры ответного сообщенияcreateAddress Создать адрес с кодом Параметры входного сообщения Параметры ответа при ошибке / Параметры ответа при успешном запросеupdateAddress Изменить адреса с кодом Параметры входного сообщенияПараметры ответа при ошибке / Параметры ответа при успешном запросеgetInvoiceFile Получить файл накладной (формат файла – PDF) Параметры входного сообщенияПараметры ответа при ошибке/ Параметры ответа при успешном запросеgetRegisterFile Получить реестр заказов, передаваемых курьеру DPD (формат файла - xls) Параметры входного сообщенияПараметры ответа при успешном запросеaddAirwayBill Добавление в международный заказ авианакладной Параметры входного сообщенияПараметры ответа при успешном запросеАлгоритмыСоздание заказа на доставкуПодготавливаем параметры вызова: массив заказов, объединенных общим адресом приёма груза и датой приема отправки, в соответствии с описанием входного сообщения метода createOrder.
Вызываем метод createOrder.
Получаем ответное сообщение с результатом выполнения функции по каждому заказу.
Анализируем статус создания заказа (см. «Статусы создания заказа») и при необходимости – сообщение об ошибке.
Если статус заказа – OrderPending, то через какое-то время можно вызвать метод getOrderStatus, чтобы убедиться в том, что заказ доработан и создан в информационной системе DPD. Мы используем сервис обработки адресов IQsystem,
Создание адреса с кодомПодготавливаем параметры вызова в соответствии с описанием входного сообщения метода createAddress.
Вызываем метод createAddress.
Получаем ответное сообщение с результатом создания адреса.
Анализируем статус создания адреса (см. «Статусы создания и изменения адреса») и при необходимости – сообщение об ошибке.
Если статус адреса - address-error, необходимо внести изменения в параметры и повторно вызвать метод.
Изменение адреса с кодомПодготавливаем параметры вызова в соответствии с описанием входного сообщения метода updateAddress.
Вызываем метод updateAddress.
Получаем ответное сообщение с результатом создания адреса.
Анализируем статус создания адреса (см. «Статусы создания и изменения адреса») и при необходимости – сообщение об ошибке.
Если статус адреса - code-not-found – в системе отсутствует адрес с таким кодом, соответственно для создания адреса необходимо воспользоваться методом createAddress.
Если статус адреса - address-error, необходимо внести изменения в параметры или добавить недостающие и повторно вызвать метод.
СообщенияПараметры входного сообщения createOrderПараметр Описание Тип Обязательный Пример
Внешний тэг orders auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1001028502
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
header Информация, содержащаяся в этом параметре, является общей для всех заказов в запросе datePickup Дата приёма груза Дата Да 2016-07-26
payer Клиентский номер плательщика в системе DPD (номер договора с DPD).
Если этот параметр не заполнен, то плательщиком будет считаться заказчик (номер из параметра auth). Число Нет 1000000000
senderAddress Адрес приёма груза addressДа pickupTimePeriod Интервал времени приёма груза. Доступные для выбора интервалы приёма см. в разделе «Интервалы времени приёма». Строка Да 9-18
regularNum Номер регулярного заказа DPD. Если вы используете доставку на регулярной основе, уточните этот номер у своего менеджера. Строка Нет 1000
order Массив данных, относящихся к каждому конкретному заказу orderNumberInternal Номер заказа в информационной системе клиента Строка Да 123456
serviceCode Код услуги DPD. Уточните код нужной Вам услуги у своего менеджера или используйте код услуги, полученный из веб-сервиса «Калькулятор стоимости» Строка Да CUR
serviceVariant Вариант доставки. Доступно 4 варианта: ДД, ДТ, ТД и ТТ. Расшифровку вариантов см. в разделе «Варианты доставки».Строка Да ДД
cargoNumPack Количество грузомест (посылок) в отправке Целое число Да 5
cargoWeight Вес отправки, кг Число Да 5
cargoVolume Объём, м3 Число Нет 0.05(после запятой не более 2-х знаков)
cargoRegistered Ценный груз. Внутреннее вложение, включенное в перечень товаров, требующих дополнительных мер безопасности, снижающих риск его утери или повреждения при перевозке.
Перечень товаров, относимых к категории «Ценный груз»:
1. Мобильные телефоны
2. Ноутбуки, планшеты boolean Да false
cargoValue Сумма объявленной ценности, руб. Число Нет 1000 (после запятой не более 2-х знаков)
cargoCategory Содержимое отправки Строка Да Одежда
deliveryTimePeriod Интервал времени доставки груза. Доступные для выбора интервалы доставки см. в разделе «Интервалы времени доставки». Строка Нет 9-18
paymentType* Форма оплаты
«Возможные варианты оплаты»Строка Нет ОУП
extraParam Зарезервированный параметр для ввода новых параметров без изменения схемы сервиса parameterНет dataInt Данные для международных отправок dataInternationalНет receiverAddress Адрес доставки addressДа extraService Массив опций доставки extraServiceНет parcel Массив посылок отправки parcelНет unitLoad Массив вложений в посылке unitLoadнет *- Если данный параметр не указывать, то счёт будет выставлен автоматически на отправителя по безналичному расчёту.
Параметры входного сообщения getOrderStatusПараметр Описание Тип Обязательный Пример
Внешний тэг orderStatus auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
order Информация о заказе, статус которого вы проверяете orderNumberInternal Номер заказа в информационной системе клиента Строка Да 123456
datePickup Дата приёма груза (на тот случай, если номер в вашей информационной системе не является уникальным) Дата Нет Параметры ответного сообщения createOrder \ getOrdersStatusПараметр Описание Тип Обязательный Пример
orderNumberInternal Номер заказа в информационной системе клиента Строка Да 123456
orderNum Номер заказа DPD. Возвращается в ответном сообщении. Строка Нет 01010001MOW
status Статус создания заказа. Возвращается в ответном сообщении. Возможные статусы перечислены в разделе «Статусы создания заказа». Строка Да OK
errorMessage Текст ошибки Строка Нет Не заполнен параметр «Улица»
Параметры входного сообщения createAddress \ updateAddressПараметр Описание Тип Обязательный Пример
Внешний тэг address auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
clientAddress Адрес addressДа  
Параметры ответного сообщения createAddress \ updateAddressПараметр Описание Тип Обязательный Пример
code Код адреса Строка Да X333
status Статус.
Возможные статусы описаны в «Ошибки службы «Создания адреса с кодом»» Строка Да address-error
errorMessage Описание ошибки Строка Нет Не указана улица
Параметры входного сообщения getInvoiceFileПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
orderNum Номер заказа DPD Строка Да 01010001MOW
parcelCount Количество мест в заказе Число Нет 3
cargoValue Сумма объявленной ценности, руб. Число Нет 1000 (после запятой не более 2-х знаков)
ПРИМЕЧАНИЕ. Если не заданы parcelCount или cargoValue, то при формировании файла выводятся параметры из заказа.
Параметры ответного сообщения getInvoiceFileПараметр Описание Тип Обязательный Пример
file Файл Массив байтов Да Параметры входного сообщения getRegisterFileПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
datePickup Дата приёма груза (на тот случай, если номер в вашей информационной системе не является уникальным) Дата Да 2014-09-15
regularNum Номер регулярного заказа DPD. Если вы используете доставку на регулярной основе, уточните этот номер у своего менеджера. Строка Нет 1000
cityPickupId Идентификатор города приёма груза в системе DPD Строка Нет 123456
addressCode Код адреса в информационных системах заказчика и DPD. Адрес с кодом должен быть передан в DPD отдельно. Строка Нет 1234
Параметры ответного сообщения getRegisterFileПараметр Описание Тип Обязательный Пример
file Файл Массив байтов Да Параметры ответа при ошибке
Параметр Описание Тип Обязательный Пример
code Код ошибки. Возможные коды описаны в «Ошибки службы «создания заказа»».Строка Да no-data-found
message Описание ошибки Строка Нет Данные не найдены
Параметры входного сообщения addAirwayBillПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Строка Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
Order Массив с данными заказа Тип Order Да OrderNumberDPD Номер заказа ДПД Строка Да OrderNumberInternal Номер заказа в системе клиента Строка нет Param Массив параметров к изменению Param Да Param_name Наименование параметра Строка Да Carrier_Number
Param_value Значение параметра Строка Да 2343421
Параметры выходного сообщения addAirwayBillПараметр Описание Тип Пример
OrderNumberDPD Номер заказа в системе DPD Строка сode Код ошибки Строка too-many-rows
message Сообщение об ошибке Строка Неоднозначно задан населенный пункт
airwaybill Номер заказа в системе клиента Строка ок
Справочник ошибок:
Код Message
701 Состояние заказа не позволяет его изменить
702 Заказ не найден
703 Значение переданного параметра некорректно
704 Имя параметра некорректно
705 Параметр не соответствует типу заказа
706 Изменение заказа не произведено
707 Дубликат
ТипыОписание типа address
Параметр Описание Тип Обязательный Пример
code Код адреса в информационных системах заказчика и DPD. Адрес с кодом должен быть передан в DPD отдельно. Строка Нет 1234
name Название отправителя/получателя. В случае, когда адрес приёма/доставки – это магазин, филиал компании, дилерский центр и т.п., в эту строку пишется его название. Если доставка осуществляется физическому лицу, то пишется Ф.И.О получателя. Строка Да Иванов Сергей Петрович
terminalCode Код терминала. Строка Да M91
addressString Строка адреса для международных отправок Строка Нет 16, Grafton Street, Dublin, Ireland
countryName Название страны Строка Да Россия
index Индекс Строка Нет 140012
region Регион Строка Нет Московская обл.
city Город Строка Да Люберцы
street Улица (формат ФИАС) Строка Да Авиаторов
streetAbbr Сокращения типа улицы (ул, пр-т, б-р и т.д.) Строка Да ул
house6 Дом Строка Да 1
houseKorpus6 Корпус Строка Нет А
str6 Строение Строка Нет 1
vlad6 Владение Строка Нет 1
extraInfo Доп. Информация Строка Нет Пав. 1 (max 90 символов)
office Офис Строка Нет 12 (только цифры или цифры с буквами 12Б)
flat Квартира Строка Нет 144 (только цифры или цифры с буквами 144А)
workTimeFrom Время работы от Строка Нет 9:00
workTimeTo Время работы до Строка Нет 21:00
dinnerTimeFrom Время обеда от Строка Нет 14:00
dinnerTimeTo Время обеда до Строка Нет 15:00
contactFio Контактное лицо Строка Да Смирнов Игорь Николаевич
contactPhone Контактный телефон Строка Да5, 89165555555
contactEmail Контактный e-mail Строка Нет [email protected]
instructions Инструкции для курьера Строка Нет Подъезд со стороны ул. Кирова
needPass Требуется пропуск Строка Нет 1
Описание типа dataInternationalПараметр Описание Тип Обязательный Пример
currency Валюта Строка Нет USD
currencyDeclaredValue Объявленная ценность в валюте Строка Нет 100 (после запятой не более 2-х знаков)
Описание типа extraServiceПараметр Описание Тип Обязательный Пример
esCode Код опции. См описания опций в разделе «Опции». Строка Да SMS
param Параметр опции. parameterНет Описание типа parameterПараметр Описание Тип Обязательный Пример
name Имя параметра
Возможные варианты параметраСтрока Да phone
value Значение параметра Строка Да 89165555555
Описание типа parcelПараметр Описание Тип Обязательный Пример
number Номер посылки в информационной системе клиента (номер штрих-кода посылки) Строка Да 1001000998
box_needed* Требуется обрешётка Целое число Нет 1
Weight Вес посылки, кг Число Нет 5
Length Длина посылки, см Число Нет 50
Width Ширина посылки,см Число Нет 20
Height Высота посылки, см Число Нет 20
number_for_print        Клиентский ШК для печати Число Нет 1000
insuranceCost             Страховая стоимость посылки Число Нет 120
insuranceCostVat       НДС страх. стоимости Число Нет 10
codAmount                 Сумма к получению от покупателя Число Нет 100
* 1 – требуется обрешётка данной посылки 0 – не требуется.
Описание типа unitLoadПараметр Описание Тип Обязательный Пример
article Артикул Строка нет 201
descript Номенклатура Строка Да Брюки
declared_value Объявленная ценность Число Нет 100 (после запятой не более 2-х знаков)
parcel_num Посылка клиент Строка Нет parcel_1
npp_amount Цена Число Нет 100
count Количество Число vat_percent  Ставка НДС Число Нет 18
without_vat Флаг Без НДС (0/1) Число Нет 0
Варианты доставкиДоступны следующие варианты:
ДД – от двери отправителя до двери получателя;
ДТ – от двери отправителя до терминала DPD;
ТД – от терминала DPD до двери получателя;
ТТ – от терминала DPD до терминала DPD.
Интервалы времени приёмаДоступны следующие варианты выбора времени приёма груза:
9-18 – в любое время с 09:00 до 18:00 (вариант по умолчанию);
9-13 – с 09:00 до 13:00;
13-18 – с 13:00 до 18:00.
Интервалы времени доставкиДоступны следующие варианты выбора времени доставки груза:
9-18 – в любое время с 09:00 до 18:00 (вариант по умолчанию);
9-14 – с 09:00 до 14:00;
13-18 – с 13:00 до 18:00;
18-22 – с 18:00 до 22:00. (внимание, данный интервал оплачивается дополнительно!)
9-22 – с 09:00 до 22:00. (внимание, данный интервал работает только по услугам DPD Consumer, DPD Classic Parcel ,DPD Classic international)
Варианты формы оплатыОУП – оплата у получателя наличными
ОУО – оплата у отправителя наличными
Услуги DPDКод услуг Наименование
BZP DPD 18:00
ECN DPD ECONOMY
DPT DPD 13:00
CUR DPD CLASSIC
NDY DPD EXPRESS
CSM DPD CONSUMER
PCL DPD CLASSIC Parcel
DPI DPD Classic international
MAX DPD MAX domestic
ОпцииКод опции Описание опции Опция платная Имя параметра для передачи сопутствующих данных Значение параметра
SMS SMS уведомление получателя о приёме посылки у отправителя и о выходе посылки на доставку Нет phone Телефон получателя для отправки уведомления
EML E-mail уведомление получателя о приёме посылки у отправителя и о выходе посылки на доставку Нет email E-mail получателя для отправки уведомления
ЭСД Электронное сообщение о доставке груза получателю Нет email E-mail, на который нужно отправить сообщение о доставке груза
ЭСЗ Электронное сообщение о приёме заказа Нет email E-mail, на который нужно отправить сообщение о приёме заказа
ВДО Возврат документов отправителю.
Если клиенту необходимо вернуть сопроводительные документы на груз (товарную накладную, акты приема-передачи), заверенные получателем. Да - ДВД Доставка в выходные дни.
Эта опция, позволяющая осуществить доставку отправки получателю в соответствии со сроком доставки ТК, но раньше даты, рассчитанной по стандартным правилам, при условии, что итоговая дата доставки придется на выходной день. Да - НПП Наложенный платеж Да sum_npp cумма наложенного платежа1
ПОД Подтверждение о доставке Да email/fax E-mail или факс, на который нужно отправить подтверждение о доставке
ПРД Погрузо-разгрузочные работы при доставке.
Если необходимо организовать разгрузку и доставку поступивших посылок в то или иное помещение на территории, независимо от того, на каком этаже оно расположено. Да - ТРМ Температурный режим Да - ОЖД Ожидание на адресе Да reason_delay причина ожидания на адресе  из Справочника причин ожидания на адресе:
ВНЕШ Проверка на внешние поврежденияПРИМ ПримеркаРАБТ Проверка работоспособностиСООТ Проверка на соответствие
ЧСТ2 Возврат части отправки Да goods_return_amount
delivery_amount Компенсация доставки при полном возврате
Компенсация доставки
Указывать обязательно, при условии, что сумма за Наложенный платеж будет отличаться от суммы Объявленной стоимости. Но опцию указывать обязательно, если есть НПП.
- если с получателя нужно взимать стоимость доставки только при отказе от всего товара, то данная стоимость передается в параметре «Компенсация доставки при полном возврате», а в параметре «Компенсация доставки» не передается ничего
данный вариант не может использоваться совместно со способом оплаты услуг DPD «Наличными получателем»;
- если с получателя всегда нужно взимать стоимость доставки, то данная стоимость передается в параметре «Компенсация доставки», а в параметре «Компенсация доставки при полном возврате» не передается ничего
данный вариант не может использоваться совместно со способом оплаты услуг DPD «Наличными получателем»;
- если с получателя не нужно взимать стоимость доставки, то информация не передается ни в параметре «Компенсация доставки при полном возврате», ни в параметре «Компенсация доставки».
3.13. Справочник параметров3.13.1. Справочник оплаты.
Вариант формы оплаты услуги и плательщика Название параметра - name Значение - value
Оплата наличными отправителем на терминале отправки
плательщик – юридическое лицо order_payment_type
payer_num ‘ОУО’
десятизначный номер клиента плательщика
Оплата наличными получателем  на терминале доставки
плательщик – юридическое лицо order_payment_type
payer_num ‘ОУП’
десятизначный номер клиента плательщика
Оплата наличными получателем  у двери
плательщик – юридическое лицо order_payment_type
payer_num ‘ОУП’
десятизначный номер клиента плательщика
Оплата наличными отправителем на терминале отправки
плательщик – физическое лицо order_payment_type
payer_num ‘ОУО’
‘1001028502’- номер для оплаты наличными
Оплата наличными получателем  на терминале доставки
плательщик – физическое лицо order_payment_type
payer_num ‘ОУП’
‘1001028502’- номер для оплаты наличными
Оплата наличными получателем  у двери
плательщик – физическое лицо order_payment_type
payer_num ‘ОУП’
‘1001028502’- номер для оплаты наличными
3.13.2. Справочник для создания пропуска.
Описание параметра Название параметра - name Значение - value
Пропуск требуется при заборе у отправителя pickup_need_pass 1
Пропуск требуется при доставке к получателю delivery_need_pass 1
Статусы создания заказаВ ответном сообщении о создании заказа может быть возвращен один из следующих статусов:
OK – заказ на доставку успешно создан с номером, указанным в поле orderNum.
OrderPending – заказ на доставку принят, но нуждается в ручной доработке сотрудником DPD, (например, по причине того, что адрес доставки не распознан автоматически). Номер заказа будет присвоен ему, когда это доработка будет произведена.
OrderDuplicate – заказ на доставку не может быть принять по причине, указанной в поле errorMessage.
OrderError – заказ на доставку не может быть создан по причине, указанной в поле errorMessage.
Статусы создания и изменения адреса
В ответном сообщении о результатах создания адреса может быть возвращен один из следующих статусов:
ОК – адрес с кодом создан.
code-already-exists – адрес с указанным кодом уже существует.
address-error – адрес не может быть создан. Причина при этом указывается в поле message.
code-not-found- адрес с указанным кодом не найден.
Веб-служба «Изменение заказа»ОписаниеВеб-служба «Изменение заказа» предназначена для внесения изменений в уже созданный заказ на доставку в информационной системе DPD. При этом внесение изменений в заказ возможно до физического получения груза на терминале DPD.
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru/services/order2?wsdlПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/services/order2?wsdlДоступные методыМетод Назначение Входящее сообщение Ответное сообщение
addParcels Изменить заказ с добавлением посылок Параметры входного сообщения addParcels Параметры ответного сообщения
removeParcels Изменить заказ с удалением посылок Параметры входного сообщения removeParcels Параметры ответного сообщения
АлгоритмыИзменение заказа с добавлением посылокПодготавливаем параметры вызова: массив данных изменяемых заказов и список добавляемых посылок в соответствии с описанием входного сообщения метода addParcels.
Вызываем метод addParcels.
Получаем ответное сообщение с результатом выполнения функции по каждому заказу.
Изменение заказа с удалением посылокПодготавливаем параметры вызова: массив данных изменяемых заказов и список удаляемых посылок в соответствии с описанием входного сообщения метода removeParcels.
Вызываем метод removeParcels.
Получаем ответное сообщение с результатом выполнения функции по каждому заказу.
СообщенияПараметры входного сообщения addParcels \ removeParcelsПараметр Описание Тип Обязательный Пример
Внешний тэг parcels auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
orderNum Номер заказа Строка Да 01010001MOW
orderNumberInternal Номер заказа в информационной системе клиента Строка Нет 123456
cargoNumPack Количество грузомест (посылок) в отправке Целое число Да 5
cargoWeight Вес отправки, кг Число Да 5
cargoVolume Объём, м3 Число Нет 0.05(после запятой не более 2-х знаков)
cargoValue Сумма объявленной ценности, руб. Число Нет 1000 (после запятой не более 2-х знаков)
cargoCategory Содержимое отправки Строка Да Одежда
parcel Посылки для добавления в заказ parcelПараметры ответного сообщения для addParcels \ removeParcelsПараметр Описание Тип Обязательный Пример
orderNum Номер заказа DPD. Возвращается в ответном сообщении. Строка Нет 01010001MOW
status Статус изменения заказа. Возвращается в ответном сообщении. Возможные статусы перечислены в разделе «Статусы изменения заказа» Строка Да OK
parcelStatus Список посылок parcelStatusНет ТипыОписание типа parcelПараметр Описание Тип Обязательный Пример
number Номер посылки в информационной системе клиента (номер штрих-кода посылки) Строка Да WS121
weight Вес посылки, кг Число Нет 5
length Длина посылки, см Число Нет 5
width Ширина посылки, см Число Нет 2
height Высота посылки, см Число Нет 2
Описание типа parcelStatusПараметр Описание Тип Обязательный Пример
number Номер посылки Строка Да WS121
status Статус выполнения операции. Возможные статусы перечислены в разделе «Статусы добавления \ удаления посылки». Строка Да OK
СтатусыСтатусы изменения заказа
В ответном сообщении об изменении заказа может быть возвращен один из следующих статусов:
OK – заказ успешно изменен.
illegal-state -состояние заказа не позволяет выполнять его корректировку.
no-data-found – не найдены данные.
Статусы добавления \ удаления посылкиВ ответном сообщении об изменении состава посылок в заказе может быть возвращен один из следующих статусов:
no-data-found  - при удалении  посылка с указанным номером в заказе не найдена.
too-many-rows  - при удалении  найдено более одной посылки с указанным номером.
illegal-state  - состояние заказа не позволяет выполнять добавление или удаление посылки.
Веб-служба «Отслеживание статуса»ОписаниеВеб-служба «Отслеживание статуса» предоставляет сервис для отслеживания состояния посылок клиента DPD. Можно отслеживать изменения всех статусов посылок своего клиентского номера, либо запрашивать историю состояний по конкретному заказу или посылке.
Для использования данной веб – службы Вам необходимо обратиться в [email protected] и запросить одну из настроек – «с подтверждением» или «без подтверждения».
Для метода getEvents требуется подключение дополнительных настроек.
Обращаем ваше внимание, статусы начинают храниться в базе DPD, только после подключения настройки для отслеживания. Все созданные ранее заказы отследить невозможно.
ВНИМАНИЕ: На данный сервис есть ограничения:
http://ws.dpd.ru:80/services/event-tracking – 10.000 запросов в сутки.
Методы: getEvents и confirm
http://ws.dpd.ru:80/services/tracing - 70.000 запросов в сутки.
Методы: confirm, getStatesByClient, getStatesByClientOrder, getStatesByClientParcel, getStatesByDPDOrder
http://ws.dpd.ru:80/services/tracing1-1 - 50.000 запросов в сутки.
Методы: getStatesByClientOrder, getStatesByClientParcel, getStatesByDPDOrder
На методы getStatesByClient и getEvents есть ограничение частоты вызова - 1 раз в 5 минут.
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru:80/services/tracing?wsdlhttp://wstest.dpd.ru:80/services/tracing1-1?wsdl
http://wstest.dpd.ru:80/services/event-tracking
Промышленная версия сервиса доступна по адресу:
http://ws.dpd.ru:80/services/tracing?wsdlhttp://ws.dpd.ru:80/services/tracing1-1?wsdlhttp://ws.dpd.ru:80/services/event-tracking
Доступные методы:
tracing?wsdl – confirm, getStatesByClient, getStatesByClientOrder, getStatesByClientParcel, getStatesByDPDOrder.
tracing1-1?wsdl – getStatesByClientOrder, getStatesByClientParcel, getStatesByDPDOrder
event-tracking - confirm, getEvents
Доступные методыМетод Назначение Входящее сообщение Исходящее сообщение
getStatesByClient Получить все состояния посылок клиента, изменившиеся с момента последнего вызова данного метода getStatesByClientgetStatesByClientResponseconfirm Подтвердить получение состояний, переданных методом getStatesByClient или getEvents confirmconfirmResponsegetStatesByClientOrder Получить историю состояний всех посылок заданного заказа. Заказ идентифицируется по номеру заказа в информационной системе клиента. getStatesByClientOrdergetStatesByClientOrderResponsegetStatesByClientParcel Получить историю состояний заданной посылки. Посылка идентифицируется по номеру посылки в информационной системе клиента. getStatesByClientParcelgetStatesByClientParcelResponsegetStatesByDPDOrder Получить историю состояний всех посылок заданного заказа. Заказ идентифицируется по номеру заказа в информационной системе DPD. getStatesByDPDOrdergetStatesByDPDOrderResponsegetEvents Получить все состояния заказа клиента, изменившиеся с момента последнего вызова данного метода getEventsgetEventsResponseАлгоритмыАлгоритм работы с методом getStatesByClient.С методом getStatesByClient можно работать двумя способами: с подтверждением и без подтверждения. Вам необходимо сообщить желаемый метод сотруднику DPD при подключении сервиса.
Если вы работаете с подтверждением, то метод getStatesByClient не выдаст вам новых состояний, пока не получит от вас подтверждения прочтения переданных состояний через метод confirm. Если наша система не получит такого подтверждения, то при следующем запросе она выдаст те же состояния, что и в предыдущем. Таким образом, гарантируется защита от сбоя при передаче данных - если сбой произошел, данные не потеряются, а будут переданы при повторном запросе. Вызов метода confirm говорит нам о том, что процесс передачи данных прошел успешно, и все данные закачаны в информационную систему клиента.
Если вы работаете без подтверждения, то метод getStatesByClient будет всегда выдавать только новые состояния. При формировании новой порции состояний система учитывает только то, были ли состояния уже переданы через веб-сервис и не принимает в расчёт то, были ли они загружены в систему клиента.
Вы также можете воспользоваться настройкой «Расширенное отслеживание». С помощью данной настройки Вы сможете в отслеживании видеть код и наименование инцидента с посылкой.
Алгоритм работы:
Подготавливаем параметры аутентификации.
Вызываем метод getStatesByClient,
Получаем ответное сообщение с идентификатором документа и массивом состояний посылок.
Если выбран способ работы с подтверждением - вызываем метод confirm, передавая в качестве параметра полученный идентификатор документа.
Особенности алгоритма работы для getEvents
Передаются статусы заказов;
Требуется подключение дополнительных настроек.
Вызываем метод confirm, передавая в качестве параметра полученный идентификатор документа.
Алгоритм работы с методами getStatesByClientOrder, getStatesByDPDOrder, getStatesByClientParcelДанные методы позволяют получить полную историю состояний нужного заказа или посылки. По запрошенному заказу или посылке передаются все состояния, независимо от того, были ли они уже переданы или нет. Никаких подтверждений не требуется.
Алгоритм работы:
Подготавливаем параметры аутентификации и номер для идентификации заказа или посылки.
Вызываем нужный метод.
Получаем ответное сообщение с массивом состояний посылок.
Чтобы узнать текущее состояние посылки, выбираем последнее по параметру transitionTime.
getStatesByClientПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
confirmПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
docId Идентификатор документа, полученного в запросе getStatesByClient или getEvents. Все сообщения, переданные по данному документу, получат статус «Получение подтверждено». Число Да 12346897
getStatesByClientOrderПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
clientOrderNr Номер заказа в информационной системе клиента Строка Да 12346DPD
pickupDate Дата приёма груза (на случай, если номер заказа не уникален, и требуется уточнение по дате) Дата Нет 2014-02-28
getEventsПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
DateTo Дата статуса заказа. Если не заполнено, то текущая дата Дата Нет 2016-04-07T00:00:00+03:00
DateFrom Дата статуса заказа.Если не заполнено, то текущая дата минус 15 календарных дней. Дата Нет 2016-04-07T00:00:00+03:00
maxRowCount Максимальное количество записей передаваемое в ответе. Если не заполнено то 100. Число Нет getStatesByClientParcelПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
clientParcelNr Номер посылки в информационной системе клиента Строка Да 12346897
pickupDate Дата приёма груза (на случай, если номер посылки не уникален, и требуется уточнение по дате) Дата Нет 2014-02-28
getStatesByDPDOrderПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
dpdOrderNr Номер заказа в информационной системе DPD Строка Да 04040001MOW
pickupYear Год заказа (т.к. номера заказов DPD уникальные в пределах года, требуется уточнение, чтобы получить однозначный результат) Целое число Нет 2012
Исходящие сообщенияgetStatesByClientResponseПараметр Описание Тип Пример
docId Идентификатор документа. Данный идентификатор используется для подтверждения получения статусов Число 12346897
docDate Дата формирования документа Дата 2014-02-28
clientNumber Ваш клиентский номер в системе DPD Число 1000000000
resultComplete Показывает, выбраны ли в текущем запросе все новые состояния по клиенту (значение true), или был достигнут лимит записей в одном запросе и для продолжения необходим ещё один запрос (значение false). boolean true
states Массив состояний посылок clientOrderNr Номер заказа в информационной системе клиента Строка 12346DPD
clientParcelNr Номер посылки в информационной системе клиента Строка 12346897
dpdOrderNr Номер заказа в информационной системе DPD Строка 04040001MOW
dpdParcelNr Номер посылки в информационной системе DPD Строка 12346897
pickupDate Дата приёма груза Дата 2014-02-28
dpdOrderReNr Номер повторного заказа в системе DPD (заполняется в том случае, если по одному и тому же клиентскому номеру посылки в системе DPD существует два заказа – например, при заказе на возврат посылки) Строка 04040002MOW
dpdParcelReNr Номер посылки при повторном заказе в системе DPD (заполняется в том случае, если по одному и тому же клиентскому номеру посылки в системе DPD существует два заказа – например, при заказе на возврат посылки) Строка 12346899
isReturn признак «Возвратная посылка» Логический true/false
planDeliveryDate Планируемая дата доставки посылки Дата 2014-03-01
* orderPhysicalWeight Физический вес (кг) отправки Число 2.08
* orderVolume Объем (м3) отправки Число 0.023
* orderVolumeWeight Объемный вес (кг.)отправки Число 4.6
* orderPayWeight Платный вес (кг.) отправки Число 5
* orderCost Сумма за доставку, без НДС Число 1200 (после запятой не более 2-х знаков)
* parcelPhysicalWeight Физический вес (кг.) Число 1.5
* parcelVolume Объем (м3) Число 0.008
* parcelVolumeWeight Объемный вес (кг.) посылки Число 1.5
* parcelPayWeight Платный вес (кг.) посылки Число 1.5
* parcelLength Длина (см.) посылки Число 157
* parcelWidth Ширина (см.) посылки Число 7
* parcelHeight Высота (см.) посылки Число 7
newState Состояние посылки после перехода. См. список возможных состояний в разделе «Состояния» пункт «Посылка». Строка Delivering
transitionTime Время перехода состояния Дата/время 2012-04-04T17:10:15
terminalCode Код терминала DPD, на котором произошел переход состояния Строка LED
terminalCity Город терминала DPD, на котором произошел переход состояния Строка LED
incidentCode Код инцидента, произошедшего при переходе состояния. Список возможных кодов инцидентов и их расшифровок вы можете получить у своего менеджера. Строка 90
incidentName Наименование инцидента, произошедшего при переходе состояния Строка Возвращено отправителю
consignee Фактический получатель посылки (передается только со статусом Delivered) Строка Иванов И.И.
* получение данной информации возможно по URL:
http://wstest.dpd.ru:80/services/tracing1-1?xsd=1 или http://ws.dpd.ru:80/services/tracing1-1?xsd=1getEventsResponsehttp://ws.dpd.ru/services/event-tracking?xsd=1
Параметр Описание Тип Пример
docId Идентификатор документа. Данный идентификатор используется для подтверждения получения статусов Число 12346897
docDate Дата формирования документа Дата 2014-02-28
clientNumber Ваш клиентский номер в системе DPD Число 1000000000
resultComplete Показывает, выбраны ли в текущем запросе все новые состояния по клиенту (значение true), или был достигнут лимит записей в одном запросе и для продолжения необходим ещё один запрос (значение false). boolean true
clientOrderNr Номер заказа в информационной системе клиента Строка 12346DPD
dpdOrderNr Номер заказа в информационной системе DPD Строка 04040001MOW
eventNumber Номер условий статуса Строка eventCode Если EventCode пуст, то заполняется TypeCode Строка eventName Наименование статуса Строка eventName Наименование статуса Строка reasonCode Код причины статуса Строка reasonName Наименование причины статуса Строка EventDate Момент события Дата/Время parameter Тип parameter Массив parameter
Параметр Описание Тип Пример
paramName Наименование параметра, измененного по событию Строка 12346897
Value * Значение параметра Строка *Наименование тега может быть в трех вариантах. В наименование входит тип значения дополнительного параметра.
<valueString>Москва</valueString>
<valueDecimal>0.134</valueDecimal>
<valueDateTime>2016-04-07T00:00:00+03:00</valueDateTime>
Справочник статусов заказа EventCode, EventName и его параметров(ParamName)
​Номер статуса Код Наименование Параметр код Название
​1001 ​OfferCreate ​Получена заявка ClientNumber Номер клиента
ReqOfferId ИД заявки
ClientOrderNumber Номер заказа в системе клиента
OrderPickupDate Дата приема груза в заказе
PickupAddress Адрес отправителя
PickupCity Город отправления
DeliveryAddress Адрес получателя
DeliveryCity Город получения
DeliveryVariant Вариант приема-доставки
ParcelCount Кол-во посылок в заказе
Weight Вес заказа
Volume Объем заказа
AmountNPP Сумма НПП
DeclaredValue Сумма ОЦ
CurrencyDeclaredValue Валюта ОЦ
PickupTermilalCode Код терминала приема
RegularNumber; Номер регулярного заказа
PickupAddressCode Адресный код приема
DeliveryAddressCode Адресный код доставки
​1101 ​OfferUpdating ​В заявке присутствует ошибка ErrorMessage Сообщение об ошибке
​1201 ​OfferWaiting ​Запрошены паспортные данные получателя ​1301 ​OfferCancelled Отмена заявки ErrorMessage Сообщение об ошибке
​1401 ​​OrderCreate ​​​​Заказ создан ClientNumber Номер клиента
ClientOrderNumber Номер заказа в системе клиента
OrderPickupDate Дата приема груза в заказе
PlanDeliveryMoment Плановая дата доставки
ControlDeliveryMoment Контрольная дата доставки
PickupAddress Адрес отправителя
PickupCity Город отправления
DeliveryAddress Адрес получателя
DeliveryCity Город получения
DeliveryVariant Вариант приема-доставки
DeliveryInterval Интервал доставки
ParcelCount Кол-во посылок в заказе
Weight Вес заказа
Volume Объем заказа
AmountNPP Сумма НПП
DeclaredValue Сумма ОЦ
CurrencyNPP Валюта НПП
CurrencyDeclaredValue Валюта ОЦ
PickupTermilalCode Код терминала приема
RegularNumber Номер регулярного заказа
PickupAddressCode Адресный код приема
DeliveryAddressCode Адресный код доставки
​1501 ​OrderWaiting ​​Заказ ожидает дату приема ​1601 ​OrderPickup Заказ принят у отправителя ​1701 ​OrderArrivedInRF Заказ прибыл в страну доставки Doc_Num Номер документа
​1801 ​OrderOnTerminal ​ ​Закончено таможенное оформление PointCyty ​ Город присвоения события
​1802 ​Прибыл на первый сортировочный комплекс DPD 2101 ​OrderOnRoad ​ ​​Заказ следует по маршруту до терминала доставки Weght Вес заказа
Volume Объем заказа
ParcelCount Кол-во посылок в заказе
PayWeght ​ Платный вес отправления
2102 ​Заказ следует по маршруту до терминала возврата ​2201 ​​OrderReady ​Заказ готов к выдаче на пункте DeliveryVariant Вариант приема-доставки
PointCity Город присвоения события
OrderType (только для возврата) ​2202 ​Заказ готов к передаче курьеру для доставки ​2203 ​Заказ на возврат готов к выдаче ​2204 ​Заказ на возврат готов к передаче  курьеру для доставки 2205 Таможенное оформление в стране отправления ​2301 ​OrderDelivering ​ ​Заказ доставляется получателю Weght Вес заказа
Volume Объем заказа
ParcelCount Кол-во посылок в заказе
PayWeght ​ Платный вес отправления
DeliveryInterval
Вариант приема-доставки
2302 Таможенное оформление закончено в стране отправления 2303 Отправка на транзитном терминале за рубежом 2304 Доставляется получателю за рубежом 2305 Возвращается отправителю из-за рубежа 2306 Заказ готов к доставке за рубежом 2307 Проблема при доставке за рубежом 2309 Заказ доставляется отправителю ​2401 ​​OrderProblem ​ ​ ​ ​ ​ ​ ​Истек срок бесплатного хранения заказа DataChannel Канал получения информации
​2402 ​Оплата за товар по заказу не произведена Получателем ​2404 ​Отказ от заказа в момент доставки ​2405 ​Отказ от заказа по желанию получателя через Predict ​2406 ​Отказ от заказа по желанию получателя через контакт центр ​2407 Получатель отсутствует на адресе доставки ​2408 ​Указан неправильный адрес доставки ​​3701 ​Заказ поврежден ​2501 ​OrderDied Услуга не оказана ​2601 ​OrderInvoice ​ ​Произведен  расчет стоимости доставки ​Doc_Num; Номер документа
Doc_Amount; Сумма документа
Doc_Currency Валюта докумета
Doc_Vat НДС
Doc_Date Дата документа
​2602 ​Выставлен счет ​2701 ​OrderCODConfirmed ​Наложенный платёж принят у получателя AmountNPP Сумма НПП
​2801 ​OrderCODSent ​Наложенный платёж перечислен интернет-магазину ​Doc_Num; Номер документа
Doc_Amount; Сумма документа
Doc_Currency Валюта докумета
Doc_Date Дата документа
​2901 ​OrderCancelled ​Заказ отменен ​3001 ​OrderPaidStorage ​ ​Произведен расчет стоимости за платное хранение ​Doc_Num; Номер документа
Doc_Amount; Сумма документа
​3201 OrderChangeDeliveryCondition ​ ​ ​ ​Перенос даты доставки по инициативе DPD DeliveryAddress Адрес получателя
DeliveryInterval Интервал доставки
DeliveryVariant Вариант приема-доставки
PlanDeliveryMoment Плановая дата доставки
ControlDeliveryMoment Контрольная дата доставки
DeliveryAddressCode Адресный код доставки
PickupCity; Город отправления
​3202 Изменены условия доставки получателем во время доставки ​3203 ​Изменены условия доставки получателем  через Predict ​3204 ​Изменены условия доставки получателем  через call-centre 3205 Изменена дата доставки ​3301 ​OrderWorkCompleted ​ ​Заказ утилизирован OrderNumber Номер заказа
OrderPickupDate Дата приёма заказа
OrderDeliveryDate Дата доставки заказа
ReasonName Наименование причины изменения
ConsigneeFIO ФИО получателя
PointCode Код пункта
​3302 ​Посылка не востребована ​3303 ​Заказ утерян 3304 Заказ доставлен до двери ​3305 ​Заказ выдан на ПВЗ ​3306 ​Заказ на возврат доставлен ​3401 ​OrderEAWaybill ​Накладная в электронном архиве ​3501 ​OrderRepeatDelivering ​ ​ ​N-я повторная бесплатная доставка ReDeliveryType Тип повторной доставки
ReDeliveryNumber
Номер повторной доставки
​3601 ​N-я повторная платная доставка ​3901 ​OrderEmailSent ​Направлено сообщение Email AddressMail адресат
SubjectMail Тема письма
ReasonName Наименование причины уведомления
​4001 ​OrderCallToConsignee ​Звонок получателю CallResult Результат звонка
ReasonName
Наименование причины
​4101 OrderSMSSent ​Направлено сообщение SMS PhoneNumber Номер телефона
ReasonName
Наименование причины
confirmResponseСтруктура сообщения аналогична входящему «confirm».
getStatesByClientOrderResponse
Параметры сообщения совпадают с параметрами ответного сообщения «getStatesByClientResponse».
getStatesByClientParcelResponseПараметры сообщения совпадают с параметрами ответного сообщения «getStatesByClientResponse».
getStatesByDPDOrderResponseПараметры сообщения совпадают с параметрами ответного сообщения «getStatesByClientResponse».
СостоянияПосылкаПосылка может принимать одно из следующих состояний:
NewOrderByClient – оформлен новый заказ по инициативе клиента
NotDone– заказ отменен
OnTerminalPickup– посылка находится на терминале приема отправления
OnRoad– посылка находится в пути (внутренняя перевозка DPD)
OnTerminal– посылка находится на транзитном терминале
OnTerminalDelivery– посылка находится на терминале доставки
Delivering – посылка выведена на доставку
Delivered – посылка доставлена получателю
Lost – посылка утеряна
Problem– с посылкой возникла проблемная ситуация
ReturnedFromDelivery– посылка возвращена с доставки
NewOrderByDPD – оформлен новый заказ по инициативе DPD
Последовательное отслеживание посылки по статусам становится возможным, когда на стороне DPD посылка будет обработана на терминале приема. Данной ситуации соответствует статус «OnTerminalPickup».
В случае если обращение к сервису поступает до момента обработки посылки на стороне DPD на терминале приема, сервис вернет ошибку с кодом «no-data-found» (см. справочник ошибок)
Веб-служба «Отчеты»ОписаниеВеб-служба «Отчеты» предоставляет возможность получать отчеты из информационной системы компании.
ВНИМАНИЕ: На данный сервис есть ограничение - 1000 запросов в сутки.
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru/services/nl?wsdlПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/services/nl?wsdlДоступные методыМетод Назначение Входящее сообщение Ответное сообщение
getNLAmount Отчет о предварительной стоимости перевозки за указный период. Параметры входного сообщения Параметры ответного сообщенияgetNLInvoice Отчет об окончательной стоимости перевозки за указный период. Параметры входного сообщенияПараметры ответного сообщенияgetWaybill Получение сканобраза подписанной получателем накладной Параметры входного сообщенияПараметры ответного сообщенияАлгоритмыСообщенияПараметры входного сообщения метода getWaybillПараметр Описание Тип Обязательный Пример
Внешний тэг getWaybill auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
orderNum Номер заказа DPD Строка Да 94520014362
year Год заказа Число Да 2016
Параметры входного сообщения метода getNLAmountПараметр Описание Тип Обязательный Пример
Внешний тэг arg0 auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
dateFrom Начальная дата периода отчета Дата Да 2014-05-21
dateTo Конечная дата периода отчета Дата Да 2014-05-21
Параметры входного сообщения метода getNLInvoiceПараметр Описание Тип Обязательный Пример
Внешний тэг arg0 auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
dateFrom Начальная дата периода отчета Дата Да 2014-05-21
dateTo Конечная дата периода отчета Дата Да 2014-05-21
Параметры ответного сообщения метода getNLAmountПараметр Описание Тип Обязательный Пример
amount Стоимость перевозки Число Нет 100
ordernum Номер заказа Строка Нет Параметры ответного сообщения метода getNLInvoiceПараметр Описание Тип Обязательный Пример
invoicenum Номер счета Строка Нет invoicedate Дата выставления счета Строка Нет 2016-09-01
ordernum Номер заказа Строка Нет 02200119MOW
amount Сумма счета Число Нет 100
weight Вес отправки, кг Число Нет 5
volume Объём, м3 Число Нет 0.05
Параметры ответного сообщения метода getWillBillПараметр Описание Тип Обязательный Пример
dpdOrderNum Номер заказа в системе DPD Строка Нет 94520014362
clientOrderNum Номер заказа в системе клиента Строка Нет RUS13914491
Status Статус ответа Строка Да Error/OK OK
pdfFile Скан образ накладной base64Binary errorMessage Сообщение об ошибке Срока Нет (если status Error) Too many rows
Ограничение на частоту вызововне разрешается вызывать метод, если еще не завершился предыдущий вызов;
не разрешается вызывать метод менее чем через 30 минут после предыдущего вызова.
В случае нарушений возвращается ошибка с соответствующим сообщением.
Веб-служба «Печать Наклейки»ОписаниеВеб-служба «Печать Наклейки» предоставляет сервис для формирования наклейки DPD по ранее созданному заказу.
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru/services/label-print?wsdlПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/services/label-print?wsdlДоступные методыМетод Назначение Входящее сообщение Ответное сообщение
createLabelFile Формирует файл с наклейками DPD. createLabelFilecreateLabelFileResponsecreateParcelLabel Получить параметры для печати наклейки createParcelLabelcreateParcelLabelResponseАлгоритмыПеред вызовом метода в ИС DPD заказы должны быть сформированы, им присвоены номера DPD (например, 05120002MOW). Далее необходимо в метод передать список номеров заказов DPD и для каждого заказа количество необходимых наклеек (как правило, оно равно количеству мест в заказе) или номер посылки в учетной системе клиента. В ответ сервис вернет файл с наклейками DPD или параметры наклейки.
Формат файлаВозвращаемый файл имеет один из двух форматов, который задается во входящем сообщении:
PDF;
FP3 – формат генератора отчетов FastReport.
Формат области печатиРазмер наклейки – A6 (четвертушка стандартного листа A4). Возвращаемый файл формируется в одном из двух вариантов расположения наклеек на листах бумаги: в одну колонку (для узких принтеров) и две наклейки на ширине листа. Входящее сообщение содержит строковое поле Формат области печати, которое может содержать значения:
A6 – в одну колонку;
A5 – в две колонки.
Примечание. Если задан формат A5, то для каждого заказа первая наклейка печатается в левой части листа. То есть, если заказы включают по одной посылке, то наклейки разместятся в одну колонку.
Входящие сообщенияcreateLabelFile
Параметр Описание Тип Обязательный Пример
Внешний тэг getLabelFile Auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
fileFormat Формат файла.
Возможные значения: PDF, FP3 Срока Да PDF
pageSize Формат области печати.
Возможные значения: A5, A6. Да A5
order Массив данных, относящихся к каждому конкретному заказу orderNum Номер заказа DPD Строка Да 05120002MOW
parcelsNumber Кол-во наклеек для формирования Число Да 3
createParcelLabel
Параметр Описание Тип Обязательный Пример
Внешний тэг createParcelLabel Auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
parcel Массив данных, относящихся к каждой конкретной посылки orderNum Номер заказа DPD Строка Да 05120002MOW
parcelNum Номер посылки в информационной системе клиента Строка Да 1982838492211
Исходящие сообщенияcreateLabelFileResponse
Параметр Описание Тип Обязательный Пример
file Файл Массив байтов order Массив данных, относящихся к каждому конкретному заказу orderNum Номер заказа DPD Строка 05120002MOW
status Статус Строка OrderPending
errorMessage Сообщение об ошибке Строка Заказ 95890002690 для клиента 1001000000 не найден
createParcelLabelResponseПараметр Описание Тип Обязательный Пример
order Массив данных, относящихся к каждому конкретному заказу
1 senderName Название отправителя Ширина="253,22851", Высота="22,67718", Шрифт="Arial",
Стиля нет. 6
2 senderAddress Адрес отправителя Ширина ="253,22851", Высота ="22,67716535" Шрифт="Arial",
Стиля нет. 6
3 - Эмблема. Рисунок действующего на момент печати логотипа компании. (constant*) -
4 isIntroscope Номер бренда клиента или признак необходимости проверки груза на интроскопе. Если есть признак, то бренд не выводится. -
5 - Text(constant)="Прием:" Ширина="37,7953", Высота="15,11812", Шрифт="Arial", Стиль="1"(жирный шрифт) 7
6 datePickup Дата приема: Date = ‘dd.mm.yyyy’ Ширина="90,70872", Высота="18,89765", Шрифт="Arial", Стиль="1" 12
7 - Text(constant)="Код зак.:" Ширина="45,35436", Высота="15,11812", Шрифт="Arial", Стиль="1" 7
8 clientOrderNum Номер заказа в информационной системе клиента Ширина="162,51979", Высота="56,69295", Шрифт="Arial", Стиль="1" 12
9 serviceCode 3-х символьный код услуги заказа Ширина="105,82684", Высота="41,57483", Шрифт="Arial", Стиль="1" 24
10 - Номер рейса (не передается по WS). Ширина="49,13389", Высота="37,7953", Шрифт="Arial", Стиль="1" 20
11 firstTransport Код вида транспорта первого лайнхола в маршруте транспортировки Ширина="98,26778", Высота="41,57483", Шрифт="Arial", Стиль="1" 24
12 isAviadepo Картинка “Звезда”- указание на то, что данная посылка должна быть перевезена от московского терминала в авиа депо филиала компании в городе Москва для последующей отправки авиационным транспортом -
13 pickipTerminalCode 3-х символьный код терминала приема Ширина="79,37013", Высота="37,7953", Шрифт="Arial", Стиль="1" 20
14 deliveryTerminalName Название(город) терминала доставки Ширина="253,22851", Высота="18,89765", Шрифт="Arial", Стиль="1" 12
15 deliveryTerminalCode Код терминала доставки Ширина="188,9765", Высота="41,57483", Шрифт="Arial", Стиль="1" 28
16 deliveryServiceArea Район доставки Ширина="98,26778", Высота="41,57483", Шрифт="Arial", Стиль="1" 24
17 receiverName Название получателя Ширина="230,55133", Высота="22,67718", Шрифт="Arial",
Стиля нет. 6
18 - Картинка “Снежинка”- указание на то, что при обработке и транспортировке данной посылки необходимо обеспечить соблюдение температурного режима не ниже +5°С -
19 receiverAddress Адрес получателя Ширина="230,55133", Высота="22,67718", Шрифт="Arial",
Стиля нет. 6
20 - Text(constant)="Код посылки:" (Одно поле) Ширина="230,55133", Высота="15,11812", Шрифт="Arial",
Стиля нет. 7
21 clientParcelNum Номер транспортного места в информационной системе клиента 22 - Text(constant)="Отправка №" Ширина="83,14966", Высота="18,89765", Шрифт="Arial",
Стиля нет. 10
23 orderNum Номер заказа DPD Ширина="238,11039", Высота="26,45671", Шрифт="Arial",
Стиля нет. 20
24 (= parcelNum) Штрих-код посылки DPD Align="baCenter", ShiftMode="smDontShift", Left="-1,73472347597681E-18", Top="0", Ширина="311,85", Высота="75,5906", ShowHint="False", BarType="bcCode128A" -
25 - Text(constant)="Посылка №" Ширина="75,5906", Высота="18,89765", Шрифт="Arial",
Стиля нет. 10
26 parcelNum Номер посылки DPD Ширина="136,06308", Высота="18,89765", Шрифт="Arial", Стиль="1". 16
27 - Text(constant)="Категория:" Шрифт="71,81107", Высота="18,89765", Шрифт="Arial",
Стиля нет. 10
28 category Категория посылки Ширина="56,69295", Высота="18,89765", Шрифт="Arial", Стиль="1" 11
29 secondTransport Смена вида транспорта Ширина="154,96073", Высота="34,01577", Шрифт="Arial", Стиль="1" 20
30 thirdTransport Смена вида транспорта Ширина="154,96073", Высота="34,01577", Шрифт="Arial", Стиль="1" 20
Веб-служба «Отмена заказа»ОписаниеВеб-служба «Отмена заказа» предоставляет клиентам сервис, который позволяет без звонка в call-центр DPD:
Отменять оформленные заказы
Инициировать возврат груза, уже переданного курьеру
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru/services/order2?wsdlПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/services/order2?wsdl
Доступные методыМетод Назначение Входящее сообщение Ответное сообщение
cancelOrder Отмена заказа. Создание заказа на возврат Входящие сообщения Исходящие сообщенияАлгоритмыПеред вызовом метода в ИС DPD должна быть зарегистрирована заявка на ввод заказа или заказы должны быть сформированы, им присвоены номера DPD (например, 05120002MOW). Заказ не должен иметь признака «возврат».  Заявка на ввод заказа считается разовым заказом, если нет номера регулярного заказ, иначе – фактическим регулярным заказом. Далее необходимо в метод передать список номеров заказов из системы клиента; дату приема заказа (не обязательно); номер клиента.
 Условие успешной отмены заказа – не забранный груз. Условие успешного оформления возврата отправления – груз забран и нет незавершенного звонка в Call-центр.
Далее система вернет статус результата операции «отмена заказа».
Входящие сообщенияПараметр Описание Тип Обязательный Пример
Внешний тэг orders Auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
cancel orderNumberInternal Номер заказа в информационной системе клиента Строка Да* 123456
orderNum Номер заказа DPD Строка Да* 05120002MOW
pickupdate Дата приема груза Дата Нет 2014-12-05
*Обязательно должен быть указан один из параметров «Номер заказа клиента» или «Номер заказа DPD»
Параметры ответного сообщения Параметр Описание Тип Обязательный Пример
orderNumberInternal Список посылок Строка Нет orderNum Номер заказа DPD. Возвращается в ответном сообщении. Строка Нет 01010001MOW
status Статус изменения заказа. Возвращается в ответном сообщении. Возможные статусы перечислены в разделе «Статусы» Строка Да Canceled
errorMassage Текст сообщения об ошибкеСтрока Статусы
Код Status Описание
Cancelled Операция выполнена успешно
CancelledPreviously Отменено ранее
Error Текст сообщения об ошибкеТекст сообщений об ошибкеОтмена заказа невозможна, возникла ошибка:  <Описание проблемы>
Описание проблемы:
Получены не все данные на вход
Полученные данные некорректны
Не найден заказ \ заявка \ отправка
«Справочная информация»Веб-служба «Справочная информация»ОписаниеВеб-служба «Справочная информация» предоставляет клиентам различную справочную информацию
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru/services/inquiry-desk?wsdlПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/services/inquiry-desk?wsdlДоступные методыМетод Назначение Входящее сообщение Ответное сообщение
getClientNumByINN Определение клиентского номера в системе DPD по ИНН Входящие сообщения Исходящие сообщенияgetClientPredictSms
Предоставление короткой ссылки на сервис predict без авторизации. Входящие сообщения Исходящие сообщенияАлгоритмыПодготавливаем данные для аутентификации входного запроса и вызываем нужный метод.
Получаем ответное сообщение или сообщение об ошибке
Входящее сообщения (getClientNumByINN)Параметр Описание Тип Обязательный Пример
Внешний тэг request Auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
clientINN ИНН компании, чей клиентский номер необходимо определить Число Да 1234567890
Параметры ответного сообщения (getClientNumByINN)Параметр Описание Тип Обязательный Пример
clientINN ИНН компании, чей клиентский номер необходимо определить Число Да 1234567890
clientNumber Номер в системе DPD, определенный по ИНН Число Да 1000000000
status Статус определения клиентского номера.
Возможные статусы перечислены в разделе «Статусы» Строка Да ОК
errorMassage Текст сообщения об ошибке в зависимости от статуса Строка Входящее сообщения (getClientPredictSms)
Параметр Описание Тип Обязательный Пример
Внешний тэг request Auth clientNumber Ваш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKey Ваш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
dpdOrderNum Номер заказа DPD Строка Нет 1234567890
clientOrderNum Клиентский номер заказа Строка Нет 1234567891
Параметры ответного сообщения (getClientPredictSms)Параметр Описание Тип Обязательный Пример
predictLink Ссылка на сервис предикт по данному заказу Строка да http://www.dpd.ru/p.do2?rKqNlPkMpPlhh
errorMassage Текст сообщения об ошибке в зависимости от статуса Строка нет Статусы ответовКод Status Описание
ОК Определение клиентского номера по ИНН завершено успешно
no-data-found В системе DPD не существует клиентского номера, зарегистрированного с искомым ИНН
too-many-rows По заданному ИНН в системе DPD существует несколько клиентских номеров, зарегистрированных с искомым ИНН. Просьба обратиться в DPD
no-setting Нет разрешения на оплату не заказчиком перевозки. Просьба обратиться к Вашему менеджеру в DPD
no-order-found Заказ не найден
auth-error Ошибка в параметрах аутентификации
Файловый обмен Справочников ДПДОписаниеПо расписанию один раз в сутки производится выгрузка обновляемой информации о данных НСИ в системе ДПД.
Файлы выгружаются в формате csv. Разделитель полей в файле « ;». В файлах нет заголовков. Описание полей см. REF _Ref453838361 \h Доступные отчеты
Расположениеftp.dpd.ru;
порт 22;
\integration
Доступ на чтение к папке предоставляется отделом itcustomers.
Доступные отчеты9.2.3.1. Список населенных пунктов в системе ДПД
Параметры отчета по порядку:
Идентификатор населенного пункта в БД ДПД;
Код населенного пункта в ФИАС;
Сокращенное наименование типа населенного пункта;
Наименование населенного пункта;
Список наименований административно-территориальных единиц, к которым подчинен населенный пункт – через запятую начиная с низшего ранга не включая страну.
Страна, к которой относится населенный пункт;
Минимальный и максимальный индексы населенного пункта.
9.2.3.2.График приезда курьера в населенные пункты
Параметры отчета по порядку:
Идентификатор населенного пункта в БД ДПД;
Код населенного пункта в ФИАС;
Сокращенное наименование типа населенного пункта;
Наименование населенного пункта;
Список наименований административно-территориальных единиц, к которым подчинен населенный пункт – через запятую начиная с низшего ранга не включая страну.
Страна, к которой относится населенный пункт;
Минимальный и максимальный индексы населенного пункта.
Перечень дней недели с отметкой о призеде в н.п. курьера.
Веб-служба «Предикт»
ОписаниеИнтерфейс «Предикт» предназначен для обеспечения возможности пользователям изменять следующие данные заказа:
Дата доставки в пределах 5 дней со дня поступления заказа на терминал;
Временной интервал доставки (время приезда курьера);
Адрес доставки в пределах города (в том числе можно выбрать «Самовывоз»),
а так же произвести отказ от доставки заказа.
Обмен данными производится в JSON структуре в кодировке UTF-8 , используется архитектура REST.
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru/rest/application.wadlhttp://wstest.dpd.ru/rest/application.wadl/xsd0.xsdПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/rest/application.wadlhttp://ws.dpd.ru/rest/application.wadl/xsd0.xsdДоступные методы
Параметры всех web методов передаются по методу POST
№ п/п Метод Назначение Входные параметры Ответные параметры
1 getShipmentList Получить список заказов по заданным параметрам. Авторизация REF _Ref423595493 \h \* MERGEFORMAT Входящее сообщение REF _Ref423965191 \h \* MERGEFORMAT Параметры ответного сообщения
2 IsAddressChangeable Получить признак доступности адреса к изменению REF _Ref423595502 \h \* MERGEFORMAT Входящее сообщение REF _Ref423965198 \h \* MERGEFORMAT Параметры ответного сообщения
3 getDeliveryDate Получить планируемую дату доставки по заказу REF _Ref423595502 \h \* MERGEFORMAT Входящее сообщение REF _Ref423965208 \h \* MERGEFORMAT Параметры ответного сообщения
4 getDeliveryIntervalList Получить список интервалов доставки, на которые можно поменять интервал доставки из заказа REF _Ref423595502 \h \* MERGEFORMAT Входящее сообщение REF _Ref423965213 \h \* MERGEFORMAT Параметры ответного сообщения
5 getAddress Получить адрес доставки из заказа REF _Ref423595502 \h \* MERGEFORMAT Входящее сообщение REF _Ref423965219 \h \* MERGEFORMAT Параметры ответного сообщения
6 getStreetList Получить список улиц из города доставки REF _Ref423595502 \h \* MERGEFORMAT Входящее сообщение REF _Ref423965226 \h \* MERGEFORMAT Параметры ответного сообщения
7 getParcelShopList Получить список пунктов выдачи, которые можно выбрать при самовывозе REF _Ref423595502 \h \* MERGEFORMAT Входящее сообщение REF _Ref423965233 \h \* MERGEFORMAT Параметры ответного сообщения
8 saveDeliveryDate Подтверждение изменения планируемой даты доставки REF _Ref423595502 \h \* MERGEFORMAT Входящее сообщение REF _Ref423965239 \h \* MERGEFORMAT Параметры ответного сообщения
9 getWebSite Получение списка ссылок на страницы dpd.ru с описанием выбранного пункта выдачи из списка REF _Ref423595502 \h \* MERGEFORMAT Входящее сообщение REF _Ref423965309 \h \* MERGEFORMAT Параметры ответного сообщения
10 cancelOrder Подтверждение отказа от получения заказа REF _Ref423595502 \h \* MERGEFORMAT Входящее сообщение REF _Ref423965245 \h \* MERGEFORMAT Параметры ответного сообщения
11 saveAddress Подтверждение изменения адреса доставки REF _Ref423595502 \h \* MERGEFORMAT Входящее сообщение REF _Ref423965252 \h \* MERGEFORMAT Параметры ответного сообщения
12 getDeliveryDateList Получить список дат, на которые можно поменять планируемую дату доставки REF _Ref423595502 \h \* MERGEFORMAT Входящее сообщение REF _Ref423965268 \h \* MERGEFORMAT Параметры ответного сообщения
АлгоритмыПодготавливаем данные для аутентификации входного запроса и вызываем нужный метод.
Получаем ответное сообщение или сообщение об ошибке
Входящее сообщение метода getShipmentListПараметр Описание Тип Обязательный Пример
request Auth clientNumber Клиентский номер мобильного приложения
Число Да 3355779903
clientKey Ключ доступа мобильного приложения
Строка Да 7BC65C96D4DE98CD17072C88BFE21CC703A38607
eshopOrderNum Номе заказа в Интернет-Магазине (Номер заказа в ИС клиента) Строка Нет 1234567890
phone Номер телефона получателя и/или номер телефона для SMS оповещения Строка Нет 89260161212
email Email номер клиента. Строка Нет [email protected]
orderNum Номер заказа DPD. Возвращается в ответном сообщении. Строка Нет 05120002MOW
Параметры ответного сообщения getShipmentListПараметр Описание Тип Обязательный Пример
sessionId shipment Параметры заказа REF _Ref423597735 \h \* MERGEFORMAT shipment Тип shipmentПараметр Описание Тип Обязательный Пример
orderId Идентификатор заказа в системе DPD Число Да 123456
orderNum Номер заказа DPD Строка Да 05120002MOW
eshopOrderNum Номер заказа интернет-магазина Строка Да Н15в
parcelCount Число посылок Целое число Да 1
deliveryAddress Адрес доставки Строка Да Москва, ул. Муссы Джалиля, д. 26, корп. 1
Входящее сообщение методов
10.7.1Методы получения данных
Параметр Описание Тип Обязательный Пример
request Auth sessionId Идентификатор сессии, полученный методом getShipmentList
Число Да orderId Идентификатор заказа, полученный методом getShipmentList
Число Да 23854956
Методы cохранения данных
saveAddress
Параметр Описание Тип Обязательный Пример
request Auth sessionId Идентификатор сессии, полученный методом getShipmentList
Число Да orderId Идентификатор заказа, полученный методом getShipmentList
Число Да 23854956
streetID Идентификатор улицы Число Нет StreetName Наименование улицы Строка Да BildingNum Номер дома Строка Нет Str Номер строения Строка Нет Korp Номер корпуса Строка Нет Flat Номер квартиры Строка Нет saveDeliveryDate
Параметр Описание Тип Обязательный Пример
request Auth sessionId Идентификатор сессии, полученный методом getShipmentList
Число Да orderId Идентификатор заказа, полученный методом getShipmentList
Число Да 23854956
DeliveryDate Дата доставки Строка Да DeliveryInterval_ID Идентификатор интервала доставки Число Нет 23854956
SaveParcelShop
Параметр Описание Тип Обязательный Пример
request Auth sessionId Идентификатор сессии, полученный методом getShipmentList
Число Да orderId Идентификатор заказа, полученный методом getShipmentList
Число Да 23854956
Departmetnt_ID Идентификатор терминала Число Да 23854957
CancelOrder
Параметр Описание Тип Обязательный Пример
request Auth sessionId Идентификатор сессии, полученный методом getShipmentList
Число Да orderId Идентификатор заказа, полученный методом getShipmentList
Число Да 23854956
Параметры ответного сообщения IsAddressChangeableПараметр Описание Тип Обязательный Пример
isChangeable Признак доступности адреса доступности для изменений Логический false/true
Параметры ответного сообщения getDeliveryDateПараметр Описание Тип Обязательный Пример
date Дата плановой доставки из заказа Строка Да interval Наименование интервала доставки из заказа Строка Да 9:00-18:00
intervalId Идентификатор интервала доставки в системе DPD Число Да 234
Параметры ответного сообщения getDeliveryIntervalListПараметр Описание Тип Обязательный Пример
deliveryInterval Список интервалов доставки доступных для выбора REF _Ref423603835 \h \* MERGEFORMAT массив
interval Нет Тип intervalПараметр Описание Тип Обязательный Пример
intervalId Идентификатор интервала доставки в системе DPD REF _Ref423603835 \h \* MERGEFORMAT Число Да 123
interval Наименование интервала доставки Строка Да 9:00-18:00
Параметры ответного сообщения getParselShopListПараметр Описание Тип Обязательный Пример
ParcelShop Список доступных для самовывоза пунктов выдачи REF _Ref423604676 \h \* MERGEFORMAT Массив department Нет Тип departmentПараметр Описание Тип Обязательный Пример
departmentId Идентификатор терминала доставки в системе DPD REF _Ref423603835 \h \* MERGEFORMAT Число Да 123
department Наименование терминала доставки Строка Да Параметры ответного сообщения getAddressПараметр Описание Тип Обязательный Пример
contactor Наименование получателия Строка Да Иванов ПП
contact Контактное лицо получателя Строка Да courierInstruction Комментарий для курьера Строка Да country Страна Строка Да zipcode Индекс Строка Нет cityId Идентификатор города в системе DPD Строка Да address Адрес строковый Строка Да streetId Идентификатор улицы в системе DPD Число Да Street Наименование улицы Строка Да streetAbbrId Идентификатор аббревиатуры улицы в системе DPD Число Да bilding Номер дома Строка Нет korp Номер корпуса Строка Нет str Номер строения Строка Нет vlad Номер владения.
Один из параметров (дом/корпус/строение/владение) должен быть обязательно заполнен Строка Нет office Номер офиса Строка Нет flat Номер квартиры Строка Нет needPass Признак необходимости пропуска для курьера на въезд на территорию получателя Целое число Нет phone Номер телефона получателя Строка Да email Электронный почтовый адрес получателя Строка Нет Параметры ответного сообщения getStreetListПараметр Описание Тип Обязательный Пример
street Список улиц города доставки Массив
REF _Ref423605341 \h \* MERGEFORMAT street Да Тип streetПараметр Описание Тип Обязательный Пример
streetId Идентификатор улицы в системе DPD REF _Ref423603835 \h \* MERGEFORMAT Число Да 123
street Наименование улицы Строка Да Ул. Ленина
abbrId Идентификатор аббревиатуры улицы в системе DPD Число Да Параметры ответного сообщения saveDeliveryDateПараметр Описание Тип Обязательный Пример
isOk Признак изменения заказа в системе DPD Логический Да false/true
Параметры ответного сообщения getWebSiteПараметр Описание Тип Обязательный Пример
url Ссылка на страницу пункта выдачи Строка Нет Параметры ответного сообщения cancelOrderПараметр Описание Тип Обязательный Пример
isOk Признак изменения заказа в системе DPD Логический Да false/true
Параметры ответного сообщения saveAddressПараметр Описание Тип Обязательный Пример
isOk Признак изменения заказа в системе DPD Логический Да false/true
Параметры ответного сообщения saveParcelShopПараметр Описание Тип Обязательный Пример
isOk Признак изменения заказа в системе DPD Логический Да false/true
Параметры ответного сообщения getDeliveryDateListПараметр Описание Тип Обязательный Пример
deliveryDate Список дат к выбору Массив
Строка Нет Статусы сообщенийКод Status Описание
200 OK;
400 ошибки request: не заданы поля, недопустимые значения, и т.п.;
403 ошибки аутентификации;
480 в Аргис не установлены настройки, связанные с правами клиента;
481 недопустимое состояние объекта в Аргис, например, состояние заказа не позволяет его изменять;
482 данные не найдены;
520 внутренняя обработанная ошибка;
500 необработанные exceptions.
Статусы, кроме 200 сопровождаются сообщениями.
Справочник ошибокОбщие ошибкиКод ошибки Текст ошибки Примечание
system-error Системная ошибка Не типизированная ошибка. Обратитесь на [email protected]
too-many-calls Превышен лимит одновременных вызовов сервиса На сервере DPD установлено ограничение на частоту вызовов сервиса с одного клиентского номера. Попробуйте уменьшить частоту вызова сервиса.
call-client-twin Повторный вызов сервиса по одному коду клиента На сервере DPD установлено ограничение на количество одновременных вызовов сервиса. Попробуйте уменьшить частоту вызова сервиса.
client-num-error Не найден номер клиента На сервере DPD установлено ограничение, не допускающее более одного вызова сервиса с одного клиентского номера. Попробуйте уменьшить частоту вызова сервиса.
auth-error Ошибка в параметрах аутентификации Уникальный ключ клиента не соответствует номеру клиента. Обратитесь на [email protected]
required-value Не заданы значения обязательных полей Проверьте алгоритм заполнения всех обязательных полей входного сообщения.
error-value        Недопустимое значение поля Проверьте алгоритм заполнения полей, имеющих ограниченный набор значений («Услуга», «Вариант доставки» и пр.)
«ORA-06508: PL/SQL: could not find program unit being called или "Системная ошибка: DpdConnectionDbException". С чем связанно:
На сервере ведутся работы.
Решение проблемы:
Отправить письмо на [email protected] с указанием данной ошибки.
access-denied Превышен суточный лимит вызовов сервиса клиентом На сервере DPD установлено ограничение на количество вызовов некоторых сервисов в сутки. Необходимо уменьшить количество запросов. Разблокировка произойдёт в 0:00.
Ошибки службы «Расчёт стоимости»Код ошибки Текст ошибки Примечание
no-service-available Невозможна услуга, удовлетворяющая запросу Доставка груза по данной услуге невозможна. Попробуйте задать другое направление, услугу или дату доставки.
no-data-found Данные не найдены По заданным параметрам не найден пункт отправления и пункт назначения.
too-many-rows Найдено более одной записи данных По заданным параметрам найдено более одного пункта отправления и пункта назначения.
Неоднозначно задан населенный пункт С чем связанно:
Система не может найти населенный пункт, т.к.с таким названием их более 2ух.
Решение проблемы:
При отправке запроса указать дополнительный параметр.( к примеру «regionCode»).
Так же можно использовать параметр cityID. Справочник городов с cityID можно запросить по почте [email protected]Ошибки службы «Создание заказа»Код ошибки Текст ошибки Примечание
no-data-found Данные не найдены По заданным параметрам не найдено ни одного заказа. Проверьте корректность указанного номера или попробуйте изменить дату приёма груза.
too-many-rows Найдено более одной записи данных По заданным параметрам найдено более одного заказа. Попробуйте указать дату приёма груза, чтобы сузить область поиска.
ORA-20809: Не найден адрес по учетному коду в системе клиента “XXXXXX”(номер кода). С чем связанно:
При отправке запроса на создание заказа учётный код адреса не найден.
Решение проблемы:
Уточнить у менеджера DPD или у IT специалистов [email protected] существует ли данный код в системе.
Если его нет, то создать учётный код адреса через метод «createAddress».
ORA-20201: Ошибка обработки адреса. Не найден регулярный заказ с номером XXXX! С чем связанно:
Не создан регулярный заказ или он изменён.
Решение проблемы:
Обратится к своему менеджеру DPD и уточнить, работаете ли вы по пикапу.
ORA-20448:<<Недопустимая категория отправления для опции НПП Заказ с опцией НПП не может быть оформлен.>> С чем связанно:
В заказе не указана сумма объявленной ценности.
Решение проблемы:
Следует добавить в массив запроса параметр «cargoValue».
Обращаем Ваше внимание, что НПП(наложенный платёж) может быть в заказе только с ОЦ.
ORA-20817: Найдено более одной улицы с названием "xxxxxxx". С чем связанно:
Системе не удалось определить улицу.
Решение проблемы:
Во избежание таких ошибок просьба написать письмо на [email protected] или [email protected] с просьбой подключить Вас на разборщик адресов IQ systems.
ORA-20201: <<Форма оплаты "Наличными получателем" не может быть выбрана.>> С чем связанно:
В данном нас. пункте нет возможности оплаты наличными при получении.
Решение проблемы:
Изменить форму оплаты за услугу перевозки.
ORA-20137: <<Дата забора попадает на выходной день>> С чем связанно:
Дата приёма посылки попадает на выходной день.
Решение проблемы:
Изменить дату приёма посылки на рабочий день или обратиться к Вашему менеджеру DPD, чтобы подключил Вам услугу ПВД (Приём в выходные дни).
ORA-20749: Клиент находится в стоп листе. С чем связанно:
У Вас есть не оплаченные счета за доставку.
Решение проблемы:
Обратитесь к Вашему менеджеру DPD.
ORA-20805: Период забора 9-13 указан некорректно! С чем связанно:
Данный интервал времени приёма посылок в этом населённом пункте не предоставляется.
Решение проблемы:
Изменить интервал времени в параметре «pickupTimePeriod».
ORA-20201:<<Форма оплаты "Наличными отправителем" не может быть выбрана.>> С чем связанно:
Вы выбрали доставку «от Двери», а оплата наличными за услуги перевозки возможна только на терминале при самопривозе.
Решение проблемы:
Изменить форму оплаты в параметре «paymentType». Если оплата будет заказчиком и по безналу, то данный параметр указывать не нужно.
ORA-20448: <<Не задана максимальная сумма НПП для партнерской сети (МБИ-почта). Заказ с опцией НПП не может быть оформлен.>> С чем связанно:
Данный пункт выдачи не осуществляет выдачу заказа с наложенным платежом.
Решение проблемы:
Изменить терминал выдачи или убрать из заказа опцию НПП в параметре «extraService».
ORA-20201: Ошибка разбора адреса: c_house_error_desc = ; c_house_error = 000; c_status_error = 1020 С чем связанно:
Системе не удалось определить адрес приёма/доставки.
Решение проблемы:
Заказ падает на доработку сотруднику DPD и будет доработан.
Для уточнения состояния Вашей заявки можно обратиться на [email protected]Так же Вы можете воспользоваться методом «getOrderStatus», чтобы узнать номер отправления и фактическое состояние заявки.
ORA-20808: Не найден адрес для регулярного заказа по номеру “ХХХХ”. С чем связанно:
В нашей базе не найден номер регулярного заказа(пикапа).
Решение проблемы:
Просьба обратиться к Вашему менеджеру DPD.
ORA-20448: <<Для оказания опции ДПС нужно наличие доп. соглашения Заказ с опцией ДПС не может быть оформлен.>> С чем связанно:
Отсутствует доп. соглашение на услугу ДПС.
Решение проблемы:
Просьба обратиться к Вашему менеджеру DPD.
ORA-20807: Не указано значение входного параметра “дом/здание/владение” для создания адреса. С чем связанно:
Отсутствует данные в одном из обязательных параметров.
Решение проблемы:
Добавить данные в один из параметров: «house» или «vlad».
ORA-20171: Ошибка ввода; Услуга CSM не может быть оказана без договора; С чем связанно:
Отсутствует договор на предоставлении услуг по тарифу CSM (DPD Consumer).
Решение проблемы:
Просьба обратиться к Вашему менеджеру DPD.
ORA-20815: Улица с названием  “xxxxx” неизвестна. С чем связанно:
Системе не удалось определить адрес приёма/доставки.
Решение проблемы:
При оформлении нового заказа нужно проверить на наличие улицы в данном нас. пункте.
Для уточнения состояния Вашей заявки можно обратиться на [email protected]Так же Вы можете воспользоваться методом «getOrderStatus», чтобы узнать номер отправления и фактическое состояние заявки.
ORA-20805: Период забора 9-18 указан некорректно! С чем связанно:
Вы оформляете заказ по экспресс тарифу(NDY), а по нему приём посылки возможен только 9-13.
Решение проблемы:
Изменить параметр «pickupTimePeriod» на 9-13.
ORA-20201: Время оформления 13.07.2015 13:30:00 меньше Локального времени «дата и время». С чем связанно:
Ошибка связанна с тем, что Вы пытаетесь оформить заказ на сегодня, но по месту приёма посылки время превышает 13:30 для приёма заявки.
Решение проблемы:
Изменить дату приёма груза на следующий (рабочий) день или если согласована отправка обратиться на [email protected]:<<Ошибка ввода>><<Не определен терминал доставки (OrdOrdSimple_DeliveryAddress)>> С чем связанно:
При оформлении заказа не указан код терминала.
Решение проблемы:
При создании заказа указать код терминала.
Блок запроса receiverAddress.
Параметр для ввода : «terminalCode»
Нет разрешения на загрузку посылок! С чем связанно:
У Вас не включена работа по своему штрих-коду.
Решение проблемы:
Если Вы не будете работать по своему ШК, то просьба тип «Parcel» не указывать.
Обратиться к менеджеру DPD, чтобы он включил работу по штрих-коду.
Ошибки службы «Отслеживание статуса»Код ошибки Текст ошибки Примечание
no-data-found Данные не найдены По заданным параметрам не найдено ни одного заказа. Проверьте корректность указанного номера или попробуйте изменить дату приёма груза.
too-many-rows Найдено более одной записи данных По заданным параметрам найдено более одного заказа. Попробуйте указать дату приёма груза, чтобы сузить область поиска.
no-setting Клиент не подписан на Web сервис Event Tracking. / Клиент не подписан на Web сервис Parcel Tracing. С чем связанно:
Вам не подключены настройки по отслеживанию.
Решение проблемы:
Отправить письмо на [email protected] с указанием выбранного метода подключения.
Более подробную информацию Вы можете найти в нашем интеграционном гиде веб-службе «Отслеживание статуса»
date-before-start Дата запрошенного объекта ранее подключения клиента к сервису Вы можете получать статусы заказов, созданных в системе после вашего подключения к сервису. Выдача статусов «задним числом» не поддерживается.
confirm-not-required Запрос не предполагает подтверждения Вы попытались вызвать запрос подтверждения, но ваши настройки не предполагают подтверждения. Обратитесь на [email protected] , чтобы изменить эти настройки.
Ошибки службы «Создание адреса с кодом»Код ошибки Текст ошибки Примечание
code-already-exists Адрес с указанным кодом уже существует Адрес с указанным кодом уже существует. Обратитесь к вашему менеджеру или напишите на [email protected] Адрес не может быть создан. Не для всех параметров адреса заданы значения. Необходимо указать недостающие значения.
code-not-found Адрес с указанным кодом не найден. По указанному коду не найден адрес. Необходимо создать адрес.
Ошибки службы «Печать Наклейки»Код ошибки Текст ошибки Примечание
no-data-found Заказ № для клиента № не найден Ошибка в номере заказа
input-data-error У заказа № дата забора ранее текущей даты Заказ устарел
illegal-state Состояние заказа № не позволяет создавать наклейки Заказ уже переведен в состояние, не позволяющее формировать наклейки. Например, посылки уже получены у клиента.
Ошибки службы «Отчеты»Код ошибки Текст ошибки Примечание
waiting-time: Не завершилось время ожидания между вызовами С чем связанно:
Повторный запрос на выгрузку данных запрошен раньше чем это возможно.
Решение проблемы:
Отправить повторный запрос через 30мин.
Клиент не включен в группу для получения отчета
С чем связанно:
Вы не подключены к группе для получения отчётов.
Решение проблемы:
Направить письмо на [email protected] с просьбой подключить Вас к этой группе.
КонтактыПо всем вопросам, связанным с использованием нашего интеграционного модуля, обращайтесь в службу информационной поддержки DPD: [email protected]

Приложенные файлы

  • docx 7047903
    Размер файла: 1 MB Загрузок: 1

Добавить комментарий