Greece Couriers — модуль доставки ACS, ELTA, Geniki і Speedex для OpenCart: на адресу, в ACS store / SmartPoint / locker

Greece Couriers — незалежний модуль доставки від студії CatCode для магазинів у Греції та на Кіпрі на OpenCart 4, 3 і 2.3. Він підключає чотирьох грецьких кур’єрів — ACS Courier, ELTA Courier, Geniki Taxydromiki і Speedex. Покупець обирає доставку на адресу або точку ACS — магазин, SmartPoint чи SmartPoint-locker — прямо на чекауті, а менеджер створює ваучер, друкує етикетку і бачить статус посилки в картці замовлення, не відкриваючи кабінети кур’єрів.

Що потрібно від вас. Договір і доступ до веб-сервісів тих кур’єрів, якими ви користуєтесь. Чесно про перевірку: тестових акаунтів кур’єрів у нас немає — ACS і ELTA не мають публічних тестових систем, Geniki і Speedex дають їх лише клієнтам з договором. Модуль написано за офіційною документацією ACS Rest API і Geniki JobServicesV2, за WSDL ELTA Courier і Speedex і перевірено на моках цих сервісів, зібраних за їхньою документацією. Справжніх ваучерів у кур’єрів ми не створювали. ELTA Courier — бета: публічної документації ELTA немає, і доставка «забрати в магазині ELTA» на реальному акаунті ще не перевірена. Спробуйте модуль на своїх акаунтах у 7-денному тріалі Pro — якщо кур’єр відповість інакше, ніж у документації, виправимо оперативно.

Про торговельні марки. ACS, ELTA Courier, Geniki Taxydromiki і Speedex — торговельні марки їхніх власників. Greece Couriers — незалежний модуль CatCode, а не офіційний продукт цих компаній: вони його не випускають і не підтримують. Модуль працює з вашими власними акаунтами через їхні веб-сервіси.

Магазин на WooCommerce? Для нього є окремий плагін Greece Couriers для WooCommerce: ті самі чотири кур’єри — ACS, ELTA Courier (бета), Geniki Taxydromiki і Speedex, вибір точки ACS на класичному й блоковому чекауті, ваучери й етикетки з картки замовлення, трекінг і накладений платіж.

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

• Методи кур’єрів у списку доставки: ACS на адресу і в точку, ELTA на адресу і в магазин ELTA, Geniki і Speedex на адресу. Вмикаються лише ті, які ви налаштували.
• Пошук точки ACS грецькою чи латиницею, за містом, районом, вулицею або індексом. Спершу показано точки міста покупця.
• У списку — назва, адреса, регіон і тип точки: store, SmartPoint або locker. Для кошика понад 6 кг SmartPoint і locker не показуються.
• Без точки далі не пройти: сервер відхиляє крок, а блок підтвердження на сторінці притримується з підказкою, що бракує точки.
• ELTA «забрати в магазині» — без вибору точки: ELTA тримає посилку в магазині, що обслуговує індекс покупця.

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

• Налаштування у восьми вкладках: методи доставки, ACS, ELTA, Geniki, Speedex, відправлення, автоматизація, ліцензія. У кожного кур’єра — перевірка з’єднання, яка показує відповідь кур’єра його текстом.
• Панель ваучера в картці замовлення: кур’єр і точка, вага, накладений платіж у EUR, створення ваучера, етикетка PDF, оновлення статусу, скасування. Точку можна поміняти вручну, поки ваучера немає.
• Ваучери й для замовлень з іншим методом доставки — з вибором кур’єра, на адресу покупця.
• Pickup list ACS і закриття дня Geniki — кнопками у вкладках кур’єрів і в списку ваучерів.
• Лист покупцю з номером ваучера і посиланням на трекінг, і запис в історії замовлення.
• Список ваучерів у меню «Продажі», з масовими діями в Pro.

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

1. Ви вводите дані кур’єрів, перевіряєте з’єднання і завантажуєте точки ACS — вони лягають у таблицю модуля й оновлюються щодня.
2. Покупець обирає метод. Для ACS у точку — обирає точку в панелі під методом; точка йде в сесію на сервері, поля адреси покупця не змінюються.
3. При оформленні адреса доставки замовлення стає адресою точки, а регіон — регіоном індексу точки. Для доставки на адресу лишається адреса покупця.
4. Менеджер у картці замовлення створює ваучер: модуль відправляє дані кур’єру, зберігає номер і показує етикетку PDF.
5. Покупець отримує лист з трекінгом. Наприкінці дня — pickup list ACS і закриття дня Geniki. Статус оновлюється кнопкою, а в Pro — щогодини, і доставлене замовлення переходить в обраний статус.

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

• ACS Rest API (JSON) за офіційною документацією: точки, пошук станції за індексом, тариф, ваучер, етикетка, трекінг, скасування, pickup list. Geniki JobServicesV2, ELTA Courier і Speedex — SOAP через власний розбір XML, розширення SOAP у PHP не потрібне.
• Точка — лише на сервері. JavaScript пікера не читає і не пише поля адреси покупця. У сесію йде лише код точки, дані — з таблиці модуля, а точка, що не підходить за вагою, не приймається.
• Перевірка без точки в OpenCart 4 стоїть на збереженні способу оплати і на підтвердженні; в OpenCart 3 — на подіях кроків доставки, оплати й підтвердження; в OpenCart 2.3 — ті самі кроки через модифікацію, яку модуль реєструє сам.
• Одна бібліотека на три збірки, код сумісний з PHP 7.0; працює і з драйвером бази pdo в OpenCart 4.1.
• Паролі й ключі кур’єрів — AES-256-CBC з HMAC, після збереження не показуються.
• Pro-гейт без «цегли»: коли тріал закінчився, зупиняються лише Pro-функції, доставка й ваучери працюють далі.
• Деінсталяція знімає події й завдання крону; таблиці модуля й копія налаштувань лишаються для повторного встановлення.

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

1. OpenCart 4: Розширення → Інсталятор → завантажте cc_grcourier.ocmod.zip (ім’я архіву не змінюйте) і натисніть «Встановити». OpenCart 3: Розширення → Інсталятор → cc_grcourier-oc3.ocmod.zip, потім Розширення → Модифікації → «Оновити». OpenCart 2.3: залийте вміст папки upload/ з cc_grcourier-oc23.ocmod.zip у корінь магазину (FTP або файловий менеджер хостингу).
2. Розширення → Розширення → Доставка → Greece Couriers (ACS, ELTA, Geniki, Speedex) → «Встановити», потім «Редагувати».
3. OpenCart 2.3: Розширення → Модифікації → «Оновити». Модуль реєструє свою модифікацію сам, а сторінка налаштувань нагадує, доки «Оновити» не натиснуто.
4. У вкладках ACS, ELTA, Geniki і Speedex введіть дані тих кур’єрів, якими користуєтесь, і натисніть «Save and check the connection». Для ACS — ще «Download points».
5. На вкладці «Delivery methods» увімкніть методи, поставте ціни, поріг безкоштовної доставки й ліміт ваги; на вкладці «Shipments» — телефон і індекс відправника, способи оплати з накладеним платежем.
6. Оформіть тестове замовлення в точку ACS і створіть ваучер з картки замовлення.
7. Для Pro: вставте ліцензійний ключ з листа після оплати або увімкніть тріал на вкладці «Licence». Для OpenCart 3 і 2.3 додайте cron-адресу з вкладки «Automation» у cron хостингу, раз на годину.