UniXML для OpenCart: імпорт з XML і вивантаження на маркетплейси

Магазин, що працює з зовнішнім постачальником, рано чи пізно впирається в одну й ту саму задачу. Прайс постачальника й каталог на сайті мають синхронізуватись самі, без щоденного ручного звіряння цін і залишків. Друга частина тієї ж історії, це маркетплейси. Rozetka чи Prom дають трафік, від якого нема сенсу відмовлятись, але вести під кожен майданчик окремий фід руками швидко перетворюється на рутину.

UniXML від розробника Exploits закриває обидві задачі одним модулем: імпорт від постачальника і генерацію XML/YML фідів для маркетплейсів. Подивимось, що там реально під капотом.

Що робить модуль насправді

Модуль об'єднує дві незалежні функції: імпорт і експорт, з окремими налаштуваннями, але спільною ліцензією. Раз налаштований фід далі працює за розкладом через cron, без участі людини. Постачальник оновив прайс, за годину чи дві оновились і ваші ціни з наявністю.

Імпорт. Забирає XML, YML, а також xls(x) і csv від постачальника й накатує це на каталог OpenCart: товари, ціни, наявність, категорії з повною вкладеністю, атрибути, опції, фото. Працює блоками, тобто не тягне весь фід в пам'ять одразу, а обробляє порціями. Це дозволяє імпортувати великі прайси без падіння по таймауту чи пам'яті. Після генерації модуль показує статистику: скільки запитів до бази пішло, скільки пам'яті з'їлось, скільки товарів додалось чи оновилось. Дрібниця, але саме вона рятує, коли треба зрозуміти, чому імпорт триває довше, ніж очікували.

Експорт. Формує фід у форматі, який розуміє конкретний маркетплейс: Rozetka, Prom, Google Merchant Center, Facebook, Hotline, Kaspi, AliExpress і ще кілька десятків майданчиків, включно з нещодавно доданими Maudau, Мономаркет, EVA, KASTA. Список оновлюється. Розробник додає нові напрямки в міру появи попиту.

Імпорт з XML: де саме гнучкість, а де підводні камені

Найцінніша частина імпортного функціоналу — не сам факт завантаження товарів, а можливість тонко керувати відповідностями. Можна вказати, який тег фіда відповідає за яке поле в OpenCart, налаштувати зв'язаний ключ (за замовчуванням модуль прив'язує товар до id у фіді, але можна перемкнути на артикул чи назву), задати стоп-лист позицій, які не треба вантажити взагалі.

Окремо варто відзначити три речі, які в дешевших чи саморобних рішеннях зазвичай відсутні:

• Кастомний код у трьох точках: до імпорту, під час і після. Це фактично хук у процес генерації. Якщо потрібна логіка, якої немає в стандартних налаштуваннях (наприклад, розрахунок ціни за складною формулою або підтяжка даних з іншої таблиці), її можна дописати прямо в модулі.
• Мультимовний імпорт без обмежень по кількості мов, з можливістю прив'язати атрибути головного фіда до атрибутів фідів інших мов. Якщо теги йдуть по порядку, прив'язка відбувається автоматично, і це рятує години ручного налаштування для магазинів з двома-трьома мовами інтерфейсу.
• Оновлення без дублювання. Можна налаштувати так, щоб модуль лише оновлював існуючі товари, не чіпаючи нові, або навпаки вимикав ті позиції, які зникли з фіда постачальника, але раніше були завантажені. Це закриває класичну проблему: постачальник прибрав товар з наявності, а на сайті він так і висить у продажу, поки хтось не зробить замовлення й не отримає відмову.

Із конвертацією фото теж продумано. Якщо постачальник віддає картинки у webp, модуль автоматично перетворює їх у png, з можливістю відключити цю опцію. Дрібниця, але саме на такому спотикаються магазини, де фронтенд чи шаблон не готовий до webp у всіх місцях виводу.

Вивантаження на маркетплейси: не просто генератор XML

Тут головна цінність не в самому факті наявності фіда для Rozetka чи Prom (це є в багатьох модулях), а в рівні контролю над тим, що саме туди йде. Можна фільтрувати за категоріями, брендами, наявністю, ціною, наявністю фото, і комбінувати ці умови. Можна виставити націнку окремо для кожної категорії маркетплейсу, а не одну загальну на весь фід, що критично, якщо на різні групи товарів у вас різна маржа.

Окремо варто сказати про множення товару на опції. Якщо у товару два кольори й три розміри, для маркетплейсу це має піти як шість окремих offer. Інакше покупець на Rozetka чи Prom просто не побачить потрібний варіант. У модулі це реалізовано, і за описом розробника саме цей функціонал переробляли в новій версії, отже раніше там були проблеми, які вже виправили.

Для Епіцентру є нюанс, який варто знати заздалегідь. Перед вивантаженням треба вручну проставити відповідність даних магазину з довідниками маркетплейсу. Це не питання одного кліка "увімкнути фід", без цієї відповідності Епіцентр фід просто не прийме коректно. Розробник виніс окрему інструкцію на сайті документації саме через те, що це найчастіше місце, де новачки застрягають.

Технічні реалії: що перевірити перед покупкою

• Версії OpenCart: 2.0.3–3.0.5.
• PHP: 5.6–8.4, тобто актуальні збірки на PHP 8.x модуль підтримує.
• Ioncube: не використовується, вихідний код відкритий. Перевірка ліцензії йде один раз при активації на сервер розробника, якщо сервер недоступний, модуль продовжує працювати.
• Встановлення: через стандартний ocmod-файл в адмінці. Є відомий нюанс для версій 3.x: якщо директорія admin/controller/feed недоступна для запису, спершу ставите допоміжний мод localcopy, чистите кеш модифікацій, і тільки тоді UniXML. Пропустите цей крок — встановлення завершиться помилкою, яку легко прийняти за баг модуля, хоча причина суто в правах на директорію.
• Модуль з'являється в меню Доповнення → Канали просування (популяризації) → UniXML.

Ціна та ліцензія

Модуль коштує приблизно 40 USD, ліцензія на один домен. При зміні домену розробник переглядає запит індивідуально, жорсткого автоматичного механізму зміни немає. Є знижки від кількості: від 2 шт. мінус 30%, від 10 шт. мінус 50%, що логічно для агентств чи людей, які ведуть кілька магазинів клієнтів.

Окремо продається встановлення й налаштування одного фіда (30 USD) та доопрацювання під нетипову задачу (20 USD) розробник прямо пише в описі, що краще спершу написати йому особисто щодо ціни на імпорт і вимог, а не одразу оформлювати замовлення наосліп. Підхід, який рідко зустрінеш у типових описах на маркетплейсах модулів, і це радше плюс, ніж мінус: менше шансів купити не те, що треба.

Кому підійде UniXML

Найкраще модуль розкривається там, де є реальна складність: кілька постачальників з різною структурою прайсу, кілька маркетплейсів з різними вимогами до фіда, каталог на тисячі позицій, де вручну звіряти категорії й атрибути вже нереально. Тут гнучкість відповідностей, кастомний код і націнки по категоріях відпрацьовують свою ціну. Заощадити на дешевшому рішенні означає потім місяцями руками виправляти криві фіди й губити замовлення через неактуальні залишки.

Чек-лист перед встановленням

1. Перевірте версію OpenCart — модуль підтримує 2.1–3.0.5.
2. Перевірте версію PHP на хостингу: підтримка від 5.6 до 8.4.
3. За потреби поставте localcopy.
4. Визначте зв'язаний ключ для імпорту заздалегідь: id з фіда, артикул чи назва, щоб не переналаштовувати синхронізацію пізніше.
5. Для Епіцентру одразу закладіть час на ручне проставлення відповідностей за довідниками маркетплейсу.
6. Вказуйте домен одразу при покупці — тоді активація ліцензії відбувається автоматично.
7. Якщо потрібен нетиповий сценарій імпорту чи вивантаження, напишіть розробнику до покупки, а не після.