VibeFox SMSA Express for WooCommerce — Помощь

Требования

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

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

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

Тарифы SMSA Express: цены для тарифной таблицы берутся из вашего аккаунта SMSA или у отдела продаж SMSA. Вводите их в валюте вашего магазина. Если ваши тарифы в SAR, AED или другой валюте, сначала пересчитайте их.

passKey SMSA (только для расчёта в реальном времени): расчёт в реальном времени использует веб-сервис SMSA (SECOM, операция getShipCharges). SMSA выдаёт passKey по запросу: обратитесь к менеджеру вашего аккаунта SMSA или напишите на info@smsaexpress.com и попросите доступ к веб-сервису SMSA, указав номер вашего аккаунта. passKey может отличаться от API-ключа портала электронной коммерции SMSA. Для этого сервиса SMSA не предоставляет тестовый сервер (sandbox).

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите ваши цены SMSA Express в тарифную таблицу.

6. Необязательно: в разделе Live rates (API) включите Live charges, введите passKey SMSA, город и страну отправления и, если валюта вашего магазина не SAR, курс обмена.

7. Добавьте VibeFox SMSA Express в зону доставки в WooCommerce > Settings > Shipping > Shipping zones (например, «Саудовская Аравия») или включите Ignore shipping zones и выберите страны.

Настройка

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

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

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

Общие

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

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

Расчёт в реальном времени (API) (необязательно; если SMSA не возвращает стоимость, используется тарифная таблица)

Live charges: получать стоимость доставки от SMSA Express. По умолчанию: выкл.

SMSA passKey: ключ веб-сервиса SMSA (SECOM). Если в журнале написано «Invalid Passkey», этот сервис не принимает ключ. Запросите у SMSA passKey веб-сервиса.

Ship-from city: город, из которого отправляются ваши посылки, написанный так, как его пишет SMSA, например Riyadh, Jeddah или Dammam. Оставьте поле пустым, чтобы использовать город магазина из WooCommerce > Settings > General.

Ship-from country: страна, из которой отправляются ваши посылки. По умолчанию это страна вашего магазина.

Shipment type: передаётся в SMSA как тип отправления. DLV (по умолчанию) означает стандартную доставку. Меняйте его, только если SMSA дал вам другой код.

Currency of SMSA charges: SMSA возвращает каждую стоимость с кодом валюты, обычно SAR (по умолчанию). Стоимость в любой другой валюте, кроме этой и валюты вашего магазина, не используется.

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

Цены (ваши тарифы SMSA Express в валюте магазина; используются, когда расчёт в реальном времени выключен, и как запасной вариант, если SMSA не возвращает стоимость)

Price table: одна строка на страну назначения. Нажмите + Add country, чтобы добавить строку, и крестик, чтобы удалить строку. Строка * All other countries применяется к странам, у которых нет собственной строки. Каждая строка содержит базовую цену и весовые колонки: XS до 1 кг, S до 2 кг, M до 3 кг, L до 5 кг и XL свыше 5 кг. Пустая или нулевая весовая колонка использует базовую цену. Базовая цена 0 означает бесплатную доставку. Строки без единой цены удаляются при сохранении. Принимаются как «9.99», так и «9,99».

Price for countries not in the table: используется, когда в таблице нет строки для страны назначения (и нет строки *) или в строке нет цены для этого веса. Оставьте поле пустым, чтобы в этом случае скрыть способ.

Price applies: как рассчитывается цена.

Веса товаров переводятся из единицы веса вашего магазина в килограммы.

Условия

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

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

Minimum order amount: показывает способ, только если промежуточная сумма корзины (после скидок, до налогов) достигает этой суммы. Оставьте поле пустым, чтобы показывать способ всегда.

Free shipping from: промежуточная сумма корзины (после скидок, до налогов), начиная с которой доставка SMSA Express бесплатна. Бесплатная доставка предлагается только там, где у способа есть цена для назначения: стоимость SMSA, строка таблицы или цена для стран вне таблицы. Если в таблице есть цена, запрос к SMSA не отправляется. Оставьте поле пустым, чтобы никогда не предлагать бесплатную доставку.

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

Tax status: Taxable добавляет налог WooCommerce к стоимости доставки, None не добавляет. Выберите None, если ваши цены (таблица и стоимость SMSA) уже включают налог, например НДС Саудовской Аравии.

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

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

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

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

Debug log: записывает каждый расчёт тарифа в WooCommerce > Status > Logs, источник vfd_smsa_express. Адреса покупателей и ключи не записываются. Ошибки расчёта в реальном времени записываются всегда, даже когда эта опция выключена. Выключите журнал, когда закончите.

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

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

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

При включённом расчёте в реальном времени плагин отправляет в SMSA город и страну отправления, город и страну покупателя, тип отправления, вес посылки в кг и сумму наложенного платежа 0. SMSA отвечает стоимостью и её валютой. Плагин пересчитывает её в валюту вашего магазина и показывает. Расчёт в реальном времени запрашивается только после того, как покупатель ввёл город.

Каждый расчёт кэшируется на час, поэтому одна и та же корзина не вызывает новый запрос. Неудачный запрос кэшируется на 5 минут. После тайм-аута или ошибки сервера SMSA не запрашивается 2 минуты. После отклонённого ключа — 5 минут. Так оформление заказа никогда не ждёт неработающего сервиса при каждом обновлении. Тайм-аут запроса — 12 секунд.

Всякий раз, когда SMSA не возвращает пригодной стоимости (нет passKey, город ещё не введён, нет весов товаров, неверный ключ, тайм-аут, ошибка, нет сервиса в город или неизвестная валюта), используется тарифная таблица. Если таблица и Price for countries not in the table не дают цены, способ скрывается. Покупатель никогда не видит ошибку. Причина записывается в журнал.

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

Плагин только рассчитывает стоимость доставки. Он не создаёт отправления SMSA, не печатает накладные AWB, не обрабатывает возвраты и не отслеживает посылки. Наложенный платёж и его комиссия не входят в расчёт в реальном времени. Выбора розничного пункта SMSA нет: способ — доставка до двери.

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

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

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

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

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

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

SMSA Express не появляется при оформлении заказа: проверьте, что лицензия активна, что Enable/Disable включено и способ добавлен в зону страны покупателя (или что включена опция Ignore shipping zones и страна разрешена). Проверьте ограничения по весу, Minimum order amount и Excluded shipping classes. Проверьте, что у страны или * есть цена или что задана опция Price for countries not in the table.

Покупатели видят цену из таблицы вместо стоимости SMSA: SMSA нужен город покупателя, поэтому до его ввода показывается цена из таблицы. Таблица также используется, когда SMSA не отвечает, отклоняет ключ или город или возвращает стоимость в валюте без курса обмена. Откройте WooCommerce > Status > Logs, источник vfd_smsa_express, чтобы узнать причину.

«Invalid Passkey» в журнале: ключ не принимается веб-сервисом SMSA. Запросите у SMSA passKey веб-сервиса.

Город покупателя не принимается: SMSA ожидает собственное написание городов. Разработчики могут изменить запрос, например название города, с помощью фильтра vfd_smsa_express_live_request_fields.

Налог на доставку начисляется дважды: ваши тарифы или стоимость SMSA могут уже включать НДС. Установите Tax status в значение None.

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

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

Удаление

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

SMSA Express — товарный знак его правообладателя. Этот плагин не связан с SMSA Express и не одобрен SMSA Express.