Romania Couriers для WooCommerce — FAN Courier, Sameday і Cargus: доставка до дверей і в поштомати

Romania Couriers для WooCommerce — плагін доставки для магазинів у Румунії. Три найбільші кур’єри країни в одному модулі: FAN Courier з поштоматами FANbox, Sameday з поштоматами easybox і пунктами PUDO, Cargus з мережею Ship & Go. Покупець обирає доставку на адресу або в пункт прямо на чекауті, а менеджер створює накладну AWB, друкує етикетку й бачить статус посилки, не відкриваючи кабінети кур’єрів.

Що потрібно від вас. Бізнес-акаунт у кожного кур’єра, якого вмикаєте: FAN Courier — client ID, логін і пароль selfAWB; Sameday — API-користувач eAWB; Cargus — ключ підписки UrgentOnlineAPI і акаунт WebExpress. Чесно про перевірку: FAN Courier перевірено наживо на публічному тестовому акаунті FAN Courier; Sameday і Cargus — за офіційною специфікацією їхніх API (SDK Sameday, OpenAPI Cargus) на тестовому сервері, бо тестовий доступ ці кур’єри дають лише клієнтам. Спробуйте на своїх акаунтах у 7-денному тріалі Pro — якщо кур’єр відповість інакше, ніж у документації, виправимо оперативно.

Як це виглядає для покупця

Покупець бачить методи всіх кур’єрів, яких ви додали в зону доставки, з цінами. Обрав метод доставки в пункт — під ним з’являється панель пункту: список починається з пунктів його міста, пошук іде за містом, вулицею або назвою пункту. Перемкнувся на доставку на адресу — панель зникає, а його адреса лишається своєю: плагін не пише адресу поштомату в поля покупця ні в класичному, ні в блоковому чекауті. У кожного кур’єра свій обраний пункт, тож перемикання між FANbox і easybox нічого не плутає.

Спробуєте оформити доставку в пункт, не обравши його, — сервер відмовить з поясненням («Please choose a Cargus Ship & Go pickup point.»), на будь-якому чекауті. Пункт, обраний раніше, ніколи не потрапить у замовлення з іншим способом доставки.

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

• Шість методів у зонах доставки WooCommerce: FAN Courier і FANbox, Sameday і easybox, Cargus і Cargus Ship & Go. Показуються лише для адрес у Румунії.
• Ціна методу — фіксована, безкоштовно від суми замовлення (рахується так, як показує кошик), купони з безкоштовною доставкою, ліміт ваги на метод.
• Пункти кур’єрів у вашій базі. Кнопка «Download … points» тягне пункти кожного кур’єра (FAN Courier — понад 3 200 FANbox), далі вони оновлюються щодня. Покупець шукає пункт у вашій базі, а не чекає на API кур’єра.
• «Check the connection» перевіряє акаунт і для Sameday та Cargus сам підставляє ваші точки відправлення й послуги.
• Паролі й ключі зберігаються в базі зашифрованими і не потрапляють у HTML сторінки налаштувань.

• AWB з картки замовлення: вага, розмір посилки, післяплата (ramburs) для способів оплати, які ви позначили, оголошена цінність за бажанням.
• PDF-етикетка A4 або A6 / 10×14 см на вибір (FAN Courier друкує A6 лише для AWB з ePOD), оновлення статусу і скасування AWB — кнопками в тому ж блоці.
• Змінити пункт вручну, якщо покупець попросив, — за ID пункту; неіснуючий ID плагін не прийме.
• AWB для будь-якого замовлення: навіть якщо покупець обрав «Flat rate», кур’єра обираєте в картці.
• Трекінг — номер AWB з посиланням на сторінку кур’єра в листах, на сторінці подяки і в акаунті покупця.
• Журнал кожного звернення до кур’єрів у журналах WooCommerce (джерело romania-couriers); помилки пишуться завжди.

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

1. Налаштування. WooCommerce → Romania Couriers: акаунти потрібних кур’єрів, «Check the connection», завантаження пунктів.
2. Зона доставки. У зоні «Romania» додаєте методи з позначкою «(Romania Couriers)» і ставите ціну, поріг безкоштовної доставки та ліміт ваги.
3. Чекаут. Покупець обирає кур’єра й тип доставки. Для пункту — обирає пункт у панелі; з Pro ціна доставки береться з тарифу кур’єра для його міста і ваги кошика.
4. Перевірка на сервері. Для методу доставки в пункт замовлення без пункту або з пунктом, якого вже нема в базі, не проходить. Для Cargus Ship & Go без післяплати не пройде й замовлення з післяплатою.
5. Замовлення. Пункт зберігається в замовленні, за бажанням — ще й в адресі доставки, щоб його бачили листи й інші інструменти. Збережена адреса в акаунті покупця лишається його адресою.
6. AWB. Менеджер створює накладну в картці замовлення (з Pro — автоматично на обраний статус або масово зі списку), друкує етикетку.
7. Статус. Кнопка «Refresh status» питає кур’єра; з Pro статуси синхронізуються щогодини, зміни пишуться в нотатки, а доставлене замовлення може ставати «Виконано» саме.
8. Скасування. AWB, який кур’єр ще не забрав, скасовується з картки замовлення.

Що під капотом

• Пункт — лише на сервері. JavaScript пікера не пише в поля адреси покупця. Пункт іде в сесію окремо для кожного кур’єра, а в замовлення — лише якщо метод доставки саме в пункт цього кур’єра; інакше прив’язка стирається.
• Акаунт покупця не страждає. У блоковому чекауті адреса пункту пишеться в замовлення вже після того, як WooCommerce зберіг дані покупця, тож наступного разу покупцю підставиться його адреса, а не адреса поштомату.
• Живий тариф без сюрпризів (Pro). Кур’єр відповів нулем, помилкою або не встиг за кілька секунд — метод показує вашу фіксовану ціну, а не «Безкоштовно». До вибору пункту тариф для методу в пункт не запитується.
• Післяплата в тарифі (Pro) на класичному чекауті: зміна способу оплати перераховує ціну доставки. На блоковому чекауті WooCommerce не передає спосіб оплати до оформлення, тож післяплата враховується, якщо спосіб оплати вже обрано.
• Протоколи кур’єрів: FAN Courier REST API (токен, FANbox з pickupLocationId), Sameday API (easybox → lockerLastMile, PUDO → oohLastMile), Cargus UrgentOnlineAPI (Ship & Go — послуга 38 з DeliveryPudoPoint, післяплата лише на рахунок). Токени оновлюються самі при 401.
• Паролі й ключі — AES-256-CBC з HMAC, без XOR.
• Pro-гейт без «цегли»: коли тріал закінчився, зупиняються лише Pro-функції, доставка й AWB працюють далі.
• Видалення плагіна прибирає свою таблицю пунктів, налаштування і завдання крону.

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

1. Плагіни → Додати новий → Завантажити плагін: оберіть romania-couriers-for-woocommerce-1.0.4.zip і активуйте.
2. WooCommerce → Romania Couriers: заповніть акаунт кожного кур’єра, якого вмикаєте, і збережіть.
3. Натисніть «Check the connection» (Sameday і Cargus підставлять точки відправлення й послуги) і «Download … points».
4. WooCommerce → Налаштування → Доставка → ваша зона «Romania» → Додати метод доставки → методи з позначкою «(Romania Couriers)».
5. Оформіть тестове замовлення в пункт і створіть AWB з картки замовлення.
6. Для Pro: вставте ліцензійний ключ з листа після оплати або запустіть 7-денний тріал.