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