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 хостинга, раз в час.