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.