Elbuz створює відправлення Poczta Polska (Pocztex Kurier) із замовлення через e-Nadawca: посилка потрапляє у ваш zbiór, номер одразу лягає в замовлення, етикетка друкується з картки.
Коли це знадобиться:
- Відправляєте кур'єром Pocztex на адресу — одержувач і адреса беруться із замовлення.
- Покупець платить при отриманні — сума наложки з замовлення, рахунок для переказу вказується один раз.
- Посилок за день багато — кур'єра Poczta Polska викликаєте з перегляду накладної.
- Треба знати, де посилка — статус оновлюється в замовленні й у реєстрі «Відправлення».
З чого почати: створіть користувача WebAPI в e-Nadawca → впишіть логін і пароль в Elbuz.
Що вміє Poczta Polska в Elbuz
- Відправлення Pocztex Kurier — на адресу або в пункт видачі, з наложеним платежем на рахунок.
- Етикетка PDF — з картки замовлення і з реєстру «Відправлення», поки zbiór не передано.
- Виклик кур'єра — на дату й години, які ви вкажете.
- Статуси посилок — кожні 10 хвилин; замовлення в позначених статусах переходить у ваш статус саме.
Як підключити Poczta Polska: користувач WebAPI e-Nadawca
Що потрібно від Poczta Polska
Elbuz працює через WebAPI Elektroniczny Nadawca (e-Nadawca). Для нього Poczta Polska вимагає реєстрації і договору.
- Зареєструйтеся на e-nadawca.poczta-polska.pl і підпишіть договір з Poczta Polska.
- В e-Nadawca відкрийте «Ustawienia» → «Lista użytkowników» і створіть користувача для Elbuz з правами на відправлення.
- Збережіть його логін і пароль: їх ви впишете в Elbuz.
Через 30 днів e-Nadawca радить змінити пароль. Змінили — оновіть його і в Elbuz. Щоб зміна не була обов'язковою для інтеграції, попросіть Poczta Polska налаштувати це для вашого акаунта.
Куди вписати доступ в Elbuz
Де: «Зовнішні сервіси та інтеграції» → група «Доставка» → «Poczta Polska (Pocztex)».
- Увімкніть «Активність».
- Логін користувача WebAPI впишіть у «Користувач», пароль — у «Пароль».
- Оберіть «Габарит Pocztex за замовчуванням».
- Для наложки впишіть «Рахунок для післяплати (NRB)».
- «Номер zbioru» лишіть порожнім, якщо посилки мають іти в активний zbiór.
1
Користувач і пароль WebAPI e-Nadawca2
Рахунок для післяплати (NRB)3
Номер zbioru4
Логін сервісу відстеження5
Підказка блоку «Відправник»- Користувач і Пароль — логін і пароль користувача WebAPI Elektroniczny Nadawca.
- Рахунок для післяплати (NRB) — рахунок, на який надходять гроші за наложеним платежем.
- Номер zbioru — залиште порожнім, і відправлення потраплять в активний zbiór.
- Логін сервісу відстеження Poczta Polska — потрібен, якщо замовлень багато; пароль вводиться в полі «Токен».
- Якщо блок «Відправник» порожній, e-Nadawca бере адресу з профілю відправника.
Блок «Відправник» можна не заповнювати: тоді e-Nadawca бере адресу з профілю відправника. Elbuz передає свою адресу, лише якщо вписано назву компанії та індекс. Для виклику кур'єра потрібні назва, індекс, місто й вулиця.
Форма зберігається сама при кожній зміні поля. Логін і пароль при збереженні не перевіряються: помилку покаже перша накладна.
«Тестове середовище (sandbox)» перемикає Elbuz на тестовий сервер e-Nadawca. Логін і пароль там окремі від бойових.
Габарит посилки
| Габарит | Найбільші розміри | Вага |
|---|---|---|
| S | 9 × 40 × 65 см | до 20 кг |
| M (за замовчуванням) | 20 × 40 × 65 см | до 20 кг |
| L | 42 × 40 × 65 см | до 20 кг |
| XL | 60 × 60 × 70 см | до 20 кг |
| 2XL | сума сторін до 250 см, довжина до 120 см | до 50 кг, понад 30 кг — з доплатою |
Габарит із запису служби форма накладної підставляє сама. Для посилки іншого розміру виберіть його у формі в полі «Габарит (макс. розміри, см)» — запис служби міняти не треба.
Як відправити замовлення Pocztex
Де: картка замовлення → «Вид доставки» = «Poczta Polska (Pocztex)» → секція «Доставка» → «Створити накладну» («Редагувати накладну», якщо форму вже відкривали).
Форма бере із замовлення прізвище, ім'я, телефон, e-mail, індекс, населений пункт і вулицю. Обов'язкові прізвище або ім'я, телефон, індекс, місто й вулиця; без ваги Elbuz передасть 1 кг. Одержувач — лише в Польщі.
1
Адреса2
Пункт видачі Poczta Polska (id)3
Габарит (макс. розміри, см)4
Зворотна доставка (одержувач)5
Створити накладну- Адреса — адресна доставка: індекс, населений пункт, вулиця, дім і квартира одержувача.
- Пункт видачі Poczta Polska (id) — заповнюється, якщо посилку треба доставити у пункт видачі; зараз порожньо.
- Габарит — розмір цієї посилки, за замовчуванням береться із запису служби.
- Зворотна доставка — вибрано «Гроші», сума до сплати одержувачем.
- Створити накладну — кнопка відправляє накладну до служби.
Доставка в пункт видачі
Щоб посилка чекала покупця в пункті, впишіть числовий id пункту в поле «Пункт видачі Poczta Polska (id)». Довідника пунктів Poczta Polska в Elbuz немає: id приходить із замовлення або вписується вручну.
Пункти — це відділення Poczta Polska, автомати Pocztex і магазини мереж Żabka, Groszek, Lewiatan, ABC та інших. Посилка чекає у відділенні 7 днів після повідомлення, у пункті — 3 дні, в автоматі — 72 години. Потім вона повертається відправнику за його рахунок.
Наложений платіж
«Зворотна доставка (одержувач)» стоїть на «Гроші», якщо замовлення не оплачене і оплата — при отриманні. Сума — сума замовлення без перерахунку валюти: якщо замовлення не в злотих, впишіть суму в zł вручну. Гроші йдуть на рахунок NRB із запису служби.
Найбільша сума наложки — за вашим договором, у пунктах і автоматах — за лімітом точки. Магазини-партнери наложку не приймають: лише відділення Poczta Polska й автомати Pocztex.
Що відбувається після «Створити накладну»
- Elbuz перевіряє, що номера в замовленні ще немає і обов'язкові поля заповнені.
- Додає відправлення в активний zbiór e-Nadawca або в zbiór із номером із запису служби.
- Пише номер відправлення в поле «Сервіс доставки: номер» — Poczta Polska віддає його одразу.
Номер замовлення Elbuz передає як номер клієнта до відправлення (до 25 символів), «Опис відправлення» e-Nadawca не отримує.
Zbiór: без нього посилка не поїде
Zbiór — набір відправлень, підготовлених до здачі. Elbuz лише додає в нього посилки, а передати zbiór пошті треба в e-Nadawca: «Przekaż dane do Poczty» → «Przekaż zbiory».
Поки zbiór не передано, Poczta Polska про посилку не знає. Дата відправлення ставиться в день передачі zbioru, тому передавайте його в день здачі посилок.
Друк етикетки і видалення
«Друк» біля номера в перегляді накладної або «Друк накладної» у «Відправленні» відкриває етикетку PDF. Elbuz знаходить відправлення в zbiorі за номером і завантажує етикетку сам.
Після передачі zbioru Elbuz етикетку вже не знайде — друкуйте її в e-Nadawca.
Видалити відправлення з Elbuz не можна. Приберіть його зі zbioru в e-Nadawca до передачі і зітріть номер у полі «Сервіс доставки: номер» — тоді накладну можна створити знову.
Як викликати кур'єра Poczta Polska
Де: картка замовлення → «Перегляд накладної» → блок «Виклик курʼєра».
- Перевірте «Дату забору» — за замовчуванням найближчий робочий день.
- Вкажіть «Забрати з» і «до» або залиште порожніми — тоді заявка піде на 08:00–20:00. e-Nadawca приймає лише 08:00–20:00 або двогодинні вікна від 08:00–10:00 до 18:00–20:00, не раніше поточної години.
- Вкажіть «Посилок, шт.» і «Загальна вага, кг», натисніть «Викликати курʼєра».
Адреса забору — блок «Відправник» запису служби. Номера заявки Poczta Polska не повертає: у вікні з'явиться «Курʼєра замовлено», підтвердження пошта надсилає на e-mail з блоку «Відправник», якщо він вписаний. Результат пишеться в журнал замовлення.
Як Elbuz стежить за посилкою
Кожні 10 хвилин Elbuz питає сервіс відстеження Poczta Polska по одному номеру і бере останню подію: код і назву польською. Сервіс бачить лише посилки з подією за останні 30 днів.
Без власного доступу Elbuz користується загальним доступом Poczta Polska для поодиноких запитів. Якщо замовлень багато, замовте свій доступ формою «Wniosek o utworzenie konta WSDL/SOAP» на сторінці сервісу відстеження. Логін впишіть у «Логін сервісу відстеження Poczta Polska», пароль — у «Токен».
Коди подій з таблиці нижче Elbuz сам вписує у вікно «Статуси доставки» запису Poczta Polska — за ними «Відправлення» показують стан посилки. Код поза таблицею — стан «Невідомо». Як працюють вікна кодів — у статті про статуси перевізника.
| Статус доставки Elbuz | Коди Poczta Polska | Що означає |
|---|---|---|
| У дорозі | P_NAD | посилку відправлено |
| У пункті призначення | P_A, P_KWD | повідомлення залишено; готова до видачі у відділенні |
| Доставлено | P_D, P_OWP, P_OWU | вручено; отримано в пункті; отримано у відділенні |
| Відмова від отримання | P_ZZP | повернення з пункту |
Повний перелік кодів — у списку подій Poczta Polska (PDF). Пошта радить зіставляти саме коди: назви подій можуть змінюватися.
«Відстеження на сайті служби» у «Відправленні» відкриває сторінку пошуку poczta-polska.pl/sledzenie-przesylek: посилання з номером Poczta Polska не публікує, тож номер вводиться в поле вручну. Там само посилку відстежує покупець.
Сценарії
Звичайний день відправок
Протягом дня створюйте накладні із замовлень і друкуйте етикетки. Увечері передайте zbiór в e-Nadawca і викличте кур'єра з перегляду будь-якої накладної дня.
Замовлення з оплатою при отриманні
Один раз впишіть рахунок NRB у запис служби. Далі для неоплаченого замовлення з оплатою при отриманні форма сама ставить «Гроші» і суму замовлення.
Що робити, коли щось пішло не так
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Служба доставки не підключена: заповніть налаштування API цієї служби…» | У записі немає пароля або вимкнено «Активність» | Впишіть логін і пароль WebAPI (куди вписати) |
| «Error: login/password is required (API settings)» | У записі заповнено лише «Токен» або немає логіна | Впишіть логін і пароль WebAPI (куди вписати) |
| «Error: bank account for COD is required (API settings)» | Обрано «Гроші», а рахунку для наложки в записі немає | Впишіть «Рахунок для післяплати (NRB)» (наложка) |
| «Error: postcode is required for recipient» (або city, street) | У замовленні немає індексу, міста чи вулиці | Допишіть адресу у формі (відправлення) |
| «Error: ‹опис› (‹номер помилки›)» | e-Nadawca не прийняла відправлення; причина — в описі | Виправте дані за текстом помилки і створіть накладну знову |
| У вкладці друку «e-Nadawca: shipment … is not in the buffer (already sent?)» | Zbiór уже передано пошті | Друкуйте етикетку в e-Nadawca (друк) |
| У «Відправленні» стан «Невідомо» | Коди Poczta Polska не вписані у «Статуси доставки» | Впишіть коди з таблиці (статуси) |
Часті запитання
Скільки коштує інтеграція з Poczta Polska?
Elbuz за відправлення, етикетки й статуси нічого не списує. Посилки ви оплачуєте Poczta Polska за договором.
Номер у замовленні є, а посилка не рухається — чому?
Найчастіше zbiór не передано пошті: до цього Poczta Polska посилку не бачить. Передайте його в e-Nadawca (zbiór).
Чи можна вибрати габарит для окремої посилки?
Так: у формі накладної — поле «Габарит (макс. розміри, см)». За замовчуванням там габарит із запису служби (габарит).
Чи потрібен окремий доступ для відстеження?
Ні, без нього працює загальний доступ Poczta Polska. Власний доступ замовляйте, якщо посилок багато (статуси).
Чи можна відправити Pocztex за кордон?
Ні, Elbuz створює відправлення Pocztex Kurier лише одержувачу в Польщі.
Де це і хто має доступ
- Меню
- Кабінет → Налаштування системи → Інші налаштування → Зовнішні сервіси та інтеграції → Доставка → Poczta Polska (Pocztex)
- Інші входи
- Довідники → Документи → Відправлення → «Служби доставки»; картка замовлення → секція «Доставка»
- Право доступу
- підключення — «API та токени доступу»; накладна й кур'єр — «Створення ТТН служби доставки»; посилки — «Відправлення»
- Підготувати
- договір з Poczta Polska, акаунт e-Nadawca, номер рахунку для наложки
- Створити користувача WebAPIe-Nadawca
- Вписати логін, пароль, рахунок і габаритЗовнішні сервіси та інтеграції → Poczta Polska
- Створити відправленняКартка замовлення, секція «Доставка»
- Передати zbiór поштіe-Nadawca
- Викликати кур'єраПерегляд накладної
Суміжні теми
- Якщо треба бачити посилки всіх служб в одному списку — реєстр «Відправлення».
- Якщо посилки йдуть у пачкомати — InPost в Elbuz або ORLEN Paczka в Elbuz.
- Якщо статус замовлення має мінятися сам за статусом посилки — статуси перевізника.
- Якщо накладні треба створити на десятки замовлень — накладні пачкою.
