VibeFox Delhivery for WooCommerce — Помощь

Требования

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

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

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

API-токен Delhivery (только для актуальных тарифов): войдите в Delhivery One и откройте Settings > API setup. Шаги описаны в статье справки Delhivery «API token generation». Тестовые токены работают с тестовой средой (staging). Также нужен 6-значный PIN-код вашего пункта отгрузки. Если вы используете только фиксированные цены, токен не нужен.

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите API-токен и PIN-код отправления, выберите Express или Surface, а также Pre-paid или COD. Если валюта вашего магазина не INR, введите курс пересчёта. При желании введите фиксированные цены (см. раздел «Настройка»).

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

Настройка

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

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

При каждом сохранении настроек кешированные тарифы Delhivery очищаются. Цены и суммы принимают «9.99» и «9,99».

Общие

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

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

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

Учётная запись API Delhivery (нужна только для актуальных тарифов)

Environment: Production (track.delhivery.com) (по умолчанию) или Staging / test account (staging-express.delhivery.com). Используйте Staging только с тестовым токеном Delhivery.

API token: ваш API-токен Delhivery. Он отправляется только в заголовке авторизации и никогда не записывается в логи.

Origin pincode: 6-значный PIN-код вашего пункта отгрузки или склада, например 110001.

Актуальные тарифы

Актуальный тариф запрашивается для направлений в Индии с действительным 6-значным PIN-кодом, для прямой доставки.

Shipping mode: тарифный режим Delhivery для расчёта: Express (по умолчанию) или Surface.

Payment type: тип оплаты, который передаётся в Delhivery: Pre-paid (по умолчанию) или COD (наложенный платёж; Delhivery добавляет свою комиссию COD). Плагин не меняет его в зависимости от способа оплаты, выбранного покупателем.

Rate amount: Delhivery возвращает стоимость с GST и без GST.

INR to (store currency) conversion rate: тарифы Delhivery указаны в индийских рупиях. Если валюта вашего магазина не INR, введите, сколько единиц вашей валюты стоит одна рупия, например 0.011. Если поле пустое, актуальные тарифы не используются, применяются фиксированные цены и над настройками выводится предупреждение. Не нужно, если валюта магазина — INR.

Фиксированные цены (используются, когда актуального тарифа нет)

Фиксированные цены применяются, если токен или PIN-код ещё не указаны, адрес доставки находится за пределами Индии, PIN-код не обслуживается или API вернул ошибку. Цены указаны в валюте вашего магазина.

Prices per country: по одной записи в строке в формате COUNTRY_CODE:price, например IN:120. Проверяются раньше резервной цены.

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

Fixed price is charged: Per order — цена списывается один раз. Per item (price × quantity) — цена умножается на количество товаров в корзине. Актуальный тариф Delhivery всегда рассчитывается по общему весу посылки.

Условия

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

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

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

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

Веса товаров переводятся в кг из единицы веса вашего магазина. Тариф использует фактический вес корзины (сумму весов товаров) без объёмного веса и коробок.

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

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

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

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

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

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

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

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

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

Для адреса в Индии с действительным 6-значным PIN-кодом плагин отправляет в Delhivery PIN-коды отправления и назначения, вес корзины в граммах, режим доставки и тип оплаты, и показывает возвращённую сумму, пересчитанную в валюту вашего магазина. Каждый ответ кешируется на 1 час. Неудачный запрос кешируется на 10 минут, чтобы оформление заказа не ждало Delhivery при каждом обновлении. Таймаут API — 10 секунд.

Если актуального тарифа нет, используется цена для страны или резервная цена. Если не задано ни одно, способ скрывается. Покупатель никогда не видит ошибку API.

Способ работает в классическом оформлении заказа и в блоках «Корзина» и «Оформление заказа». Он совместим с HPOS (хранилищем заказов высокой производительности) WooCommerce.

Плагин рассчитывает тарифы и показывает ссылку для отслеживания. Он не создаёт отправления и накладные, не печатает этикетки, не вызывает курьеров и не формирует манифесты, не проверяет обслуживание PIN-кодов, не оценивает даты доставки, не синхронизирует статусы отслеживания и не рассчитывает международные тарифы Delhivery. За пределами Индии используются только фиксированные цены.

Заказы и отслеживание

На экране заказа, под адресом доставки, блок Delhivery показывает режим доставки (Express или Surface) и источник цены: актуальный тариф Delhivery, фиксированная цена или порог бесплатной доставки.

Создайте отправление в Delhivery One, затем вставьте его AWB в поле Delhivery AWB / tracking number и сохраните заказ. В админке появится ссылка Track on delhivery.com. Покупатель видит Delhivery tracking со ссылкой на странице заказа в разделе «Мой аккаунт» и в письмах о заказе (HTML и текст). AWB сохраняется раньше статуса заказа, поэтому письмо «Выполненный заказ» уже содержит его, если вы выполняете заказ тем же сохранением.

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

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

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

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

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

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

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

Актуальные тарифы не появляются: проверьте API-токен, корректный Origin pincode и, если валюта магазина не INR, курс пересчёта. Покупатель должен ввести корректный 6-значный индийский PIN-код. Включите Debug log и откройте WooCommerce > Status > Logs, источник vfd_delhivery, чтобы увидеть ошибки API, например PIN-код, который не обслуживается.

GST начисляется дважды: общая сумма Delhivery уже включает GST. Установите Rate amount в значение Gross amount (excluding GST) или Tax status в значение None.

Тестирование: используйте Environment Staging с тестовым токеном Delhivery.

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

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

Удаление

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

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