VibeFox DHL Africa for WooCommerce — Помощь

Требования

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

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

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

Учётная запись DHL Express (только для тарифов в реальном времени): тарифы в реальном времени используют MyDHL API. Нужны номер учётной записи DHL Express и учётные данные MyDHL API: API key и API secret. Запросите их на портале разработчиков DHL (MyDHL API, "Get access") или у вашего аккаунт-менеджера DHL Express. Учётные записи, у которых ещё есть учётные данные DHL XML Services (Site ID и пароль), могут использовать их вместо этого. Если вы используете только резервные цены, учётные данные DHL не нужны.

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

Установка

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

2. Нажмите Activate.

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

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

5. Выберите DHL API, введите API key, API secret и номер учётной записи DHL. Оставьте Test mode включённым, пока используете тестовые данные. Введите адрес Ship from. Если счета по вашей учётной записи DHL выставляются не в валюте вашего магазина, задайте DHL quote currency и Exchange rate. По желанию задайте цены по странам и резервную стоимость (см. раздел «Настройка»).

6. Добавьте DHL Express Africa в зоны доставки в WooCommerce > Settings > Shipping > Shipping zones или включите Ignore shipping zones и выберите страны.

Настройка

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

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

Предупреждения над настройками сообщают, когда тарифы в реальном времени отключены из-за отсутствия учётных данных или адреса отправления, и когда валюта котировки задана без курса обмена. Каждый раз при сохранении настроек кэшированные котировки DHL очищаются. В ценах и весе можно использовать десятичную запятую или точку.

Общие

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

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

Tax status: Taxable (при включённых налогах WooCommerce) берёт тариф DHL без налога, который указан в котировке DHL, а WooCommerce добавляет свой налог. None берёт тариф DHL как указано в котировке, включая налог.

Учётная запись DHL Express (нужна только для тарифов в реальном времени)

DHL API: какой интерфейс DHL используется. Показываются только поля выбранного API.

API key: ваш логин MyDHL API (API key).

API secret: ваш пароль MyDHL API (API secret).

XML Site ID: ваш Site ID DHL XML Services (только для устаревшего API).

XML password: ваш пароль DHL XML Services (только для устаревшего API).

DHL account number: номер вашей учётной записи DHL Express (9 цифр). MyDHL API требует его. С XML Services он возвращает тарифы вашей учётной записи вместо опубликованных тарифов.

Test mode: использовать тестовую среду DHL. По умолчанию включено. Тестовые данные работают только в тестовой среде, а рабочие — только в рабочей. Выключите его при переходе к реальной работе.

Отправка из

Адрес, с которого DHL забирает посылки. От него зависит тариф.

Origin country: страна, из которой вы отправляете.

Origin city: город, из которого вы отправляете, например Йоханнесбург. MyDHL API требует его.

Origin postcode: оставьте пустым для стран без почтовых индексов (например Кения, Нигерия, Гана).

Тарифы

Все цены указаны в валюте вашего магазина. Тариф в реальном времени — самый дешёвый продукт DHL Express для посылки. Если DHL не настроен, возвращает ошибку или не имеет услуги для маршрута, используется цена страны, затем резервная стоимость. Если нет ни того, ни другого, способ доставки скрывается.

DHL quote currency: DHL выставляет котировку в валюте страны вашей учётной записи DHL (например ZAR, NGN или KES). Если DHL не возвращает сумму в валюте вашего магазина, тариф в реальном времени пересчитывается из этой валюты по курсу ниже. Иначе он не используется.

Exchange rate: сколько 1 единица валюты котировки DHL составляет в валюте вашего магазина, например 1 ZAR = 0.05. Оставьте пустым, если пересчёт не нужен. Курс задаётся вручную.

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

Country prices: резервная цена для каждой страны назначения, по одной в строке: CC:Price, например ZA:25.00. Используется, когда нет тарифа в реальном времени.

Fallback price basis: Per order берёт цену один раз. Per item (multiplied by the cart quantity) умножает её на количество товаров. Применяется только к цене страны и резервной стоимости. Тариф DHL в реальном времени всегда рассчитывается на всю посылку.

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

Условия

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

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

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

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

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

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

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

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

Debug log: записывает расчёты тарифов в WooCommerce > Status > Logs, источник vfd-dhl-africa. Ошибки DHL записываются всегда, даже когда опция выключена. Учётные данные и адреса покупателей никогда не записываются.

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

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

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

Иначе плагин отправляет в DHL адреса отправления и назначения (страна, город, почтовый индекс), вес корзины, пересчитанный в кг (не менее 0,5 кг), и одну коробку, собранную по размерам товаров в см: наибольшая длина, наибольшая ширина и сумма высот товаров в стопке. Товары без размеров ничего не добавляют. Если ни у одного товара нет размеров, используется коробка 10 x 10 x 10 см. Международные отправления декларируются как товары, с суммой корзины как объявленной стоимостью, поэтому DHL рассчитывает тариф для товарных посылок. Внутренние отправления не декларируются. Тариф в реальном времени запрашивается только после того, как покупатель ввёл город (с XML Services — город или почтовый индекс).

Самый дешёвый продукт DHL Express показывается как один тариф с вашим названием. Покупатель не видит продукт DHL и срок доставки. Название продукта (например "EXPRESS WORLDWIDE (P)") сохраняется как DHL product в строке доставки заказа, чтобы вы знали, что заказывать.

Каждая котировка кэшируется на 1 час для каждой посылки и маршрута. Неудачный запрос кэшируется на 10 минут, чтобы оформление заказа не ждало DHL при каждом обновлении. Тайм-аут API — 12 секунд. Если DHL возвращает ошибку или не имеет услуги, покупатель не видит ошибки: используется резервная цена или способ скрывается.

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

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

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

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

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

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

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

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

DHL Express не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включено и способ добавлен в зону страны покупателя (или включено Ignore shipping zones и страна разрешена). Проверьте ограничения по весу, Minimum subtotal и Excluded shipping classes. Без тарифа в реальном времени способ появляется, только если задана цена страны или резервная стоимость.

Тарифы в реальном времени не появляются: проверьте предупреждения вверху страницы настроек (отсутствуют учётные данные или адрес отправления). Включите Debug log и откройте WooCommerce > Status > Logs, источник vfd-dhl-africa. Ошибки DHL, например неверные учётные данные, отсутствие услуги для маршрута или проблема с валютой, всегда записываются. Проверьте, что Test mode соответствует вашим учётным данным.

DHL возвращает тариф в ZAR, NGN или KES, но мой магазин использует другую валюту: укажите эту валюту в DHL quote currency и введите Exchange rate. Без этого тариф в реальном времени не используется, и применяются резервные цены.

У меня старые учётные данные DHL XML Services: выберите XML Services (legacy) в DHL API. Переключитесь на MyDHL API, когда получите учётные данные MyDHL.

Налог на доставку начисляется дважды: задайте Tax status как Taxable, чтобы тариф DHL брался без НДС DHL, или None, чтобы начислять сумму DHL как указано в котировке.

Тарифы выглядят устаревшими после изменения: сохраните страницу настроек. Это очистит кэшированные котировки DHL.

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

Удаление

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

DHL — товарный знак соответствующего правообладателя. Этот плагин не связан с DHL и не одобрен ею.