eMAG Marketplace Connector для OpenCart — ціни, залишки й замовлення eMAG у вашому магазині

eMAG Marketplace Connector для OpenCart — інтеграція вашого магазину на OpenCart 4, 3 або 2.3 з eMAG Marketplace, найбільшим маркетплейсом Румунії, Болгарії й Угорщини (разом з Fashion Days). Ви продаєте і в себе, і на eMAG — модуль стежить, щоб ціна й залишок на eMAG відповідали OpenCart, а з Pro приносить замовлення eMAG у ваш магазин і відправляє їх через кур’єрів eMAG. Усе — через офіційний eMAG Marketplace API, без парсингу й без ручних експортів. Магазин на WooCommerce — є eMAG Marketplace Connector для WooCommerce.

Що потрібно від вас. Акаунт продавця eMAG Marketplace з API-користувачем і IP-адреса вашого сервера в білому списку API в кабінеті eMAG. Чесно про перевірку: публічної пісочниці eMAG не дає — API відповідає лише продавцям з білого списку. Модуль зроблено за офіційною документацією eMAG Marketplace API v4.5.2 і перевірено наскрізно на симуляції цього API (пропозиції, ціни, залишки, замовлення, скасування, статуси, AWB, рахунки, публікація) на OpenCart 4.1, 4.0.2.3, 3.0.5.0 і 2.3.0.2. На бойовому акаунті продавця модуль ще не запускали — перевірте на своєму в 7-денному тріалі Pro. Журнал показує кожен запит і відповідь eMAG, і якщо eMAG відповість інакше, ніж у документації, виправимо оперативно.

Що отримує магазин

• Один модуль — п’ять майданчиків: eMAG Румунія, eMAG Болгарія, eMAG Угорщина, Fashion Days Румунія і Болгарія. Той самий API, свій акаунт і валюта (RON, EUR, HUF).
• «Save and check the connection» перевіряє логін і пароль API й тягне ставки ПДВ з вашого акаунта. Помилку eMAG (невірний пароль, IP не в білому списку) модуль показує зрозумілим текстом разом з відповіддю eMAG.
• Пароль API зберігається в базі зашифрованим (AES-256 з HMAC), у форму більше не повертається і не потрапляє в журнал.

• Імпорт пропозицій: модуль читає всі ваші пропозиції eMAG і зв’язує їх з товарами OpenCart за part number — полем SKU, Model або MPN на ваш вибір, з нормалізацією пробілів і розділових знаків, як це робить eMAG, — за EAN, UPC, JAN чи ISBN або за ID. Неоднозначні збіги модуль не зв’язує навмання, а показує окремо.
• Синхронізація: продаж у магазині, збереження товару в адмінці, видалення товару — і пропозиція потрапляє в чергу, яку планувальник надсилає щохвилини. Раз на годину — повна перевірка всіх зв’язаних товарів. Надсилається лише змінене, пакетами до 50 пропозицій; пропозицію, яку eMAG відхилив, модуль знаходить поштучно, не зупиняючи решту.
• Правила ціни: ціна без ПДВ, як її приймає eMAG (товар з класом податку — ціна OpenCart уже без ПДВ, без класу — з ПДВ), націнка у % і фіксована, курс валют магазину або ручний, акційна ціна OpenCart з перекресленою звичайною, діапазон min–max, який вимагає eMAG.
• Залишок: резерв для свого магазину, кількість для товарів без обліку залишку, термін відвантаження.

У формі кожного товару — вкладка eMAG: продавати чи ні, ID пропозиції (за замовчуванням — ID товару), власна ставка ПДВ і термін відвантаження, стан на eMAG і кнопка «Send to eMAG now». Поля зберігаються штатною кнопкою збереження товару.

Pro: замовлення, відправка, публікація

• Замовлення eMAG в OpenCart — миттєво через колбек-URL eMAG, а перевірка кожні 5 хвилин підбирає пропущене. Покупець, адреса або поштомат, область за назвою (зокрема Бухарест і сектори), товари, ПДВ рядків, ваучери, заставна плата SGR і доставка — сума збігається з розрахунком eMAG, валюта RON з курсом магазину.
• Штатна історія замовлення OpenCart: кожен статус замовлення eMAG ставиться тим самим викликом, що й для замовлення з сайту, з усіма його подіями. Ваші модулі фіскалізації, Telegram-сповіщень, автоматичних ТТН чи CRM бачать замовлення eMAG як звичайні, залишок списує і повертає сам OpenCart. Лист-підтвердження OpenCart іде на пошту магазину або обрану адресу, бо пошти покупця eMAG не передає.
• Підтвердження на eMAG (acknowledge) і одне замовлення на один номер eMAG, навіть якщо колбек прийде кілька разів.
• Скасування в обидва боки: скасоване на eMAG стає «Скасовано» в OpenCart з поверненням залишку; скасоване в OpenCart йде в eMAG з причиною, яку ви обрали.
• Статус назад в eMAG: змінюєте статус у звичайній історії замовлення в адмінці — на обраний статус замовлення стає «prepared» або «finalized» на eMAG.

• AWB через кур’єрські акаунти eMAG прямо зі сторінки замовлення: відправник з ваших адрес eMAG, поштомат покупця, післяплата на суму замовлення, посилки, конверти й вага, PDF-етикетка A4, A5 або A6, оновлення статусу доставки щогодини і, за бажанням, «Виконано» після доставки.
• Рахунок-фактура: посилання на PDF рахунку йде в замовлення eMAG кнопкою в тому ж блоці.
• Публікація товарів: знайти товар на eMAG за EAN і прив’язати свою пропозицію або створити новий товар — категорія eMAG з мапи категорій OpenCart, бренд з виробника, опис, фото, характеристики з атрибутів OpenCart (автоматично за назвою або за мапою), EAN, гарантія; статус валідації документації повертається в товар.
• Монітор кнопки «Купити»: ваше місце, кількість пропозицій і найкраща ціна раз на 6 годин, лист, коли ви втратили перше місце.

Як це працює — крок за кроком

1. Підключення. Розширення → Модулі → eMAG Marketplace Connector → Connection: майданчик, API-користувач і пароль, «Save and check the connection».
2. Правила цін. Вкладка «Prices & stock»: ціни з ПДВ чи без, націнка, курс, резерв залишку, ставки ПДВ на класи податку.
3. Зв’язка. Вкладка «Products» → «Read offers from eMAG»: пропозиції eMAG зв’язуються з товарами, незв’язані видно у звіті.
4. Синхронізація. Далі кожен продаж і кожна зміна товару йдуть на eMAG самі. OpenCart 4 робить це своїм планувальником, для OpenCart 3 і 2.3 додайте cron-адресу з вкладки «Log» у cron хостингу.
5. Замовлення (Pro). Увімкніть імпорт і вставте два колбек-URL з вкладки «Orders» у кабінет eMAG — нові й скасовані замовлення приходять в OpenCart миттєво.
6. Відправка (Pro). Вкладка «AWB»: кур’єрські акаунти й адреси з eMAG, телефон відправника — і AWB створюється зі сторінки замовлення.

Що під капотом

• Формат запитів за документацією eMAG: тіло JSON, збереження — у ключі data, читання — фільтри на верхньому рівні; для незвичного шлюзу кодування читань перемикається константою.
• Ліміти eMAG (3 запити на секунду, 12 для замовлень) модуль витримує сам і повторює запит на 429.
• Штатні події OpenCart: рядки замовлення записуються в таблиці замовлень, а статус — через model checkout/order (addHistory в OpenCart 4, addOrderHistory в 3.x і 2.3). Дії з адмінки в OpenCart 4 йдуть через екземпляр вітрини, як це робить сама адмінка OpenCart; в OpenCart 3 і 2.3 — через вітрину магазину за захищеною адресою, а якщо вітрина недоступна, дія виконується в адмінці й прямо про це пише.
• Замовлення без дублів: замок у базі на номер eMAG і зв’язка номер eMAG ↔ замовлення OpenCart; повторний колбек не створює другого замовлення і не рухає залишок.
• Колбек захищено ключем: чужий виклик отримує 403 і не змушує модуль звертатися до eMAG.
• Pro-гейт без «цегли»: коли тріал закінчився, зупиняються лише Pro-функції, синхронізація працює далі.
• Видалення модуля прибирає події, завдання крону й права; таблиці зв’язок і копія налаштувань лишаються, тож перевстановлення нічого не губить.

Як встановити

1. OpenCart 4: Розширення → Інсталятор → завантажте cc_emag.ocmod.zip (ім’я архіву не змінюйте) і натисніть «Встановити». OpenCart 3: Розширення → Інсталятор → cc_emag-oc3.ocmod.zip, потім Розширення → Модифікації → «Оновити». OpenCart 2.3: залийте вміст папки upload/ з cc_emag-oc23.ocmod.zip у корінь магазину (FTP або файловий менеджер хостингу) — Інсталятор 2.3 без налаштованого FTP файлів не копіює.
2. Розширення → Розширення → Модулі → eMAG Marketplace Connector → «Встановити», потім «Редагувати».
3. Connection: майданчик, API-користувач і пароль, «Save and check the connection».
4. Products: «Read offers from eMAG» — пропозиції зв’яжуться з товарами.
5. Для Pro: вставте ліцензійний ключ з листа після оплати або натисніть «Start the 7-day trial» на вкладці «Licence», далі — вкладки Orders і AWB. Для OpenCart 3 і 2.3 додайте cron-адресу з вкладки «Log» у cron хостингу.