Polkurier.pl для OpenCart — кур’єри Польщі, пункти видачі й етикетки

Polkurier.pl для OpenCart 4.x, 3.x і 2.3 додає в чекаут доставку по Польщі через агрегатор кур’єрів Polkurier: до восьми методів, кожен із них — один перевізник вашого акаунта Polkurier, на адресу або в пункт видачі цього перевізника. Ціну можна задати фіксовану або брати живу оцінку Polkurier для кошика.

Що потрібно від Polkurier. Акаунт на polkurier.pl з підписаною угодою для API та згенерований у панелі токен (Ustawienia → Token API). Перевізники, яких ви бачите в модулі, — ті, що підключені до вашого акаунта.

Що бачить покупець

У чекауті — методи доставки з вашими назвами й цінами. Для методу «в пункт» під ним зʼявляється вибір пункту: кнопка офіційної мапи Polkurier і пошук у списку за містом, вулицею, індексом або кодом пункту. Без вибраного пункту замовлення не оформити, пункт без післяплати не пропустить замовлення з оплатою при отриманні, а після вибору в замовленні зʼявляється адреса пункту. Сервер звіряє вибраний пункт із Polkurier, тож підмінити його запитом із браузера не вийде.

Що отримує адміністратор

Розширення → Доставка → Polkurier.pl: вкладки «Методи доставки», «Акаунт і відправник», «Відправлення», «Автоматизація» і «Ліцензія». На вкладці «Акаунт і відправник» ви вводите ID акаунта та токен і натискаєте «Зберегти й перевірити зʼєднання»: модуль завантажує перевізників, банківські рахунки й шаблони пакунків вашого акаунта. Токен зберігається зашифрованим і назад у форму не підставляється.

До восьми методів: для кожного ви вибираєте перевізника зі списку вашого акаунта, тип (на адресу або в пункт видачі), назву в чекауті, країни, ліміт ваги й суму, від якої доставка безкоштовна. Ціна — фіксована, жива оцінка Polkurier (для розміру пакунка за замовчуванням і ваги кошика, з націнкою у відсотках і запасною фіксованою сумою, коли Polkurier не відповідає) або, у Pro, за ваговими порогами з доплатою за післяплату. Polkurier рахує у злотих: щоб жива ціна працювала, у магазині має бути валюта PLN.

На сторінці замовлення зʼявляється панель Polkurier: перевізник, розмір і вага пакунка, спосіб підʼїзду — «передам сам» або «перший доступний виїзд кур’єра». Кнопка створює відправлення в Polkurier з адресою одержувача, розбитою на вулицю, будинок і квартиру; нижче — номер замовлення Polkurier, номер накладної перевізника, статус і ціна. Етикетку завантажуєте PDF-файлом, статус оновлюєте кнопкою. Якщо в адресі не знайдено номер будинку або в замовленні нема телефону, модуль так і каже і нічого не вигадує: дані вносить оператор у панелі.

Список відправлень (кнопка «Список відправлень» у налаштуваннях) показує всі накладні зі статусами. У Pro в ньому зʼявляються масові дії: створити відправлення для вибраних замовлень, надрукувати всі етикетки одним PDF, замовити збірний підʼїзд кур’єра на вибрану дату й години та отримати протокол передачі. На вкладці «Автоматизація» Pro створює відправлення, коли замовлення досягає потрібного статусу, щогодини оновлює статуси й переводить замовлення в обраний вами статус після доставки, а покупцеві йде лист з номером відправлення.

Післяплата — у Pro: замовлення з вибраними способами оплати йдуть у Polkurier із сумою післяплати в злотих, а повернення зібраних грошей ви обираєте на вкладці «Відправлення»: на банківський рахунок (рахунок можна взяти з акаунта Polkurier), поштовим переказом або на скарбничку Polkurier, зі строком повернення S, 1D, 4D чи 16D. У Free відправлення із замовлення з післяплатою не створюється: панель одразу пояснює чому. Pro також скасовує відправлення з сторінки замовлення, тримає шаблони пакунків акаунта й веде доплату за післяплату в чекауті.

Як це працює, крок за кроком

1. Встановіть архів для своєї версії OpenCart і увімкніть доставку Polkurier.pl.
2. На вкладці «Акаунт і відправник» введіть ID акаунта, токен і дані відправника, натисніть «Зберегти й перевірити зʼєднання».
3. На вкладці «Методи доставки» виберіть перевізників, тип (адреса чи пункт), ціну й країни.
4. Переконайтеся, що в магазині є валюта PLN, і перевірте чекаут: метод «в пункт» просить вибрати пункт.
5. У замовленні натисніть «Створити відправлення», завантажте етикетку й оновлюйте статус.
6. У Pro увімкніть автоматичні відправлення за статусом і щогодинну синхронізацію статусів.

Що всередині

• Polkurier API версії 1.14; ID акаунта й токен зберігаються зашифрованими, у журнал токен не потрапляє.
• Коди перевізників беруться з вашого акаунта (available_carriers), а не з жорсткого списку: нові перевізники зʼявляються в модулі без оновлення.
• Жива ціна — один запит оцінки на всі методи, результат коротко кешується; валюта Polkurier — злоті, ціна переводиться у валюту магазину за курсом.
• Мапа пунктів — офіційний віджет Polkurier, токен мапи кешується; якщо мапа недоступна, лишається пошук у списку.
• Polkurier приймає окремо вулицю, номер будинку й квартири, а в OpenCart адреса — один рядок: номер виділяється з адреси, а коли його не знайдено, оператор вводить його в панелі.
• Для замовлень у пункт без платіжної адреси (типово в OpenCart 4) адресою одержувача йде адреса самого пункту.
• Ліміт Polkurier — 500 запитів за 60 секунд з одного IP: пошук пунктів і оцінка кешуються, але на спільному хостингу ліміт ділиться з іншими магазинами.
• Статуси Polkurier тягне опитуванням: вебхуків API не має.
• Події OpenCart без правок ядра; при оновленні модуля акаунт, токен і методи лишаються. Інтерфейс англійською та польською.

Як встановити

1. Розширення → Встановлення: завантажте архів для своєї версії без перейменування (OpenCart 4 — cc_polkurier.ocmod.zip, 3.x — cc_polkurier-oc3.ocmod.zip, 2.3 — cc_polkurier-oc23.ocmod.zip).
2. Для 3.x і 2.3: Розширення → Модифікатори → Оновити.
3. Розширення → Розширення → Доставка → Polkurier.pl: встановіть і відкрийте.
4. Введіть ID акаунта й токен, заповніть відправника, збережіть і перевірте зʼєднання.
5. Для Pro: вставте ключ або запустіть пробний період на вкладці «Ліцензія».