Интеграция DPD на сайт: руководство с примерами кода на PHP

При интеграции DPD разработчики часто спотыкаются о SOAP-протокол: ошибки в теле ответа, собственная система кодирования городов, неочевидные поля для заказа. Например, чтобы создать заказ, нужно передавать коды городов из справочника DPD, а не КЛАДР — иначе API вернёт ошибку city not found. Для расчёта стоимости требуется объём груза: длина × ширина × высота / 1 000 000. Без готового SDK самостоятельная разработка занимает до 10 дней и может привести к ошибкам в обработке ответов. Мы накопили опыт на 15+ проектах и сократили этот срок вдвое. Профессиональная интеграция экономит до 30% на доставке за счёт выбора оптимального тарифа и кеширования справочников. Средний бюджет на интеграцию составляет от $500–1.5k в зависимости от сложности, но точная стоимость рассчитывается индивидуально.

Как подключить DPD API?

Установка SDK через Composer:

composer require dpd-ru/dpd-php-api-client 

Инициализация клиента с тестовым окружением:

use DPD\DPDClient;

$client = new DPDClient(
    username: config('services.dpd.username'),
    password: config('services.dpd.password'),
    clientNumber: config('services.dpd.client_number'),
    test: app()->environment('production') === false
);

Тестовая среда (test: true) работает на https://test.dpd.ru. Учётные данные для теста запрашиваются у менеджера DPD отдельно от боевых.

Основные методы интеграции

Ниже приведены ключевые функции: расчёт стоимости, поиск города, получение терминалов, создание заказа, отслеживание, печать накладной, вызов курьера.

// --- Расчёт стоимости ---
public function calculateDelivery(
    string $fromCityId, // код города DPD (не ISO)
    string $toCityId,
    float $weightKg,
    array $dimensions,
    float $declaredValue = 0
): array {
    $response = $this->client->getDPDOrderCost2([...]);
    // ... обработка
}

// --- Поиск города ---
public function findCity(string $cityName, string $countryCode = 'RU'): array {
    $response = $this->client->getCitiesCashPay([...]);
    // ...
}

// --- Пункты выдачи ---
public function getTerminals(?string $cityId = null): array {
    $response = $this->client->getTerminalsSelfDelivery2([...]);
    // ...
}

// --- Создание заказа ---
public function createOrder(Order $order): array {
    $response = $this->client->createOrder([...]);
    // ...
}

// --- Отслеживание ---
public function trackParcel(string $dpdOrderNum): array {
    $response = $this->client->getStatesByClient([...]);
    // ...
}

// --- Печать накладной ---
public function printLabel(string $dpdOrderNum, string $format = 'PDF'): string {
    $response = $this->client->createLabelFile([...]);
    // ...
}

// --- Вызов курьера ---
public function createPickupRequest(...): string {
    // ...
}

Настройка расчёта стоимости DPD: 5 шагов

1. Получите тестовые учётные данные у менеджера DPD.
2. Установите SDK через Composer.
3. Инициализируйте клиент с test: true.
4. Вызовите метод getDPDOrderCost2, передав коды городов, вес и габариты.
5. Обработайте ответ: проверьте статус, извлеките стоимость для каждой услуги.

Кеширование справочника городов сокращает количество запросов на 80%. Среднее время расчёта — менее 1 секунды.

Принцип расчёта стоимости DPD

Расчёт стоимости требует передачи кодов городов отправителя и получателя, веса и габаритов. DPD возвращает стоимость для каждой доступной услуги. SDK автоматически обрабатывает ответ и формирует массив с ценами. Сравнение стоимости разных служб позволяет автоматически выбрать самый выгодный вариант, что экономит до 30% на доставке.

Какие сервисы доставки DPD поддерживаются?

Дополнительно поддерживаются сервисы с особыми условиями, например, "Parcel Return" для возвратов.

Что выбрать: тестовое или боевое окружение?

Использование официального SDK сокращает время разработки в 2 раза по сравнению с самостоятельной реализацией SOAP-запросов.

Почему профессиональная интеграция надёжнее самостоятельной?

SOAP-спецификация DPD содержит множество нюансов: ответы возвращают ошибки в теле, а не HTTP-статусы; коды городов не совпадают с КЛАДР; требуется собственная система маппинга. Наши сертифицированные инженеры интегрировали DPD для 15+ проектов, поэтому гарантируем:

• Корректную обработку всех типов ответов (включая ошибки status !== 'OK')
• Оптимизацию запросов: кеширование справочника городов, распараллеливание расчётов
• Поддержку всех сервисов: от PCL до EXPRESS
• Сокращение сроков разработки до 5–7 дней для базовой интеграции

Профессиональная интеграция обходится на 40% дешевле самостоятельного внедрения за счёт отсутствия ошибок и потерь времени.

Когда нужна расширенная интеграция?

Расширенная интеграция включает вызов курьера, печать накладных (PDF/ZPL), поддержку мультисклада и возвратов. Такая интеграция занимает от 10 дней и требует глубокой настройки учётных записей. Если ваш интернет-магазин обрабатывает более 100 заказов в день, расширенная интеграция окупается за счёт автоматизации процессов.

Объём работ по интеграции DPD

• Подключение API DPD (получение доступов, настройка SDK)
• Реализация расчёта стоимости с выбором сервиса и учётом габаритов
• Интеграция карты ПВЗ с фильтрацией и отображением режима работы
• Создание заказов с автоматической передачей данных в DPD
• Отслеживание статусов и обновление статуса заказа в вашей системе
• Печать накладных в форматах PDF или ZPL для термопринтеров
• Вызов курьера для забора отправлений
• Тестирование на тестовом и боевом окружениях
• Документация по интеграции и поддержка в течение месяца после запуска

Сроки и стоимость

Базовая интеграция (расчёт, ПВЗ, создание заказа, отслеживание) — от 5 до 7 дней. Расширенная интеграция (включая вызов курьера, печать накладных, мультисклад) — от 10 дней. Стоимость рассчитывается индивидуально на основе объёма работ. Свяжитесь с нами для оценки вашего проекта — мы подготовим коммерческое предложение за 1 день. Получите консультацию по интеграции DPD прямо сейчас.

Типичные проблемы самостоятельной интеграции

• Ошибки в ответах: DPD не использует HTTP-статусы, каждая операция требует проверки status в теле ответа.
• Коды городов: требуется отдельный поиск через getCitiesCashPay, так как DPD использует свою нумерацию.
• Объём груза: параметр volume вычисляется в кубических метрах, ошибка в формуле приводит к некорректной стоимости.
• Тайм-ауты: запросы к тестовой среде могут быть медленными, рекомендуется кеширование справочников.