VibeFox Instabee for WooCommerce — Помощь

Требования

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

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

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

Учётные данные Budbee API (только для выбора посылочного бокса): API-ключ и API-секрет. Instabee выдаёт их мерчантам с договором на доставку. Обратитесь к контактному лицу Instabee или используйте портал мерчанта Instabee. Документация API находится на developer.budbee.com. Без учётных данных способ доставки работает с фиксированными ценами, но покупатели не могут выбрать посылочный бокс.

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

Установка

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

2. Нажмите Activate.

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

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

5. Заполните раздел Цены и для выбора посылочного бокса укажите ваши API key и API secret Budbee (см. раздел «Настройка»).

6. Добавьте VibeFox Instabee в зоны доставки стран, куда вы доставляете (например, Швеция), в разделе WooCommerce > Settings > Shipping > Shipping zones, или включите Ignore shipping zones и выберите страны.

Настройка

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

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

Предупреждения над настройками сообщают, когда введено только одно из учётных данных API, когда их нет совсем, когда нет цен по странам и резервной стоимости, а также когда последний запрос к API Budbee завершился ошибкой (с датой, временем и причиной). При каждом сохранении настроек кешированные списки боксов и последняя ошибка API очищаются.

Общие

Enable/Disable: включает или выключает способ везде, включая зоны доставки. По умолчанию: включено.

Method name: название способа доставки, которое показывается в корзине и при оформлении заказа. Зона может заменить его собственным Title. По умолчанию: Instabee parcel box.

Tax status: Taxable добавляет налог WooCommerce к стоимости доставки, None не добавляет.

Выбор посылочного бокса (Budbee API)

При наличии учётных данных API покупатель выбирает посылочный бокс рядом со своим почтовым индексом при оформлении заказа, и бокс сохраняется в заказе. Нужны оба поля. Выбор остаётся выключенным, пока оба не заполнены.

API key: ваш API-ключ Budbee (имя пользователя HTTP Basic).

API secret: ваш API-секрет Budbee (пароль HTTP Basic).

Test environment: использует тестовый API Budbee (api.staging.budbee.com). Включайте его только с тестовыми учётными данными от Instabee. Рабочие магазины оставляют его выключенным (api.budbee.com). По умолчанию: выключено.

Цены (в заголовке раздела показана валюта вашего магазина)

Все цены указываются в валюте магазина. Принимаются и десятичная запятая, и десятичная точка (49,90 = 49.90). Значение, которое не является числом, не сохраняется, и сообщение об ошибке называет поле.

Calculation type: способ применения цены.

Country prices: таблица с колонками Country, Price, XS (до 1 кг), S (до 2 кг), M (до 3 кг), L (до 5 кг) и XL (свыше 5 кг). Нажмите + Add country, чтобы добавить строку, и крестик, чтобы удалить её. Выберите * Any other country для строки, которая применяется ко всем странам без собственной строки. Пустой диапазон или 0 использует колонку Price. Price 0 означает бесплатную доставку. Если в строке страны нет цены для веса корзины, используется строка *, затем Fallback cost. Веса переводятся из единицы веса вашего магазина в кг.

Fallback cost: используется, когда ни строка страны назначения, ни строка * не дают цены. Оставьте поле пустым, чтобы скрыть способ для таких стран.

Условия

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

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

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

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

Excluded shipping classes: скрывает способ, когда в корзине есть товар из любого из этих классов доставки WooCommerce.

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

Обычно вы добавляете VibeFox Instabee в зону доставки. В качестве альтернативы его можно включить здесь для списка стран.

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

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

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

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

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

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

Когда покупатель вводит адрес доставки, WooCommerce запрашивает у плагина тариф. Плагин проверяет условия: вес корзины, минимальную сумму заказа и исключённые классы доставки. Если промежуточная сумма корзины достигает Free shipping from, тариф бесплатный. В противном случае цена берётся из строки Country prices страны назначения, строки * или Fallback cost. Если цены нет, способ скрывается.

Когда покупатель выбирает тариф Instabee и учётные данные API заданы, под тарифом для Швеции, Финляндии, Дании, Нидерландов и Бельгии появляется выбор Parcel box. Он показывает боксы рядом с почтовым индексом адреса доставки, отсортированные по расстоянию, с названием, адресом и расстоянием. Покупатель может ввести другой почтовый индекс и нажать Search. Пока индекс не введён, выбор его запрашивает. Если боксы не найдены, покупателю предлагается попробовать другой почтовый индекс или выбрать другой способ доставки.

Выбор посылочного бокса обязателен. При оформлении заказа плагин проверяет на сервере, что выбранный бокс есть в списке Budbee для этого почтового индекса. Иначе покупатель видит Please choose an Instabee parcel box. Название бокса берётся из списка Budbee, а не из браузера.

Плагин отправляет в Budbee только страну назначения и почтовый индекс, но никогда не имена, адреса, e-mail или данные заказа. Списки боксов кешируются на 12 часов для каждого почтового индекса, индекс без боксов — на 1 час, а неудачный запрос — на 5 минут, чтобы медленный или сломанный API не замедлял каждое обновление оформления заказа. Тайм-аут API — 10 секунд.

Если API Budbee недоступен, покупателю сообщается, что заказ можно оформить без выбора бокса. Заказ тогда помечается, и бокс вы выбираете при оформлении отправления. Ранее выбранный бокс, который в этот момент нельзя проверить, сохраняется и помечается как непроверенный.

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

Плагин не рассчитывает тарифы в реальном времени, не оформляет отправления, не печатает этикетки, не выдаёт трек-номера и письма с отслеживанием, не предлагает слоты доставки Budbee Home и не показывает карту. Оформите посылку на выбранный бокс в ваших инструментах мерчанта Instabee / Budbee.

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

Выбранный посылочный бокс сохраняется в заказе и показывается в этих местах:

Экран заказа в админке: под адресом доставки как Instabee parcel box с названием бокса, адресом и Box ID. Если бокс не удалось проверить при оформлении, он помечается как not verified (Budbee API was unavailable at checkout). Если бокс не выбран, потому что API был недоступен, экран сообщает об этом и напоминает выбрать бокс при оформлении отправления.

Страница «Спасибо за заказ» и страница заказа в «Мой аккаунт»: название и адрес бокса.

Письма о заказе: HTML и текстовая версия. Письма магазину также показывают ID бокса. Если бокс не выбран, потому что API был недоступен, об этом пишут только письма магазину.

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

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

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

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

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

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

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

Покупатели не видят список посылочных боксов: список появляется только когда заданы API key и API secret, для Швеции, Финляндии, Дании, Нидерландов и Бельгии, и после ввода почтового индекса. Последняя ошибка API показывается над настройками. Подробности — в WooCommerce > Status > Logs (источник vfd-instabee). Включите Debug log для более подробной информации.

HTTP 401 или 403 в журнале: Budbee отклонил API-ключ или секрет. Проверьте их и убедитесь, что Test environment соответствует вашим учётным данным (тестовые учётные данные только при включённой тестовой среде).

Нет боксов для почтового индекса: Budbee не обслуживает этот почтовый индекс. Покупатель может ввести другой индекс или выбрать другой способ доставки.

Старые списки боксов после изменений: сохраните страницу настроек. Это очистит кешированные списки боксов.

Другие страны для поиска боксов: разработчики могут изменить список стран с помощью фильтра vfd_ibee_box_countries.

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

Удаление

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

Instabee и Budbee — товарные знаки их владельцев. Этот плагин не связан с Instabee или Budbee и не одобрен ими.