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 хостинга.