Mercado Libre Connector для OpenCart 2.3, 3.x и 4.x — объявления, цены, остатки, заказы

Mercado Libre Connector подключает магазин OpenCart к Mercado Libre: Mercado Livre в Бразилии и Mercado Libre в Мексике, Аргентине и Колумбии. Модуль связывает ваши существующие объявления с товарами и держит на них цену и остаток. Pro приводит оплаченные заказы в OpenCart, даёт этикетки Mercado Envíos, передаёт отправления собственным перевозчиком и создаёт новые объявления из товаров.

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

Покупатель на Mercado Libre видит цену вашего магазина в местной валюте: по курсу магазина или вашему, с налогом и наценкой, округлённую под валюту (колумбийское песо без копеек). Товар закончился или выключен — объявление ставится на паузу и возвращается в продажу, когда товар снова есть.

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

Расширения → Модули → Mercado Libre Connector: страна, адрес возврата и адрес уведомлений для приложения, App ID, секретный ключ и кнопка «Connect to Mercado Libre». Импорт читает объявления аккаунта и связывает их с товарами по id объявления, SELLER_SKU или GTIN; что не связалось, видно в списке с причиной. Дальше курс, налог, наценка в процентах и фиксированная, резерв остатка.

В форме товара есть вкладка Mercado Libre: продавать или нет, id или ссылка на объявление, SKU, GTIN, цена и остаток, которые уйдут на Mercado Libre, состояние и кнопки «Send now» и «Read the listing».

В Pro оплаченные заказы приходят в OpenCart по уведомлениям Mercado Libre и проверке каждые 5 минут: имя, адрес доставки, телефон и доставка покупателя в сумме. Отмена на Mercado Libre ставит заказу статус «Отменён» и возвращает остаток. На странице заказа есть панель: перечитать заказ, этикетка Mercado Envíos в PDF, «отправлено» и «доставлено» с трек-номером для собственного перевозчика. Новые объявления создаются из товара: категория, атрибуты, до 10 фото, описание.

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

1. В кабинете разработчика Mercado Libre своей страны создаёте приложение с адресами из модуля и вставляете его App ID и секретный ключ.
2. «Connect to Mercado Libre» открывает страницу разрешения Mercado Libre; после разрешения токены хранятся зашифрованными и обновляются сами.
3. Импорт связывает существующие объявления с товарами по id объявления, SELLER_SKU или GTIN.
4. Изменения цены и остатка встают в очередь, крон каждую минуту отправляет только изменённое, а раз в час модуль сверяет всё.
5. В Pro заказы приходят в OpenCart, а «отправлено» и «доставлено» для собственного перевозчика уходят обратно в Mercado Libre.

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

• Ключи и токены хранятся зашифрованными (AES-256 с HMAC); после 401 токен обновляется и запрос повторяется.
• Отправляется только изменённое; выключенный или удалённый товар ставит объявление на паузу.
• Объявления с вариациями модуль показывает с пояснением, но не меняет: их правят на Mercado Libre.
• Заказы не задваиваются; заказы Mercado Envíos Full по умолчанию не создаются, потому что их остаток на складе Mercado Libre.
• Корзина из нескольких заказов (pack): доставка считается один раз.
• Журнал API: 100 записей за 30 дней.

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

1. Расширения → Установщик: загрузите архив под свою версию, не меняя имя файла.
2. OpenCart 3.x и 2.3: Расширения → Модификации → «Обновить».
3. Расширения → Модули → Mercado Libre Connector → установить → редактировать.
4. Выберите страну, создайте приложение с адресами из модуля, вставьте App ID и секретный ключ, нажмите «Connect to Mercado Libre».
5. На вкладке Products запустите «Import and link» и проверьте связку товаров.
6. Для Pro: вставьте ключ или запустите 7 дней триала на вкладке Licence.