VibeFox 99Minutos for WooCommerce — Помощь

Требования

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

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

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

API-ключ 99minutos (только для проверки покрытия): получите его у своего менеджера аккаунта 99minutos или на портале разработчиков 99minutos (developers.99minutos.com). Ключи тестовой и рабочей среды различаются. Если вы используете только матрицу цен, API-ключ не нужен.

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

Установка

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

2. Нажмите Activate.

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

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

5. Заполните Price matrix (хотя бы одну строку, например «* Default») и, при желании, API-ключ и режим проверки покрытия (см. раздел «Настройка»).

6. Добавьте VibeFox 99Minutos в зону доставки в WooCommerce > Settings > Shipping > Shipping zones, которая включает Мексику, Колумбию, Чили или Перу.

Настройка

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

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

При сохранении настроек страница предупреждает, если матрица цен пуста или выбран режим проверки покрытия без API-ключа.

Общие

Enable/Disable: включает 99Minutos во всех зонах доставки сразу. Способ также нужно добавить в зону доставки, которая включает Мексику, Колумбию, Чили или Перу. По умолчанию: включено.

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

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

API 99minutos (проверка покрытия) (необязательно)

API используется только для проверки того, доставляет ли 99minutos по почтовому индексу покупателя. Цена всегда берётся из матрицы.

Coverage check: проверять ли почтовый индекс и каким способом.

При проверке покрытия способ доставки появляется только после того, как покупатель введёт почтовый индекс. Результаты кэшируются: покрыто — 6 часов, не покрыто — 30 минут, ошибка API — 5 минут. В 99minutos отправляется только почтовый индекс.

API key: ваш API-ключ 99minutos, который передаётся как Bearer-токен на эндпоинт проверки покрытия 99minutos. Обязателен, когда проверка покрытия включена. Поле скрыто маской.

Environment: Sandbox (test) (по умолчанию) или Production. Тестовая и рабочая среды используют разные API-ключи, поэтому выберите среду, которая соответствует вашему ключу.

Тарифы

Цены указываются в валюте магазина и используются так, как введены, без конвертации.

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

Calculation: Per order — size by the total cart weight (по умолчанию) взимает одну цену за размер посылки всей корзины. Per item — each unit priced by its own weight оценивает каждую единицу по размеру её собственного веса и складывает результаты.

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

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

Ограничения

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

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

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

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

Restrict countries: предлагает способ доставки только для стран, перечисленных ниже. Это дополнительный фильтр поверх зон доставки: способ всё равно нужно добавить в зону. Полезно, когда одна зона охватывает несколько стран.

Countries: выбор стран 99minutos (Мексика, Колумбия, Чили, Перу). Используется только если включена опция Restrict countries. Оставьте пустым, чтобы разрешить все страны 99minutos.

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

Debug log: записывает расчёты тарифов в WooCommerce > Status > Logs (источник «vfd-99minutos»). Ошибки API записываются, даже когда опция выключена. Ключи API, имена и адреса покупателей никогда не записываются в журнал.

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

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

Способ доставки предлагается, только если страна доставки — Мексика, Колумбия, Чили или Перу (и входит в список Countries, если включена опция Restrict countries). Когда покупатель вводит адрес доставки, плагин проверяет ограничения по весу корзины, Minimum subtotal и Excluded shipping classes.

Если включён режим проверки покрытия, плагин затем запрашивает у API 99minutos, покрыт ли почтовый индекс. Тайм-аут запроса — 10 секунд, ответ кэшируется, поэтому для одного и того же индекса новый запрос не отправляется. Ошибки API никогда не показываются покупателю: в режиме Strict способ скрывается, в режиме Soft используется цена из матрицы. Бесплатная доставка не обходит проверку покрытия.

Цена берётся из строки матрицы для страны доставки или из строки * Default. Если нет ни той, ни другой, способ скрывается. Если включена опция Free shipping и промежуточный итог корзины достигает Free shipping from, тариф равен 0.

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

Плагин не получает от 99minutos актуальные котировки: цены всегда берутся из вашей матрицы. Он не создаёт отправления и заказы в 99minutos, не печатает этикетки (guides), не отслеживает посылки, не предлагает пункты выдачи Punto99 и не принимает оплату при получении. Создавайте отправления в своём аккаунте 99minutos как обычно.

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

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

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

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

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

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

99Minutos не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включено и способ добавлен в зону, которой относится адрес покупателя. Страна доставки должна быть Мексика, Колумбия, Чили или Перу. Убедитесь, что в Price matrix есть строка для этой страны или строка * Default, а также проверьте ограничения по весу, Minimum subtotal, Excluded shipping classes и Restrict countries.

Способ появляется только после ввода почтового индекса: это ожидаемо при проверке покрытия. В режиме Strict он появляется, только если API подтверждает покрытие.

Способ всегда скрыт в режиме Strict: включите Debug log, обновите страницу оформления заказа и откройте WooCommerce > Status > Logs (источник «vfd-99minutos»). Ошибка HTTP 401 или 403 означает, что API-ключ отклонён: проверьте ключ и соответствие Environment (ключи тестовой и рабочей среды различаются). Используйте режим Soft, если покупатели должны видеть цену из матрицы, пока API недоступен.

Цена не такая, как вы ожидали: проверьте Calculation (по заказу или по товару), веса товаров и единицу измерения веса в магазине. Пустая или нулевая цена размера заменяется на Base price.

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

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

Удаление

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

99minutos — товарный знак его правообладателя. Этот плагин не аффилирован с 99minutos и не одобрен компанией 99minutos.