VibeFox Bob Go for PrestaShop — Помощь

Требования

PrestaShop: 8.0–9.x.

PHP: 8.0 или новее. Модуль не устанавливается на более старые версии PHP.

Аккаунт Bob Go (только для тарифов в реальном времени): Bob Go не использует API-ключи. Нужны аккаунт Bob Go (bobgo.co.za), ваш магазин, установленный в аккаунте Bob Go как канал продаж WooCommerce (Sales channels), и включённая опция «Rates at checkout» для этого канала. Услуги, цены и правила настраиваются на стороне Bob Go. Если вы используете только фиксированные цены, аккаунт Bob Go не нужен.

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

Установка

1. В панели администратора перейдите в Modules > Module Manager и нажмите Upload a module. Выберите ZIP-файл модуля.

2. Когда загрузка завершится, нажмите Configure или позже найдите VibeFox Bob Go в списке модулей и нажмите Configure.

3. Введите лицензионный ключ VibeFox в поле License key в блоке лицензии вверху страницы Configure и нажмите Activate (см. раздел Лицензионный ключ).

4. В аккаунте Bob Go установите ваш магазин как канал продаж. Включите «Rates at checkout» для этого канала и настройте услуги и цены.

5. На странице Configure проверьте домен магазина, адрес отправления (откуда отправляете) и, если валюта магазина не ZAR, курс пересчёта в ZAR (см. раздел Настройки). Если у южноафриканских адресов в магазине не указана провинция, нажмите Add South African provinces. Нажмите Save.

При установке модуль создаёт перевозчика Bob Go с текстом срока доставки Courier delivery (South Africa). Перевозчик активен, привязан ко всем зонам и всем группам клиентов и по умолчанию использует тарифы Bob Go в реальном времени. Зоны, группы клиентов, срок доставки, логотип и ограничения по размеру можно изменить в Shipping > Carriers. Цены там не задавайте: цена всегда берётся из модуля.

Настройки

Все настройки находятся на странице модуля: Modules > Module Manager > VibeFox Bob Go > Configure. Они действуют для всех зон перевозчика. У каждого раздела есть своя кнопка Save, которая сохраняет всю страницу. Каждое сохранение также очищает кеш тарифов Bob Go. Числа принимаются с точкой или запятой в качестве десятичного разделителя. Если значение неверное, страница показывает ошибку, и ничего не сохраняется: значение, которое не является числом ("…" must be a number.), отрицательная сумма или вес ("…" must be a number of 0 or more.), ZAR conversion rate 0 или меньше, Minimum weight больше Maximum weight, или Method title длиннее 64 символов.

Над формой страница предупреждает, когда тарифы в реальном времени не могут работать: Live rates are not requested: your store currency is … — set the "ZAR conversion rate"., когда у южноафриканских адресов нет провинции (см. ниже Провинции Южной Африки), или когда единица измерения веса или размеров магазина не распознана и принимается как кг или см. Задайте единицы в International > Localization (Local units).

Общие

Enable Bob Go: включает или выключает перевозчика. Это тот же переключатель, что и статус перевозчика в Shipping > Carriers.

Method title: название перевозчика, которое видит покупатель. Услуги Bob Go, например «The Courier Guy - Economy», отображаются под ним при оформлении заказа с названиями из Bob Go. По умолчанию: Bob Go. Обязательное поле, не более 64 символов.

Shipping cost: способ расчёта цены.

Причина отсутствия тарифов в реальном времени записывается в журнал. Покупателю она никогда не показывается.

Аккаунт Bob Go

Этот раздел объясняет, что нужно сделать в Bob Go, и показывает последний ответ Bob Go для домена вашего магазина: connected, the WooCommerce channel is not installed on Bob Go (HTTP 404), "Rates at checkout" is not enabled for this channel (HTTP 401), либо request failed с кодом ошибки, либо no connection.

Store domain: Bob Go определяет ваш магазин по домену. Оставьте поле пустым, чтобы использовать домен магазина, который показан в поле как подсказка. Указывайте другой домен, только если ваш канал в Bob Go установлен по другому адресу, например example.co.za/shop для магазина в подпапке. Схема и завершающий слеш удаляются.

ZAR conversion rate: Bob Go выставляет тарифы в южноафриканских рандах (ZAR). Если валюта магазина по умолчанию не ZAR, укажите, сколько 1 ZAR стоит в вашей валюте, например 0.05. По этому курсу тарифы пересчитываются, а цены товаров передаются в Bob Go в ZAR. Оставьте поле пустым, если не хотите использовать тарифы Bob Go в вашей валюте (фиксированные цены продолжат работать). Курс должен быть больше 0. Если валюта магазина ZAR, оставьте поле пустым.

Delivery dates: показывает расчётный диапазон дат доставки от Bob Go рядом с каждой услугой при оформлении заказа. Расчёт всегда сохраняется с заказом и виден на странице заказа.

Отправление (адрес отправления)

Адрес отправления передаётся в Bob Go с каждым запросом тарифов. Если адрес магазина в Shop Parameters > Contact > Stores находится в той же стране, пустые поля заполняются из него.

Origin country: страна, из которой вы отправляете. По умолчанию: Южная Африка. Bob Go доставляет только внутри Южной Африки.

Origin province: провинция Южной Африки или Store province (if in South Africa).

Origin city / suburb: город или район, из которого вы отправляете, например Йоханнесбург.

Origin postal code: почтовый индекс, из которого вы отправляете, например 2001.

Origin street address: адрес улицы, с которой вы отправляете.

Провинции Южной Африки: PrestaShop не содержит провинций для Южной Африки, поэтому у адресов клиентов там нет провинции, а Bob Go её ожидает. Нажмите Add South African provinces, чтобы добавить 9 провинций (коды EC, FS, GP, KZN, LP, MP, NC, NW, WC) как регионы Южной Африки и показать поле региона в южноафриканских адресах. Провинции, которые уже есть (по коду или названию), повторно не добавляются. Ничего не меняется, пока вы не нажмёте кнопку. Когда провинции добавлены, поле показывает South African addresses have a province с их количеством.

Фиксированные цены (используются, когда Shipping cost установлено в Fixed prices (below), и как запасной вариант, если Bob Go не возвращает тарифов)

Price per country: одна строка на страну: двухбуквенный код страны, знак равенства и цена в валюте магазина по умолчанию без налога, например ZA=99.99. Используйте * для всех остальных стран, например *=199.99 на следующей строке. Строки в другом формате удаляются при сохранении, и страница перечисляет их в предупреждении.

Flat price: цена для стран без строки выше. Оставьте пустым, чтобы скрыть перевозчика для этих стран.

Fixed price applies: Per order берёт цену один раз. Per item (price × quantity) умножает её на количество товаров в корзине. Тарифы Bob Go в реальном времени всегда относятся ко всей отправке.

Условия

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

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

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

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

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

Tax: налоговое правило перевозчика или No tax (по умолчанию). Тарифы Bob Go обычно уже включают НДС. В этом случае оставьте No tax, чтобы не брать налог дважды.

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

Ignore shipping zones: если включено, перевозчик привязывается ко всем зонам, в том числе созданным позже, и предлагается для стран, указанных ниже. Если выключено, перевозчик предлагается только в зонах, назначенных ему в Shipping > Carriers; зоны, которые у него были раньше, возвращаются.

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

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

Debug log: записывает расчёты тарифов и запросы к Bob Go в logs/vfd_bobg_debug.log.php в папке модуля. Файл нельзя открыть из браузера. Адреса покупателей не записываются. Ошибки Bob Go записываются даже когда опция выключена. Выключите её, когда закончите.

Log: показывает размер и последние записи журнала. Нажмите Clear log, чтобы очистить его.

Remove data on uninstall: если включено, при удалении модуля удаляются настройки Bob Go, перевозчик, кешированные тарифы и журналы. Услуга Bob Go, сохранённая с заказами, остаётся. Если выключено, всё сохраняется для повторной установки.

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

На шаге доставки PrestaShop запрашивает у модуля цену Bob Go. Учитываются только физические товары: виртуальные товары не добавляют вес и не входят в сумму заказа. Модуль сначала проверяет страну назначения (с учётом Ignore shipping zones), вес корзины и Minimum order amount. Если применяется бесплатная доставка, перевозчик показывается как бесплатный, и запрос к Bob Go не отправляется.

В режимах с тарифами в реальном времени модуль передаёт в Bob Go домен магазина, адреса отправления и доставки (с провинцией) и товары корзины с ценами в ZAR. Тарифы в реальном времени запрашиваются только после того, как покупатель введёт город или почтовый индекс. Тарифы в ZAR пересчитываются по ZAR conversion rate, когда валюта магазина не ZAR. Цена рассчитывается в валюте магазина по умолчанию, а затем показывается в валюте корзины покупателя.

Под перевозчиком Bob Go покупатель видит Choose a delivery service: и один вариант на каждую услугу Bob Go с её названием, ценой и, если включена опция Delivery dates, расчётными сроками доставки. Первая услуга выбрана по умолчанию. Когда покупатель выбирает другую услугу, выбор сразу сохраняется, а цена перевозчика и итог корзины обновляются. Перевозчик стоит столько, сколько стоит выбранная услуга. Если услуга больше не предлагается для адреса, покупатель видит This service is not available for your address any more. Please choose another one. Если сохранить не удалось, появляется сообщение The service could not be saved. Please try again. Список услуг работает с темами Classic и Hummingbird.

Тарифы кешируются на 1 час для каждого полного запроса, поэтому одна и та же корзина не вызывает новый запрос. Неудачный запрос кешируется на 5 минут, а тайм-аут составляет 12 секунд, чтобы сбой Bob Go не замедлял каждое обновление оформления заказа. Неудачный запрос никогда не прерывает оформление заказа: перевозчик скрывается или, в режиме запасного варианта, используется фиксированная цена. Причина записывается в журнал.

Если вы редактируете перевозчика в Shipping > Carriers после того, как с ним были заказы, PrestaShop сохраняет его как новую версию перевозчика. Модуль автоматически переходит на новую версию.

Модуль только показывает тарифы. Он не создаёт отправления, накладные и этикетки, не отслеживает посылки, не синхронизирует заказы с Bob Go и не отправляет уведомления. Для выполнения заказов используйте панель Bob Go. Выбора пункта выдачи или постамата нет. Bob Go доставляет только в пределах Южной Африки.

Заказы

При оформлении заказа выбранная услуга Bob Go, её код и расчётный срок доставки сохраняются с заказом. Последующие изменения корзины или цен Bob Go их не меняют.

В панели администратора на странице заказа показан блок Bob Go с Bob Go service (название и код) и Estimated delivery. Покупатель видит Bob Go service и Estimated delivery на странице деталей заказа в своём аккаунте. У заказов с фиксированной ценой или бесплатной доставкой нет услуги Bob Go.

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

Модуль работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии License — VibeFox Bob Go находится первым на странице Modules > Module Manager > VibeFox Bob Go > Configure, над настройками. Введите ключ в поле License key и нажмите Activate. После этого блок показывает ключ в скрытом виде, статус (например, дату, до которой лицензия действительна, и ваш домен) и кнопки Check now, чтобы проверить статус снова, Change key, чтобы ввести другой ключ, и Remove key, чтобы удалить ключ из этого магазина. Ниже находятся строка Product: presta-shipping-bob-go и ссылка Manage licenses and domains in your account, которая открывает ваш аккаунт vibefox.net. Изменить ключ могут только сотрудники с правом Configure для модуля. Тексты блока следуют языку back office (включены английский и русский).

Если ключ не принят, блок объясняет причину, например Key not found, This key belongs to another product, Domain limit reached или License expired on с датой. После смены адреса магазина или после освобождения слота домена в вашем аккаунте нажмите Check now. Если сервер лицензий недоступен, модуль продолжает работать по последнему известному статусу.

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

Без действующего ключа перевозчик Bob Go не показывается покупателям при оформлении заказа, и тарифы не рассчитываются. Публичная часть PrestaShop не знает, что вы вошли в back office, поэтому перевозчик скрыт и для вас: настроить модуль можно до покупки ключа, но проверить его при оформлении заказа нельзя. Напоминание появляется в Modules > Module Manager на вкладке Alerts. Существующие заказы не затрагиваются.

Когда срок лицензии истекает, модуль продолжает работать, но для обновлений и поддержки нужно продление. Статус проверяется автоматически, пока вы работаете в back office: раз в день в первые 14 дней после ввода ключа, затем раз в неделю. Cron-задание не нужно. Удаление или сброс модуля всегда удаляет лицензионный ключ и статус лицензии.

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

Bob Go не появляется при оформлении заказа: проверьте, что лицензия действует и включена опция Enable Bob Go. В Shipping > Carriers проверьте, что перевозчик охватывает зону страны покупателя и его группу, или включите Ignore shipping zones и проверьте Countries. Проверьте ограничения по весу и Minimum order amount. В режиме фиксированных цен проверьте, что для страны, * или Flat price задана цена. Товары также можно ограничить определёнными перевозчиками на странице товара.

Тарифы Bob Go не показываются: откройте страницу модуля. Раздел Аккаунт Bob Go показывает последний ответ Bob Go. «The WooCommerce channel is not installed on Bob Go» (HTTP 404) означает, что домен магазина не является каналом продаж в Bob Go: проверьте Store domain. «Rates at checkout is not enabled» (HTTP 401) означает, что функция выключена для этого канала. Также убедитесь, что покупатель ввёл город или почтовый индекс и, для магазинов не в ZAR, что задан ZAR conversion rate. Включите Debug log, перезагрузите оформление заказа и посмотрите поле Log. С опцией Bob Go live rates, fixed prices if Bob Go returns no rates покупатели всё равно получают фиксированную цену, пока вы устраняете проблему.

Мой магазин не в рандах: Bob Go выставляет тарифы в ZAR. Укажите, сколько 1 ZAR стоит в валюте вашего магазина. Без этого модуль не запрашивает тарифы у Bob Go. Фиксированные цены продолжат работать.

На странице предупреждение, что у южноафриканских адресов нет провинции: нажмите Add South African provinces в разделе Отправление (адрес отправления). У существующих адресов клиентов провинция появится только при их редактировании.

Налог на доставку начисляется дважды: тарифы Bob Go обычно включают НДС. Установите Tax в значение No tax.

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

На странице написано, что перевозчик Bob Go не найден: перевозчик был удалён в Shipping > Carriers. Сбросьте модуль в Modules > Module Manager, чтобы создать его заново.

Удаление

Перейдите в Modules > Module Manager, откройте меню рядом с VibeFox Bob Go и выберите Uninstall. Лицензионный ключ, статус лицензии и кешированные тарифы удаляются всегда. Если Remove data on uninstall включено, перевозчик удаляется (заказы сохраняют историю), а настройки, журнал и выбор услуг в открытых корзинах удаляются. Если выключено, перевозчик только отключается, и все настройки сохраняются. При повторной установке модуля или при Reset сохранённый перевозчик возвращает статус, который имел раньше: включённый перевозчик снова включается, отключённый остаётся отключённым. Услуга Bob Go, сохранённая с заказами, всегда остаётся.

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