Spain Couriers для WooCommerce — SEUR и Correos Express: доставка на адрес, в пункт выдачи и в локер

Spain Couriers для WooCommerce — плагин доставки для магазинов в Испании. Два курьера в одном модуле: SEUR с магазинами SEUR Pickup и локерами (SEUR 2SHOP) и Correos Express с офисами и пунктами PaqPunto. Покупатель выбирает доставку на адрес или в пункт выдачи прямо на чекауте, а менеджер создаёт накладную, печатает этикетку и видит статус посылки, не открывая кабинеты курьеров.

Что нужно от вас. Договор с каждым курьером, которого включаете, с доступом к API: SEUR — client ID и secret, API-пользователь с паролем и счёт клиента (CCC); Correos Express — код клиента, API-пользователь и пароль. Без договора курьеры ключей не выдают.

Честно о проверке. Публичных тестовых аккаунтов нет ни у SEUR, ни у Correos Express, поэтому плагин проверен на локальном магазине WooCommerce, где ответы курьеров смоделированы: для SEUR — по официальному мануалу PIC API и официальному плагину SEUR, для Correos Express — по контракту API из официального модуля Correos для WooCommerce (публичной документации у Correos Express нет). С живыми API обоих курьеров плагин ещё не работал. Начните с тестовой среды курьера (SEUR pre-production или тестовый сервер Correos Express) в 7-дневном триале Pro — если курьер ответит иначе, чем описано, исправим оперативно. Ошибку курьера плагин показывает его же текстом.

Как это выглядит для покупателя

Покупатель видит методы обоих курьеров, которых вы добавили в зону доставки, с ценами. Выбрал доставку в пункт — под методами появляется панель «Choose a pickup point»: список сразу показывает пункты по почтовому коду из его адреса. Можно ввести другой почтовый код (4 цифры с пропущенным нулём плагин дополнит) или искать словами по улице или названию — без учёта ударений, так что «odin» найдёт «ODÍN». Локеры SEUR отмечены в списке отдельно.

Переключился на доставку на адрес — панель исчезает, а его адрес остаётся своим: плагин не пишет адрес пункта в поля покупателя ни в классическом, ни в блочном чекауте. У каждого курьера свой выбранный пункт, так что переключение между SEUR и Correos Express ничего не путает. Попробуете оформить доставку в пункт, не выбрав его, — сервер откажет с объяснением. Так же не пройдёт пункт, которого курьер не выдавал, и корзина тяжелее лимита веса локера, который сообщил SEUR.

Выбранный пункт виден на странице благодарности, в аккаунте покупателя и в письмах вместе со ссылкой на трекинг. По желанию плагин пишет пункт и в адрес доставки заказа, чтобы его видели письма и другие инструменты; адрес, сохранённый в аккаунте покупателя, остаётся его адресом.

Что получает админ

• Четыре метода в зонах доставки WooCommerce: «SEUR — home delivery», «SEUR Pickup point or locker», «Correos Express — home delivery», «Correos Express office or pickup point». Показываются только для адресов в Испании.
• Регионы на каждом методе — полуостров, Балеары, Канары, Сеута и Мелилья, определяются по почтовому коду. По умолчанию — полуостров и Балеары.
• Цена метода — фиксированная, бесплатно от суммы заказа, купоны с бесплатной доставкой, лимит веса (для пунктов по умолчанию 30 кг у SEUR и 20 кг у Correos Express).
• Пункты выдачи по почтовому коду. Полного списка пунктов не отдаёт ни один из курьеров, поэтому плагин запрашивает пункты почтового кода, когда покупатель открывает список, и хранит ответ сутки — второй покупатель с того же кода не ждёт.
• «Check the connection» и «Find pickup points» проверяют аккаунт каждого курьера и показывают, какие пункты он отдаёт для нужного кода.
• Пароли и секреты хранятся в базе зашифрованными и не попадают в HTML страницы настроек.

• Накладная из карточки заказа: вес, contra reembolso (сумма заказа — для способов оплаты, которые вы отметили), объявленная ценность по желанию.
• PDF-этикетка — для термопринтера (одна на страницу) или на лист A4 (три на страницу); обновление статуса и отмена — кнопками в том же блоке.
• Отмена Correos Express: в API Correos Express отмены нет, поэтому «Cancel» помечает накладную отменённой в магазине и добавляет заметку «позвоните в Correos Express». Накладную SEUR отменяет сам SEUR.
• Повторная накладная после отмены получает суффикс к номеру заказа (1234-2), чтобы курьер не отклонил её как дубль.
• Сменить пункт вручную, если покупатель попросил, — по коду пункта.
• Накладная для любого заказа: даже если покупатель выбрал «Flat rate», курьера выбираете в карточке, и посылка идёт на адрес.
• Трекинг — номер накладной со ссылкой на страницу курьера в письмах, на странице благодарности и в аккаунте покупателя.
• Журнал каждого обращения к курьерам в журналах WooCommerce (источник spain-couriers); ошибки пишутся всегда, секреты — никогда.

Как это работает — шаг за шагом

1. Настройки. WooCommerce → Spain Couriers: отправитель (название, NIF/CIF, телефон, адрес), аккаунты нужных курьеров, среда (рабочая или тестовая), сервисы SEUR и продукты Correos Express, «Check the connection».
2. Зона доставки. В зоне «Spain» добавляете методы с пометкой «(Spain Couriers)» и ставите цену, порог бесплатной доставки, лимит веса и регионы.
3. Чекаут. Покупатель выбирает курьера и тип доставки, для пункта — сам пункт в панели. С Pro цена доставки SEUR берётся из вашего тарифа SEUR для почтового кода и веса корзины.
4. Проверка на сервере. Для метода доставки в пункт заказ без пункта, с неизвестным пунктом или с корзиной тяжелее лимита пункта не проходит.
5. Заказ. Пункт сохраняется в заказе, по желанию — ещё и в адресе доставки.
6. Накладная. Менеджер создаёт её в карточке заказа (с Pro — автоматически на выбранный статус или массово из списка), печатает этикетку. Пункты SEUR идут сервисом SEUR 2SHOP (1/48), офисы Correos Express — продуктом Paq 24 Oficina Elegida, PaqPunto — продуктом PaqPunto.
7. Статус. Кнопка «Refresh status» спрашивает курьера; с Pro статусы синхронизируются ежечасно, изменения пишутся в заметки, а доставленный заказ может становиться «Выполнен» сам. Накладные старше 60 дней больше не опрашиваются.
8. Отмена. SEUR — из карточки заказа у самого курьера; Correos Express — пометка в магазине и звонок курьеру.

Что под капотом

• Пункт — только на сервере. JavaScript пикера не пишет в поля адреса покупателя. Пункт идёт в сессию отдельно для каждого курьера, а в заказ — только если метод доставки именно в пункт этого курьера; иначе привязка стирается.
• Пункты в своей таблице базы: ответ курьера на почтовый код кешируется на сутки, поиск словами идёт по пунктам, которые уже известны магазину.
• Живой тариф без сюрпризов (Pro). SEUR ответил нулём, ошибкой или не успел за несколько секунд — метод показывает вашу фиксированную цену, а не «Бесплатно». Включает ли тариф вашего договора IVA, проверьте и при необходимости добавьте наценку.
• Протоколы курьеров: SEUR — публичный PIC API (OAuth2, пункты, расчёт, накладные, этикетки, трекинг, отмена) с одним повтором при просроченном токене; Correos Express — REST API (пункты, накладные, этикетки, трекинг).
• Секреты — AES-256-CBC с HMAC, без XOR.
• Pro-гейт без «кирпича»: когда триал закончился, останавливаются только Pro-функции, доставка и накладные работают дальше.
• Удаление плагина убирает свою таблицу пунктов, настройки, задания крона и свои методы из зон доставки.

Как установить

1. Плагины → Добавить новый → Загрузить плагин: выберите spain-couriers-for-woocommerce-1.0.0.zip и активируйте.
2. WooCommerce → Spain Couriers: заполните отправителя и аккаунт каждого курьера, которого включаете, и сохраните.
3. Нажмите «Check the connection» и «Find pickup points» — курьер должен ответить.
4. WooCommerce → Настройки → Доставка → ваша зона «Spain» → Добавить метод доставки → методы с пометкой «(Spain Couriers)».
5. Оформите тестовый заказ в пункт и создайте накладную из карточки заказа.
6. Для Pro: вставьте лицензионный ключ из письма после оплаты или запустите 7-дневный триал.