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.
- Увійдіть у Manager Paczek і відкрийте «Moje Konto».
- Перевірте, що заповнені дані фірми й дані для фактури: без них токен не створюється.
- На вкладці API розгорніть «API ShipX» і натисніть «Generuj». Для самих пачкоматів номер договору не потрібен; для кур'єра InPost попросить номер клієнта з кур'єрського договору.
- Скопіюйте токен кнопкою «Pokaż token». ID організації з'явиться на вкладці «Ustawienia organizacji».
Покрокова інструкція InPost з картинками — instrukcja konfiguracji API ShipX (PDF, польською).
Куди вписати токен в Elbuz
Де: «Зовнішні сервіси та інтеграції» → група «Доставка» → InPost.
- Увімкніть «Активність».
- Вставте токен у поле «Токен». Збережений ключ показується крапками; порожнє поле його не стирає.
- Впишіть «ID організації» в блоці «Параметри InPost (ShipX)». Без нього відправлення не створиться.
- Оберіть «Спосіб передачі відправлень»: «Пачкомат (Paczkomat)», «Забір курʼєром (dispatch order)» чи «Пункт приймання (POP)». «За замовчуванням (з договору)» — InPost візьме спосіб із договору.
1
Токен2
ID організації3
Спосіб передачі відправлень4
Тестове середовище (sandbox)- Токен організації вводиться в полі «Токен» (у полі точки).
- ID організації береться з кабінету Менеджер Paczek.
- Спосіб передачі відправлень: за замовчуванням — з договору.
- Перемикач тестового середовища (sandbox).
Форма зберігається сама при кожній зміні поля, кнопки «Зберегти» немає. Токен при збереженні не перевіряється: помилку ключа покаже перша накладна.
«Тестове середовище (sandbox)» перемикає Elbuz на пісочницю ShipX. Токен для неї окремий, з Sandbox Manager; посилки з пісочниці нікуди не їдуть.
Список пачкоматів Elbuz отримує сам, ключ для цього не потрібен. Таблиця «Довідники служби» у записі показує, скільки точок і коли їх оновлено; оновлення — щоночі.
Як відправити замовлення InPost
Де: картка замовлення → «Вид доставки» = InPost → секція «Доставка» → «Створити накладну» («Редагувати накладну», якщо форму вже відкривали).
Форма бере одержувача, суму й вагу із замовлення. Вам лишається перевірити точку, розмір і наложку.
1
Спосіб відправлення2
Точка InPost3
Розмір посилки4
Зворотна доставка (одержувач)5
Створити накладну- Спосіб відправлення: пачкомат або кур'єр InPost.
- Точка InPost вибирається за воєводством і містом.
- Розмір посилки A, B або C.
- Зворотна доставка: сума, яку збирає InPost з одержувача.
- Кнопка створення накладної.
Пачкомат: точка і розмір
Elbuz шукає код пачкомата в адресі замовлення (вигляду KRA01A чи POP-WAW762) і звіряє його з довідником InPost. Знайшов — у формі вже вибрані воєводство, місто й точка.
Не знайшов — оберіть точку списками «Воєводство» → «Населений пункт» → «Точка InPost». У списку лише працюючі точки, що видають посилки.
| Розмір | Габарити з упаковкою | Вага |
|---|---|---|
| A | 8 × 38 × 64 см | до 25 кг |
| B (за замовчуванням) | 19 × 38 × 64 см | до 25 кг |
| C | 41 × 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 страхує посилку, за його тарифом.
Що відбувається після «Створити накладну»
- Elbuz перевіряє, що номера в замовленні ще немає: подвійний клік другу накладну не створить.
- Надсилає відправлення в InPost і до 12 секунд чекає номер відстеження: InPost присвоює його не одразу.
- Пише номер у поле «Сервіс доставки: номер», а посилання «Створити накладну» в картці зникає.
Якщо за 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 — за ними у «Відправленні» стан «У відділенні», «Отримано» чи «Відмова». Код поза таблицею — стан «Невідомо». Як позначити статуси замовлення, які міняються самі, — у статті про статуси перевізника.
| Статус доставки 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.
1
Код (назва) на сайті (API)2
У пункті призначення3
Доставлено- Колонка з кодами статусів InPost, розширена, щоб коди читалися повністю.
- Кілька кодів InPost зіставлені зі статусом «У пункті призначення».
- Статус «Доставлено» відповідає коду 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
- Створити токен ShipX і взяти ID організаціїManager Paczek
- Вписати токен і ID організаціїЗовнішні сервіси та інтеграції → InPost
- Вписати коди InPost у «Статуси доставки»Там само, «Налаштування повідомлень»
- Створити відправленняКартка замовлення, секція «Доставка»
- Надрукувати етикеткуПерегляд накладної або «Відправлення»
Суміжні теми
- Якщо треба бачити посилки всіх служб в одному списку — реєстр «Відправлення».
- Якщо замовлення прийшло з Allegro і відправляти треба етикеткою Allegro — Wysyłam z Allegro в Elbuz.
- Якщо накладні треба створити на десятки замовлень — накладні пачкою.
- Якщо статус замовлення має мінятися сам за статусом посилки — статуси перевізника.
