Настройка интеграции с службой доставки DPD
Скопировать ссылку на статью
Скопировано

Предварительная настройка со стороны DPD

Для интеграции со службой доставки DPD необходимо получить клиентский номер и интеграционный ключ. Для этого зайдите в личный кабинет DPD. В правом верхнем углу будет указан «Номер клиента». В левом меню перейдите в раздел «Получение ключа интеграции» и следуйте инструкциям. После получения интеграционный ключ будет отображаться в этом разделе.

Предварительная настройка системы

Перед подключением модуля требуется выполнить следующие настройки в системе:

  • Указать время работы и адрес для складов (Настройки - Магазины - Склады), которые будут использованы в работе при оформлении заказов
  • В настройках магазина (Настройки - Магазины) необходимо указать страну (она будет по умолчанию устанавливаться в карточке заказа) и доступные склады.

Подключение

Примечание

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

Модуль интеграции со службой DPD располагается в «Настройках» системы в разделе «Маркетплейс», в блоке «Доставки». Кликните по модулю интеграции, а затем по кнопке «Подключить» для перехода к настройкам. При первом подключении нужно будет пройти несколько шагов:

Настройки подключения DPD

На этом шаге нужно ввести клиентский номер и ключ, который Вы получили на этапе предварительной настройки DPD. В поле «Дополнительная информация аккаунта» можно ввести строку, определяющую данное подключение в системе.

Важно!

Если при попытке подключения аккаунта возвращается ошибка Клиент не подписан на Web сервис Event Tracking либо Не предусмотрены настройки (Subsribe), нужно обратиться в техподдержку DPD с просьбой подключить отслеживание getEvents для указанного клиентского номера.

Сопоставление статусов

Настройте соответствие статусов DPD статусам заказа системы. Данное сопоставление позволяет автоматически изменять статус заказа в системе в зависимости от статуса доставки. Указывать соответствия всем статусам необязательно. Для разных статусов DPD допускается указание одинаковых статусов системы.

Code Name Code Name
no-data-found Заказ не найден 2407 Получатель отсутствует на адресе доставки
OrderPending Заказ отправлен на ручную обработку 2408 Указан неправильный адрес доставки
OrderDuplicate Дубль заказа 2409 Задержано на таможне
OrderError Заказ не может быть создан 2410 Другие проблемы при доставке
1001 Получена заявка 2411 Отказано в таможенном оформлении по причине неуплаты таможенных пошлин
1101 В заявке присутствует ошибка 3701 Заказ поврежден
1201 Запрошены паспортные данные получателя 2501 Услуга не оказана
1301 Отмена заявки 2601 Произведен предварительный расчет стоимости доставки
1401 Заказ создан 2602 Выставлен счет
1501 Заказ ожидает дату приема 2701 Наложенный платёж принят у получателя
1601 Заказ принят у отправителя 2801 Наложенный платёж перечислен интернет-магазину
1701 Заказ прибыл в страну доставки 2901 Заказ отменен
1801 Закончено таможенное оформление 3001 Произведен расчет стоимости за платное хранение
1802 Прибыл на первый сортировочный комплекс DPD 3201 Перенос даты доставки по инициативе DPD
2101 Заказ следует по маршруту до терминала доставки 3202 Изменены условия доставки получателем во время доставки
2102 Заказ следует по маршруту до терминала возврата 3203 Изменены условия доставки получателем через веб-службу «Управление доставкой
2201 Заказ готов к выдаче на пункте 3204 Изменены условия доставки получателем через call-centre
2202 Заказ готов к передаче курьеру для доставки 3205 Изменена дата доставки
2203 Заказ на возврат готов к выдаче 3206 Изменена дата доставки по инициативе DPD
2204 Заказ на возврат готов к передаче курьеру для доставки 3211 Перенос даты доставки по инициативе DPD(уменьшение)
2205 Таможенное оформление в стране отправления 3216 Изменена дата доставки по инициативе DPD(уменьшение)
2301 Заказ доставляется получателю 3301 Заказ утилизирован
2302 Таможенное оформление закончено в стране отправления 3302 Посылка не востребована
2303 Отправка на транзитном терминале за рубежом 3303 Заказ утерян
2304 Доставляется получателю за рубежом 3304 Заказ доставлен до двери
2305 Возвращается отправителю из-за рубежа 3305 Заказ выдан на ПВЗ
2306 Заказ готов к доставке за рубежом 3306 Заказ на возврат доставлен
2307 Проблема при доставке за рубежом 3401 Накладная в электронном архиве
2309 Заказ доставляется отправителю 3501 N-я повторная бесплатная доставка
2310 Передано спецперевозчику 3601 N-я повторная платная доставка
2401 Истек срок бесплатного хранения заказа 3901 Направлено сообщение Email
2402 Оплата за товар по заказу не произведена получателем 4001 Звонок получателю
2404 Отказ от заказа в момент доставки 4101 Направлено сообщение SMS
2405 Отказ от заказа по желанию получателя через веб-службу «Управление доставкой crmDeleted Удален
2406 Отказ от заказа по желанию получателя через контакт центр


Доступные типы оплат

На этом шаге укажите, какие типы оплат будут доступны для нового типа доставки. Флаг в колонке «Наложенным платежом» означает, что с этим способом оплаты можно отправлять заказ наложенным платежом.

Склады

На шаге «Склады» можно для каждого склада указать точное соответствие города из справочника DPD, терминал, который по умолчанию будет подставляться при оформлении заказа, номер телефона склада, а также номер регулярного заказа. Номер регулярного заказа нужен, если используете доставку на регулярной основе. Уточните этот номер у своего менеджера DPD. В случае, если используется несколько номеров регулярных заказов для одного склада используйте опцию «Номера регулярных заказов». При отправке товара с терминала отгрузки, то на странице требуется указать сопоставление склада, созданного в системе, с терминалом и городом отгрузки DPD (является обязательным для заполнения). Выбор доступных городов появляется при вводе любого символа в соответствующее поле.

Опция «Номера регулярных заказов» позволяет добавлять и изменять список номеров регулярных заказов. При заполнении опции, то есть при добавлении одного или более номеров регулярных заказов в модуле, в карточке заказа в системе появляется поле «Номер регулярного заказа». С помощью этого поля для конкретного заказа в системе можно выбрать один из добавленных номеров заказа в настройках модуля, либо выбрать использование номера регулярного заказа (вариант «По умолчанию»), который указан в настройках соответствия склада в модуле. Поле не является обязательным для заполнения. При отсутствии заполнения поведение модуля то же, что и при выборе варианта «По умолчанию». Если в модуле опция не заполнена, то в карточке заказа в системе поле «Номер регулярного заказа» отображаться не будет.

Список терминалов отгрузки зависит от города, указанного в настройках склада в системе.

Уведомление «Не найдены терминалы» может быть отображено, если в настройках склада в системе неверно задан адрес (он должен быть связан с Geohelper), проверьте заполнение полей «Регион» и «Город».

Настройки интеграции

Заполните настройки интеграции.

Поле «Тип плательщика по умолчанию» - можно указать, кто будет по умолчанию оплачивать заказ: «Отправитель» (магазин) или «Получатель» (клиент).

Поле «Стоимость доставки» позволяет выбрать два варианта:

  • «Рассчитывается автоматически службой доставки» - стоимость будет передаваться автоматически из DPD при выборе типа доставки и сохранении заказа.
  • «Задается вручную» - стоимость доставки указывается вручную или же передается по API.

При включенной настройке «Нулевая объявленная стоимость по умолчанию» объявленная стоимость товаров в заказе при оформлении будет равна нулю.

«По умолчанию не синхронизировать со службой доставки» - при активации данной настройки заказ будет добавляться с включенным флагом «Не синхронизировать со службой доставки», то есть изменения заказа не будут передаваться в DPD при сохранении заказа.

Для указания даты приёма груза, в том случае, когда эта дата не совпадает с датой отгрузки, нужно включить настройку «Отображать поле "Дата приема груза"»

Настройка «Отображать поля "Общее количество грузомест" и "Общий объём"». При её включении в карточке заказа дополнительно отображаются два поля:

  • «Общее количество грузомест (посылок)» - позволяет указать общее количество грузомест, если в составе заказа имеется составной товар (одна позиция товара содержит несколько грузомест). Поле не является обязательным для заполнения. При отсутствии значения, число грузомест будет сформировано по количеству упаковок в заказе.
  • «Общий объём (куб. м)» - позволяет указать общий объём всех грузомест в заказе. Поле не является обязательным для заполнения. При отсутствии значения, общий объём будет расчитан по габаритам всех упаковок.

Опция «Отображать фильтр по типу ПВЗ в карточке заказа». При активации опции, в системе появится дополнительное поле «Доступные типы ПВЗ при расчете» со списком значений: «Все типы», «Пункты приема/выдачи посылок (ПВП)», «Постаматы (П)», «Терминалы». При выборе конкретного значения, в списке тарифов будет выводиться только этот тип ПВЗ. Также доступно указать значение по умолчанию для этого поля на странице модуля «Значения по умолчанию».

Следующими тремя настройками можно регулировать учет комиссии за наложенный платеж: включить комиссию в стоимость доставки, указать ставку и минимальную сумму комиссии.

Пример использования комиссии за наложенный платёж: сумма заказа 10’000р., сумма доставки 500 р., комиссия 5%:

  • Настройка «Добавлять комиссию за наложенный платеж в стоимость доставки» не включена. Тогда с покупателя будет взята сумма в размере 10’500 р., из которых продавец платит комиссию 5% = 525 р. и сумму доставки 500 р. Итоговый доход = 9’475 р.
  • Настройка «Добавлять комиссию за наложенный платеж в стоимость доставки» включена. Тогда покупателю будет выставлена сумма 11’052,63 р., из которых продавец платит комиссию 5% = 552,63 р. и сумму доставки 500 р. Итоговый доход = 10’000 р.

Для использования дополнительных услуг «Электронное сообщение о доставке груза получателю» и «Электронное сообщение о приеме заказа» необходимо заполнить «E-mail для получения уведомлений».

Опции «Статус для возвращенных товаров» и «Статус для доставленных товаров» позволяют передавать статус товара при полной и частичной доставке.

В случае полной доставки или полного возврата, соответствующий статус проставляется всем товарам. Если в заказе были товары в статусе отмены, модуль их игнорирует. В случае частичной доставки, статусы передаются соответствующим товарам.

Важно!

API DPD не работает с маркированными товарами. Поэтому при частичной доставке, если есть несколько единиц позиции с маркировкой, позиция будет разделена и будут установлены соответствующие статусы, но конкретные маркировки в итоговых позициях будут распределены случайным образом.

Возможные ошибки и причины пропуска обработки частичной доставки:

  • Наличие в заказе системы нескольких товаров с одинаковым артикулом и названием.
  • Если товар из DPD не был найден в заказе системы (по артикулу и названию).

Условия для обработки частичной доставки в заказе:

  • Заказ в DPD перешел в конечный статус;
  • Заказ в DPD перешел в конечный статус, и в нем имеется список товаров;
  • Установлен хотя бы один из двух статусов для товаров в настройках («Статус для возвращенных товаров» /«Статус для доставленных товаров»)
  • Успешная обработка частичной доставки может проходить только один раз (с обновлением списка товаров в заказе системы)

Важно!

Для корректной работы частичной доставки необходимо включить в настройках системы (НастройкиСистемныеЗаказ) опцию «Возможность добавлять в заказ одинаковые торговые предложения как разные позиции» - это нужно для возможности разбивки одинаковых товарных позиций на несколько, для указания разных статусов, при неполном возврате.

Опция «Включить передачу артикулов» передает выбранное свойство товара в качестве артикула в заказ DPD. По умолчанию активна. При отключении данной настройки артикул товара не будет передаваться в заказ DPD, что исключит работу с частичной доставкой. Также станет недоступна опция «Передавать как артикул заказа».

Опция «Содержимое отправки» позволяет выбрать, каким образом модуль заполняет «Содержимое отправки» (в накладной DPD - «Описание содержимого») при оформлении заказа в DPD. Поддерживается два варианта:

  • Передавать названия групп товаров заказа — поведение по-умолчанию, модуль передает категорию (группу) товара из системы и передает ее название как содержимое отправки.
  • Указывать вручную — при этом варианте в карточке заказа системы появляется поле «Содержимое отправки», в котором можно указать в строчном виде необходимое значение. Также при выборе этого варианта в настройках модуля появляется опция «Cодержимое отправки по-умолчанию», для указания значения по-умолчанию для поля «Содержимое отправки».

Опция «Передавать как артикул заказа» позволяет выбрать определённое свойство товара, которое будет использоваться в качестве артикула при передаче данных в заказ DPD. По умолчанию выбрано свойство «Артикул».

Особенности работы опции:

  • Если выбранное свойство товара не заполнено, вместо него в качестве артикула передается xmlId товара.
  • В случае, если свойство товара или xmlId отсутствуют либо их длина превышает 50 символов, артикул не передается в заказ DPD.
  • Если в качестве артикула планируется передавать другое свойство товара, необходимо добавить его в раздел «Дополнительные свойства товаров» по пути НастройкиСистемныеТоварыВывод свойств товаров.

Значения по умолчанию

На этой вкладке можно указать значения по умолчанию для заполняемых во время формирования заказа полей, указать интервалы времени приема и доставки груза, комментарий к заказу и отметку «ценный груз», означающую, что товары заказа требуют дополнительных мер безопасности, снижающих риск их утери или повреждения при перевозке.

Также по умолчанию можно задать дополнительные услуги, которыми ваш магазин чаще всего пользуется. Рассмотрим некоторые из них:

  • SMS и email уведомления - выберите опции, и адресат будет информирован о местонахождении отправки и готов к ее получению.
  • Возврат документов отправителю - воспользуйтесь опцией, если необходимо вернуть сопроводительные документы на груз (товарную накладную, акты приема-передачи), заверенные получателем.
  • Температурный режим - выберите услугу, если при транспортировке ваших посылок и грузов по России необходимо обеспечить температуру не ниже +5°C.
  • Возврат части отправки - например, покупатель может примерить товары и выбрать те, которые готов оплатить. Остальное будет возвращено отправителю. Услуга доступна только в РФ и РБ.
  • Доставка крупногабаритных посылок - воспользуйтесь разгрузкой крупногабаритных и тяжелых посылок и подъемом их в то или иное место на любом этаже вашего здания.
  • Обрешетка - жесткая упаковка для посылки в виде деревянного каркаса. Активируйте опцию для перевозки хрупких, бьющихся, крупногабаритных и нестандартных грузов. С другими опциями можно ознакомиться на сайте DPD.

При включении дополнительной услуги «Ожидание на адресе» можно указать причину ожидания: «С примеркой», «Простая» и/или «С проверкой работоспособности». Для дополнительной услуги «Возврат части отправки» можно указать тип комплектности, сумму за доставку и минимальную сумму выкупа.

Завершение установки

При нажатии на кнопку «Завершить установку», настройка модуля будет завершена. После, откроется форма личного кабинета, где будет отображен весь список подключенных аккаунтов.

Управление аккаунтами

На странице «Личный кабинет» выводится список подключенных аккаунтов DPD. Перейти в режим редактирования аккаунта можно нажав на кнопку «Редактировать». Добавить новый аккаунт можно нажав на кнопку «Добавить аккаунт».

Важно!

Если ранее вы пользовались данными из справочника объектов для DPD, то чтобы данные поля работали для нового модуля, требуется брать наименование полей из Данных службы доставки, подключенной через API. Данные поля могут быть использованы в печатных формах, письмах, SMS, триггерах, пользовательской валидации, типах цен, быстрых ответах в чате.

Благодарим за отзыв.
Была ли статья полезна?
Нет
  • Рекомендации не помогли
  • Нет ответа на мой вопрос
  • Текст трудно понять
  • Не нравится описанный функционал
Да
Предыдущая статья
Возможности модуля DPD
В статье описаны все возможности и особенности работы с модулем DPD.
Следующая статья
Работа с DPD в карточке заказа
Оформление заявки на доставку в службе доставки DPD через заказ в системе.