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

Требования

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

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

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

DHL API key: список пунктов загружается из бесплатного API DHL Location Finder. Зарегистрируйтесь на портале разработчиков DHL (developer.dhl.com), создайте приложение, добавьте API «Location Finder - Unified» и скопируйте API-ключ приложения. Для этого API не нужен коммерческий договор с DHL. Без ключа способ доставки скрыт при оформлении заказа. Учитывайте лимит запросов вашего приложения DHL: каждый новый поиск по индексу или городу — это один запрос к API.

VibeFox license key: покупается на vibefox.net. Один ключ работает на одном домене.

Установка

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

2. Нажмите Activate.

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

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

5. Вставьте API-ключ DHL, сохраните, нажмите Test API key, выберите типы пунктов и введите цены по странам (см. Настройка).

6. Добавьте DHL Packstation в зону доставки (например Германия) в WooCommerce > Settings > Shipping > Shipping zones или включите Ignore shipping zones.

Настройка

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

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

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

Общие

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

Name: название способа доставки, которое видит покупатель. По умолчанию: DHL Packstation. Зона может переопределить его своим Title.

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

DHL Location Finder API

DHL API key: API-ключ вашего приложения на developer.dhl.com. Без него способ доставки скрыт при оформлении заказа.

Connection test: кнопка Test API key ищет пункты рядом с 53113 Bonn сохранённым ключом и очищает кэш пунктов. Сначала сохраните настройки. Показывает, сколько пунктов найдено, или что DHL отклонил ключ (401/403).

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

Location types: какие пункты DHL может выбрать покупатель: Packstation (parcel locker), Post Office (Postfiliale) и DHL Parcel Shop (Paketshop). По умолчанию все три. Если не выбран ни один, способ скрыт. Для Packstation покупатель должен ввести свой DHL Postnummer.

Search radius (meters): радиус вокруг искомого индекса или города. По умолчанию: 5000. DHL допускает до 25000 м.

Max results: максимальное количество пунктов, показываемых за один поиск. По умолчанию: 20. DHL допускает до 50.

Shipping address: использовать выбранный пункт как адрес доставки заказа. Включено по умолчанию. Адресная строка 1 становится, например, «Packstation 105», строка 2 — «Postnummer» с номером, плюс индекс и город пункта, чтобы этикетки, напечатанные из заказа, попадали в нужное место. Postnummer также сохраняется как _shipping_dhl_postnum — поле, которое читает официальный плагин «DHL Shipping Germany for WooCommerce».

Цены

Country prices: цена за страну назначения в валюте магазина в формате CC:ЦЕНА, через запятые или с новой строки. По умолчанию: DE:4.99, AT:5.99. Работает и десятичная запятая (DE:4,99).

Other countries: цена для страны назначения, которой нет в Country prices. По умолчанию: 5.99. Оставьте пустым, чтобы скрыть способ для таких стран.

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

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

Доступность

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

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

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

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

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

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

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

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

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

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

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

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

Плагин не создаёт отправления DHL, не печатает этикетки и не отслеживает посылки. Используйте портал для корпоративных клиентов DHL или плагин для этикеток: заказ уже содержит адрес Packstation и Postnummer в нужном для них формате. Плагин не рассчитывает тарифы DHL в реальном времени и не показывает карту. Если API DHL недоступен, покупатель видит сообщение и не может использовать этот способ, пока API снова не заработает. Ручной ввод номера Packstation не предусмотрен.

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

Когда покупатель выбирает DHL Packstation, под вариантом доставки появляется выбор пункта. Загружаются пункты DHL рядом с индексом или городом доставки. Покупатель может искать другой индекс или город. Пункты группируются по типу (Packstation, Post Office, Parcel Shop) и сортируются по расстоянию.

Для Packstation покупатель обязан ввести DHL Postnummer — свой 6–12-значный номер клиента DHL из приложения DHL или аккаунта DHL. Для других пунктов он необязателен. Заказ нельзя оформить без пункта выдачи или с неверным Postnummer. Это проверяется на сервере, в том числе при оформлении в блоках.

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

Пункт (ID, тип, номер, название, адрес) и Postnummer сохраняются в заказе. Они показываются на экране заказа под адресом доставки, на странице благодарности, в My account > Orders и в письмах о заказе (HTML и текстовая версия) как DHL pickup location и DHL Postnummer.

На экране заказа нажмите Edit рядом с пунктом, найдите по индексу или городу, выберите другой пункт, измените Postnummer и нажмите Save location. Каждое изменение добавляет примечание к заказу. Если включён параметр Shipping address, обновляется и адрес доставки. Обновите страницу, чтобы увидеть изменения.

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

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

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

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

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

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

DHL Packstation не появляется при оформлении заказа: проверьте, что лицензия активна, что Enable/Disable включено и способ добавлен в зону страны покупателя (или включено Ignore shipping zones и страна разрешена). Проверьте, что DHL API key заполнен, выбран хотя бы один тип пунктов, у страны назначения есть цена (или задано Other countries), а правила по весу, сумме и классу доставки не скрывают способ.

Пункты не отображаются: нажмите Test API key. Если DHL отклоняет ключ (401/403), проверьте ключ и то, что в вашем приложении есть API «Location Finder - Unified». Включите Debug log и откройте WooCommerce > Status > Logs, источник vfd-dhl-packstation. Проверьте, что лимит запросов вашего приложения DHL не исчерпан.

Нет пунктов рядом с адресом: увеличьте Search radius (meters) или Max results либо позвольте покупателю искать другой индекс или город.

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

Удаление

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

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