VibeFox Shippo for WooCommerce — Помощь

Требования

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

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

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

Учётная запись Shippo: создайте учётную запись Shippo, подключите или включите перевозчиков (USPS, UPS, FedEx, DHL и других) и скопируйте API-токен в разделе Shippo > Settings > Advanced > API. Shippo взимает плату за купленные этикетки, а не за запросы тарифов. Новые учётные записи Shippo могут потребовать проверки со стороны Shippo, прежде чем начнут возвращаться актуальные тарифы. Без токена используются только резервные цены.

Товары: у товаров должны быть вес и габариты. Товары без габаритов используют размер коробки по умолчанию.

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

Установка

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

2. Нажмите Activate.

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

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

5. Вставьте API-токен Shippo и заполните адрес Ship from. Почтовый индекс обязателен.

6. Выберите Shippo rate currency (USD, если вы отправляете из США) и, если ваш магазин использует другую валюту, введите курс обмена.

7. При желании введите резервные цены в таблице по странам и весу.

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

Настройка

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

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

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

Общие

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

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

Учётная запись Shippo

API token: ваш API-токен Shippo. Используйте боевой токен (shippo_live_...) для реальных тарифов в рабочем магазине или тестовый токен (shippo_test_...) для тестовых тарифов Shippo.

Allowed carriers / services: необязательно, через запятую. Укажите перевозчика так, как его называет Shippo (USPS, UPS, FedEx, DHL Express), или токен уровня сервиса Shippo (usps_priority, ups_ground). Показывается самый дешёвый разрешённый тариф. Оставьте поле пустым, чтобы показывать самый дешёвый тариф любого перевозчика.

Ship from (адрес, с которого отправляются посылки; пустые поля заполняются из адреса магазина в WooCommerce > Settings > General, если он в той же стране)

Sender name / company: имя отправителя. Оно также используется для подписи таможенной декларации.

Street address: улица отправителя.

City: город отправителя.

State / province: двухбуквенный код штата или области, например CA или NY. Некоторым перевозчикам он нужен.

Postal / ZIP code: обязательно для актуальных тарифов.

Country: страна, из которой вы отправляете. По умолчанию: United States.

Тарифы

Parcels: как корзина отправляется в Shippo.

Default box size: длина x ширина x высота в единицах измерения вашего магазина, например 30 x 20 x 10. Shippo требует размер коробки. Он используется, когда у товара в корзине нет габаритов. Оставьте пустым, чтобы использовать 30 x 20 x 10 см.

Shippo rate currency: валюта, в которой Shippo котирует тарифы перевозчиков, то есть валюта страны отправки: USD (США), CAD (Канада), GBP (Великобритания), EUR (еврозона) или AUD (Австралия). По умолчанию: USD. Тарифы, которые Shippo возвращает в валюте магазина, всегда используются как есть.

Exchange rate: цена 1 единицы Shippo rate currency в валюте вашего магазина, например 0.92. Не нужен, если валюты совпадают. Без него тарифы в другой валюте не используются, и действуют резервные цены. Плагин не конвертирует валюты автоматически.

Tax status: Taxable позволяет WooCommerce начислять налог на доставку по вашим налоговым правилам, None — нет. Тарифы Shippo не включают налог с продаж.

Резервные цены (используются, когда актуального тарифа нет: нет API-токена, Shippo недоступен, токен отклонён или для адреса нет тарифов перевозчиков; цены в валюте магазина; оставьте оба поля пустыми, чтобы скрыть способ в этом случае)

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

Other countries: цена для стран, которых нет в таблице выше (если нет строки * Default). Оставьте пустым, чтобы скрыть способ для них.

Условия

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

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

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

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

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

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

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

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

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

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

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

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

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

Затем плагин отправляет в Shippo адрес отправки, адрес покупателя и посылку. Для стран, где WooCommerce требует почтовый индекс, запрос ждёт, пока покупатель его введёт. Для международных отправлений добавляется таможенная декларация с названиями товаров, количеством, весом и стоимостью. Shippo возвращает тарифы ваших перевозчиков, и плагин показывает самый дешёвый разрешённый тариф в валюте магазина под названием способа доставки.

В режиме «одна посылка на заказ» товары упаковываются в одну коробку: самая длинная и средняя стороны самых крупных товаров и наименьшие стороны всех единиц, сложенные вместе. Если у какого-либо товара нет габаритов, для всей посылки используется размер коробки по умолчанию. В режиме «одна посылка на товар» каждый товар тарифицируется как отдельная посылка, а тариф умножается на его количество.

Каждый ответ кэшируется на 1 час для каждого адреса и посылки. Если Shippo отвечает без пригодного тарифа, адрес запоминается на 10 минут. После тайм-аута, отклонённого токена, ошибки сервера или ограничения частоты запросов плагин приостанавливает запросы на 5 минут и использует резервные цены. Тайм-аут запроса — 10 секунд.

Если актуального тарифа нет, цена берётся из резервной таблицы, затем из Other countries. Если ни одна из них не подходит, способ скрывается. Покупатель никогда не видит ошибку.

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

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

Заказы

Строка доставки заказа сохраняет выбранные Carrier / service и, для одной посылки на заказ, Estimated delivery days. Вы видите их на экране заказа в админке и можете купить соответствующую этикетку в Shippo.

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

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

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

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

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

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

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

Актуальные тарифы не появляются: включите Debug log, обновите страницу оформления заказа и откройте WooCommerce > Status > Logs, источник vfd-shippo. Частые причины: нет API-токена или почтового индекса отправителя, валюта магазина отличается от Shippo rate currency без курса обмена, почтовый индекс покупателя ещё не введён, ни один перевозчик вашей учётной записи Shippo не обслуживает адрес, или учётная запись Shippo ещё не проверена.

Тестовые тарифы в рабочем магазине: тестовый токен (shippo_test_...) возвращает тестовые тарифы Shippo. Используйте боевой токен (shippo_live_...).

Бесплатная доставка для неожиданных стран: проверьте таблицу цен на наличие пустой строки, особенно пустой строки * Default. Строка со всеми пустыми ячейками взимает 0.

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

Для разработчиков: фильтры vfd_shpo_shipment_request, vfd_shpo_customs_declaration, vfd_shpo_selected_rate и vfd_shpo_api_url изменяют тело запроса, таможенную декларацию, выбранный тариф и URL API.

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

Удаление

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

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