Інтеграція DHL Parcel Poland

Модуль DHL інтегрує WooCommerce з REST API DHL Parcel Poland. Генеруйте етикетки, відстежуйте відправлення та пропонуйте пункти ServicePoint під час оформлення замовлення.

Налаштування

Перейдіть до WooCommerce > Налаштування > Polski PRO > Доставка.

Автентифікація API

Налаштування	Опис
Ключ API DHL	Bearer token з DHL Developer Portal
Номер рахунку DHL	Номер рахунку клієнта DHL Parcel Poland

Ключ API отримаєте, зареєструвавшись на developer.dhl.com та створивши застосунок з доступом до DHL Parcel Poland API.

Увімкнення модуля

Перейдіть до Polski PRO > Модулі
Увімкніть модуль DHL Parcel Poland
Заповніть ключ API та номер рахунку в налаштуваннях доставки

Генерування етикеток

Етикетки генеруєте з рівня редактора замовлення:

Відкрийте замовлення в WooCommerce > Замовлення
У секції Shipment Tracking виберіть перевізника DHL
Натисніть Згенерувати етикетку
Система створить відправлення через DHL REST API і поверне номер відстеження + посилання на PDF-етикетку

Типи послуг

Тип	Опис
AH	Стандартна доставка за адресою (за замовчуванням)
AP	Доставка до ServicePoint / поштомата DHL

Для послуг AP (ServicePoint) потрібно вказати ID пункту видачі.

Дані відправлення

Модуль автоматично отримує із замовлення дані одержувача та вагу продуктів. Стандартні розміри посилки: 40x30x20 см.

DHL ServicePoint

Модуль дає змогу шукати пункти ServicePoint (POP та поштомати DHL):

Пошук за містом
Пошук за координатами GPS (радіус 5 км)
Повертані дані: назва, адреса, тип (POP/поштомат), координати

Відстеження відправлень

Після генерування етикетки номер відстеження автоматично зберігається. Посилання на трекінг DHL генерується у форматі:

https://www.dhl.com/pl-pl/home/sledzenie-przesylek.html?tracking-id={numer}

Клієнт отримує лист з номером відстеження при зміні статусу на Відправлено.

Коди помилок

Код	Опис	Рішення
HTTP 401	Неправильний ключ API	Перевірте Bearer token у налаштуваннях
HTTP 400	Неправильні дані відправлення	Перевірте адресу, поштовий індекс та номер рахунку
HTTP 429	Ліміт запитів API	Зачекайте хвилину і спробуйте знову

Фільтри та дії

// Filtruj dane przesyłki przed wysłaniem do DHL
add_filter('polski_pro/shipping/dhl/parcel_data', function (array $data, WC_Order $order): array {
    $data['service_type'] = 'AP'; // Wymuś dostawę do ServicePoint
    $data['servicepoint_id'] = 'PL-12345';
    return $data;
}, 10, 2);