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.