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 враховуються після завершення 1-годинного кешу або під час збереження налаштувань.

Сторінка повідомляє, що перевізника 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 і не схвалений нею.