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

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

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

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

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

Спробуєте оформити доставку в офіс, не обравши його, — сервер відмовить з поясненням («Please choose the Econt office or Econtomat.»). В OpenCart 4 це крок оплати й підтвердження, в OpenCart 3 і 2.3 — вже крок доставки. Поки офісу нема, блок підтвердження замовлення на сторінці притримується з приміткою, що бракує офісу. Офіс, обраний раніше, ніколи не потрапить у замовлення з іншим способом доставки. Для офісу Speedy, що не приймає оплат, модуль відхилить наложен платеж.

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

Налаштування — Розширення → Розширення → Доставка → Bulgaria Couriers (Econt, Speedy). Там вкладки методів, двох кур’єрів, «Shipments», «Automation» та «Licence».

• Чотири методи в одному розширенні доставки: Econt на адресу, Econt в офіс або Еконтомат, Speedy на адресу, Speedy в офіс або автомат. Показуються лише для адрес у Болгарії (і, за бажанням, лише в обраній геозоні).
• Ціна методу — фіксована в основній валюті магазину, безкоштовно від суми товарів, купон з безкоштовною доставкою працює як завжди, ліміт ваги на метод.
• Валюта. Тарифи кур’єрів і наложен платеж — у євро (для старого акаунта в левах — BGN). Якщо в магазині нема цієї валюти, сторінка налаштувань попередить: без неї суми беруться 1:1.

• Офіси кур’єрів у вашій базі. Кнопка «Download offices» тягне офіси й автомати кожного кур’єра, далі вони оновлюються щодня кроном. Покупець шукає офіс у вашій базі, а не чекає на API кур’єра.
• «Save and check the connection» перевіряє акаунт: для Econt підтягує адресу відправника з профілю e-Econt, для Speedy — об’єкти договору й послуги.
• Паролі зберігаються в базі зашифрованими і не потрапляють у HTML сторінки налаштувань.
• Телефон. Обом кур’єрам потрібен телефон покупця. OpenCart 4 за замовчуванням його не питає — модуль про це попереджає і одним кліком вмикає «Telephone display» і «Telephone required».

• Панель Bulgaria Couriers у картці замовлення: вага, кількість пакетів (понад один — у Pro), наложен платеж для способів оплати, які ви позначили, обявена стойност, преглед преди плащане, створення товарителниці.
• PDF-етикетка (Speedy — A4 або A6, Econt — його власний PDF), оновлення статусу і анулювання — кнопками в тій самій панелі.
• Змінити офіс вручну, якщо покупець попросив, — за кодом офісу.
• Товарителниця для будь-якого замовлення: навіть якщо покупець обрав іншу доставку, кур’єра обираєте в панелі.
• Замовлення без телефону отримує в панелі поле телефону: його записано в замовлення разом з товарителницею.
• Покупцю — лист з номером товарителниці і посиланням на трекінг кур’єра, а в його акаунті — рядок в історії замовлення.

• Список товарителниць у меню «Продажі»: замовлення з кур’єром, офісом і станом пратки.
• Pro: масові дії — створити товарителниці для відмічених замовлень, надрукувати всі етикетки разом (один PDF або ZIP), оновити статуси.
• Pro: автоматизація — товарителниця створюється сама, коли замовлення переходить в обраний статус; статуси звіряються щогодини, зміни пишуться в історію замовлення, а доставлене замовлення може отримати обраний статус.

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

1. Налаштування. Акаунти потрібних кур’єрів, «Save and check the connection», завантаження офісів, потім увімкнення методів і цін на вкладці «Delivery methods».
2. Чекаут. Покупець з адресою в Болгарії бачить методи увімкнених кур’єрів. Для офісу — обирає офіс у панелі; з Pro ціна доставки береться з тарифу кур’єра і перераховується після вибору офісу та способу оплати (наложен платеж).
3. Перевірка на сервері. Для методу доставки в офіс оформлення без офісу не проходить. Для офісу Speedy без оплат не пройде й замовлення з наложеним платежем.
4. Замовлення. Офіс пишеться в замовлення на сервері, лише якщо метод доставки саме в офіс цього кур’єра: адреса доставки замовлення стає адресою офісу, область — областю офісу. Адресна книга покупця лишається його.
5. Товарителниця. Менеджер створює її в картці замовлення (з Pro — автоматично на обраний статус або масово зі списку), друкує етикетку. Покупець отримує лист з трекінгом.
6. Статус. Кнопка «Refresh status» питає кур’єра; з Pro статуси синхронізуються щогодини — кроном OpenCart 4 або cron-адресою з налаштувань.
7. Анулювання. Товарителниця, яку кур’єр ще не забрав, анулюється з картки замовлення.

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

• Офіс — лише на сервері. JavaScript пікера не читає і не пише поля адреси покупця. Офіс іде в сесію окремо для кожного кур’єра (лише код, дані — з таблиці модуля), а в замовлення — лише якщо метод доставки саме в офіс цього кур’єра; інакше прив’язка стирається.
• Перевірка без офісу в OpenCart 4 стоїть на збереженні способу оплати і на підтвердженні; в OpenCart 3 — на подіях кроків доставки, оплати й підтвердження; в OpenCart 2.3 — ті самі кроки через модифікацію (install.xml), яку модуль реєструє сам.
• Живий тариф без сюрпризів (Pro). Кур’єр відповів нулем, помилкою або не встиг за кілька секунд — метод показує вашу фіксовану ціну, а не «безкоштовно». Ціна в списку методів — та сама, що піде в замовлення.
• Одна бібліотека на три збірки, код сумісний з PHP 7.0. Власні таблиці офісів, прив’язок замовлень, товарителниць і службових даних.
• Паролі — AES-256-CBC з HMAC, без XOR.
• Pro-гейт без «цегли»: коли тріал закінчився, зупиняються лише Pro-функції, доставка й товарителниці працюють далі.
• Деінсталяція знімає події й завдання крону; таблиці модуля й копія налаштувань лишаються для повторного встановлення.

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

1. OpenCart 4: Розширення → Інсталятор → завантажте cc_bgcourier.ocmod.zip (ім’я архіву не змінюйте) і натисніть «Встановити». OpenCart 3: Розширення → Інсталятор → cc_bgcourier-oc3.ocmod.zip, потім Розширення → Модифікації → «Оновити». OpenCart 2.3: залийте вміст папки upload/ з cc_bgcourier-oc2.ocmod.zip у корінь магазину (FTP або файловий менеджер хостингу) — Інсталятор 2.3 без налаштованого FTP файлів не копіює.
2. Розширення → Розширення → Доставка → Bulgaria Couriers (Econt, Speedy) → «Встановити», потім «Редагувати».
3. OpenCart 2.3: Розширення → Модифікації → «Оновити». Модуль реєструє свою модифікацію сам, а сторінка налаштувань показує жовте нагадування, доки «Оновити» не натиснуто — без цього перевірка офісу на чекауті не працює.
4. Заповніть акаунт кожного кур’єра, якого вмикаєте, натисніть «Save and check the connection» і «Download offices».
5. На вкладці «Delivery methods» увімкніть потрібні методи й поставте ціни, поріг безкоштовної доставки та ліміт ваги.
6. Оформіть тестове замовлення в офіс і створіть товарителницю з картки замовлення.
7. Для Pro: вставте ліцензійний ключ з листа після оплати або натисніть «Try Pro free for 7 days» на вкладці «Licence». Для OpenCart 3 і 2.3 додайте cron-адресу з вкладки «Automation» у cron хостингу, раз на годину.