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