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


Интеграционный гид DPDВерсия: 1.12
Ноябрь 2014 г.

Оглавление TOC \o "1-3" \h \z \u Интеграционный гид DPD PAGEREF _Toc404846638 \h 1Оглавление PAGEREF _Toc404846639 \h 2История обновлений PAGEREF _Toc404846640 \h 7Введение PAGEREF _Toc404846641 \h 8I.Области интеграции PAGEREF _Toc404846642 \h 91.Запрос географии обслуживания PAGEREF _Toc404846643 \h 92.Расчёт стоимости доставки PAGEREF _Toc404846644 \h 93.Создание заказа на доставку PAGEREF _Toc404846645 \h 94.Изменение заказа на доставку PAGEREF _Toc404846646 \h 105.Отслеживание статуса доставки PAGEREF _Toc404846647 \h 106.Отчеты PAGEREF _Toc404846648 \h 107.Печать наклейки PAGEREF _Toc404846649 \h 108.Отмена заказа PAGEREF _Toc404846650 \h 11II.Пример схемы взаимодействия PAGEREF _Toc404846651 \h 12III.Этапы интеграции PAGEREF _Toc404846652 \h 14IV.Руководство разработчика PAGEREF _Toc404846653 \h 151.Веб-служба «География DPD» PAGEREF _Toc404846654 \h 151.1.Описание PAGEREF _Toc404846655 \h 151.2.Расположение PAGEREF _Toc404846656 \h 151.3.Доступные методы PAGEREF _Toc404846657 \h 151.4.Алгоритм PAGEREF _Toc404846658 \h 151.5.Сообщения PAGEREF _Toc404846659 \h 151.5.1.Параметры входного сообщения PAGEREF _Toc404846660 \h 151.5.2.Параметры ответа getCitiesCashPay PAGEREF _Toc404846661 \h 161.5.3.Параметры ответа getTerminalsSelfDelivery2 PAGEREF _Toc404846662 \h 161.5.4.Параметры входного сообщения getParcelShops PAGEREF _Toc404846663 \h 161.5.5.Параметры ответа getParcelShops PAGEREF _Toc404846664 \h 172.Веб-служба «Расчёт стоимости» PAGEREF _Toc404846665 \h 192.1.Описание PAGEREF _Toc404846667 \h 192.2.Расположение PAGEREF _Toc404846668 \h 192.3.Доступные методы PAGEREF _Toc404846669 \h 192.4.Алгоритмы PAGEREF _Toc404846670 \h 192.4.1.Рассчитать общую стоимость доставки PAGEREF _Toc404846671 \h 192.4.2.Рассчитать стоимость доставки по параметрам посылок PAGEREF _Toc404846672 \h 192.5.Сообщения PAGEREF _Toc404846673 \h 202.5.1.Параметры входного сообщения для getServiceCost2 PAGEREF _Toc404846674 \h 202.5.2.Параметры входного сообщения для getServiceCostByParcels2 PAGEREF _Toc404846675 \h 212.5.3.Параметры ответа при ошибке PAGEREF _Toc404846676 \h 232.5.4.Параметры ответа при успешном запросе PAGEREF _Toc404846677 \h 232.6.Типы PAGEREF _Toc404846678 \h 242.6.1.Описание типа parcel PAGEREF _Toc404846679 \h 243.Веб-служба «Создание заказа» PAGEREF _Toc404846680 \h 253.1.Описание PAGEREF _Toc404846684 \h 253.2.Расположение PAGEREF _Toc404846685 \h 253.3.Доступные методы PAGEREF _Toc404846686 \h 253.4.Алгоритмы PAGEREF _Toc404846687 \h 253.4.1.Создание заказа на доставку PAGEREF _Toc404846688 \h 253.4.2.Создание адреса с кодом PAGEREF _Toc404846689 \h 263.4.3.Изменение адреса с кодом PAGEREF _Toc404846690 \h 263.5.Сообщения PAGEREF _Toc404846691 \h 263.5.1.Параметры входного сообщения createOrder PAGEREF _Toc404846692 \h 263.5.2.Параметры входного сообщения getOrderStatus PAGEREF _Toc404846693 \h 283.5.3.Параметры ответного сообщения createOrder \ getOrdersStatus PAGEREF _Toc404846694 \h 293.5.4.Параметры входного сообщения createAddress \ updateAddress PAGEREF _Toc404846695 \h 293.5.5.Параметры ответного сообщения createAddress \ updateAddress PAGEREF _Toc404846696 \h 293.5.6.Параметры входного сообщения getInvoiceFile PAGEREF _Toc404846697 \h 303.5.7.Параметры ответного сообщения getInvoiceFile PAGEREF _Toc404846698 \h 303.5.8.Параметры входного сообщения getRegisterFile PAGEREF _Toc404846699 \h 303.5.9.Параметры ответного сообщения getRegisterFile PAGEREF _Toc404846700 \h 313.5.10.Параметры ответа при ошибке PAGEREF _Toc404846701 \h 313.6.Типы PAGEREF _Toc404846702 \h 313.6.1.Описание типа address PAGEREF _Toc404846703 \h 313.6.2.Описание типа dataInternational PAGEREF _Toc404846704 \h 323.6.3.Описание типа extraService PAGEREF _Toc404846705 \h 333.6.4.Описание типа parameter PAGEREF _Toc404846706 \h 333.6.5.Описание типа parcel PAGEREF _Toc404846707 \h 333.6.6.Описание типа unitLoad PAGEREF _Toc404846708 \h 343.7.Варианты доставки PAGEREF _Toc404846709 \h 343.8.Интервалы времени приёма PAGEREF _Toc404846710 \h 343.9.Интервалы времени доставки PAGEREF _Toc404846711 \h 343.10.Услуги DPD PAGEREF _Toc404846712 \h 343.11.Опции PAGEREF _Toc404846713 \h 353.12.Статусы создания заказа PAGEREF _Toc404846714 \h 363.13.Статусы создания и изменения адреса PAGEREF _Toc404846715 \h 364.Веб-служба «Изменение заказа» PAGEREF _Toc404846716 \h 374.1.Описание PAGEREF _Toc404846721 \h 374.2.Расположение PAGEREF _Toc404846722 \h 374.3.Доступные методы PAGEREF _Toc404846723 \h 374.4.Алгоритмы PAGEREF _Toc404846724 \h 374.4.1.Изменение заказа с добавлением посылок PAGEREF _Toc404846725 \h 374.4.2.Изменение заказа с удалением посылок PAGEREF _Toc404846726 \h 374.5.Сообщения PAGEREF _Toc404846727 \h 384.5.1.Параметры входного сообщения addParcels \ removeParcels PAGEREF _Toc404846728 \h 384.5.2.Параметры ответного сообщения для addParcels \ removeParcels PAGEREF _Toc404846729 \h 384.6.Типы PAGEREF _Toc404846730 \h 384.6.1.Описание типа parcel PAGEREF _Toc404846731 \h 384.6.2.Описание типа parcelStatus PAGEREF _Toc404846732 \h 394.7.Статусы PAGEREF _Toc404846733 \h 394.7.1.Статусы изменения заказа PAGEREF _Toc404846734 \h 394.7.2.Статусы добавления \ удаления посылки PAGEREF _Toc404846735 \h 395.Веб-служба «Отслеживание статуса» PAGEREF _Toc404846736 \h 405.1.Описание PAGEREF _Toc404846742 \h 405.2.Расположение PAGEREF _Toc404846743 \h 405.3.Доступные методы PAGEREF _Toc404846744 \h 405.4.Алгоритмы PAGEREF _Toc404846745 \h 415.4.1.Алгоритм работы с методом getStatesByClient PAGEREF _Toc404846746 \h 415.4.2.Алгоритм работы с методами getStatesByClientOrder, getStatesByDPDOrder, getStatesByClientParcel PAGEREF _Toc404846747 \h 415.5.Входящие сообщения PAGEREF _Toc404846748 \h 425.4.3.getStatesByClient PAGEREF _Toc404846749 \h 425.4.4.confirm PAGEREF _Toc404846750 \h 425.4.5.getStatesByClientOrder PAGEREF _Toc404846751 \h 425.4.6.getStatesByClientParcel PAGEREF _Toc404846752 \h 425.4.7.getStatesByDPDOrder PAGEREF _Toc404846753 \h 435.5.Исходящие сообщения PAGEREF _Toc404846754 \h 435.5.1.getStatesByClientResponse PAGEREF _Toc404846755 \h 435.5.2.confirmResponse PAGEREF _Toc404846756 \h 455.5.3.getStatesByClientOrderResponse PAGEREF _Toc404846757 \h 455.5.4.getStatesByClientParcelResponse PAGEREF _Toc404846758 \h 455.5.5.getStatesByDPDOrderResponse PAGEREF _Toc404846759 \h 455.6.Состояния PAGEREF _Toc404846760 \h 455.6.1.Посылка PAGEREF _Toc404846761 \h 456.Веб-служба «Отчеты» PAGEREF _Toc404846762 \h 476.1.Описание PAGEREF _Toc404846769 \h 476.2.Расположение PAGEREF _Toc404846770 \h 476.3.Доступные методы PAGEREF _Toc404846771 \h 476.4.Алгоритмы PAGEREF _Toc404846772 \h 476.5.Сообщения PAGEREF _Toc404846773 \h 476.5.1.Параметры входного сообщения метода PAGEREF _Toc404846774 \h 476.5.2.Параметры ответного сообщения метода getNLAmount PAGEREF _Toc404846775 \h 486.5.3.Параметры ответного сообщения метода getNLInvoice PAGEREF _Toc404846776 \h 486.6.Ограничение на частоту вызовов PAGEREF _Toc404846777 \h 487.Веб-служба «Печать Наклейки» PAGEREF _Toc404846778 \h 497.1.Описание PAGEREF _Toc404846779 \h 497.2.Расположение PAGEREF _Toc404846780 \h 497.3.Доступные методы PAGEREF _Toc404846781 \h 497.4.Алгоритмы PAGEREF _Toc404846782 \h 497.4.1.Формат файла PAGEREF _Toc404846783 \h 497.4.2.Формат области печати PAGEREF _Toc404846784 \h 497.5.Входящие сообщения PAGEREF _Toc404846785 \h 497.5.1.createLabelFile PAGEREF _Toc404846786 \h 497.6.Исходящие сообщения PAGEREF _Toc404846787 \h 507.6.1.createLabelFileResponse PAGEREF _Toc404846788 \h 508.Веб-служба «Отмена заказа» PAGEREF _Toc404846789 \h 518.1.Описание PAGEREF _Toc404846790 \h 518.2.Расположение PAGEREF _Toc404846791 \h 518.3.Доступные методы PAGEREF _Toc404846792 \h 518.4.Алгоритмы PAGEREF _Toc404846793 \h 518.5.Входящие сообщения PAGEREF _Toc404846794 \h 518.6.Параметры ответного сообщения PAGEREF _Toc404846795 \h 528.7.Статусы PAGEREF _Toc404846796 \h 528.8.Текст сообщений об ошибке PAGEREF _Toc404846797 \h 529.Веб-служба «Справочная информация» PAGEREF _Toc404846798 \h 539.1.Описание PAGEREF _Toc404846799 \h 539.2.Расположение PAGEREF _Toc404846800 \h 539.3.Доступные методы PAGEREF _Toc404846801 \h 539.4.Алгоритмы PAGEREF _Toc404846802 \h 539.5.Входящее сообщения PAGEREF _Toc404846803 \h 539.6.Параметры ответного сообщения PAGEREF _Toc404846804 \h 539.7.Статусы PAGEREF _Toc404846805 \h 54V.Справочник ошибок PAGEREF _Toc404846806 \h 551.Общие ошибки PAGEREF _Toc404846813 \h 552.Ошибки службы «Расчёт стоимости» PAGEREF _Toc404846814 \h 553.Ошибки службы «Создание заказа» PAGEREF _Toc404846815 \h 564.Ошибки службы «Отслеживание статуса» PAGEREF _Toc404846816 \h 565.Ошибки службы «Создание адреса с кодом» PAGEREF _Toc404846817 \h 566.Ошибки службы «Печать Наклейки» PAGEREF _Toc404846818 \h 56VI.Контакты PAGEREF _Toc404846819 \h 58
История обновленийВерсия 1.8
новая веб-служба «Отмена заказа» (CancelOrder).
Версия 1.9
метод getTerminalSelfDelivery2 – расширен список параметров ответного сообщение (отображение координат нахождения терминалов, времени работы терминалов, код КЛАДР населенного пункта нахождения терминала);
веб-служба «Расчет стоимости» - добавлена расшифровка кодов услуг DPD;
добавлены наименования оборотов для каждого метода;
примеры интеграции вынесены в отдельные документы.
Версия 1.10
для методов getNLAmount и getNLInvoice отменены ограничения только ночного запуска. Отчеты можно запускать в любое время суток. Введены ограничения на частоту запуска отчетов;
новый метод getRegisterFile в веб-службе «Создание заказа» - позволяет получать реестр отправок, передаваемых курьеру DPD.
Версия 1.11
метод createOrder – добавлено описание параметров и их значений для различных вариантов оплаты наличными.
метод createOrder – описание параметров и значений для опции ЧСТ; описание параметров для добавления вложений – unitLoad.
Версия 1.12
новая веб-служба «Справочная информация». Метод getClientNumByINN – определение клиентского номера в системе DPD по ИНН (для оформления заказов с оплатой не заказчиками).
ВведениеКомпания 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.
Пример схемы взаимодействия
Следующая схема описывает взаимодействие с использованием всех областей интеграции на примере клиента - интернет-магазина.


Этапы интеграцииДля запуска интеграционного процесса с DPD вам нужно совершить следующие действия:
Передать данное руководство в ваш IT-департамент.
Разработать клиентскую программу для взаимодействия с выбранными веб-службами.
Получить уникальный ключ клиента для аутентификации в интеграционном модуле DPD. Для получения данного ключа вам нужно иметь клиентский номер DPD (номер вашего договора с DPD). Вы можете получить ключ у своего менеджера DPD или обратившись на адрес нашей информационной поддержки: [email protected]
Протестировать работу веб-служб совместно с сотрудниками информационной поддержки DPD, используя тестовый сервер DPD. Адрес тестового сервера приведен ниже в руководстве разработчика.
Настроить вашу программу на промышленный сервер DPD и начать работать в реальном режиме. Адрес промышленного сервера приведен ниже в руководстве разработчика.
Руководство разработчикаВ данном разделе дано подробное описание методов, имеющихся в веб-службах.
Веб-служба «География DPD»ОписаниеВеб-служба «География DPD» предназначена для получения актуального списка городов, в которые возможна доставка с наложенным платежом, списка терминалов DPD и списка пунктов выдачи посылок (ПВП).
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru/services/geography?wsdlПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/services/geography?wsdlДоступные методыМетод Назначение Входящее сообщение Ответное сообщение
getCitiesCashPayПолучить список городов с возможностью доставки с наложенным платежом Параметры входного сообщения Параметры ответа getCitiesCashPaygetTerminalsSelfDelivery2 Получить список терминалов DPD Параметры входного сообщенияПараметры ответа getTerminalsSelfDelivery2
getParcelShopsПолучить список пунктов выдачи посылок (ПВП) Параметры входного сообщенияПараметры ответаАлгоритмПодготавливаем данные для аутентификации входного запроса и вызываем нужный метод.
Обрабатываем результат в соответствии со спецификацией ответных сообщений выбранного метода.
СообщенияПараметры входного сообщенияПараметр Описание Тип Обязательный Пример
Auth clientNumberВаш клиентский номер в системе DPD (номер вашего договора с DPD) Строка Да 1000000000
clientKeyВаш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
Параметры ответа getCitiesCashPayПараметр Описание Тип Пример
city Массив городов с поддержкой доставки с наложенным платежом cityIdИдентификатор города Число 49694102
countryCodeКод страны Строка RU
countryNameСтрана Строка Россия
regionCodeКод региона Строка 50
regionNameРегион Строка Московская обл. (формат ФИАС)
cityNameГород Строка Люберцы (буквенные обозначения аббревиатур и других знаков)
Параметры ответа getTerminalsSelfDelivery2Параметр Описание Тип Пример
terminal Массив терминалов DPD terminalCodeКод терминала DPD Строка LED
terminalNameНазвание терминала DPD Строка Санкт-Петербург
terminalAddressАдрес терминала DPD Строка пр. Обуховской Обороны, д.295, лит БД
192012 г. Санкт-Петербург
geoCoordinates:
geoXgeoYГеографические координаты по карте ЯндексЧисло 53.322927
Число 83.638803
workingTime:
weekDaysworkTimeМассив расписаний работы по дням Список дней недели Строка пн,вт,ср,чт,птСтрока 09:00–20:00
сityИнформация о городе, в котором расположен терминал DPD cityIdИдентификатор города Число 49694103
cityCodeКод города Строка 78000000001
countryCodeКод страны Строка RU
countryNameСтрана Строка Россия
regionCodeКод региона Строка 78
regionNameРегион Строка г. Санкт-Петербург (формат ФИАС)
cityNameГород Строка Санкт-Петербург (буквенные обозначения аббревиатур и других знаков)
Параметры входного сообщения getParcelShopsПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumberВаш клиентский номер в системе DPD (номер вашего договора с DPD) Строка Да 1000000000
clientKeyВаш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
countryCodeКод страны Строка Нет RU
regionCodeКод региона Строка Нет 77
cityCodeКод города cityNameНаименование города Строка Нет Москва (буквенные обозначения аббревиатур и других знаков)
serviceCodeСписок кодов услуг DPD. Если параметр задан, то сервис возвращает сроки бесплатного хранения по заданным услугам. Если он не задан, сервис не возвращает сроки бесплатного хранения. СтрокаСписок кодов услуг через запятую Нет BZP, ECN
ПРИМЕЧАНИЯ. 1. Поля countryCode, regionCode и cityCode задаются для фильтрации списка. Если коды не заданы, возвращается полный список. Поле cityName анализируется только, если не задан cityCode.
2. Сроки бесплатного хранения зависят от услуги DPD и одинаковы для всех пунктов. Для получения сроков бесплатного хранения необходимо задать поле serviceCode.
Параметры ответа getParcelShopsПараметр Описание Тип Пример
parcelShopМассив ПВП code Код подразделения DPD Строка LED
parcelShopTypeТип подразделения:
Т–терминал, СД–сити-депо, ПВП–отдельный пункт выдачи посылок Строка ПВП
address Адрес пункта countryCodeКод страны Строка RU
regionCodeКод региона Строка 78
regionNameРегион Строка г. Санкт-Петербург (формат ФИАС)
cityCodeКод города Строка 78000000001
cityNameГород Строка Санкт-Петербург (буквенные обозначения аббревиатур и других знаков)
addressStringСтрока с адресом Строка пр. Обуховской Обороны, д.295, лит БД
192012 г. Санкт-Петербург
geoCoordinatesГеографические координаты по карте ЯндексgeoXЧисло 53.322927
geoYЧисло 83.638803
limits Ограничения параметров посылки maxWeightМакс. вес в кгЧисло 30.5
maxLengthМакс. длина в смЧисло 70
maxWidthМакс. ширина в смЧисло 70
maxHeightМакс. высота в смЧисло 50
workingTimeМассив расписаний работы по дням weekDaysСписок дней недели Строка пн,вт,ср,чт,птworkTimeСтрока 09:00–20:00
storagePeriodМассив сроков бесплатного хранения serviceCodeКод услуги Строка CSM
days Количество дней Число 14
Веб-служба «Расчёт стоимости»ОписаниеВеб-служба «Расчёт стоимости» предназначена для расчёта стоимости доставки по тарифам DPD.
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru/services/calculator2?wsdlПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/services/calculator2?wsdlДоступные методыМетод Назначение Входящее сообщение Ответное сообщение
getServiceCost2 Рассчитать общую стоимость доставки Параметры входного сообщения Параметры ответа при ошибке / Параметры ответа при успешном запросеgetServiceCostByParcels2 Рассчитать стоимость доставки по параметрам посылок Параметры входного сообщенияПараметры ответа при ошибке / Параметры ответа при успешном запросеАлгоритмыРассчитать общую стоимость доставкиПодготавливаем параметры вызова в соответствии с описанием входного сообщения метода getServiceCost2: пункт отправления и назначения, дату приёма груза, объявленную ценность. Если вы работаете с DPD только по одной услуге, рекомендуется указать код этой услуги во входном сообщении.
Вызываем метод getServiceCost2.
Получаем ответное сообщение с кодом ошибки или с массивом доступных услуг для выбранной доставки и их стоимости. Если услуга была задана во входном сообщении, то при успешном выполнении запроса массив ответного сообщения будет состоять из одного элемента.
Если вы получили код ошибки TooManyRows, то проанализируйте массивы pickupDups и DeliveryDups во входном сообщении. Выберите ID нужного населенного пункта и повторите запрос.
Рассчитать стоимость доставки по параметрам посылокПодготавливаем параметры вызова в соответствии с описанием входного сообщения метода getServiceCostByParcels2: пункт отправления и назначения, дату приёма груза, объявленную ценность. Если вы работаете с DPD только по одной услуге, рекомендуется указать код этой услуги во входном сообщении.
Вызываем метод getServiceCostByParcels2.
Получаем ответное сообщение с кодом ошибки или с массивом доступных услуг для выбранной доставки и их стоимости. Если услуга была задана во входном сообщении, то при успешном выполнении запроса массив ответного сообщения будет состоять из одного элемента.
Если вы получили код ошибки TooManyRows, то проанализируйте массивы pickupDups и DeliveryDups во входном сообщении. Выберите ID нужного населенного пункта и повторите запрос.
СообщенияПараметры входного сообщения для getServiceCost2Параметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumberВаш клиентский номер в системе DPD (номер вашего договора с DPD) Строка Да 1000000000
clientKeyВаш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
pickup cityIdИдентификатор города отправления Число Нет 49694102
cityNameГород отправления Строка Нет Москва (буквенные обозначения аббревиатур и других знаков)
regionCodeКод региона отправления Строка Нет 77
countryCodeКод страны отправления Строка Нет RU
delivery cityIdИдентификатор города доставки Число Нет 49265227
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
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Да Параметры ответа при ошибкеПараметр Описание Тип Пример
сode Код ошибки Строка too-many-rowsmessageСообщение об ошибке Строка Неоднозначно задан населенный пункт
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
ТипыОписание типа parcelПараметр Описание Тип Обязательный Пример
weight Вес посылки Число Да 0.5
length Длина посылки Число Да 0.5
width Ширина посылки Число Да 0.2
height Высота посылки Число Да 0.2
quantity Количество посылок Число Нет 3
Веб-служба «Создание заказа»ОписаниеВеб-служба «Создание заказа» предназначена для создания заказов на доставку в информационной системе DPD.
РасположениеТестовая версия сервиса доступна по адресу:
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) Параметры входного сообщенияПараметры ответа при успешном запросеАлгоритмыСоздание заказа на доставкуПодготавливаем параметры вызова: массив заказов, объединенных общим адресом приёма груза и датой приема отправки, в соответствии с описанием входного сообщения метода createOrder.
Вызываем метод createOrder.
Получаем ответное сообщение с результатом выполнения функции по каждому заказу.
Анализируем статус создания заказа (см. «Статусы создания заказа») и при необходимости – сообщение об ошибке.
Если статус заказа – OrderPending, то через какое-то время можно вызвать метод getOrderStatus, чтобы убедиться в том, что заказ доработан и создан в информационной системе DPD.
Создание адреса с кодомПодготавливаем параметры вызова в соответствии с описанием входного сообщения метода createAddress.
Вызываем метод createAddress.
Получаем ответное сообщение с результатом создания адреса.
Анализируем статус создания адреса (см. «Статусы создания и изменения адреса») и при необходимости – сообщение об ошибке.
Если статус адреса - address-error, необходимо внести изменения в параметры и повторно вызвать метод.
Изменение адреса с кодомПодготавливаем параметры вызова в соответствии с описанием входного сообщения метода updateAddress.
Вызываем метод updateAddress.
Получаем ответное сообщение с результатом создания адреса.
Анализируем статус создания адреса (см. «Статусы создания и изменения адреса») и при необходимости – сообщение об ошибке.
Если статус адреса - code-not-found – в системе отсутствует адрес с таким кодом, соответственно для создания адреса необходимо воспользоваться методом createAddress.
Если статус адреса - address-error, необходимо внести изменения в параметры или добавить недостающие и повторно вызвать метод.
СообщенияПараметры входного сообщения createOrderПараметр Описание Тип Обязательный Пример
Внешний тэг orders auth clientNumberВаш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKeyВаш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
header Информация, содержащаяся в этом параметре, является общей для всех заказов в запросе datePickupДата приёма груза Дата Да payer Клиентский номер плательщика в системе DPD (номер договора с DPD).
Если этот параметр не заполнен, то плательщиком будет считаться заказчик (номер из параметра auth).
При оплате наличными указываются значения в extraParamЧисло Нет senderAddressАдрес приёма груза addressДа pickupTimePeriodИнтервал времени приёма груза. Доступные для выбора интервалы приёма см. в разделе «Интервалы времени приёма». Строка Да 9-18
regularNumНомер регулярного заказа DPD. Если вы используете доставку на регулярной основе, уточните этот номер у своего менеджера. Строка Нет 1000
order Массив данных, относящихся к каждому конкретному заказу orderNumberInternalНомер заказа в информационной системе клиента Строка Да 123456
serviceCodeКод услуги DPD. Уточните код нужной Вам услуги у своего менеджера или используйте код услуги, полученный из веб-сервиса «Калькулятор стоимости» Строка Да CUR
serviceVariantВариант доставки. Доступно 4 варианта: ДД, ДТ, ТД и ТТ. Расшифровку вариантов см. в разделе «Варианты доставки».Строка Да ДД
cargoNumPackКоличество грузомест (посылок) в отправке Целое число Да 5
cargoWeightВес отправки, кгЧисло Да 5
cargoVolumeОбъём, м3 Число Нет 0.05
cargoRegisteredЦенный груз. Внутреннее вложение, включенное в перечень товаров, требующих дополнительных мер безопасности, снижающих риск его утери или повреждения при перевозке.
Перечень товаров, относимых к категории «Ценный груз»:
1. Мобильные телефоны
2. Ноутбуки, планшеты booleanДа false
cargoValueСумма объявленной ценности, руб. Число Нет 1000 (после запятой не более 2-х знаков)
cargoCategoryСодержимое отправки Строка Да Одежда
deliveryTimePeriodИнтервал времени доставки груза. Доступные для выбора интервалы доставки см. в разделе «Интервалы времени доставки». Строка Нет 9-18
extraParamЗарезервированный параметр для ввода новых параметров без изменения схемы сервиса parameterНет dataIntДанные для международных отправок dataInternationalНет receiverAddressАдрес доставки addressДа extraServiceМассив опций доставки extraServiceНет parcelМассив посылок отправки parcelНет unitLoadМассив вложений в посылке unitLoadнет Параметры входного сообщения getOrderStatusПараметр Описание Тип Обязательный Пример
Внешний тэг orderstatusauth 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
Параметры ответного сообщения getRegisterFileПараметр Описание Тип Обязательный Пример
file Файл Массив байтов Да Параметры ответа при ошибке
Параметр Описание Тип Обязательный Пример
code Код ошибки. Возможные коды описаны в «Ошибки службы «создания заказа»». Строка Да no-data-foundmessage Описание ошибки Строка Нет Данные не найдены
ТипыОписание типа address
Параметр Описание Тип Обязательный Пример
code Код адреса в информационных системах заказчика и DPD. Адрес с кодом должен быть передан в DPD отдельно. Строка Нет 1234
name Название отправителя/получателя. В случае, когда адрес приёма/доставки – это магазин, филиал компании, дилерский центр и т.п., в эту строку пишется его название. Если доставка осуществляется физическому лицу, то пишется Ф.И.О получателя. Строка Да Иванов Сергей Петрович
terminalCodeКод терминала. Строка Да M91
addressStringСтрока адреса для международных отправок Строка Нет 16, Grafton Street, Dublin, Ireland
countryNameНазвание страны Строка Да Россия
index Индекс Строка Нет 140012
region Регион Строка Нет Московская обл.
city Город Строка Да3 Люберцы
street Улица (формат ФИАС) Строка Да3 Авиаторов
streetAbbrСокращения типа улицы (ул, пр-т, б-р и т.д.) Строка Да3 улhouse4 Дом Строка Да 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Контактный телефон Строка Да689165555555
contactEmailКонтактный e-mail Строка Нет [email protected]
instructionsИнструкции для курьера Строка Нет Подъезд со стороны ул. Кирова
Описание типа dataInternationalПараметр Описание Тип Обязательный Пример
currency Валюта Строка Нет USD
currencyDeclaredValueОбъявленная ценность в валюте Строка Нет 100 (после запятой не более 2-х знаков)
Описание типа extraServiceПараметр Описание Тип Обязательный Пример
esCodeКод опции. См описания опций в разделе «Опции». Строка Да SMS
paramПараметр опции. parameterНет Описание типа parameterПараметр Описание Тип Обязательный Пример
name Имя параметра Строка Да phone
value Значение параметра Строка Да 89165555555
Вариант формы оплаты услуги и плательщика Название параметра - name Значение - value
Оплата наличными отправителем на терминале отправки
плательщик – юридическое лицо order_payment_typepayer_num‘ОУО’
десятизначный номер клиента плательщика
Оплата наличными получателем  на терминале доставки
плательщик – юридическое лицо order_payment_typepayer_num‘ОУП’
десятизначный номер клиента плательщика
Оплата наличными получателем  у двери
плательщик – юридическое лицо order_payment_typepayer_num‘ОУП’
десятизначный номер клиента плательщика
Оплата наличными отправителем на терминале отправки
плательщик – физическое лицо order_payment_typepayer_num‘ОУО’
‘1001028502’- номер для оплаты наличными
Оплата наличными получателем  на терминале доставки
плательщик – физическое лицо order_payment_typepayer_num‘ОУП’
‘1001028502’- номер для оплаты наличными
Оплата наличными получателем  у двери
плательщик – физическое лицо order_payment_typepayer_num‘ОУП’
‘1001028502’- номер для оплаты наличными
Описание типа parcelПараметр Описание Тип Обязательный Пример
number Номер посылки в информационной системе клиента (номер штрих-кода посылки) Строка Да 1001000998
weightВес посылки Число Нет 0.5
lengthДлина посылки Число Нет 0.5
widthШирина посылки Число Нет 0.2
heightВысота посылки Число Нет 0.2
Описание типа unitLoadПараметр Описание Тип Обязательный Пример
articleАртикул Строка Да 201
descriptНоменклатура Строка Да Брюки
declared_valueОбъявленная ценность Число Нет 100 (после запятой не более 2-х знаков)
parcel_numПосылка клиент Строка Нет parcel_1
npp_amountЦена Число Нет 100
Варианты доставкиДоступны следующие варианты:
ДД – от двери отправителя до двери получателя;
ДТ – от двери отправителя до терминала 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-13 – с 09:00 до 13:00;
13-18 – с 13:00 до 18:00;
18-21 – с 18:00 да 21:00. (внимание, данный интервал оплачивается дополнительно!)
Услуги DPDКод услуг Наименование
BZP DPD 18:00
ECN DPD ECONOMY
TEN DPD 10:00
DPT DPD 13:00
CUR DPD CLASSIC
NDY DPD EXPRESS
CSM DPD CONSUMER
PCL DPD CLASSIC Parcel
ОпцииКод опции Описание опции Опция платная Имя параметра для передачи сопутствующих данных Значение параметра
SMS SMS уведомление получателя о приёме посылки у отправителя и о выходе посылки на доставку Нет phone Телефон получателя для отправки уведомления
EML E-mail уведомление получателя о приёме посылки у отправителя и о выходе посылки на доставку Нет email E-mail получателя для отправки уведомления
ЭСД Электронное сообщение о доставке груза получателю Нет email E-mail, на который нужно отправить сообщение о доставке груза
ЭСЗ Электронное сообщение о приёме заказа Нет email E-mail, на который нужно отправить сообщение о приёме заказа
ВДО Возврат документов отправителю.
Если клиенту необходимо вернуть сопроводительные документы на груз (товарную накладную, акты приема-передачи), заверенные получателем. Да - ДВД Доставка в выходные дни.
Эта опция, позволяющая осуществить доставку отправки получателю в соответствии со сроком доставки ТК, но раньше даты, рассчитанной по стандартным правилам, при условии, что итоговая дата доставки придется на выходной день. Да - НПП Наложенный платеж Да sum_nppcумма наложенного платежа1
ПОД Подтверждение о доставке Да email/fax E-mail или факс, на который нужно отправить подтверждение о доставке
ПРД Погрузо-разгрузочные работы при доставке.
Если необходимо организовать разгрузку и доставку поступивших посылок в то или иное помещение на территории, независимо от того, на каком этаже оно расположено. Да - ТРМ Температурный режим Да - ОЖД Ожидание на адресе Да reason_delayпричина ожидания на адресе  из Справочника причин ожидания на адресе:
ВНЕШ Проверка на внешние поврежденияПРИМ ПримеркаРАБТ Проверка работоспособностиСООТ Проверка на соответствие
ЧСТ2Возврат части отправки Да goods_return_amountdelivery_amountКомпенсация доставки при полном возврате
Компенсация доставки
Указывать обязательно, при условии, что сумма за Наложенный платеж будет отличаться от суммы Объявленной стоимости.
- если с получателя нужно взимать стоимость доставки только при отказе от всего товара, то данная стоимость передается в параметре «Компенсация доставки при полном возврате», а в параметре «Компенсация доставки» не передается ничего
данный вариант не может использоваться совместно со способом оплаты услуг DPD «Наличными получателем»;
- если с получателя всегда нужно взимать стоимость доставки, то данная стоимость передается в параметре «Компенсация доставки», а в параметре «Компенсация доставки при полном возврате» не передается ничего
данный вариант не может использоваться совместно со способом оплаты услуг DPD «Наличными получателем»;
- если с получателя не нужно взимать стоимость доставки, то информация не передается ни в параметре «Компенсация доставки при полном возврате», ни в параметре «Компенсация доставки».
Статусы создания заказаВ ответном сообщении о создании заказа может быть возвращен один из следующих статусов:
OK – заказ на доставку успешно создан с номером, указанным в поле orderNum.
OrderPending – заказ на доставку принят, но нуждается в ручной доработке сотрудником DPD, (например, по причине того, что адрес доставки не распознан автоматически). Номер заказа будет присвоен ему, когда это доработка будет произведена.
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
cargoValueСумма объявленной ценности, руб. Число Нет 1000 (после запятой не более 2-х знаков)
cargoCategoryСодержимое отправки Строка Да Одежда
parcel Посылки для добавления в заказ parcelПараметры ответного сообщения для addParcels \ removeParcelsПараметр Описание Тип Обязательный Пример
orderNumНомер заказа DPD. Возвращается в ответном сообщении. Строка Нет 01010001MOW
status Статус изменения заказа. Возвращается в ответном сообщении. Возможные статусы перечислены в разделе «Статусы изменения заказа» Строка Да OK
parcelStatusСписок посылок parcelStatusНет ТипыОписание типа parcelПараметр Описание Тип Обязательный Пример
number Номер посылки в информационной системе клиента (номер штрих-кода посылки) Строка Да WS121
weight Вес посылки Число Нет 0.5
length Длина посылки Число Нет 0.5
width Ширина посылки Число Нет 0.2
height Высота посылки Число Нет 0.2
Описание типа parcelStatusПараметр Описание Тип Обязательный Пример
number Номер посылки Строка Да WS121
status Статус выполнения операции. Возможные статусы перечислены в разделе «Статусы добавления \ удаления посылки». Строка Да OK
СтатусыСтатусы изменения заказа
В ответном сообщении об изменении заказа может быть возвращен один из следующих статусов:
OK – заказ успешно изменен.
illegal-state -состояние заказа не позволяет выполнять его корректировку.
no-data-found – не найдены данные.
Статусы добавления \ удаления посылкиВ ответном сообщении об изменении состава посылок в заказе может быть возвращен один из следующих статусов:
no-data-found  - при удалении  посылка с указанным номером в заказе не найдена.
too-many-rows  - при удалении  найдено более одной посылки с указанным номером.
illegal-state  - состояние заказа не позволяет выполнять добавление или удаление посылки.
Веб-служба «Отслеживание статуса»ОписаниеВеб-служба «Отслеживание статуса» предоставляет сервис для отслеживания состояния посылок клиента DPD. Можно отслеживать изменения всех статусов посылок своего клиентского номера, либо запрашивать историю состояний по конкретному заказу или посылке.
Для использования данной веб – службы Вам необходимо обратиться в it_customers и запросить одну из настроек – «с подтверждением» или «без подтверждения».
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru:80/services/tracing?wsdlhttp://wstest.dpd.ru:80/services/tracing1-1?wsdl
Промышленная версия сервиса доступна по адресу:
http://ws.dpd.ru:80/services/tracing?wsdlhttp://ws.dpd.ru:80/services/tracing1-1?wsdlДоступные методы:
tracing?wsdl – confirm, getStatesByClient, getStatesByClientOrder, getStatesByClientParcel, getStatesByDPDOrder.
tracing1-1?wsdl – getStatesByClientOrder, getStatesByClientParcel, getStatesByDPDOrderДоступные методыМетод Назначение Входящее сообщение Исходящее сообщение
getStatesByClientПолучить все состояния посылок клиента, изменившиеся с момента последнего вызова данного метода getStatesByClientgetStatesByClientResponseconfirm Подтвердить получение состояний, переданных методом getStatesByClientconfirmconfirmResponsegetStatesByClientOrderПолучить историю состояний всех посылок заданного заказа. Заказ идентифицируется по номеру заказа в информационной системе клиента. getStatesByClientOrdergetStatesByClientOrderResponsegetStatesByClientParcelПолучить историю состояний заданной посылки. Посылка идентифицируется по номеру посылки в информационной системе клиента. getStatesByClientParcelgetStatesByClientParcelResponsegetStatesByDPDOrderПолучить историю состояний всех посылок заданного заказа. Заказ идентифицируется по номеру заказа в информационной системе DPD. getStatesByDPDOrdergetStatesByDPDOrderResponseАлгоритмыАлгоритм работы с методом getStatesByClientС методом getStatesByClient можно работать двумя способами: с подтверждением и без подтверждения. Вам необходимо сообщить желаемый метод сотруднику DPD при подключении сервиса. По умолчанию используется метод работы с подтверждением.
Если вы работаете с подтверждением, то метод getStatesByClient не выдаст вам новых состояний, пока не получит от вас подтверждения прочтения переданных состояний через метод confirm. Если наша система не получит такого подтверждения, то при следующем запросе она выдаст те же состояния, что и в предыдущем. Таким образом, гарантируется защита от сбоя при передаче данных - если сбой произошел, данные не потеряются, а будут переданы при повторном запросе. Вызов метода confirm говорит нам о том, что процесс передачи данных прошел успешно, и все данные закачаны в информационную систему клиента.
Если вы работаете без подтверждения, то метод getStatesByClient будет всегда выдавать только новые состояния. При формировании новой порции состояний система учитывает только то, были ли состояния уже переданы через веб-сервис и не принимает в расчёт то, были ли они загружены в систему клиента.
Вы также можете воспользоваться настройкой «Расширенное отслеживание», которое всегда работает без подтверждения. С помощью данной настройки Вы сможете в отслеживании видеть код и наименование инцидента с посылкой.
Алгоритм работы:
Подготавливаем параметры аутентификации.
Вызываем метод getStatesByClient.
Получаем ответное сообщение с идентификатором документа и массивом состояний посылок.
Если выбран способ работы с подтверждением - вызываем метод 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. Все сообщения, переданные по данному документу, получат статус «Получение подтверждено». Число Да 12346897
getStatesByClientOrderПараметр Описание Тип Обязательный Пример
Внешний тэг request auth clientNumberВаш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKeyВаш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
clientOrderNrНомер заказа в информационной системе клиента Строка Да 12346DPD
pickupDateДата приёма груза (на случай, если номер заказа не уникален, и требуется уточнение по дате) Дата Нет 2014-02-28
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
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=1confirmResponseСтруктура сообщения аналогична входящему «confirm».
getStatesByClientOrderResponse
Параметры сообщения совпадают с параметрами ответного сообщения «getStatesByClientResponse».
getStatesByClientParcelResponseПараметры сообщения совпадают с параметрами ответного сообщения «getStatesByClientResponse».
getStatesByDPDOrderResponseПараметры сообщения совпадают с параметрами ответного сообщения «getStatesByClientResponse».
СостоянияПосылкаПосылка может принимать одно из следующих состояний:
NewOrderByClient – оформлен новый заказ по инициативе клиента
NotDone– заказ отменен
OnTerminalPickup– посылка находится на терминале приема отправления
OnRoad– посылка находится в пути (внутренняя перевозка DPD)
OnTerminal– посылка находится на транзитном терминале
OnTerminalDelivery– посылка находится на терминале доставки
Delivering – посылка выведена на доставку
Delivered – посылка доставлена получателю
Lost – посылка утеряна
Problem– с посылкой возникла проблемная ситуация
ReturnedFromDelivery– посылка возвращена с доставки
NewOrderByDPD – оформлен новый заказ по инициативе DPD
Веб-служба «Отчеты»ОписаниеВеб-служба «Отчеты» предоставляет возможность получать отчеты из информационной системы компании.
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru/services/nl?wsdlПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/services/nl?wsdlДоступные методыМетод Назначение Входящее сообщение Ответное сообщение
getNLAmountОтчет о предварительной стоимости перевозки за указный период. Параметры входного сообщения Параметры ответного сообщенияgetNLInvoiceОтчет об окончательной стоимости перевозки за указный период. Параметры входного сообщенияПараметры ответного сообщенияАлгоритмыСообщенияПараметры входного сообщения метода
Параметр Описание Тип Обязательный Пример
Внешний тэг arg0 auth clientNumberВаш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKeyВаш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
dateFromНачальная дата периода отчета Дата Да 2014-05-21
dateToКонечная дата периода отчета Дата Да 2014-05-21
Параметры ответного сообщения метода getNLAmountПараметр Описание Тип Обязательный Пример
amount Стоимость перевозки Число Нет 100
ordernumНомер заказа Строка Нет Параметры ответного сообщения метода getNLInvoiceПараметр Описание Тип Обязательный Пример
amount Сумма счета Число Нет 100
invoicenumНомер счета Строка Нет ordernumНомер заказа Строка Нет 02200119MOW
Ограничение на частоту вызововне разрешается вызывать метод, если еще не завершился предыдущий вызов;
не разрешается вызывать метод менее чем через 30 минут после предыдущего вызова.
В случае нарушений возвращается ошибка с соответствующим сообщением.
Веб-служба «Печать Наклейки»ОписаниеВеб-служба «Печать Наклейки» предоставляет сервис для формирования наклейки DPD по ранее созданному заказу.
РасположениеТестовая версия сервиса доступна по адресу:
http://wstest.dpd.ru/services/label-print?wsdlПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/services/label-print?wsdlДоступные методыМетод Назначение Входящее сообщение Ответное сообщение
createLabelFileФормирует файл с наклейками DPD. createLabelFilecreateLabelFileResponseАлгоритмыПеред вызовом метода в ИС DPD заказы должны быть сформированы, им присвоены номера DPD (например, 05120002MOW). Далее необходимо в метод передать список номеров заказов DPD и для каждого заказа количество необходимых наклеек (как правило, оно равно количеству мест в заказе). В ответ сервис вернет файл с наклейками DPD.
Формат файлаВозвращаемый файл имеет один из двух форматов, который задается во входящем сообщении:
PDF;
FP3 – формат генератора отчетов FastReport.
Формат области печатиРазмер наклейки – A6 (четвертушка стандартного листа A4). Возвращаемый файл формируется в одном из двух вариантов расположения наклеек на листах бумаги: в одну колонку (для узких принтеров) и две наклейки на ширине листа. Входящее сообщение содержит строковое поле Формат области печати, которое может содержать значения:
A6 – в одну колонку;
A5 – в две колонки.
Примечание. Если задан формат A5, то для каждого заказа первая наклейка печатается в левой части листа. То есть, если заказы включают по одной посылке, то наклейки разместятся в одну колонку.
Входящие сообщенияcreateLabelFile
Параметр Описание Тип Обязательный Пример
Внешний тэг getLabelFileAuth clientNumberВаш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKeyВаш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
fileFormatФормат файла.
Возможные значения: PDF, FP3 Срока Да PDF
pageSizeФормат области печати.
Возможные значения: A5, A6. Да A5
order Массив данных, относящихся к каждому конкретному заказу orderNumНомер заказа DPD Строка Да 05120002MOW
parcelsNumberКол-во наклеек для формирования Число Да 3
Исходящие сообщенияcreateLabelFileResponse
Параметр Описание Тип Обязательный Пример
file Файл Массив байтов order Массив данных, относящихся к каждому конкретному заказу orderNumНомер заказа DPD Строка 05120002MOW
status Статус Строка OrderPending
errorMessageСообщение об ошибке Строка Не заполнен параметр «Улица»
Веб-служба «Отмена заказа»ОписаниеВеб-служба «Отмена заказа» предоставляет клиентам сервис, который позволяет без звонка в 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 Статус изменения заказа. Возвращается в ответном сообщении. Возможные статусы перечислены в разделе «Статусы» Строка Да Cancelled
errorMassageТекст сообщения об ошибкеСтрока Статусы
Код Status Описание
Cancelled Операция выполнена успешно
Cancelled_previouslyОтменено ранее
Error Текст сообщения об ошибкеТекст сообщений об ошибкеОтмена заказа невозможна, возникла ошибка:  <Описание проблемы>
Описание проблемы:
Получены не все данные на вход
Полученные данные некорректны
Не найден заказ \ заявка \ отправка
Веб-служба «Справочная информация»ОписаниеВеб-служба «Справочная информация» предоставляет клиентам различную справочную информацию
РасположениеТестовая версия сервиса доступна по адресу:
http://mowwww101:80/services/inquiry-desk?wsdlПромышленная версия сервиса доступна по адресу:
http://ws.dpd.ru/services/inquiry-desk?wsdlДоступные методыМетод Назначение Входящее сообщение Ответное сообщение
getClientNumByINNОпределение клиентского номера в системе DPD по ИНН Входящие сообщения Исходящие сообщенияАлгоритмыПодготавливаем данные для аутентификации входного запроса и вызываем нужный метод.
Получаем ответное сообщение или сообщение об ошибке
Входящее сообщенияПараметр Описание Тип Обязательный Пример
Внешний тэг request Auth clientNumberВаш клиентский номер в системе DPD (номер вашего договора с DPD) Число Да 1000000000
clientKeyВаш уникальный ключ для авторизации, полученный у сотрудника DPD Строка Да 1FD890C3556
clientINNИНН компании, чей клиентский номер необходимо определить Число Да 1234567890
Параметры ответного сообщения
Параметр Описание Тип Обязательный Пример
clientINNИНН компании, чей клиентский номер необходимо определить Число Да 1234567890
clientNumberНомер в системе DPD, определенный по ИНН Число Да 1000000000
statusСтатус определения клиентского номера.
Возможные статусы перечислены в разделе «Статусы» Строка Да ОК
errorMassageТекст сообщения об ошибке в зависимости от статуса Строка Статусы
Код Status Описание
ОК Определение клиентского номера по ИНН завершено успешно
no-data-foundВ системе DPD не существует клиентского номера, зарегистрированного с искомым ИНН
too-many-rows По заданному ИНН в системе DPD существует несколько клиентских номеров, зарегистрированных с искомым ИНН. Просьба обратиться в DPD
no-setting Нет разрешения на оплату не заказчиком перевозки. Просьба обратиться к Вашему менеджеру в DPD
Справочник ошибокОбщие ошибкиКод ошибки Текст ошибки Примечание
system-error Системная ошибка Не типизированная ошибка. Обратитесь на [email protected]
too-many-calls Превышен лимит одновременных вызовов сервиса На сервере DPD установлено ограничение на частоту вызовов сервиса с одного клиентского номера. Попробуйте уменьшить частоту вызова сервиса.
call-client-twin Повторный вызов сервиса по одному коду клиента На сервере DPD установлено ограничение на количество одновременных вызовов сервиса. Попробуйте уменьшить частоту вызова сервиса.
client-num-error Не найден номер клиента На сервере DPD установлено ограничение, не допускающее более одного вызова сервиса с одного клиентского номера. Попробуйте уменьшить частоту вызова сервиса.
auth-error Ошибка в параметрах аутентификации Уникальный ключ клиента не соответствует номеру клиента. Обратитесь на [email protected]
required-value Не заданы значения обязательных полей Проверьте алгоритм заполнения всех обязательных полей входного сообщения.
error-value        Недопустимое значение поля Проверьте алгоритм заполнения полей, имеющих ограниченный набор значений («Услуга», «Вариант доставки» и пр.)
Ошибки службы «Расчёт стоимости»Код ошибки Текст ошибки Примечание
no-service-availableНевозможна услуга, удовлетворяющая запросу Доставка груза по данной услуге невозможна. Попробуйте задать другое направление, услугу или дату доставки.
no-data-foundДанные не найдены По заданным параметрам не найден пункт отправления и пункт назначения.
too-many-rowsНайдено более одной записи данных По заданным параметрам найдено более одного пункта отправления и пункта назначения.
Ошибки службы «Создание заказа»Код ошибки Текст ошибки Примечание
no-data-foundДанные не найдены По заданным параметрам не найдено ни одного заказа. Проверьте корректность указанного номера или попробуйте изменить дату приёма груза.
too-many-rowsНайдено более одной записи данных По заданным параметрам найдено более одного заказа. Попробуйте указать дату приёма груза, чтобы сузить область поиска.
Ошибки службы «Отслеживание статуса»Код ошибки Текст ошибки Примечание
no-data-foundДанные не найдены По заданным параметрам не найдено ни одного заказа. Проверьте корректность указанного номера или попробуйте изменить дату приёма груза.
too-many-rowsНайдено более одной записи данных По заданным параметрам найдено более одного заказа. Попробуйте указать дату приёма груза, чтобы сузить область поиска.
no-settingНе предусмотрены настройки Для указанного клиента не указаны настройки службы отслеживания. Обратитесь к вашему менеджеру или напишите на [email protected]
date-before-startДата запрошенного объекта ранее подключения клиента к сервису Вы можете получать статусы заказов, созданных в системе после вашего подключения к сервису. Выдача статусов «задним числом» не поддерживается.
confirm-not-requiredЗапрос не предполагает подтверждения Вы попытались вызвать запрос подтверждения, но ваши настройки не предполагают подтверждения. Обратитесь на [email protected], чтобы изменить эти настройки.
Ошибки службы «Создание адреса с кодом»Код ошибки Текст ошибки Примечание
code-already-existsАдрес с указанным кодом уже существует Адрес с указанным кодом уже существует. Обратитесь к вашему менеджеру или напишите на [email protected]
address-errorАдрес не может быть создан. Не для всех параметров адреса заданы значения. Необходимо указать недостающие значения.
code-not-foundАдрес с указанным кодом не найден. По указанному коду не найден адрес. Необходимо создать адрес.
Ошибки службы «Печать Наклейки»Код ошибки Текст ошибки Примечание
no-data-foundЗаказ № для клиента № не найден Ошибка в номере заказа
input-data-errorУ заказа № дата забора ранее текущей даты Заказ устарел
illegal-stateСостояние заказа № не позволяет создавать наклейки Заказ уже переведен в состояние, не позволяющее формировать наклейки. Например, посылки уже получены у клиента.
КонтактыПо всем вопросам, связанным с использованием нашего интеграционного модуля, обращайтесь в службу информационной поддержки DPD: [email protected]

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

  • docx 7047900
    Размер файла: 840 kB Загрузок: 0

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