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