HikaShop Mondial Relay - Расширение Joomla

Руководство по настройке доставки через HikaShop Mondial Relay

HikaShop Mondial Relay нужен тем магазинам на Joomla, где доставка в пункты выдачи должна быть не отдельной ручной договорённостью, а нормальным шагом оформления заказа. В этом руководстве разберём не карточку продукта, а рабочую схему: что подготовить в HikaShop, как создать метод доставки, какие ограничения включить, как проверить выбор пункта выдачи и где искать причину, если карта, тариф или выбранный Point Relais не появляются в заказе.

Главный смысл расширения - связать корзину HikaShop, адрес доставки покупателя, вес товаров и API Mondial Relay. Покупатель выбирает подходящий пункт выдачи во время оформления заказа, а магазин получает эту информацию в заказе, письмах и админ-панели. Это удобно, но только если заранее настроены веса товаров, поля адреса, сценарий оформления заказа, налоги на доставку и серверные зависимости.

Материал рассчитан на владельца магазина, администратора Joomla и разработчика, который помогает настроить доставку. Здесь нет инструкций по покупке или активации лицензии. Мы исходим из того, что установочный архив уже получен легальным способом, а задача - безопасно включить расширение, проверить поведение на тестовом заказе и понять, подходит ли оно конкретному магазину.

Какую задачу закрывает доставка Mondial Relay в HikaShop

Обычный метод доставки в HikaShop может быть очень гибким: у него есть цена, ограничения по зоне, весу, сумме заказа, складу, налогам и доступу для групп пользователей. Но ручной метод не знает, какой именно пункт выдачи выбрал покупатель. Для доставки в сеть Mondial Relay этого мало, потому что магазину нужно получить не только стоимость, но и конкретный Point Relais или Locker, связанный с адресом доставки.

HikaShop Mondial Relay добавляет в этот процесс специализированный транспортный сценарий. На странице продукта HikaShop указывает, что расширение является shipping plugin, содержит предварительно настроенные тарифы, позволяет корректировать ставки через интерфейс, задавать максимальный размер и вес посылок, показывать динамическую карту и расписание выбранного пункта, а также выводить выбранный пункт в письмах и деталях заказа. Эти функции важны не как рекламный список, а как последовательность операций: тариф рассчитывается по данным корзины, пункт выдачи выбирается по адресу, а выбранное значение должно попасть в заказ.

В старой документации HikaShop есть отдельная интеграция через custom field "sélecteur point relai Mondial Relay". Там прямо сказано, что это старый вариант, требующий HikaShop Business и Google Maps JavaScript API, а более свежий вариант от Obsidev работает как полноценный shipping plugin и не требует Google Maps. Поэтому при настройке стоит различать две сущности:

• Старое поле выбора пункта выдачи - добавляется через Display - Custom Fields, зависит от поля заказа и использует отдельную карту.
• Плагин HikaShop Mondial Relay от Obsidev - создаётся как метод доставки в System - Shipping methods, работает во всех редакциях HikaShop по данным карточки продукта и опирается на API Mondial Relay.

Это различие помогает избежать типичной ошибки: администратор читает старую инструкцию, пытается создать custom field, а затем не понимает, почему настройки не совпадают с текущим расширением. Для нового сценария ориентируйтесь на метод доставки, а старую статью используйте только для понимания логики выбора пункта и зависимости от города и почтового индекса.

Кому расширение подходит, а кому лучше выбрать другой маршрут

Расширение особенно полезно магазинам, которые продают физические товары во Франции и соседних регионах, где покупатели ожидают выбор Point Relais или Locker прямо в оформлении заказа. Если магазин уже работает на HikaShop, использует вес товаров и хочет показывать пункт выдачи не вручную, а в связке с адресом покупателя, HikaShop Mondial Relay закрывает задачу точнее, чем обычная доставка с фиксированной ценой.

Подходящие сценарии:

• Магазин на Joomla продаёт физические товары и хочет дать покупателю выбор ближайшего пункта выдачи во время checkout.
• Администратору нужно сохранить выбранный пункт в деталях заказа и письмах, чтобы склад или менеджер видел, куда отправлять посылку.
• Стоимость доставки должна учитывать вес товаров и ограничения перевозчика, а не задаваться одной фиксированной ценой для всех заказов.
• Магазин использует несколько способов доставки и хочет показать Mondial Relay только там, где он действительно доступен по зоне, весу или складу.

Есть и случаи, где расширение может оказаться лишним. Если магазин продаёт только цифровые товары, если доставка оформляется полностью вне сайта, если вы работаете только с курьерской доставкой до двери или если нужная страна и сценарий не поддерживаются вашим договором с Mondial Relay, специализированный метод выбора пункта выдачи не даст пользы. Для таких задач иногда достаточно ручного shipping method с понятным описанием, а не API-интеграции.

Практический ориентир: если покупатель должен сам выбрать конкретный пункт выдачи, нужен HikaShop Mondial Relay или близкая интеграция. Если магазину достаточно надписи "доставка до пункта выдачи", а адрес согласуется вручную, начните с простого метода доставки и не усложняйте checkout.

Что проверить перед установкой

Перед установкой не стоит сразу переходить к кнопке Upload File & Install. Для доставки через API важнее подготовить магазин: HikaShop должен уметь рассчитать вес, показать shipping view после адреса, получить город и индекс, а сервер должен поддерживать модуль PHP SOAP. Если один из этих элементов отсутствует, расширение может установиться, но покупатель не увидит нужный способ доставки или не сможет выбрать пункт.

Платформа и зависимости

На странице продукта указано, что плагин является shipping plugin для HikaShop, требует учётные данные Mondial Relay API, продукты с весом и PHP Soap module. Там же приведены сведения о совместимости с редакциями HikaShop и минимальной версии HikaShop, но в разных местах карточки встречаются отличающиеся формулировки по минимальной версии. Поэтому безопасная практика такая: проверяйте текущую карточку продукта и changelog перед установкой на рабочий сайт, а не переносите старые требования из чужой инструкции.

Минимальная проверка перед запуском:

• В Joomla установлен и работает HikaShop, а вы можете попасть в Components - HikaShop - Configuration.
• На сервере включено расширение PHP SOAP, потому что плагин обращается к API Mondial Relay через SOAP.
• У товаров заполнен вес. Без веса расширение не сможет корректно обработать стоимость доставки.
• В адресе покупателя обязательны город и почтовый индекс, потому что выбор ближайшего пункта строится от адреса доставки.
• В checkout есть блоки адреса и доставки, а при необходимости - блок custom fields, если вы всё ещё поддерживаете старую схему с полем.
• Есть доступ к данным Mondial Relay для подключения модуля: code enseigne, code marque и clé privée, если они требуются вашим аккаунтом.

Резервная копия и тестовая среда

Joomla-расширения обычно устанавливаются через менеджер расширений, но доставка влияет на оформление заказа. Перед включением на живом магазине сделайте резервную копию файлов и базы данных, проверьте расширение на копии сайта или хотя бы в непубличном тестовом сценарии, а затем выполните тестовый заказ с физическим товаром. Это не формальность: если shipping method настроен с неверной зоной, максимальным весом или пустыми учётными данными, покупатель может не увидеть доставку и бросить корзину.

После подготовки у вас должен быть короткий чек-лист: тестовый товар с весом, тестовый покупатель с адресом, доступ к админ-панели Joomla, учётные данные Mondial Relay, способ оплаты для тестового заказа и понимание, какие страны или зоны вы хотите обслуживать. Только после этого установка расширения имеет смысл.

Установка и первичное включение в Joomla

Установка HikaShop-расширения следует обычной логике Joomla. Архив не нужно распаковывать вручную, если он подготовлен как нормальный пакет расширения. В админ-панели откройте менеджер установки расширений, загрузите архив и дождитесь сообщения об успешной установке. В документации HikaShop отдельно подчёркивается, что компонент и связанные плагины устанавливаются через Joomla installer, а при обновлении не нужно удалять прежнюю версию, чтобы не потерять данные.

Порядок установки

1. Откройте админ-панель Joomla под пользователем с правами установки расширений.
2. Перейдите в раздел установки расширений Joomla и загрузите ZIP-архив HikaShop Mondial Relay.
3. После установки проверьте, появился ли соответствующий плагин доставки в списке доступных shipping plugins.
4. Перейдите в HikaShop - System - Shipping methods и создайте новый метод доставки.
5. В типе метода выберите Mondial Relay, сохраните черновик и затем переходите к настройкам.

Если установка не проходит, не начинайте с повторной загрузки одного и того же архива. Проверьте права записи каталогов Joomla, временную папку и сообщения установщика. HikaShop в своей документации по установке отдельно перечисляет каталоги, куда расширение должно иметь возможность записывать файлы, включая компоненты, модули, плагины, языковые папки, tmp и media. Для обычного администратора это означает: ошибка копирования чаще связана с правами или временной папкой, а не с настройками Mondial Relay.

Первичная проверка после установки

После установки не публикуйте метод доставки сразу для всех покупателей. Сначала убедитесь, что он появился в HikaShop как отдельный shipping method, что форма настроек открывается без белого экрана, а сервер не показывает ошибку отсутствующего SOAP-класса. Если панель настроек открывается, можно переходить к конфигурации. Если нет - остановитесь и исправьте серверную зависимость, иначе следующий шаг только добавит больше симптомов.

Настройка метода доставки после установки

Основная работа начинается в HikaShop - System - Shipping methods. На странице продукта указано, что новый instance создаётся через этот раздел: нужно выбрать плагин Mondial Relay и настроить его. Не путайте этот экран с глобальной конфигурацией магазина. Глобальная конфигурация отвечает за общий checkout, налоги, языки и поведение HikaShop, а shipping method отвечает за конкретный способ доставки.

Главные параметры shipping method

У метода доставки есть общие настройки HikaShop и параметры самого перевозчика. Общие настройки решают, когда метод показывается покупателю, как отображается цена и какие ограничения применяются. Параметры Mondial Relay решают, как расширение обращается к API, какие тарифы использует и какие размеры или вес посылки допускает.

Не включайте все ограничения сразу. Сначала добейтесь базовой работы на одном тестовом товаре и одном адресе. Затем добавляйте ограничения по зонам, максимальному весу, складам или сумме заказа. Такой порядок проще диагностировать: если метод исчез после включения ограничения, вы знаете, что причина в последнем изменении, а не в API или checkout.

Тарифы, налоги и веса

Карточка продукта HikaShop Mondial Relay говорит о предварительно настроенных тарифах, но также предупреждает, что screenshot не иллюстрирует текущие тарифы, а известные ставки указаны без налогов. Поэтому не относитесь к преднастроенной таблице как к вечному прайс-листу. Для магазина важнее проверить три вещи: корректен ли вес товара, выбран ли налоговый режим доставки, и совпадает ли расчёт с условиями вашего договора и актуальной информацией Mondial Relay.

Если в магазине есть товары с необычными габаритами, не ограничивайтесь весом. На странице продукта отдельно упоминается возможность задать максимальный размер и вес посылок. Используйте это для категорий, где доставка в пункт выдачи может быть недоступна: крупные коробки, длинные товары, наборы с несколькими складами. Если такого ограничения нет, покупатель может выбрать Mondial Relay для заказа, который фактически нельзя отправить выбранным способом.

Зоны и склады

В HikaShop shipping method можно ограничить способ доставки по зоне, складу, минимальной и максимальной сумме, количеству, весу, объёму и почтовому индексу. Для Mondial Relay это полезно, если магазин обслуживает не все страны или если разные склады работают с разными перевозчиками. Начните с зон: метод должен появляться только для стран и регионов, где вы реально отправляете через Mondial Relay. Затем проверьте складские ограничения, если у вас несколько складов или vendor-сценарий.

Не используйте ограничения по почтовому индексу как замену API. Такие ограничения полезны для грубой фильтрации, но доступность конкретного Point Relais может меняться из-за нагрузки или временной недоступности. FAQ Mondial Relay объясняет, что пункт, видимый на общем сайте перевозчика, может не предлагаться на сайте магазина, если он сейчас недоступен для доставки. Поэтому задача HikaShop - передать корректный адрес и показать актуальные варианты, а не насильно держать один пункт в списке.

Checkout: где покупатель выбирает Point Relais

Даже идеально настроенный shipping method не поможет, если checkout собран неправильно. HikaShop использует рабочий сценарий оформления заказа из steps и views: на одном шаге могут быть адрес, корзина, доставка, оплата, поля и условия. Для Mondial Relay критично, чтобы покупатель сначала ввёл или подтвердил адрес доставки, а затем увидел доступные способы доставки и выбор пункта выдачи.

В документации HikaShop по checkout workflow есть важная мысль: метод доставки может быть недоступен до ввода адреса, и в таком случае лучше разделить оформление на несколько шагов, а не скрывать ошибку. Для Mondial Relay это особенно актуально, потому что список ближайших пунктов строится от города и почтового индекса. Если вы показываете shipping view до адреса, покупатель может увидеть пустой блок или сообщение, которое выглядит как поломка.

Минимальная структура checkout

Для типового магазина удобна такая последовательность:

1. Корзина и вход пользователя, если магазин требует авторизацию или предлагает гостевой checkout.
2. Адрес доставки с обязательными полями города, почтового индекса и страны.
3. Shipping view, где покупатель выбирает Mondial Relay и затем конкретный Point Relais или Locker.
4. Оплата, условия заказа и финальное подтверждение.

Можно собрать checkout в одну страницу, но тогда нужно внимательно проверить, как HikaShop обновляет shipping methods после изменения адреса. Если метод не появляется до перезагрузки страницы, попробуйте разместить адрес и доставку в разных шагах. Это не ухудшение интерфейса, а способ сделать поведение понятным: сначала покупатель сообщает, куда доставлять, затем магазин показывает доступные способы.

Поля адреса, которые нельзя делать необязательными

Старая документация интеграции Mondial Relay прямо указывает, что системе нужны address_post_code и address_city. Для актуального shipping plugin логика та же: без почтового индекса и города невозможно надёжно показать ближайшие пункты. Поэтому проверьте не только наличие полей в форме, но и их обязательность. Если покупатель может пройти checkout без города или индекса, метод доставки может вести себя непредсказуемо.

Отдельно проверьте сценарий "same address for shipping". В HikaShop есть настройка, при которой покупатель вводит только billing address, а shipping address считается таким же. Это удобно, но для доставки в пункт выдачи нужно убедиться, что именно shipping address содержит корректные город и индекс. Если магазин использует разные адреса оплаты и доставки, не скрывайте shipping address слишком рано.

Проверка результата: измените почтовый индекс в тестовом адресе и обновите checkout. Список пунктов выдачи должен перестроиться по новому адресу, а выбранный пункт не должен оставаться прежним, если он уже не подходит.

Как работает выбор пункта и сохранение результата

Покупатель видит не просто название перевозчика. Он должен выбрать конкретный пункт выдачи. По данным HikaShop, плагин показывает динамическую карту и расписание выбранного пункта, а сам пункт сохраняется в письмах и деталях заказа в админ-панели. По FAQ Mondial Relay, список ближайших пунктов строится от центра города почтового индекса адреса доставки. Это объясняет, почему адресные поля важнее, чем кажется.

Внутри процесса участвуют четыре слоя:

• Корзина HikaShop - передаёт товары, количество, вес и сумму.
• Адрес доставки - даёт страну, город и почтовый индекс для поиска пункта выдачи.
• Метод доставки Mondial Relay - применяет тарифы, ограничения, API-учётные данные и доступность способа.
• Заказ - сохраняет выбранный пункт так, чтобы его видел менеджер и чтобы данные попали в письма.

Когда покупатель выбирает пункт выдачи, проверьте не только публичную часть сайта. Откройте созданный тестовый заказ в админ-панели HikaShop и убедитесь, что выбранный пункт не потерялся. Затем проверьте письмо покупателю и письмо администратору. Если пункт виден в checkout, но не виден в письме или заказе, проблема может быть не в карте, а в шаблоне письма, старом override или конфликте с устаревшим checkout.

Что важно для менеджера магазина

Для менеджера выбранный пункт выдачи должен быть виден там, где он обрабатывает заказ. Если команда склада работает только из email, проверьте письмо администратора. Если заказ обрабатывается в админ-панели, проверьте детали заказа. Если используется выгрузка заказов во внешнюю систему, проверьте, попадает ли туда нужное поле. Не обещайте себе, что "если покупатель выбрал, значит магазин увидит". В shipping-интеграциях именно этот переход часто оказывается слабым местом.

Если в магазине используется несколько языков, проверьте отображение названия метода доставки и подсказок. HikaShop поддерживает языковые файлы и override-подход, который защищает изменения от перезаписи при обновлении. Не правьте файлы расширения напрямую. Если нужно изменить понятный покупателю текст, используйте языковые переопределения HikaShop или Joomla и сохраняйте исходные ключи без изменения.

Сценарии доставки: один склад, несколько складов и товары с ограничениями

После базового теста стоит настроить не только "работает или нет", но и реальные правила магазина. HikaShop позволяет ограничивать способ доставки по складу, зоне, весу, объёму, сумме заказа и группе пользователей. Для Mondial Relay это не второстепенные опции. Они определяют, увидит ли покупатель способ доставки в корзине, где товар действительно можно отправить выбранным перевозчиком.

Самая простая схема - один склад и один тип физических товаров. В ней достаточно проверить страну, вес и налоговый режим. Но как только появляется несколько складов, крупные товары, разные категории или B2B-покупатели, ручная логика "покажем всем" становится рискованной. Покупатель может выбрать пункт выдачи для товара, который склад отправляет другим перевозчиком, или для заказа, где вес превышает ваши лимиты.

Один склад и стандартные товары

Для небольшого магазина используйте самый прозрачный порядок. Создайте один shipping method Mondial Relay, ограничьте его по нужной зоне, проверьте максимальный вес и оставьте складские ограничения пустыми, если склад один. В описании метода напишите, что покупатель выбирает пункт выдачи на следующем шаге checkout. Это помогает снизить вопросы, когда карта появляется не сразу, а после адреса.

Проверка для такого сценария должна включать два товара: лёгкий стандартный товар и товар, который близок к верхнему весовому лимиту. Если оба проходят одинаково, вы не узнаете, что случится на границе. Добавьте в тест корзину с несколькими штуками одного товара, потому что HikaShop считает общий вес как вес каждого товара, умноженный на количество. Именно этот случай часто пропускают при первом запуске.

Несколько складов

Карточка HikaShop Mondial Relay в changelog упоминает поддержку multi-warehouse. Это важный сигнал для магазинов, где часть ассортимента лежит в разных местах или у разных поставщиков. В таком сценарии не стоит включать Mondial Relay глобально и надеяться, что менеджер потом разберётся. Настройте ограничения по складу там, где это соответствует реальной логистике.

Если у склада A есть договорённость с Mondial Relay, а склад B отправляет только курьером, метод доставки должен быть доступен только для товаров склада A. Если корзина смешанная, заранее решите, что должен увидеть покупатель: один общий метод, несколько групп доставки или сообщение о невозможности выбранного способа. HikaShop умеет группировать доставку в сложных сценариях, но на практике лучше не усложнять checkout без необходимости. Начните с правила "метод виден только для полностью подходящей корзины", а смешанные заказы обрабатывайте другим способом доставки.

Крупные, тяжёлые и виртуальные товары

Mondial Relay как сценарий пункта выдачи не подходит для любого товара автоматически. Если товар физически крупный, хрупкий или требует особых условий, скрывайте метод доставки через максимальный вес, объём или склад. В HikaShop shipping method есть ограничения по minimum и maximum weight, volume, quantity и price. Используйте их как защиту checkout: покупатель должен видеть только те способы, которыми магазин реально готов отправить заказ.

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

Правило настройки: ограничения shipping method должны повторять реальную операционную политику магазина. Если склад, вес или товарная категория не подходят для Mondial Relay, checkout должен скрыть этот вариант до оформления заказа, а не после оплаты.

Как отличить актуальный плагин от старого поля выбора пункта

По HikaShop Mondial Relay легко запутаться, потому что в источниках есть две линии документации. Одна рассказывает о старой интеграции через custom field, другая - о текущем shipping plugin от Obsidev. Оба подхода связаны с Mondial Relay, но настраиваются в разных местах и имеют разные требования. Если смешать инструкции, можно создать поле, которое не участвует в расчёте доставки, или искать настройки API не на том экране.

Признаки старого custom field сценария

Старая инструкция ведёт в Display - Custom Fields, предлагает создать новое поле, выбрать тип sélecteur point relai Mondial Relay, поставить Table в значение Order, добавить код клиента Mondial Relay и Google Maps JavaScript API key. Там же указано, что поле должно быть отображено во фронтальной части, а для работы нужны город и почтовый индекс покупателя.

Если вы видите именно такой экран, относитесь к нему как к отдельной старой схеме. Она может встречаться на давно настроенных магазинах или в старых инструкциях, но карточка HikaShop прямо предупреждает, что это старый plugin, требующий HikaShop Business, а партнёрский вариант Obsidev более полный, свежий и не требует Google Maps account. Это не значит, что старую схему нужно немедленно удалять на существующем сайте. Это значит, что для нового внедрения лучше не начинать с неё без причины.

Признаки актуального shipping plugin

Актуальный вариант настраивается как метод доставки: System - Shipping methods - новый instance - выбор Mondial Relay plugin. В карточке продукта перечислены именно shipping-функции: предварительные ставки, настройка тарифов через интерфейс, максимальный размер и вес посылок, выбор pickup point во время checkout, динамическая карта, расписание пункта, отображение выбранного пункта в email и backend order details. Это поведение должно быть связано с расчётом доставки, а не просто с дополнительным полем заказа.

Если сайт уже использует старое поле, переход на shipping plugin лучше делать через тестовую копию. Сравните, где хранится выбранный пункт, как он выводится в письмах, не осталось ли старого поля в checkout, не дублируются ли подсказки покупателю. Не удаляйте старое поле на рабочем сайте, пока не убедились, что новые тестовые заказы сохраняют нужные данные и менеджер видит их в привычном месте.

Миграционная проверка без риска

Сделайте два тестовых заказа на копии сайта: один через старый сценарий, если он ещё включён, и один через новый shipping method. Сравните публичный checkout, данные заказа, письма и процесс обработки. Если новое расширение сохраняет все нужные сведения, старое поле можно отключать из checkout и оставить только архивную совместимость для старых заказов. Если часть данных пропала, сначала исправьте шаблон письма или отображение заказа, а не торопитесь публиковать новый метод.

Такой подход особенно важен для магазинов, где менеджеры привыкли копировать адрес пункта выдачи из определённого поля. Технически новая интеграция может быть правильнее, но операционно она должна быть понятна тем, кто каждый день обрабатывает отправки. Хорошая настройка - это не только корректный API-запрос, но и отсутствие ручной путаницы после получения заказа.

Практический пример: тестовый заказ с выбором пункта выдачи

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

Цель

Нужно убедиться, что покупатель может оформить заказ с физическим товаром, увидеть Mondial Relay как доступный метод доставки, выбрать Point Relais или Locker, а магазин затем увидит выбранный пункт в деталях заказа и письме.

Подготовка

• Создайте или выберите физический товар с заполненным весом.
• Убедитесь, что способ оплаты для теста не приводит к реальному списанию или используйте безопасный тестовый метод.
• Проверьте, что адрес доставки содержит страну, город и почтовый индекс.
• Оставьте в checkout блок адреса перед блоком доставки.
• В методе доставки Mondial Relay временно не включайте лишние ограничения, кроме тех, что точно нужны для тестовой зоны.

Шаги

1. Добавьте тестовый товар в корзину и перейдите к оформлению заказа.
2. Введите адрес доставки в зоне, где вы ожидаете работу Mondial Relay.
3. Дождитесь отображения доступных методов доставки и выберите Mondial Relay.
4. Откройте карту или список пунктов выдачи, выберите удобный пункт и убедитесь, что его идентификатор или название отображается в интерфейсе.
5. Завершите заказ тестовым способом оплаты.
6. Откройте заказ в админ-панели HikaShop и проверьте выбранный пункт в деталях заказа.
7. Проверьте письмо покупателю и письмо администратора, если эти письма участвуют в вашей обработке заказа.

Ожидаемый результат

Метод доставки появляется только после корректного адреса, показывает стоимость с налогами или без налогов согласно вашим настройкам, даёт выбрать пункт выдачи и сохраняет выбранный пункт в заказе. Если список пунктов пуст, сначала меняйте адрес и тестовый товар, а не всю конфигурацию. Если выбранный пункт есть на сайте Mondial Relay, но не появляется в checkout, учитывайте, что перевозчик может не предлагать временно недоступные или перегруженные пункты на сайте магазина.

Нюанс, который часто мешает тесту

Тестовый товар без веса может выглядеть "обычным" в каталоге, но для доставки через Mondial Relay он неполноценен. Страница продукта HikaShop прямо указывает, что плагину нужны товары с весом для обработки цены доставки. Поэтому первый симптом "метод не появился" проверяйте через вес товара, адрес и ограничения, а уже потом через API.

Безопасные улучшения без правки кода расширения

Для HikaShop Mondial Relay не стоит начинать с PHP-сниппетов. Публичные хуки именно этого плагина в доступных источниках не подтверждены, а правка файлов расширения создаёт риск потерять изменения при обновлении. Практичные улучшения можно сделать штатными средствами HikaShop и Joomla: языковые переопределения, порядок checkout views, описание shipping method, налоговая категория, ограничения по зонам и тестовая диагностика.

Понятные подписи для покупателя

Если стандартная подпись метода доставки недостаточно ясна, измените название и описание метода в HikaShop, а для системных текстов используйте языковые overrides. Документация HikaShop описывает работу с языковыми файлами и отдельную область переопределений, которая не перезаписывается при обновлении. Это лучший путь для фраз вроде "Выберите пункт выдачи" или "Проверьте город и почтовый индекс", если они выводятся через языковые строки.

Правило простое: не меняйте key до знака равенства и не удаляйте placeholders вроде %s или %d. Менять нужно только текст в кавычках. После сохранения очистите кеш Joomla и проверьте checkout в публичной части сайта.

Описание метода доставки вместо лишнего кода

В shipping method можно использовать название, описание и изображение рядом с методом. Часто этого достаточно, чтобы покупатель понял, что доставка идёт в пункт выдачи, а не до двери. Короткая подсказка лучше, чем JavaScript, который пытается вмешаться в checkout: поясняющий текст должен помогать, но не ломать обновление методов доставки после изменения адреса.

Контроль кеша и старых overrides

Если после настройки интерфейс выглядит странно, сначала проверьте шаблонные overrides HikaShop и кеш, особенно на сайтах, которые давно обновлялись. В документации HikaShop есть legacy-настройки, связанные со старым checkout и старым add to cart. Не включайте их ради эксперимента на рабочем магазине. Если сайт был обновлён с очень старой версии, сравните поведение на чистом шаблоне или временно отключите кастомные overrides checkout, чтобы понять, проблема в плагине или в старой разметке.

Проверка результата перед публикацией на живом сайте

Перед тем как открыть способ доставки всем покупателям, пройдите проверку как администратор, как покупатель и как менеджер склада. Хорошая настройка доставки - это не только видимая карта. Это цепочка, где каждый следующий участник получает нужную информацию.

Проверка для покупателя

• Метод доставки появляется после ввода корректного адреса.
• Список пунктов выдачи или карта не закрывает кнопки checkout и нормально читается на шаблоне сайта.
• Покупатель может изменить адрес и получить обновлённый список пунктов.
• Выбранный пункт понятен до финального подтверждения заказа.
• Цена доставки отображается в нужном налоговом режиме.

Проверка для администратора

• В заказе видны метод доставки и выбранный пункт выдачи.
• Письма содержат достаточно информации для обработки заказа.
• Метод не появляется для товаров без веса, слишком тяжёлых посылок или неподдерживаемых зон, если такие ограничения настроены.
• Логи API помогают понять ошибку, если запрос к Mondial Relay не прошёл.
• Изменение ограничений можно быстро откатить: вы знаете, какой параметр включали последним.

Проверка для бизнеса

Сравните стоимость, налоги и процесс обработки с вашей реальной операционной схемой. Если у магазина несколько складов, проверьте каждый склад отдельно. Если часть товаров нельзя отправлять в пункты выдачи, создайте отдельные ограничения или исключите такие товары через вес, габариты или складскую логику. Если вы продаёте только по стране, где Mondial Relay работает нестабильно для вашего типа отправлений, лучше не показывать метод "на всякий случай".

Мини-итог: публикуйте HikaShop Mondial Relay только после полного тестового заказа. Проверка одной страницы настроек не доказывает, что покупатель сможет выбрать пункт и что менеджер увидит его в заказе.

Частые проблемы и диагностика HikaShop Mondial Relay

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

Метод доставки не появляется в checkout

Симптом: покупатель ввёл адрес, но Mondial Relay отсутствует среди способов доставки.

Возможные причины: товар без веса, метод не опубликован, зона доставки не совпадает с адресом, включено ограничение по весу или сумме, shipping view стоит до адреса, сервер не может обратиться к API.

Что проверить

• Откройте товар и проверьте вес.
• Откройте shipping method и временно снимите лишние ограничения, оставив только нужную зону.
• Проверьте, что checkout сначала собирает адрес, а затем показывает доставку.
• Убедитесь, что метод опубликован и доступен для нужной группы пользователей.

Как исправить: начните с одного тестового товара и одного адреса. Если метод появился после снятия ограничений, возвращайте ограничения по одному. Если не появился, проверяйте SOAP и API-учётные данные.

Карта или список пунктов пустые

Симптом: метод доставки выбран, но покупатель не видит доступные Point Relais или Locker.

Возможные причины: неверный почтовый индекс, пустой город, неподдерживаемая страна, ошибка API, временная недоступность пунктов. FAQ Mondial Relay отдельно объясняет, что пункт, видимый на общем сайте перевозчика, может не предлагаться на сайте магазина, если он сейчас недоступен для доставки.

Как исправить: проверьте адрес на простом городском индексе, затем используйте другой тестовый адрес. Если результат меняется, проблема в адресе или доступности пунктов. Если список всегда пуст, переходите к учётным данным API и логам SOAP-запросов.

Стоимость доставки не совпадает с ожиданием

Симптом: доставка появляется, но цена отличается от расчёта администратора.

Возможные причины: тарифы без налогов, неверная налоговая категория, включены automatic taxes, товар имеет другой вес или количество, метод использует ограничения по складу или максимальному весу. Карточка продукта предупреждает, что screenshot тарифов не является актуальной тарифной таблицей.

Как исправить: проверьте вес и количество товара, налоговую категорию доставки, режим Automatic taxes и ограничения метода. Не исправляйте цену вручную, пока не поняли, какой слой её меняет.

Выбранный пункт не попал в заказ или письмо

Симптом: покупатель выбрал пункт выдачи, но менеджер не видит его в заказе или email.

Возможные причины: старый override письма, старый checkout template, конфликт с кастомизацией, неполное сохранение заказа после изменения доставки. По карточке продукта выбранный пункт должен отображаться в emails и backend order details, поэтому отсутствие в этих местах - повод проверить шаблоны и overrides.

Как исправить: создайте тестовый заказ на стандартном шаблоне письма, временно отключите кастомные overrides email и checkout, затем сравните результат. Если на стандартной разметке пункт виден, проблема в кастомизации сайта.

Ошибка 97 в модуле Mondial Relay

Симптом: при работе модуля появляется ошибка 97.

Возможная причина: FAQ Mondial Relay указывает, что источник ошибки обычно написан в первой строке сообщения, а чаще всего проблема связана с некорректным полем данных клиента: телефон, вес, код postal, город и похожие координаты заказа.

Как исправить: откройте заказ, проверьте адрес, телефон, вес товаров и страну. Исправьте конкретное поле, указанное в первой строке ошибки, затем повторите действие. Не пересоздавайте метод доставки, пока не проверены данные заказа.

Ошибка 92 при создании этикетки

Симптом: модуль сообщает ошибку 92 при создании этикетки.

Возможная причина: FAQ Mondial Relay связывает ошибку 92 с недостаточным балансом предоплаченного аккаунта для создания этикетки. В рамках этого руководства мы не описываем покупку или пополнение, но для диагностики важно понимать, что это не ошибка HikaShop-настроек.

Как исправить: проверьте состояние аккаунта Mondial Relay и разделите проблему: выбор пункта в checkout может работать, а создание этикетки не проходить из-за условий аккаунта перевозчика.

Когда HikaShop Mondial Relay будет удачным выбором

HikaShop Mondial Relay стоит использовать, когда магазину на Joomla нужен полноценный выбор пункта выдачи Mondial Relay в checkout, а не просто текстовое обещание доставки. Сильная сторона расширения - связь между адресом покупателя, весом корзины, тарифами, картой пунктов и сохранением выбранного Point Relais в заказе. Но эта же связь требует аккуратной настройки: веса товаров, адресные поля, SOAP, учётные данные API, налоги и ограничения должны быть проверены до публикации.

Если вы только выбираете способ доставки для магазина, начните с тестового сценария из этого руководства. Если тест проходит, метод появляется в нужной зоне, пункт выдачи сохраняется в заказе, а менеджер видит его в письме, можно загрузить HikaShop Mondial Relay и готовить внедрение на рабочем сайте. Если тест показывает, что магазину достаточно ручной доставки или нужен другой перевозчик, лучше выбрать более простой или более точный инструмент.

Главное не включать доставку "на доверии" после установки. Настройте один понятный метод, выполните тестовый заказ, проверьте письма, заказ в админ-панели и недоступные сценарии. Тогда расширение будет не ещё одной галочкой в Joomla, а рабочей частью оформления заказа, которая помогает покупателю выбрать удобный пункт и помогает магазину обработать отправку без ручных уточнений.