Bulgaria Couriers для WooCommerce — Econt і Speedy: доставка на адресу, в офіс і в автомат

Bulgaria Couriers для WooCommerce — плагін доставки для магазинів у Болгарії. Два найбільші кур’єри країни в одному модулі: Econt з офісами й Еконтоматами і Speedy з офісами й автоматами APT. Покупець обирає доставку на адресу, в офіс або в автомат прямо на чекауті, а менеджер створює товарителницю, друкує етикетку й бачить статус пратки, не відкриваючи кабінети кур’єрів. Для OpenCart 4, 3 і 2.3 є окрема версія — Bulgaria Couriers: Econt & Speedy для OpenCart.

Що потрібно від вас. Бізнес-акаунт у кожного кур’єра, якого вмикаєте: Econt — користувач і пароль e-Econt; Speedy — користувач і пароль Web API. Чесно про перевірку: Econt перевірено наживо на офіційній тестовій середі Econt (demo.econt.com); Speedy — за офіційною документацією Web API на тестовому сервері, бо публічної тестової середи Speedy не має, а тестовий доступ дає лише клієнтам. Спробуйте на своєму акаунті Speedy у 7-денному тріалі Pro — якщо кур’єр відповість інакше, ніж у документації, виправимо оперативно.

Як це виглядає для покупця

Покупець бачить методи обох кур’єрів, яких ви додали в зону доставки, з цінами. Обрав доставку в офіс чи автомат — під методами з’являється панель: список починається з офісів його міста, пошук іде за містом, вулицею або назвою офісу, кирилицею чи латиницею. Перемкнувся на доставку на адресу — панель зникає, а його адреса лишається своєю: плагін не пише адресу офісу в поля покупця ні в класичному, ні в блоковому чекауті. У кожного кур’єра свій обраний офіс, тож перемикання між Econt і Speedy нічого не плутає.

Спробуєте оформити доставку в офіс, не обравши його, — сервер відмовить з поясненням, на будь-якому чекауті. Офіс, обраний раніше, ніколи не потрапить у замовлення з іншим способом доставки. Модулі доставки Нова Пошта й Укрпошта від CatCode можуть стояти поруч: кожна панель показується лише при своєму методі.

Що отримує адмін

• Чотири методи в зонах доставки WooCommerce: Econt на адресу, Econt в офіс або Еконтомат, Speedy на адресу, Speedy в офіс або автомат. Показуються лише для адрес у Болгарії.
• Ціна методу — фіксована, безкоштовно від суми замовлення, купони з безкоштовною доставкою, ліміт ваги на метод.
• Офіси кур’єрів у вашій базі. Кнопка «Download … offices and lockers» тягне офіси й автомати кожного кур’єра, далі вони оновлюються щодня. Закриті офіси Speedy і офіси лише для прийому в список не потрапляють.
• «Check the connection» перевіряє акаунт: для Econt підставляє відправника з профілю e-Econt, для Speedy — об’єкти договору й послуги.
• Паролі зберігаються в базі зашифрованими і не потрапляють у HTML сторінки налаштувань.

• Товарителниця з картки замовлення: вага, наложен платеж (для способів оплати, які ви позначили), преглед преди плащане, обявена стойност за бажанням.
• PDF-етикетка (Speedy — A4 або A6, Econt віддає свій PDF), оновлення статусу і анулювання — кнопками в тому ж блоці.
• Змінити офіс вручну, якщо покупець попросив, — за кодом офісу; неіснуючий код плагін не прийме.
• Товарителниця для будь-якого замовлення: навіть якщо покупець обрав «Flat rate», кур’єра обираєте в картці.
• Трекінг — номер товарителниці з посиланням на сторінку кур’єра в листах, на сторінці подяки і в акаунті покупця.
• Журнал кожного звернення до кур’єрів у журналах WooCommerce (джерело bulgaria-couriers); помилки пишуться завжди.

Як це працює — крок за кроком

1. Налаштування. WooCommerce → Bulgaria Couriers: акаунти потрібних кур’єрів, «Check the connection», завантаження офісів.
2. Зона доставки. У зоні «Bulgaria» додаєте методи Econt і Speedy і ставите ціну, поріг безкоштовної доставки та ліміт ваги.
3. Чекаут. Покупець обирає кур’єра й тип доставки, для офісу чи автомата — сам офіс у панелі. З Pro ціна доставки береться з тарифу кур’єра для його міста або офісу і ваги кошика.
4. Перевірка на сервері. Для методу доставки в офіс замовлення без офісу або з офісом, якого немає в базі, не проходить.
5. Замовлення. Офіс зберігається в замовленні, за бажанням — ще й в адресі доставки, щоб його бачили листи й інші інструменти. Збережена адреса в акаунті покупця лишається його адресою.
6. Товарителниця. Менеджер створює її в картці замовлення (з Pro — автоматично на обраний статус або масово зі списку), друкує етикетку.
7. Статус. Кнопка «Refresh status» питає кур’єра; з Pro статуси синхронізуються щогодини, зміни пишуться в нотатки, а доставлене замовлення може ставати «Виконано» саме.
8. Анулювання. Товарителницю, яку кур’єр ще не забрав, анулюєте з картки замовлення.

Що під капотом

• Офіс — лише на сервері. JavaScript пікера не пише в поля адреси покупця. Офіс іде в сесію окремо для кожного кур’єра, а в замовлення — лише якщо метод доставки саме в офіс цього кур’єра; інакше прив’язка стирається.
• Акаунт покупця не страждає. Адреса офісу пишеться в замовлення вже після того, як WooCommerce зберіг дані покупця, тож наступного разу покупцю підставиться його адреса, а не адреса офісу.
• Живий тариф без сюрпризів (Pro). Кур’єр відповів нулем, помилкою, ціною в іншій валюті або не встиг — метод показує вашу фіксовану ціну, а не «Безкоштовно». До вибору офісу тариф для методу в офіс не запитується.
• Протоколи кур’єрів: Econt — JSON-сервіси e-Econt (createLabel у режимах calculate і create, getShipmentStatuses, deleteLabels), Speedy — Web API v1 (calculate, shipment, print, track, cancel). Для автоматів преглед преди плащане не додається.
• Паролі — AES-256-CBC з HMAC, без XOR.
• Pro-гейт без «цегли»: коли тріал закінчився, зупиняються лише Pro-функції, доставка й товарителниці працюють далі.
• Видалення плагіна прибирає свою таблицю офісів, налаштування і завдання крону.

Як встановити

1. Плагіни → Додати новий → Завантажити плагін: оберіть bulgaria-couriers-for-woocommerce-1.0.0.zip і активуйте.
2. WooCommerce → Bulgaria Couriers: заповніть акаунт кожного кур’єра, якого вмикаєте, і збережіть.
3. Натисніть «Check the connection» (Econt підставить відправника з профілю, Speedy — об’єкти й послуги) і «Download … offices and lockers».
4. WooCommerce → Налаштування → Доставка → ваша зона «Bulgaria» → Додати метод доставки → методи Econt і Speedy.
5. Оформіть тестове замовлення в офіс і створіть товарителницю з картки замовлення.
6. Для Pro: вставте ліцензійний ключ з листа після оплати або запустіть 7-денний тріал.