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

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

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

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

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

Подключение

Примечание

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

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

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

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

Важно!

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

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

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

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

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

Склады

На шаге «Склады» можно для каждого склада указать точное соответствие города из справочника 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, триггерах, пользовательской валидации, типах цен, быстрых ответах в чате.