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

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

    InPost в Elbuz: відправлення в пачкомат і кур'єром через ShipX API

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

    Elbuz створює відправлення InPost прямо із замовлення: пачкомат підбирається з адреси покупця, номер відстеження сам лягає в замовлення, етикетка друкується з картки.

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

    • Покупці обирають пачкомат на сайті чи маркетплейсі — код точки з адреси замовлення підставляється у форму сам.
    • Замовлення з оплатою при отриманні — сума наложеного платежу (pobranie) береться із замовлення.
    • Посилка не влазить у пачкомат — той самий запис відправляє її кур'єром InPost на адресу.
    • Треба знати, де посилка — кожні 10 хвилин статус InPost оновлюється в замовленні й у реєстрі «Відправлення».

    З чого почати: створіть токен ShipX у Manager Paczek → впишіть його й ID організації в Elbuz.

    Що вміє InPost в Elbuz

    • Відправлення із замовлення — у пачкомат або кур'єром, з наложеним платежем і оголошеною вартістю.
    • Підбір пачкомата — за кодом точки в адресі замовлення або списками «Воєводство» → «Населений пункт» → «Точка InPost».
    • Етикетка PDF — з картки замовлення і з реєстру «Відправлення», без входу в Manager Paczek.
    • Статуси посилок — кожні 10 хвилин; замовлення в позначених статусах переходить у ваш статус саме.

    Як підключити InPost: токен ShipX і ID організації

    Де взяти токен ShipX і ID організації

    Токен дає Elbuz доступ до вашої організації в InPost: відправлень, етикеток і точок. Створюється він у Manager Paczek.

    1. Увійдіть у Manager Paczek і відкрийте «Moje Konto».
    2. Перевірте, що заповнені дані фірми й дані для фактури: без них токен не створюється.
    3. На вкладці API розгорніть «API ShipX» і натисніть «Generuj». Для самих пачкоматів номер договору не потрібен; для кур'єра InPost попросить номер клієнта з кур'єрського договору.
    4. Скопіюйте токен кнопкою «Pokaż token». ID організації з'явиться на вкладці «Ustawienia organizacji».

    Покрокова інструкція InPost з картинками — instrukcja konfiguracji API ShipX (PDF, польською).

    Куди вписати токен в Elbuz

    Де: «Зовнішні сервіси та інтеграції» → група «Доставка» → InPost.

    1. Увімкніть «Активність».
    2. Вставте токен у поле «Токен». Збережений ключ показується крапками; порожнє поле його не стирає.
    3. Впишіть «ID організації» в блоці «Параметри InPost (ShipX)». Без нього відправлення не створиться.
    4. Оберіть «Спосіб передачі відправлень»: «Пачкомат (Paczkomat)», «Забір курʼєром (dispatch order)» чи «Пункт приймання (POP)». «За замовчуванням (з договору)» — InPost візьме спосіб із договору.
    Форма підключення InPost: токен і параметри ShipX
    1Токен
    2ID організації
    3Спосіб передачі відправлень
    4Тестове середовище (sandbox)
    1. Токен організації вводиться в полі «Токен» (у полі точки).
    2. ID організації береться з кабінету Менеджер Paczek.
    3. Спосіб передачі відправлень: за замовчуванням — з договору.
    4. Перемикач тестового середовища (sandbox).

    Форма зберігається сама при кожній зміні поля, кнопки «Зберегти» немає. Токен при збереженні не перевіряється: помилку ключа покаже перша накладна.

    «Тестове середовище (sandbox)» перемикає Elbuz на пісочницю ShipX. Токен для неї окремий, з Sandbox Manager; посилки з пісочниці нікуди не їдуть.

    Список пачкоматів Elbuz отримує сам, ключ для цього не потрібен. Таблиця «Довідники служби» у записі показує, скільки точок і коли їх оновлено; оновлення — щоночі.

    Як відправити замовлення InPost

    Де: картка замовлення → «Вид доставки» = InPost → секція «Доставка» → «Створити накладну» («Редагувати накладну», якщо форму вже відкривали).

    Форма бере одержувача, суму й вагу із замовлення. Вам лишається перевірити точку, розмір і наложку.

    Форма створення ТТН InPost для замовлення 37123
    1Спосіб відправлення
    2Точка InPost
    3Розмір посилки
    4Зворотна доставка (одержувач)
    5Створити накладну
    1. Спосіб відправлення: пачкомат або кур'єр InPost.
    2. Точка InPost вибирається за воєводством і містом.
    3. Розмір посилки A, B або C.
    4. Зворотна доставка: сума, яку збирає InPost з одержувача.
    5. Кнопка створення накладної.

    Пачкомат: точка і розмір

    Elbuz шукає код пачкомата в адресі замовлення (вигляду KRA01A чи POP-WAW762) і звіряє його з довідником InPost. Знайшов — у формі вже вибрані воєводство, місто й точка.

    Не знайшов — оберіть точку списками «Воєводство» → «Населений пункт» → «Точка InPost». У списку лише працюючі точки, що видають посилки.

    Розміри посилки для пачкомата
    РозмірГабарити з упаковкоюВага
    A8 × 38 × 64 смдо 25 кг
    B (за замовчуванням)19 × 38 × 64 смдо 25 кг
    C41 × 38 × 64 смдо 25 кг

    Для пачкомата обов'язкові телефон і e-mail одержувача: туди InPost надсилає код отримання. Телефон Elbuz скорочує до 9 цифр, код +48 відкидається.

    Кур'єр InPost на адресу

    Оберіть «Курʼєр InPost»: замість точки з'явиться блок «Адреса» («Населений пункт», «Індекс», «Вулиця», «Дім») і габарити «Довжина, см», «Ширина, см», «Висота, см». Без габаритів Elbuz передасть 30 × 20 × 10 см.

    Кур'єр InPost за договором бере посилку до 50 кг, з найдовшою стороною до 120 см і сумою сторін до 220 см. Одержувач — лише в Польщі.

    Наложений платіж і оголошена вартість

    «Зворотна доставка (одержувач)» стоїть на «Гроші», якщо замовлення не оплачене і оплата — при отриманні. Сума — сума замовлення без перерахунку валюти: якщо замовлення не в злотих, впишіть суму в zł у полі «Сума, zł».

    Наложка в пачкомат — до 5 000 zł. Гроші InPost переказує на рахунок із договору чи Manager Paczek протягом п'яти робочих днів після оплати.

    «Оголошена вартість, zł» — сума, на яку InPost страхує посилку, за його тарифом.

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

    1. Elbuz перевіряє, що номера в замовленні ще немає: подвійний клік другу накладну не створить.
    2. Надсилає відправлення в InPost і до 12 секунд чекає номер відстеження: InPost присвоює його не одразу.
    3. Пише номер у поле «Сервіс доставки: номер», а посилання «Створити накладну» в картці зникає.

    Якщо за 12 секунд номера немає, у замовлення ляже внутрішній номер відправлення InPost — коротке число. Статуси й друк працюють і з ним.

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

    Друк етикетки і скасування

    «Друк» біля номера в перегляді накладної або «Друк накладної» у «Відправленні» відкриває етикетку PDF. Elbuz завантажує її з InPost сам: токен у браузер не потрапляє, вхід у Manager Paczek не потрібен.

    Етикетки InPost друкуються по одній: кілька однією кнопкою — лише для Нової пошти.

    Скасувати чи змінити відправлення InPost з Elbuz не можна. Скасуйте його в Manager Paczek, а номер у полі замовлення «Сервіс доставки: номер» зітріть вручну — тоді накладну можна створити знову.

    Як Elbuz стежить за посилкою InPost

    Кожні 10 хвилин Elbuz питає InPost про стан посилок — до 100 накладних за прохід, спершу ті, що найдовше не перевірялися. Назву статусу InPost віддає польською, як на своєму сайті: «Umieszczona w automacie Paczkomat (odbiorczym).».

    Коди InPost з таблиці нижче Elbuz сам вписує у вікно «Статуси доставки» запису InPost — за ними у «Відправленні» стан «У відділенні», «Отримано» чи «Відмова». Код поза таблицею — стан «Невідомо». Як позначити статуси замовлення, які міняються самі, — у статті про статуси перевізника.

    Коди InPost для вікна «Статуси доставки»
    Статус доставки ElbuzКоди InPostСтан у «Відправленні»
    Чекання від відправникаcreated, confirmedСтворено
    Зібраноdispatched_by_sender, taken_by_courier, dispatched_by_sender_to_pokСтворено
    У дорозіadopted_at_sorting_center, sent_from_sorting_center, adopted_at_target_branchВ дорозі
    Видана кур'єруout_for_delivery, out_for_delivery_to_addressВ дорозі
    У пункті призначенняready_to_pickup, ready_to_pickup_from_pok, pickup_reminder_sentУ відділенні
    ДоставленоdeliveredОтримано
    Відмова від отриманняrejected_by_receiver, returned_to_sender, pickup_time_expiredВідмова

    Коди вписуються через кому в колонку «Код (назва) на сайті (API)»; комірка вміщує до 80 символів, тому беріть головні коди, а не всі 53.

    Вікно «Статуси доставки» для InPost з кодами статусів служби
    1Код (назва) на сайті (API)
    2У пункті призначення
    3Доставлено
    1. Колонка з кодами статусів InPost, розширена, щоб коди читалися повністю.
    2. Кілька кодів InPost зіставлені зі статусом «У пункті призначення».
    3. Статус «Доставлено» відповідає коду delivered.

    Elbuz опитує посилку, поки замовленню не мине 60 днів або поки воно в позначеному статусі; код зі стану «Отримано» зупиняє опитування раніше. Статус замовлення, доставки й оплати змінюється лише в замовленнях позначених статусів, решті оновлюється тільки стан посилки.

    У пачкоматі посилка чекає 48 годин, у PaczkoPunkt — 72. Через 36 годин InPost нагадує одержувачу, не забрали — посилка повертається відправнику.

    У «Відправленні» кнопка «Відстеження на сайті служби» відкриває сторінку inpost.pl/sledzenie-przesylek з номером посилки, а «SMS одержувачу» — вікно повідомлення клієнту.

    Сценарії

    Щоденні замовлення в пачкомати

    Покупець обирає пачкомат на сайті, код точки приходить в адресі замовлення. Позначте замовлення в списку → «Створити ТТН (доставка)»: накладні створюються пачкою з розміром B. Етикетки друкуйте з «Відправлення».

    Замовлення з наложеним платежем

    Замовлення не оплачене, оплата при отриманні — форма сама ставить «Гроші» й суму замовлення. Коли покупець забере посилку, у «Відправленні» стан стане «Отримано», а гроші InPost перекаже за договором.

    Велика посилка кур'єром

    Оберіть «Курʼєр InPost», перевірте адресу, впишіть вагу й габарити. Пам'ятайте ліміт кур'єра: до 50 кг і 220 см суми сторін.

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

    Розбір частих проблем
    Що ви бачитеЧому такЩо зробити
    «Служба доставки не підключена: заповніть налаштування API цієї служби…» У записі InPost немає токена або вимкнено «Активність» Впишіть токен і ввімкніть запис (куди вписати токен)
    «Error: organization_id is required (API settings)» Не вписано ID організації Візьміть його в Manager Paczek, вкладка «Ustawienia organizacji» (де взяти)
    «Error: email is required for recipient (parcel locker)» У замовленні немає e-mail одержувача, а пачкомату він потрібен Впишіть e-mail у поле «E-Mail» форми (пачкомат)
    «Error: target_point is required (parcel locker)» Точку не вибрано, і код пачкомата в адресі не розпізнано Оберіть «Воєводство» → «Населений пункт» → «Точка InPost» (пачкомат)
    Списки «Воєводство» і «Точка InPost» порожні Довідник точок не оновлювався більше трьох діб Напишіть у підтримку Elbuz: без довідника точку пачкомата не вибрати
    У «Відправленні» стан «Невідомо» InPost повернув код, якого немає в таблиці, або код у «Статуси доставки» стерли Допишіть код до потрібного статусу (статуси)

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

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

    Elbuz за відправлення, етикетки й статуси нічого не списує. Відправлення ви оплачуєте InPost за його прайсом або договором.

    Чи потрібен договір з InPost?

    Для пачкоматів токен створюється в акаунті Manager Paczek із даними фірми. Для кур'єра InPost просить номер клієнта з кур'єрського договору (токен ShipX).

    Чому в замовленні коротке число, а не номер відстеження?

    InPost не встиг присвоїти номер за 12 секунд, і Elbuz записав внутрішній номер відправлення. Статуси й друк працюють і з ним (після створення).

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

    Ні, кнопки виклику кур'єра для InPost немає. Як ви передаєте посилки, задає «Спосіб передачі відправлень» у записі InPost; забір кур'єром замовляється в Manager Paczek.

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

    Ні, Elbuz створює відправлення InPost лише одержувачу в Польщі.

    Статуси приходять польською — так і має бути?

    Так, назву статусу дає InPost. Стан у «Відправленні» і ваш статус доставки Elbuz показує українською за кодом (коди InPost).

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

    Меню
    Кабінет → Налаштування системи → Інші налаштування → Зовнішні сервіси та інтеграції → Доставка → InPost
    Інші входи
    Довідники → Документи → Відправлення → «Служби доставки»; картка замовлення → секція «Доставка»
    Право доступу
    підключення — «API та токени доступу»; накладна — «Створення ТТН служби доставки»; посилки — «Відправлення»
    Підготувати
    акаунт Manager Paczek з даними фірми; для кур'єра — договір з InPost
    1. Створити токен ShipX і взяти ID організаціїManager Paczek
    2. Вписати токен і ID організаціїЗовнішні сервіси та інтеграції → InPost
    3. Вписати коди InPost у «Статуси доставки»Там само, «Налаштування повідомлень»
    4. Створити відправленняКартка замовлення, секція «Доставка»
    5. Надрукувати етикеткуПерегляд накладної або «Відправлення»

    Суміжні теми

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

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

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

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

    Зміст статті

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

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