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.