VibeFox Coordinadora for WooCommerce — Помощь

Требования

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

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

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

Ключ API Coordinadora (только для онлайн-тарифов): онлайн-тарифы поступают из Coordinadora Cotizador через сервис Coordinadora для WooCommerce, тот же сервис, который использует официальный плагин Coordinadora. Coordinadora выдаёт ключ API клиентам с действующим коммерческим соглашением. Уточните у своего менеджера Coordinadora или см. wc.coordinadora.com. Также нужен 8-значный код DANE города отправки. Без ключа способ доставки работает только с фиксированными ценами.

Товары: для онлайн-тарифа каждый товар в корзине должен иметь вес и габариты (длину, ширину, высоту).

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите ключ API, код DANE города отправки и, если валюта магазина не COP, курс в COP. Добавьте хотя бы одну фиксированную цену для Колумбии как запасной вариант (см. Настройка).

6. Добавьте VibeFox Coordinadora в зону доставки, которая охватывает Колумбию, в разделе WooCommerce > Settings > Shipping > Shipping zones, или включите Ignore shipping zones и выберите страны.

7. Убедитесь, что у ваших товаров указаны вес и габариты.

Настройка

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

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

Страница настроек показывает предупреждения вверху, если онлайн-тарифы не могут работать или способ был бы скрыт: код DANE города отправки отсутствует или неверен, курс COP не указан или для Колумбии нет фиксированной цены. При каждом сохранении настроек кэш тарифов очищается. Числа можно вводить с точкой или запятой (9,99 = 9.99).

Общие

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

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

Tax status: Taxable добавляет налог на доставку WooCommerce сверх тарифа, None не добавляет. Выберите None, если ваши цены или тариф Coordinadora уже включают налог.

Онлайн-тарифы Coordinadora

Онлайн-тарифы запрашиваются для адресов в Колумбии. Оставьте ключ пустым, чтобы использовать только фиксированные цены.

API key: ваш ключ API Coordinadora для WooCommerce. Он никогда не записывается в журнал.

Origin city (DANE code): 8-значный код DANE города, из которого вы отправляете, например 11001000 Bogotá, 05001000 Medellín, 76001000 Cali или 08001000 Barranquilla. Принимается и 5-значный код муниципалитета, он дополняется до 8 знаков.

COP per 1 unit of store currency: Coordinadora рассчитывает тарифы в колумбийских песо. Если валюта вашего магазина не COP, укажите, сколько COP составляет 1 единица вашей валюты, например 4300. Курс также используется для передачи объявленной стоимости в COP. Если оставить поле пустым, онлайн-тарифы не используются. Если валюта магазина COP, оставьте поле пустым.

Фиксированные цены (используются, когда нет ключа API, для направлений за пределами Колумбии и как запасной вариант, если онлайн-тариф недоступен)

Prices by country: таблица стран со столбцом Price и необязательными ценами по размеру посылки в валюте вашего магазина. Размер определяется по весу корзины: XS до 1 кг, S 1–2 кг, M 2–3 кг, L 3–5 кг, XL свыше 5 кг. Price используется, когда ячейка размера равна 0 или пуста. Нажмите + Add country, чтобы добавить строку, и значок крестика, чтобы удалить её. Страна * All other countries применяется к странам без собственной строки. Страна без строки (и без *) не получает фиксированную цену. Строка с Price 0 и без цены по размеру даёт бесплатную доставку.

Fixed price per: Order взимает цену один раз. Item (price × quantity) умножает её на количество товаров в корзине. Это относится только к фиксированным ценам; онлайн-тариф Coordinadora всегда покрывает весь заказ.

Условия

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для адреса в Колумбии с ключом API плагин определяет код DANE города назначения в таком порядке: код DANE в поле города (плагины выбора департаментов и городов Колумбии записывают его, например MEDELLIN (ANT) (05001000)), 8-значный почтовый индекс или встроенный список столиц департаментов и примерно 40 крупнейших городов. Город из списка сверяется с выбранным департаментом. Акценты и регистр не учитываются.

Затем плагин отправляет в Coordinadora код DANE назначения и каждый товар с городом отправки, его весом (кг), габаритами (см), количеством и объявленной стоимостью (COP). Единицы измерения магазина пересчитываются автоматически. Coordinadora возвращает цену в COP, а плагин конвертирует её в валюту вашего магазина. Каждый тариф кэшируется на 1 час. Неудачный запрос запоминается на 10 минут, чтобы сбой Coordinadora не замедлял каждое обновление оформления заказа. Тайм-аут API — 10 секунд.

Если онлайн-тариф недоступен (ошибка API, неизвестный город, товар без веса или габаритов, отсутствующие настройки), используется фиксированная цена. Если её нет, способ скрывается. Подробности ошибок записываются в журнал WooCommerce и никогда не показываются покупателю.

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

Плагин только рассчитывает тарифы. Он не создаёт отправления и накладные (guías), не печатает этикетки, не заказывает забор (recogidas), не отслеживает посылки, не принимает наложенный платёж (recaudo) и не предлагает пункты выдачи Droop; для этого используйте портал Coordinadora. Доставка в тот же день не рассчитывается, а международные направления используют фиксированные цены.

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

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

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

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

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

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

Coordinadora не появляется при оформлении заказа: проверьте, что лицензия активна, что Enable/Disable включено и способ добавлен в зону страны покупателя (или включено Ignore shipping zones и страна разрешена). Проверьте ограничения по весу, Minimum order subtotal и Excluded shipping classes. Без онлайн-тарифа должна существовать фиксированная цена для страны или для *.

Онлайн-тариф не показывается, только фиксированная цена: включите Debug log, обновите страницу оформления заказа и откройте WooCommerce > Status > Logs, источник vfd-coordinadora. Типичные причины: город назначения не распознан, у товара нет веса или габаритов, отсутствует код DANE города отправки или курс COP, либо Coordinadora вернула ошибку.

Город назначения не распознан: установите плагин выбора департаментов и городов Колумбии для оформления заказа, который записывает код DANE в поле города. Разработчики могут сопоставить больше городов с помощью фильтров vfd_crd_dane_cities и vfd_crd_destination_dane.

Тариф включает налог? Тариф — это сумма, которую рассчитывает Coordinadora. Если Tax status установлен в Taxable, WooCommerce добавляет налог на доставку сверху; выберите None, если котировка уже включает его.

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

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

Удаление

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

Coordinadora — торговая марка её владельца. Этот плагин не связан с Coordinadora и не одобрен ею.