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-дневный триал.