VibeFox Sameday Easybox for WooCommerce — Помощь

Требования

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

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

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

Имя пользователя и пароль API Sameday: доступ к API входит в бизнес-аккаунт Sameday в Румынии, Венгрии или Болгарии. Уточните у своего менеджера Sameday или у команды интеграции Sameday. Учётные данные часто совпадают с данными для портала eAWB (eawb.sameday.ro, .hu или .bg). Для демо-API Sameday выдаёт отдельные тестовые учётные данные. Без имени пользователя и пароля API способ доставки не предлагается, потому что покупатель не сможет выбрать локер.

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

Установка

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

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Shipping > VibeFox Sameday Easybox или нажмите Settings под названием плагина на странице Plugins.

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

5. Введите API username и API password Sameday, выберите Sameday country и сохраните. На странице должно появиться сообщение "Connected to Sameday ... easybox lockers". Поля Pickup point и Easybox service заполняются из вашего аккаунта.

6. Настройте цены: Exchange rate of the estimate, если валюта магазина отличается от валюты Sameday, и строку Country prices (например * Default) или Fallback cost.

7. Добавьте VibeFox Sameday Easybox в зону доставки вашей страны Sameday в WooCommerce > Settings > Shipping > Shipping zones или включите Ignore shipping zones.

Настройка

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

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

Над настройками страница показывает состояние подключения: хост Sameday, количество локеров easybox и время последнего обновления списка либо сообщение о том, что Sameday отклонил имя пользователя или пароль. Здесь также перечисляются проблемы настройки, например отсутствие учётных данных, цены или курса обмена для расчёта.

Все цены и ограничения принимают запятую или точку как десятичный разделитель (4,99 или 4.99). Некорректное число отклоняется с сообщением.

Общие

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

Name: название способа доставки, которое видит покупатель. Зона может заменить его своим Title. Default: Sameday easybox.

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

Аккаунт Sameday (API)

При сохранении плагин входит в Sameday и загружает ваши услуги, пункты забора и список локеров easybox. Список обновляется ежедневно.

API username: ваше имя пользователя API Sameday.

API password: ваш пароль API Sameday. Если Sameday его отклонил, повторная попытка не выполняется в течение 10 минут.

Sameday country: страна вашего аккаунта Sameday: Romania (api.sameday.ro) (по умолчанию), Hungary (api.sameday.hu) или Bulgaria (api.sameday.bg). Предлагаются её локеры, а способ отображается только для этой страны назначения.

Test mode: использует демо-API Sameday с демо-учётными данными.

Цены

Порядок применения такой: расчёт Sameday (когда заданы Pickup point и Easybox service), затем таблица цен по странам, затем запасная стоимость. Цены в таблице вводятся в валюте магазина.

Pickup point: ваша точка забора Sameday, где Sameday забирает посылки. После успешного входа это список точек забора вашего аккаунта, и точка по умолчанию выбирается автоматически. Нужна для расчёта Sameday. Выберите - not set (price table only) -, чтобы использовать только таблицу цен.

Easybox service: услуга Sameday для доставки в easybox, обычно "Locker NextDay" (код LN), выбирается автоматически. Нужна для расчёта Sameday.

Exchange rate of the estimate: Sameday считает стоимость в валюте вашей страны Sameday: RON, HUF или BGN (EUR для болгарских магазинов, которые продают в евро). Если ваш магазин продаёт в другой валюте, введите стоимость 1 единицы валюты Sameday в валюте магазина, например 0.20. Без этого значения расчёт не используется и действует таблица цен. Лев и евро пересчитываются автоматически по фиксированному курсу.

Table price: Per order берёт цену один раз. Per item (price x quantity) умножает её на количество товаров, которые можно доставить. Это относится к цене из таблицы и к запасной стоимости. Расчёт Sameday всегда относится ко всей посылке.

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

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

Free shipping from: сумма корзины (после скидок, без налога), начиная с которой доставка в easybox бесплатна. Применяется только там, где найдена цена: строка страны, строка * Default или запасная стоимость (тогда расчёт Sameday не запрашивается), либо расчёт Sameday. Оставьте поле пустым, чтобы никогда не предлагать бесплатную доставку.

Доступность

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

Maximum weight (kg): посылки тяжелее этого значения не получают доставку в easybox. Default: 30. Проверьте ограничение вашего договора с Sameday и размеры ячеек easybox. Пустое значение или 0 означает отсутствие ограничения.

Minimum cart subtotal: предлагать способ, только когда сумма корзины (после скидок, без налога) достигает этой суммы.

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

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

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

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

Debug log: записывает расчёты тарифов, вызовы API и выбор локеров в WooCommerce > Status > Logs (источник "vfd-sameday-easybox"). Ошибки API всегда записываются. Пароль, токен и персональные данные покупателя не записываются. Выключите журнал, когда закончите.

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

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

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

Иначе плагин запрашивает у Sameday расчёт, как только покупатель укажет город и область. Он передаёт вашу точку забора и услугу, вес посылки, а также улицу, город, область и почтовый индекс покупателя. Имя, e-mail и телефон не передаются. Бухарест передаётся как "Sector 1", как и в официальном плагине Sameday. Расчёт пересчитывается в валюту вашего магазина. Если расчёта нет (не настроено, ещё нет города или области, ошибка, нет курса обмена), цена берётся из таблицы по странам, а затем из запасной стоимости. Если цены нет, способ скрывается.

Проблемы Sameday никогда не ломают оформление заказа. Расчёт кешируется на 1 час. Ошибка кешируется на 10 минут. После тайм-аута или ошибки сервера расчёт не запрашивается в течение 5 минут. Запросы прерываются через 15 секунд. Список локеров при оформлении заказа читается с вашего сервера, а не из Sameday.

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

Плагин не создаёт AWB (отправления), не печатает этикетки, не отслеживает посылки и не принимает наложенный платёж. Курьерской доставки на дом и виджета карты Sameday нет. Создайте AWB в портале Sameday eAWB или в привычном инструменте, используя ID локера, указанный в заказе.

Выбор локера

Когда покупатель выбирает способ доставки, под ним появляется блок easybox locker с двумя списками: - Select city - и - Select easybox locker -. Город покупателя предвыбирается, если в нём есть локеры. Каждый локер показывает своё название и адрес. Выбор сохраняется при обновлении оформления заказа или перезагрузке страницы.

Локер обязателен. Без него оформление заказа останавливается с сообщением "Please choose a Sameday easybox locker.". Сервер проверяет, что выбранный локер есть в списке, как на классическом оформлении заказа, так и в блочном. Поддельный или удалённый ID локера отклоняется с сообщением "The selected easybox locker is not available any more. Please choose another easybox locker.". Название и адрес, сохраняемые с заказом, берутся из списка, а не из браузера.

Экран заказа в админке: Sameday easybox locker с названием и адресом и Locker ID для AWB Sameday, под адресом доставки. Если в заказе easybox нет локера, экран показывает сообщение "No easybox locker was selected for this order.".

Страница благодарности и просмотр заказа: Sameday easybox locker: с названием и адресом.

Письма о заказе: название и адрес локера в HTML- и текстовых письмах. Письма администратору также содержат Locker ID.

В базе данных локер хранится в метаданных заказа _vfd_sdeb_locker_id (ID локера Sameday для AWB) и _vfd_sdeb_locker_name (название и адрес).

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

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

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

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

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

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

Sameday easybox не появляется при оформлении заказа: проверьте, что лицензия активна, что Enable/Disable включено, что введены имя пользователя и пароль API, что на странице настроек написано "Connected to Sameday" и что страна назначения совпадает со страной вашего аккаунта Sameday. Проверьте, что цена доступна (расчёт Sameday, строка страны, строка * Default или Fallback cost), ограничения по весу и сумме, Excluded shipping classes, и что способ добавлен в подходящую зону (или включено Ignore shipping zones). Включите Debug log, чтобы увидеть причину в WooCommerce > Status > Logs.

Sameday отклонил имя пользователя или пароль API: проверьте их и сохраните снова. Демо-учётные данные работают только при включённом Test mode, рабочие — только при выключенном. До тех пор предлагается сохранённый список локеров, если он есть, а расчёт Sameday не используется.

Цена берётся из моей таблицы, а не из Sameday: для расчёта нужны Pickup point, Easybox service и, если валюта вашего магазина отличается от валюты Sameday, Exchange rate of the estimate. Расчёт запрашивается только после того, как покупатель указал город и область. Когда Sameday недоступен или возвращает ошибку, используется таблица или запасная стоимость; причина указана в журнале.

Список локеров устарел или отсутствует: сохраните настройки. Список загружается заново, если он пуст, старше часа или последняя загрузка не удалась. Если обновление не удалось, используется предыдущий список, и статус сообщает об этом.

Доставка бесплатна по ошибке: проверьте Country prices на строки с Price 0, особенно строку * Default, добавленную через + Add country и оставленную незаполненной.

Локеры в других странах: разработчики могут добавить страны назначения фильтром vfd_sdeb_countries. Список локеров всегда берётся из вашего аккаунта.

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

Удаление

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

Sameday и easybox являются товарными знаками их владельцев. Этот плагин не связан с Sameday и не одобрен компанией Sameday.