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

Romania Couriers для OpenCart — модуль доставки для магазинів у Румунії на OpenCart 4, 3 і 2.3. Три найбільші кур’єри країни в одному розширенні: 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 на тестовому сервері, бо тестовий доступ ці кур’єри дають лише клієнтам. Спробуйте на своїх акаунтах у 7-денному тріалі Pro — якщо кур’єр відповість інакше, ніж у документації, виправимо оперативно.

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

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

Спробуєте оформити доставку в пункт, не обравши його, — сервер відмовить з поясненням («Please choose a FANbox pickup point.»). В OpenCart 4 це крок оплати й підтвердження, в OpenCart 3 і 2.3 — вже крок доставки. Поки пункту нема, блок підтвердження замовлення на сторінці притримується з приміткою, що бракує пункту. Пункт, обраний раніше, ніколи не потрапить у замовлення з іншим способом доставки. Для пункту Cargus Ship & Go, що не приймає післяплату, модуль відхилить оплату при отриманні.

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

Налаштування — Розширення → Розширення → Доставка → Romania Couriers. Там чотири вкладки налаштувань (методи, три кур’єри) і ще «Shipments», «Automation» та «Licence».

• Шість методів в одному розширенні доставки: FAN Courier і FANbox, Sameday і easybox, Cargus і Cargus Ship & Go. Показуються лише для адрес у Румунії (і, за бажанням, лише в обраній геозоні).
• Ціна методу — фіксована в основній валюті магазину, безкоштовно від суми товарів, купон з безкоштовною доставкою працює як завжди, ліміт ваги на метод.
• Валюта. Тарифи кур’єрів і післяплата — у леях. Якщо в магазині нема валюти RON, сторінка налаштувань попередить: без неї суми беруться 1:1.

• Пункти кур’єрів у вашій базі. Кнопка «Download … points» тягне пункти кожного кур’єра (FAN Courier — понад 3 200 FANbox), далі вони оновлюються щодня кроном. Покупець шукає пункт у вашій базі, а не чекає на API кур’єра.
• «Save and check the connection» перевіряє акаунт і для Sameday та Cargus сам підставляє ваші точки відправлення й послуги.
• Паролі й ключі зберігаються в базі зашифрованими і не потрапляють у HTML сторінки налаштувань.
• Телефон. Усім трьом кур’єрам потрібен телефон покупця. OpenCart 4 за замовчуванням його не питає — модуль про це попереджає і одним кліком вмикає «Telephone display» і «Telephone required».

• Панель Romania Couriers у картці замовлення: вага, кількість посилок (понад одну — у Pro), післяплата в RON для способів оплати, які ви позначили, створення AWB.
• PDF-етикетка A4 або A6 / 10×14 см (FAN Courier друкує A6 лише для AWB з ePOD), оновлення статусу і скасування AWB — кнопками в тій самій панелі.
• Змінити пункт вручну, якщо покупець попросив, — за ID пункту.
• AWB для будь-якого замовлення: навіть якщо покупець обрав іншу доставку, кур’єра обираєте в панелі.
• Замовлення без телефону отримує в панелі поле телефону: його записано в замовлення разом з AWB.
• Покупцю — лист з номером AWB і посиланням на трекінг кур’єра, а в його акаунті — рядок в історії замовлення.

• Список AWB у меню «Продажі»: замовлення з кур’єром, пунктом і станом накладної, фільтри «Without AWB» і «On the way».
• Pro: масові дії — створити AWB для відмічених замовлень, надрукувати всі етикетки разом (один PDF або ZIP), оновити статуси.
• Pro: автоматизація — AWB створюється сам, коли замовлення переходить в обраний статус; статуси AWB звіряються щогодини, зміни пишуться в історію замовлення, а доставлене замовлення може отримати обраний статус.

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

1. Налаштування. Акаунти потрібних кур’єрів, «Save and check the connection», завантаження пунктів, потім увімкнення методів і цін на вкладці «Delivery methods».
2. Чекаут. Покупець з адресою в Румунії бачить методи увімкнених кур’єрів. Для пункту — обирає пункт у панелі; з Pro ціна доставки береться з тарифу кур’єра і перераховується після вибору пункту та способу оплати (післяплата).
3. Перевірка на сервері. Для методу доставки в пункт оформлення без пункту не проходить. Для Cargus Ship & Go без післяплати не пройде й замовлення з післяплатою.
4. Замовлення. Пункт пишеться в замовлення на сервері, лише якщо метод доставки саме в пункт цього кур’єра: адреса доставки замовлення стає адресою пункту. Адресна книга покупця лишається його.
5. AWB. Менеджер створює накладну в картці замовлення (з Pro — автоматично на обраний статус або масово зі списку), друкує етикетку. Покупець отримує лист з трекінгом.
6. Статус. Кнопка «Refresh status» питає кур’єра; з Pro статуси синхронізуються щогодини — кроном OpenCart 4 або cron-адресою з налаштувань.
7. Скасування. AWB, який кур’єр ще не забрав, скасовується з картки замовлення.

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

• Пункт — лише на сервері. JavaScript пікера не читає і не пише поля адреси покупця. Пункт іде в сесію окремо для кожного кур’єра (лише ID, дані — з таблиці модуля), а в замовлення — лише якщо метод доставки саме в пункт цього кур’єра; інакше прив’язка стирається.
• Перевірка без пункту в OpenCart 4 стоїть на збереженні способу оплати і на підтвердженні; в OpenCart 3 — на подіях кроків доставки, оплати й підтвердження; в OpenCart 2.3 — ті самі кроки через модифікацію (install.xml), яку модуль реєструє сам.
• Живий тариф без сюрпризів (Pro). Кур’єр відповів нулем, помилкою або не встиг за кілька секунд — метод показує вашу фіксовану ціну, а не «безкоштовно». До вибору пункту тариф для методу в пункт не запитується.
• Одна бібліотека на три збірки, код сумісний з PHP 7.0. Власні таблиці пунктів, прив’язок замовлень, AWB і службових даних.
• Паролі й ключі — AES-256-CBC з HMAC, без XOR.
• Pro-гейт без «цегли»: коли тріал закінчився, зупиняються лише Pro-функції, доставка й AWB працюють далі.
• Деінсталяція знімає події й завдання крону; таблиці модуля й копія налаштувань лишаються для повторного встановлення.

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

1. OpenCart 4: Розширення → Інсталятор → завантажте cc_rocourier.ocmod.zip (ім’я архіву не змінюйте) і натисніть «Встановити». OpenCart 3: Розширення → Інсталятор → cc_rocourier-oc3.ocmod.zip, потім Розширення → Модифікації → «Оновити». OpenCart 2.3: залийте вміст папки upload/ з cc_rocourier-oc2.ocmod.zip у корінь магазину (FTP або файловий менеджер хостингу) — Інсталятор 2.3 без налаштованого FTP файлів не копіює.
2. Розширення → Розширення → Доставка → Romania Couriers → «Встановити», потім «Редагувати».
3. OpenCart 2.3: Розширення → Модифікації → «Оновити». Модуль реєструє свою модифікацію сам, а сторінка налаштувань показує жовте нагадування, доки «Оновити» не натиснуто — без цього перевірка пункту на чекауті не працює.
4. Заповніть акаунт кожного кур’єра, якого вмикаєте, натисніть «Save and check the connection» і «Download … points».
5. На вкладці «Delivery methods» увімкніть потрібні методи й поставте ціни, поріг безкоштовної доставки та ліміт ваги.
6. Оформіть тестове замовлення в пункт і створіть AWB з картки замовлення.
7. Для Pro: вставте ліцензійний ключ з листа після оплати або натисніть «Try Pro free for 7 days» на вкладці «Licence». Для OpenCart 3 і 2.3 додайте cron-адресу з вкладки «Automation» у cron хостингу, раз на годину.