Mirakl Connector для OpenCart — офферы, цены, остатки и заказы Worten, PcComponentes, Carrefour, Leroy Merlin

Mirakl Connector подключает OpenCart к маркетплейсам, работающим на Mirakl: Worten, PcComponentes, Carrefour, Leroy Merlin, Decathlon и другим. Модуль связывает ваши существующие офферы с товарами магазина и держит цену и остаток такими, как в магазине. Pro добавляет несколько маркетплейсов с одним остатком, заказы в OpenCart с принятием, отправку с трек-номером и новые офферы по EAN.

Что видит покупатель

Покупатель на маркетплейсе видит ваш товар в каталоге маркетплейса с ценой и количеством из OpenCart, с вашей наценкой и в валюте маркетплейса. Маркетплейс находит товар по EAN, поэтому оффер стоит на той же карточке товара, что и у других продавцов. Выключенный или проданный товар получает на маркетплейсе количество 0.

Что получает админ

Расширения → Модули → Mirakl Connector: адрес Mirakl маркетплейса, API-ключ и, если нужно, ID магазина. «Check» сохраняет форму и читает магазин, валюту, состояния офферов и перевозчиков. Ключ хранится зашифрованным. Для каждого маркетплейса — курс, налог, наценка в процентах и фиксированная, акционная цена, резерв, состояние оффера, срок отправки и тип кода товара.

«Import offers» читает все офферы вашего магазина на маркетплейсе и связывает их с товарами: сначала по SKU, потом по EAN. Неоднозначные не связываются, список с причинами виден сразу. Дальше цена и остаток уходят из очереди раз в минуту на маркетплейс, только изменённое, а ответ маркетплейса по каждому офферу виден в модуле и в товаре. Поля, которые маркетплейс сбросил бы (описание, срок отправки, логистический класс, скидка), модуль возвращает такими, как были.

В Pro заказы маркетплейсов читаются каждые 5 минут. Новый заказ принимается сам, когда есть все товары и остаток; иначе ждёт вашего решения с кнопками принять или отказать. Заказ в OpenCart создаётся после оплаты покупателем, с адресом, телефоном и суммами. Отправка с перевозчиком и трек-номером идёт с панели заказа или по статусу OpenCart, отмена — с панели; отмены и возвраты с маркетплейса меняют статус и возвращают остаток.

Как это работает, шаг за шагом

1. Маркетплейс даёт вам адрес Mirakl и API-ключ магазина; вы вставляете их в модуль и нажимаете «Check».
2. «Import offers» связывает ваши офферы на маркетплейсе с товарами по SKU или EAN.
3. Цена и остаток товара уходят на маркетплейс после каждого изменения, через очередь раз в минуту.
4. В товаре, на вкладке Mirakl, видно, что уйдёт на каждый маркетплейс и что там стоит сейчас.
5. В Pro заказы приходят в OpenCart, а отправка и отмены возвращаются на маркетплейс.

Что под капотом

• API-ключ хранится зашифрованным (AES-256 с HMAC).
• Отправляется только изменённое; лимиты Mirakl на частоту запросов модуль соблюдает сам.
• Курс из валют магазина или вручную, налог для цен без НДС, округление до центов.
• Pro: зона доставки по названию региона, для Испании — по индексу, для Франции — по департаменту.
• Pro: статусы заказов идут через историю OpenCart, поэтому другие модули (счета, уведомления, учёт) видят их как обычные заказы.
• Журнал API за 30 дней.

Как установить

1. OpenCart 4.x и 3.x: Расширения → Установка, загрузите архив для своей версии, не переименовывая файл. OpenCart 2.3: содержимое папки upload/ из архива — в корень магазина.
2. OpenCart 3.x и 2.3: Расширения → Модификации → Обновить.
3. Расширения → Модули → Mirakl Connector → установить → редактировать.
4. Вставьте адрес Mirakl и API-ключ, нажмите «Check», потом «Import offers» на вкладке Offers.
5. Для Pro: вставьте ключ или запустите 7 дней триала на вкладке Licence.