↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Продажі та документи
    4. Обробка замовлень покупця
    5. Служби доставки в Elbuz

    DHL Parcel Polska в Elbuz: накладні DHL24 із замовлення і статуси

    8 хв читанняОновлено

    Elbuz виписує посилку DHL Parcel Polska прямо з картки замовлення, відкриває етикетку PDF і кожні 10 хвилин приносить статус посилки. Заходити в DHL24 для кожної відправки не потрібно.

    Коли це знадобиться:

    • Відправляєте по Польщі за договором з DHL — одержувач, адреса, вага й сума наложки підставляються із замовлення.
    • Покупець платить при отриманні — для неоплаченого замовлення з наложеним платежем сума ставиться сама.
    • Клієнти чекають посилку зранку — продукт DHL Domestic 09 чи Domestic 12 обирається один раз у підключенні.
    • Менеджери не мають доступу до DHL24 — етикетка і статус посилки відкриваються в Elbuz.

    З чого почати: отримайте ключ WebAPI в DHL24 → впишіть його в запис DHL в Elbuz.

    Що вміє DHL Parcel Polska в Elbuz

    Виклик кур'єра, доставка в пункти DHL і зміна накладної — у DHL24.

    Як підключити DHL24 WebAPI

    Де взяти логін і пароль WebAPI DHL24

    Логін і пароль WebAPI — окремий ключ, а не вхід до кабінету DHL24. DHL видає ключі лише клієнтам з активним договором і номером SAP.

    1. Увійдіть у DHL24 обліковим записом, прив'язаним до договору.
    2. Відкрийте сторінку «Integracje», розділ «Klucze APIv2 / API PS»: там ключ і скидання пароля.
    3. Якщо розділ порожній, запросіть доступ формою техпідтримки DHL24, тема «WebAPI - uzyskanie dostępu».

    Номер клієнта SAP — семизначний номер платника за договором. На нього DHL виставляє рахунки за посилки з Elbuz.

    Для перевірки без реальних відправок зареєструйтеся на sandbox.dhl24.com.pl: пісочниця видає окремі логін і пароль. Опис WebAPI — у документації DHL24; для роботи в Elbuz він не потрібен.

    Куди вписати ключ в Elbuz

    Де: «Зовнішні сервіси та інтеграції», група «Доставка» → запис «DHL Parcel (Польша, DHL24)».

    Форма підключення DHL Parcel (Польща, DHL24): логін, номер клієнта SAP, продукт, sandbox і відправник
    1Користувач і пароль WebAPI
    2Номер клієнта (SAP)
    3Продукт за замовчуванням
    4Тестове середовище (sandbox)
    5Блок «Відправник»
    1. Користувач і пароль — логін і пароль WebAPI, які видає DHL24.
    2. Номер клієнта (SAP) — ваш номер клієнта в DHL24.
    3. Продукт за замовчуванням — послуга, з якою створюються накладні.
    4. Тестове середовище (sandbox) — перемикач тестового режиму.
    5. Відправник — дані вашої компанії для накладної.
    ПолеЩо вписати
    «Користувач», «Пароль»логін і пароль WebAPI
    «Номер клієнта (SAP)»номер платника з договору; без нього накладна не створиться
    «Продукт за замовчуванням»«Przesyłka krajowa (AH)» — звичайна доставка; «Domestic 09» і «Domestic 12» — доставка до 9:00 чи до 12:00. «Connect (EK, міжнародна)» у списку є, але одержувач з Elbuz завжди в Польщі
    «Тестове середовище (sandbox)»увімкніть для ключа з пісочниці; для роботи — вимкніть
    Блок «Відправник»назва, індекс, місто, вулиця, дім, контактна особа, телефон, e-mail; перші чотири обов'язкові
    «Активність»увімкніть

    Поля «Токен», «Посилання на сервер API» і «API ver» для DHL не заповнюють. Кнопки «Зберегти» немає: кожна зміна поля зберігається одразу.

    Пароль після збереження показується крапками. Порожнє поле його не стирає; щоб замінити, впишіть новий поверх.

    Під час збереження ключ не перевіряється. Помилковий ключ проявиться лише на першій накладній — текстом помилки від DHL. Ключ із пісочниці працює тільки з увімкненим «Тестове середовище (sandbox)», бойовий — тільки з вимкненим.

    Як виписати накладну DHL із замовлення

    Спосіб доставки в замовленні має бути «DHL Parcel (PL)». Зі способом «DHL» посилання «Створити накладну» не з'являється.

    Де: картка замовлення → «Доставка» → «Створити накладну». Якщо форму вже відкривали, посилання називається «Редагувати накладну».

    Що форма заповнить сама і що перевірити

    Форма створення накладної DHL Parcel (PL) із даними одержувача з замовлення
    1Адреса одержувача
    2Загальна вага, кг
    3Оголошена вартість, zł
    4Опис відправлення
    5Зворотна доставка (одержувач)
    1. Адреса одержувача — індекс, місто, вулиця й дім беруться із замовлення.
    2. Загальна вага, кг — вага посилки.
    3. Оголошена вартість, zł — сума оголошеної вартості.
    4. Опис відправлення — що всередині посилки.
    5. Зворотна доставка (одержувач) — «Не потрібно», бо замовлення оплачено.
    ПолеЩо стоїть одразуЩо перевірити
    «Прізвище», «Ім'я», «Телефон», «E-Mail»покупець із замовленнябез телефону DHL накладну не прийме
    «Індекс», «Населений пункт», «Вулиця»адреса доставки із замовлення«Дім» і «Квартира» порожні — впишіть, якщо номера немає у рядку вулиці
    «Загальна вага, кг»вага товарів × кількістьпорожня — у накладну піде 1 кг
    «Довжина», «Ширина», «Висота», смпорожніпорожні — піде 30 × 20 × 10 см
    «Оголошена вартість, zł»сума замовленняна цю суму DHL страхує посилку; очищене поле теж дасть суму замовлення
    «Опис відправлення»категорія товару, без неї — список товарівобов'язковий; до DHL піде 100 символів
    «Зворотна доставка (одержувач)»«Гроші» на суму замовлення, якщо воно не оплачене й оплата — наложений платіж; інакше «Не потрібно»оплатили карткою, а оплату не відмічено — поставте «Не потрібно»

    Суми у формі — у злотих. Якщо замовлення в іншій валюті, виправте суму наложки й оголошену вартість вручну.

    Відправника, номер SAP і продукт форма бере з підключення. Номер замовлення йде в посилку як референс, одержувач — завжди в Польщі. Дата відправки — сьогодні, у суботу й неділю — найближчий понеділок.

    Що відбувається після «Створити накладну»

    • Номер посилки DHL лягає в поле «Сервіс доставки: номер», з'являється «Створено товарно-транспортну накладну №‹номер›». Цей номер DHL використовує і для відстеження.
    • У картці замість «Створити накладну» стоїть «Перегляд накладної».
    • Друга накладна на те саме замовлення не створиться: «Накладну вже створено: ‹номер› — пропущено.»
    • Якщо DHL відмовив, з'явиться «Error:» з причиною; форма лишається відкритою, її значення збережено в замовленні.
    • Якщо у способі доставки «DHL Parcel (PL)» заповнено «Посилання на трекінг», у замовлення запишеться й посилання на відстеження.

    Накладні по десятках замовлень одразу — «Створити ТТН (доставка)» у списку замовлень, детальніше: накладні пачкою.

    Етикетка і перегляд накладної

    Де: картка замовлення → «Перегляд накладної» → кнопка друку; або «Відправлення» → рядок → «Друк накладної».

    Elbuz сам забирає в DHL етикетку BLP у PDF і відкриває її в новій вкладці; пароль WebAPI в браузер не потрапляє. Якщо DHL відмовив, у вкладці буде «print error:» з причиною. У «Відправленні» етикетки DHL друкуються по одній.

    «Перегляд накладної» щоразу питає DHL про статус: угорі — «Статус:» з текстом DHL, унизу — «Детальна інформація API» з кодом статусу.

    Видалення накладної

    Де: картка замовлення → «Перегляд накладної» → «Видалити накладну»; або «Відправлення» → рядок → «Видалити накладну». Потрібне право створювати накладні.

    1. Підтвердьте «Видалити накладну ‹номер› у службі доставки?».
    2. DHL видаляє посилку, у картці зникають номер і посилання відстеження → «Накладну видалено. Замовлення можна оформити знову.»

    DHL видаляє посилку, доки на неї не замовлено кур'єра (документація DHL24). Інакше Elbuz покаже «Служба доставки не видалила накладну:» з відповіддю DHL — спершу скасуйте кур'єра в DHL24. Посилку, яку відстеження вже бачить у дорозі чи доставленою, Elbuz видалити не пропонує.

    Статуси посилок DHL

    Elbuz питає DHL про кожну посилку раз на 10 хвилин, до 100 посилок за прохід. Відстежуються замовлення за останні 60 днів і замовлення в позначених статусах. Усі посилки видно у «Відправленні».

    Коди статусів DHL

    Стан посилки Elbuz визначає за вашою таблицею кодів. Коди DHL програма сама не вписує, а повного списку DHL не публікує.

    1. Після перших посилок відкрийте «Перегляд накладної»: у «Детальна інформація API» рядок StatusCode — код DHL, Status — його опис.
    2. Підключення DHL → «Налаштування повідомлень» → «Статуси доставки». У колонці «Код (назва) на сайті (API)» впишіть код навпроти свого статусу; кілька кодів — через кому.
    3. Щоб сам мінявся статус замовлення чи оплати, так само заповніть «Статуси замовлення» і «Статуси оплати». Позначте статуси замовлень у блоці «Статуси замовлень, за якими перевіряти статус посилки в службі доставки».
    Ваш статус доставкиСтан у «Відправленні»
    «Чекання від відправника», «Зібрано»Створено
    «У дорозі», «На митниці», «Видана кур'єру»В дорозі
    «У пункті призначення»У відділенні
    «Доставлено», «Доставлено частково»Отримано — Elbuz більше не питає DHL про цю посилку
    «Відмова від отримання»Відмова
    код не вписаноНевідомо — посилка потрапляє у фільтр «Проблеми»
    Поки код доставки DHL не вписано в «Доставлено», Elbuz питає DHL про посилку всі 60 днів, а в «Відправленні» вона «Невідомо».

    Коли статус замовлення змінився за кодом, в історію замовлення пишеться «Змінився статус доставки: ‹код› ‹текст› #‹номер›». Кнопка «Відстеження на сайті служби» для DHL Parcel Polska відповідає «У цієї служби немає публічної сторінки відстеження.»

    Що лишається в DHL24

    • Зміна накладної — у DHL24; з Elbuz накладну можна лише видалити й виписати заново.
    • Виклик кур'єра — у DHL24 або за постійним забором за договором.
    • Доставка в пункт чи автомат DHL і відправки за кордон — Elbuz виписує посилки DHL лише на адресу в Польщі.

    Сценарії

    Перше підключення через пісочницю

    Ситуація. Договір з DHL щойно підписано, хочете перевірити накладні без реальних посилок.

    Що зробити. Зареєструйтеся на sandbox.dhl24.com.pl, впишіть тестові логін і пароль, увімкніть «Тестове середовище (sandbox)» і випишіть накладну з тестового замовлення. Потім впишіть бойові логін і пароль поверх тестових і вимкніть пісочницю.

    Що вийде. Помилки адреси відправника чи номера SAP ви побачите до першої справжньої відправки.

    Щоденне відвантаження

    Ситуація. Зранку 30 замовлень зі способом «DHL Parcel (PL)».

    Що зробити. Позначте їх у списку замовлень → «Створити ТТН (доставка)». Потім у «Відправленні» друкуйте етикетки по одній і віддайте посилки кур'єру DHL.

    Що вийде. Номери посилок — у замовленнях, стан кожної посилки оновлюється сам.

    Наложка й передоплата вперемішку

    Ситуація. Частину замовлень оплатили карткою, частину покупці оплатять при отриманні.

    Що зробити. Відмічайте оплату в замовленні до створення накладної.

    Що вийде. Неоплачені з наложеним платежем підуть із сумою наложки, оплачені — без неї.

    Що робити, коли щось пішло не так

    Розбір частих проблем
    Що ви бачитеЧому такЩо зробити
    «Служба доставки не підключена: заповніть налаштування API цієї служби…» у вікні накладної Не вписано пароль або вимкнено «Активність» Впишіть логін і пароль WebAPI, увімкніть «Активність» (куди вписати)
    У картці замовлення немає ні «Створити накладну», ні «Редагувати накладну» Спосіб доставки — «DHL», а не «DHL Parcel (PL)» Змініть спосіб доставки на «DHL Parcel (PL)» (накладна із замовлення)
    «Error: login/password is required (API settings)» Не вписано логін WebAPI Заповніть «Користувач» у підключенні
    «Error: account_number is required (API settings)» Не вписано номер клієнта SAP Заповніть «Номер клієнта (SAP)» у підключенні
    «Error: sender address is required (API settings)» У блоці «Відправник» порожня назва, індекс, місто чи вулиця Заповніть адресу відправника в підключенні
    «Error: phone is required for recipient» (або postcode, city, street) У замовленні немає телефону чи адреси одержувача Впишіть їх у формі накладної й створіть ще раз
    «Error: content is required for shipment» Порожній «Опис відправлення» Впишіть, що в посилці
    «Error:» з відмовою авторизації від DHL Неправильний ключ WebAPI або ключ пісочниці при вимкненому «Тестове середовище (sandbox)» чи навпаки Звірте ключ у DHL24 і перемикач пісочниці (ключ WebAPI)
    Посилки DHL у «Відправленні» в стані «Невідомо» Коди DHL не вписані в «Статуси доставки» Впишіть коди (коди статусів)
    «Накладну вже створено: ‹номер› — пропущено.», хоча посилку видалено в DHL24 Посилку видалено в DHL24, а не з Elbuz, — у замовленні лишився її номер Очистіть поле «Сервіс доставки: номер» і створіть накладну знову; надалі видаляйте з Elbuz (видалення)

    Часті запитання

    Скільки коштує інтеграція з DHL?

    Elbuz за накладні й статуси нічого не списує. Посилки ви оплачуєте DHL за своїм договором, на номер клієнта SAP.

    Чи можна відправити посилку DHL у пункт чи автомат?

    З Elbuz — ні, лише на адресу одержувача. Посилку в пункт DHL оформлюють у DHL24 або через Apaczka.

    Чи можна відправити DHL за кордон?

    Ні: в накладній з Elbuz одержувач завжди в Польщі. Міжнародні посилки оформлюйте в DHL24.

    Чи можна викликати кур'єра DHL з Elbuz?

    Ні. Кур'єра замовляють у DHL24 або домовляються з DHL про постійний забір.

    Пароль у формі показується крапками — він збережений?

    Так: крапки стоять, лише коли пароль збережено. Порожнє поле його не стирає.

    Чому статус у Elbuz відстає від DHL?

    Elbuz питає DHL раз на 10 хвилин і бере до 100 посилок за прохід. Поточний статус показує «Перегляд накладної» — він питає DHL щоразу.

    Де це і хто має доступ

    Меню
    Кабінет → Налаштування системи → Інші налаштування → Зовнішні сервіси та інтеграції → Доставка
    Інші входи
    Довідники → Документи → Відправлення → «Служби доставки»; картка замовлення → секція «Доставка»
    Право доступу
    підключення — «API та токени доступу»; накладна — вікно «Створення ТТН служби доставки»; посилки — «Відправлення»
    Підготувати
    договір з DHL Parcel Polska, номер клієнта SAP, логін і пароль WebAPI

    Накладну можна виписати лише для замовлення, яке користувач бачить за налаштуванням «Чиї дані».

    1. Отримати логін і пароль WebAPIDHL24 → Integracje
    2. Вписати ключ, номер SAP і адресу відправникаЗовнішні сервіси та інтеграції → DHL Parcel
    3. Вписати коди статусів DHLТам само, «Налаштування повідомлень»
    4. Виписати накладнуКартка замовлення, секція «Доставка»
    5. Надрукувати етикетку«Перегляд накладної» або «Відправлення»
    6. Видалити накладну, якщо треба«Перегляд накладної» або «Відправлення»

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно