VibeFox bpost Cubee for WooCommerce — Помощь

Требования

WordPress: 5.8 или новее.

WooCommerce: 7.0 или новее, установлен и активен. Плагин не активируется без него.

PHP: 8.0 или новее.

Учётная запись bpost Shipping Platform (только для выбора пункта выдачи): плагин ищет пункты выдачи через API bpost Shipping Platform. Войдите в свою учётную запись bpost Shipping Platform на plugins.bpost.be и создайте ключи в разделе Settings > Key management. Понадобятся три значения: Account ID (открытый ключ), Passphrase (закрытый ключ) и App ID (X-APPID). App ID выдаёт bpost для вашей интеграции; запросите его в службе поддержки e-commerce bpost (eol@bpost.be). Также нужен идентификатор перевозчика по вашему договору (68 = bpost). Без полных ключей способ продолжает работать как способ доставки с фиксированной ценой, но покупателю не предлагается выбрать пункт выдачи.

Лицензионный ключ VibeFox: покупается на vibefox.net. Один ключ работает на одном домене.

Установка

1. В WordPress перейдите в Plugins > Add New > Upload Plugin, выберите ZIP-архив плагина и нажмите Install Now. Также можно загрузить папку vfd_bpost_cubee в /wp-content/plugins/ по FTP.

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Shipping > VibeFox bpost Cubee или нажмите Settings под названием плагина на странице «Плагины».

4. Введите лицензионный ключ VibeFox в блоке лицензии вверху страницы и нажмите Activate.

5. Введите свои цены и для выбора пункта выдачи — API-ключи bpost (см. раздел «Настройка»).

6. Добавьте VibeFox bpost Cubee в зону доставки для Бельгии в WooCommerce > Settings > Shipping > Shipping zones или включите Ignore shipping zones и выберите страны.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Shipping > VibeFox bpost Cubee. Они действуют во всех зонах доставки. Когда вы добавляете способ в зону, в окне зоны есть только одно поле:

Title (zone): название этого варианта при оформлении заказа в данной зоне. Оставьте пустым, чтобы использовать общее Name.

На странице настроек выводятся предупреждения, если что-то незаметно скрывает способ или выбор пункта: выбор пункта выдачи включён, но API-ключи заполнены не полностью, для Бельгии нет цены, или последнее подключение к API bpost не удалось. При каждом сохранении настроек очищаются сохранённый API-токен и кэшированные списки пунктов выдачи.

Общие

Enable/Disable: включает или выключает доставку в постаматы bpost во всех зонах сразу.

Name: название способа доставки, которое видит покупатель при оформлении заказа. По умолчанию: bpost parcel locker.

Tax status: Taxable добавляет налог WooCommerce к вашим ценам, None означает, что цены окончательные.

API bpost (поиск пунктов выдачи) (нужен только для выбора пункта выдачи)

Account ID (public key): открытый ключ вашей учётной записи bpost Shipping Platform из раздела Key management на plugins.bpost.be.

Passphrase (private key): закрытый ключ, которым подписывается каждый запрос (HMAC-SHA256). Он никогда не отправляется в bpost и не записывается в журнал.

App ID (X-APPID): идентификатор приложения, выданный bpost для вашей интеграции. Он передаётся в заголовке X-APPID.

Carrier ID: перевозчик по вашему договору bpost Shipping Platform, чьи пункты выдачи и постаматы выводятся в списке. По умолчанию: 68 (bpost). Другие перевозчики, включённые в договор, имеют собственные ID.

Выбор пункта выдачи

Pickup points: показывает при оформлении заказа выбор пунктов выдачи и постаматов. По умолчанию включено. Выбор появляется только тогда, когда заполнены все три API-ключа.

Search field width: ширина поля почтового индекса / города в CSS, например 100% или 300px. По умолчанию: 100%.

Pickup point list width: ширина списка пунктов выдачи в CSS, например 100% или 400px. По умолчанию: 100%.

Цены (в валюте вашего магазина; bpost не возвращает цены доставки через этот API)

Price by: способ выбора цены.

Country prices: по одной строке на страну в формате CC=PRICE, например BE=4.95. Строка *=PRICE задаёт цену для всех остальных стран, например *=9.95. В качестве десятичного разделителя принимаются и точка, и запятая. Некорректные строки игнорируются и перечисляются в сообщении об ошибке при сохранении. Способ не предлагается странам без цены (если нет строки *).

Size prices: используется, когда Price by установлено на размер посылки, в формате S=3.50, M=4.50, L=6.00, XL=8.00. Размер определяется весом корзины: S до 2 кг, M до 5 кг, L до 10 кг, XL свыше 10 кг.

Calculation: Per order взимает цену один раз. Per item (price x number of items) умножает её на количество товаров в корзине.

Условия

Min weight (kg): минимальный вес корзины, при котором способ появляется. 0 означает без ограничения.

Max weight (kg): способ скрывается при весе корзины выше этого значения. По умолчанию: 30, потому что постаматы bpost принимают посылки до 30 кг. 0 означает без ограничения.

Minimum order amount: показывать способ только тогда, когда сумма корзины (без налога) достигает этой суммы. Оставьте пустым, чтобы показывать всегда.

Excluded shipping classes: скрывать способ, если какой-либо товар в корзине относится к одному из этих классов доставки WooCommerce.

Веса товаров пересчитываются из единицы веса вашего магазина в килограммы.

Бесплатная доставка

Free shipping: включает бесплатную доставку от суммы, указанной ниже.

Free shipping from: сумма корзины (без налога), начиная с которой доставка бесплатна. Используется, только если включено Free shipping.

Доступность без зон доставки

Ignore shipping zones: предлагать способ в указанных ниже странах без добавления в зону.

Countries: страны назначения для этого режима. По умолчанию: Бельгия. Оставьте пустым, чтобы использовать все страны, в которые вы отправляете. Это поле используется только при включённом Ignore shipping zones.

Дополнительно

Debug log: записывает запросы к API и расчёты цен в WooCommerce > Status > Logs, источник vfd-bpost-cubee. Ошибки API записываются всегда, даже когда эта опция выключена. Ключи, токены и данные покупателей никогда не записываются в журнал.

Remove data on uninstall: если включено, при удалении плагина удаляются его настройки и способы доставки в зонах. Деактивация плагина никогда не удаляет данные. Пункты выдачи, сохранённые в заказах, всегда сохраняются.

Как это работает при оформлении заказа

Когда покупатель вводит адрес доставки, WooCommerce запрашивает у плагина тариф. Плагин проверяет условия: страна доставки, вес корзины, минимальная сумма заказа и исключённые классы доставки. Затем он берёт цену из списка стран или по размеру посылки, умножает её на количество товаров в режиме «за товар» и обнуляет, если применяется бесплатная доставка.

Когда покупатель выбирает тариф bpost, под ним появляются поле поиска, кнопка Search и список пунктов выдачи. Если поле поиска пусто, автоматически ищется почтовый индекс из адреса оформления заказа. Покупатель может ввести другой почтовый индекс или название города. Каждый пункт показывается с названием и адресом. Выводятся до 50 пунктов. Список пунктов выдачи запрашивается на нидерландском на нидерландоязычных сайтах и на французском в остальных случаях.

Покупатель должен выбрать пункт выдачи. Без выбора классическое оформление заказа показывает Please select a bpost pickup point., а блочное оформление отказывается оформить заказ с тем же сообщением. Выбор сохраняется в течение сеанса оформления, поэтому обновление страницы его не сбрасывает.

Чтобы получить список пунктов выдачи, плагин отправляет в bpost только искомый почтовый индекс или город, страну и идентификатор перевозчика, подписанные вашими ключами. Имя, адрес электронной почты и строка адреса покупателя не отправляются. API-токен запрашивается и обновляется автоматически. Если bpost отклоняет токен, новый запрашивается один раз и поиск повторяется. Результаты поиска кэшируются на 6 часов. Если bpost не отвечает, покупатель видит Pickup points cannot be loaded right now. Please try again in a few minutes or choose another shipping method., а плагин повторяет попытку через 5 минут. Таймаут API — 15 секунд.

Способ работает в классическом оформлении заказа и в блоках «Корзина» и «Оформление заказа». Он совместим с WooCommerce High-Performance Order Storage (HPOS).

Плагин использует только фиксированные цены. Он не получает актуальные тарифы от bpost, не создаёт отправления, не печатает этикетки и не отслеживает посылки. Пункты выдачи показываются списком, а не на карте. Создавайте отправления в учётной записи bpost Shipping Platform или Shipping Manager; идентификатор пункта выдачи указан в заказе.

Пункты выдачи

Выбранный пункт выдачи (название и адрес) и его ID сохраняются в заказе. На экране заказа в админке он показывается под адресом доставки как bpost pickup point. Нажмите Change, найдите почтовый индекс или город и выберите другой пункт из списка. Заказ обновляется сразу, и добавляется примечание к заказу bpost pickup point changed to: …. Ссылка Change доступна только тогда, когда API-ключи заполнены.

Покупатели видят пункт выдачи на странице благодарности и в My account > Orders. Он также добавляется в письма о заказе — и в HTML, и в виде обычного текста.

Чтобы предлагать доставку в постамат и на дом вместе, добавьте в ту же зону ещё один способ доставки, например Flat rate. Выбор пункта выдачи появляется только под тарифом bpost.

Лицензионный ключ

Плагин работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии находится вверху страницы WooCommerce > Settings > Shipping > VibeFox bpost Cubee. Вставьте ключ в поле License key и нажмите Activate. Блок показывает статус, например дату, до которой лицензия активна, и ваш домен. Используйте Check now, чтобы проверить статус ещё раз, Change key, чтобы ввести другой ключ, и Remove key, чтобы удалить его с этого сайта. Ссылка Manage licenses and domains in your account открывает вашу учётную запись на vibefox.net.

Один ключ работает на одном домене. Удаление ключа с сайта не освобождает слот домена. Освободите его в своей учётной записи на vibefox.net.

Без активного ключа способ bpost не показывается покупателям при оформлении заказа. Администраторы магазина, вошедшие в систему, видят его с пометкой (unlicensed — visible to admins only), чтобы можно было настроить и проверить плагин до покупки ключа. Напоминание появляется на странице «Плагины» и на страницах WooCommerce. Существующие заказы не затрагиваются.

Когда лицензия истекает, плагин продолжает работать, но для обновлений и поддержки нужно продление. Статус автоматически проверяется снова в фоновом режиме.

Устранение неполадок

bpost не появляется при оформлении заказа: проверьте, что лицензия активна, что Enable/Disable включено и что способ добавлен в зону страны покупателя (или что включено Ignore shipping zones и страна разрешена). Проверьте, что у страны есть цена или строка *=PRICE, а также ограничения по весу, Minimum order amount и Excluded shipping classes. На странице настроек появляется предупреждение, если для Бельгии нет цены.

Нет выбора пункта выдачи при оформлении заказа: проверьте, что Pickup points включено и что Account ID (public key), Passphrase (private key) и App ID (X-APPID) заполнены. На странице настроек появляется предупреждение, если ключи заполнены не полностью.

Покупатели видят «Pickup points cannot be loaded right now»: bpost не ответил или отклонил ключи. Причина указана в WooCommerce > Status > Logs (источник vfd-bpost-cubee) и на странице настроек. Плагин повторяет попытку автоматически через 5 минут. Сохранение настроек повторяет попытку сразу.

Для этого почтового индекса или города пункты выдачи не найдены: bpost не вернул пунктов по этому запросу. Попросите покупателя указать соседний почтовый индекс или название города и проверьте Carrier ID.

Цены с запятой не используются: принимаются и 5,50, и 5.50. Строки в Country prices, которые не соответствуют формату CC=PRICE, игнорируются; сообщение об ошибке после сохранения перечисляет их.

Цены включают налог? Если Tax status установлен в Taxable, WooCommerce добавляет налог к вашим ценам. При None цены окончательные.

Блок лицензии показывает ошибку: следуйте сообщению в блоке. Например, если ключ уже используется на другом домене, освободите слот в учётной записи vibefox.net и нажмите Check now. Если адрес сайта изменился, нажмите Check now, чтобы активировать ключ для нового домена. Если сервер лицензий недоступен, плагин продолжает работать по последнему известному статусу.

Удаление

Деактивация плагина сохраняет все настройки; она только очищает API-токен и кэшированные списки пунктов выдачи. Чтобы удалить плагин, деактивируйте его и удалите на странице Plugins. Лицензионный ключ и статус лицензии этого плагина, API-токен и кэши всегда удаляются. Настройки и способы доставки в зонах удаляются, только если была включена опция Remove data on uninstall. Иначе они сохраняются для будущей переустановки. Пункты выдачи, сохранённые в заказах, являются историей заказов и никогда не удаляются.

bpost — товарный знак его владельца. Плагин не связан с bpost и не одобрен им.