eMAG Marketplace Connector для WooCommerce — цены, остатки и заказы eMAG в вашем магазине

eMAG Marketplace Connector для WooCommerce — интеграция вашего магазина с eMAG Marketplace, крупнейшим маркетплейсом Румынии, Болгарии и Венгрии (вместе с Fashion Days). Вы продаёте и у себя, и на eMAG — плагин следит, чтобы цена и остаток на eMAG совпадали с WooCommerce, а с Pro приносит заказы eMAG в ваш магазин и отправляет их через курьеров eMAG. Всё — через официальный eMAG Marketplace API, без парсинга и ручных выгрузок. Магазин на OpenCart — есть eMAG Marketplace Connector для OpenCart.

Что нужно от вас. Аккаунт продавца eMAG Marketplace с API-пользователем и IP-адрес вашего сервера в белом списке API в кабинете eMAG. Честно о проверке: публичной песочницы eMAG не даёт — API отвечает только продавцам из белого списка. Плагин сделан по официальной документации eMAG Marketplace API v4.5.2 и проверен сквозным образом на симуляции этого API (предложения, цены, остатки, заказы, отмены, AWB, счета, публикация); живой eMAG с нашего сервера отвечает на запрос плагина собственным текстом ошибки. На боевом аккаунте продавца плагин ещё не запускали — проверьте на своём в 7-дневном триале Pro. Журнал показывает каждый запрос и ответ eMAG, и если eMAG ответит иначе, чем в документации, исправим оперативно.

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

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

• Импорт предложений: плагин читает все ваши предложения eMAG и связывает их с товарами WooCommerce по SKU (part number, с нормализацией пробелов и точек с запятой, как это делает eMAG), по EAN или по ID. Несвязанные предложения и конфликты — отдельным отчётом.
• Синхронизация: продажа в магазине, смена цены, импорт — и через минуту предложение на eMAG обновляется. Страховка — проверка очереди каждые 5 минут. Отправляется только изменённое, пакетами до 50 предложений; предложение, которое eMAG отклонил, плагин находит поштучно, не останавливая остальные.
• Таблица связанных товаров: статус валидации документации eMAG, ошибки документации, цена и остаток — отправленные и те, что на eMAG.

• Цена без НДС, как её принимает eMAG: из цены WooCommerce с НДС или без — на ваш выбор.
• Наценка в % и фиксированная, курс, если магазин продаёт в другой валюте, акционная цена — обычная уходит в eMAG как зачёркнутая (recommended price), диапазон min–max, который требует eMAG, может двигаться вместе с ценой.
• НДС: ставка на каждый класс налога WooCommerce и на отдельный товар.
• Остаток: резерв для своего магазина, количество для товаров без учёта, срок отгрузки для магазина и товара.

В каждом товаре и вариации — вкладка eMAG: продавать или нет, ID предложения, своя ставка НДС и срок отгрузки, состояние на eMAG и кнопка «Send to eMAG now». В списке товаров — колонка eMAG и массовые действия «Sell on eMAG» / «Stop selling on eMAG».

Pro: заказы, отправка, публикация

• Заказы eMAG в WooCommerce — мгновенно через колбэк-URL eMAG, а проверка каждые 5 минут подбирает пропущенное. Покупатель, адрес или почтомат, товары, НДС строк, ваучеры, залоговый сбор SGR и доставка — сумма совпадает с расчётом eMAG.
• Подтверждение на eMAG (acknowledge) и списание остатка — один раз, даже если eMAG пришлёт колбэк несколько раз параллельно. Новый остаток сам уходит на eMAG.
• Отмены в обе стороны: отменённый на eMAG заказ становится «Отменён» в WooCommerce с возвратом остатка; отменённый в WooCommerce уходит в eMAG с выбранной вами причиной.
• Статус обратно в eMAG: на выбранный статус WooCommerce заказ становится «prepared» или «finalized» на eMAG.

• AWB через курьерские аккаунты eMAG прямо из карточки заказа: отправитель из ваших адресов eMAG, почтомат покупателя, наложенный платёж на сумму заказа, PDF-этикетка A4, A5 или A6, обновление статуса доставки каждый час и, по желанию, «Выполнен» после доставки.
• Счёт-фактура: ссылка на PDF счёта уходит в заказ eMAG кнопкой в том же блоке.

• Публикация товаров: найти товар на eMAG по EAN и привязать своё предложение или создать новый товар — категория eMAG, бренд, описание, фото, характеристики (из атрибутов WooCommerce автоматически или по карте категории), EAN, гарантия, семейства для вариаций.
• Категории eMAG: загрузка, поиск, карта категорий WooCommerce → eMAG, характеристики и типы семейств.
• Монитор кнопки «Купить»: ваше место, количество предложений и лучшая цена в таблице, письмо, когда вы потеряли первое место.

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

1. Подключение. WooCommerce → eMAG Marketplace → Connection: площадка, API-пользователь и пароль, «Check the connection». Ставки НДС загружаются из eMAG.
2. Правила цен. Вкладка Offers: цены с НДС или без, наценка, курс, резерв остатка.
3. Связка. «Import and link offers» — предложения eMAG связываются с товарами по SKU или EAN; несвязанные видно в отчёте.
4. Синхронизация. Дальше каждая продажа и каждое изменение цены уходят на eMAG сами; «Resend all linked products» отправляет всё разом.
5. Заказы (Pro). Включите импорт и вставьте два колбэк-URL в кабинет eMAG — новые и отменённые заказы приходят в WooCommerce мгновенно.
6. Отправка (Pro). Вкладка Shipping: «Read courier accounts and addresses from eMAG», телефон отправителя — и AWB создаётся из карточки заказа.

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

• Формат запросов по документации eMAG: тело JSON, сохранение — в ключе data, чтение — фильтры на верхнем уровне; для необычного шлюза кодировка переключается фильтром или константой.
• Лимиты eMAG (3 запроса в секунду, 12 для заказов) плагин выдерживает сам и повторяет запрос на 429.
• Очередь синхронизации — в мета товаров; сетевой сбой, 401/403 или 5xx оставляют предложения в очереди, а не теряют их. Неизменённое предложение (хеш) повторно не отправляется.
• Заказы без дублей: замок в базе и повторное чтение заказа внутри замка — три параллельных колбэка дают один заказ и одно списание остатка.
• Колбэк защищён ключом; плагины безопасности, режущие анонимный REST, не останавливают импорт — остаётся проверка каждые 5 минут.
• Pro-гейт без «кирпича»: когда триал закончился, останавливаются только Pro-функции, синхронизация работает дальше.
• Удаление плагина убирает настройки, поля eMAG в товарах, журнал и задания крона; данные eMAG в заказах остаются.

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

1. Плагины → Добавить новый → Загрузить плагин: выберите emag-marketplace-connector-for-woocommerce-1.0.0.zip и активируйте.
2. WooCommerce → eMAG Marketplace → Connection: площадка, API-пользователь и пароль, сохраните и нажмите «Check the connection».
3. Offers: проверьте правила цен и нажмите «Import and link offers».
4. Для Pro: вставьте лицензионный ключ из письма после оплаты или запустите 7-дневный триал, дальше — вкладки Orders и Shipping.