• Інтеграції

Інтеграція сайту з Епіцентром: каталог, ціни, замовлення

Інтеграція з Епіцентром — це XML-файл із вашого каталогу, який Епіцентр Маркетплейс забирає за посиланням, плюс обмін замовленнями через його API. Каталог при цьому має говорити мовою майданчика: кінцева категорія й характеристики задаються кодами з довідника Епіцентру. З Епіцентром ми ще не інтегрували жодного магазину, тож це пропозиція розробки під вашу задачу. Спираємось на документацію майданчика й на роботу з фідами Rozetka. Перший крок — безкоштовна перевірка, скільки ваших позицій уже вкладається в коди й межі майданчика.

Подивитись, як це працює
Вартість
після безкоштовного аудиту
Гарантія
30 днів після підписання акта
Як товари потрапляють на майданчик
XML за посиланням або XLSX-файл
після безкоштовного аудиту
Вартість
Гарантія

днів після підписання акта

XML за посиланням або XLSX-файл
Як товари потрапляють на майданчик

довідка Епіцентру, перевірено 12.09.2026

раз на добу о 24:00 UTC; на запит — 12, 4 або 1 година
Автооновлення за посиланням
поки жодної — це пропозиція розробки
Інтеграцій з Епіцентром у нас

кейс нижче — магазин із підключеною Rozetka

Строк робіт

робочих днів; 10–22 із замовленнями в CRM

Кому підходить

Ситуації, у яких ця послуга дає результат

Сценарій 1 із 4

Каталог уже йде на Rozetka чи Prom, тепер потрібен Епіцентр

Фід під Rozetka Епіцентр як є не прочитає: категорію він чекає кодом зі свого довідника, характеристики — парою «код атрибута, код значення». Готовий фід стає джерелом даних, з якого ми збираємо окремий файл. Rozetka підключена в магазинах із наших кейсів; з Епіцентром такої роботи в нас ще не було.

Розберемо вашу ситуацію на безкоштовному аудиті
Кейси

Задачі та результат у цифрах — усі показники зняті нашим виміром

інтернет-магазин офіційного продавця садової техніки та запчастин — сусідня робота з Rozetka

Задача
Продавати техніку Husqvarna та запчастини до неї: бензопили, газонокосарки, тримери, аксесуари. Потрібен каталог із глибокою вкладеністю категорій, фільтрами за потужністю й типом двигуна, порівнянням моделей, актуальними залишками й цінами з облікової системи, оплатою та службами доставки.
Рішення
Магазин на OpenCart 3.x (тема revolution, HTTP/2) з каталогом запчастин глибиною до 4 рівнів вкладеності. Підключено 8 способів оплати — LiqPay, покупка частинами Monobank (3 платежі), оплата за IBAN, безготівковий розрахунок з ПДВ, оплата при отриманні, Visa, Mastercard, ПриватБанк — і 4 варіанти доставки: Нова Пошта, Meest Express, Rozetka Delivery, самовивіз. Аналітика: Google Tag Manager і Google Analytics (gtag), майданчик Rozetka, модуль Google Reviews. Розмітка Organization, Store, Place, GeoCoordinates, WebSite/SearchAction; дві мовні версії uk/ru з x-default; robots.txt явно оголошує адресу sitemap.
Результат
Станом на 31.07.2026 магазин працює (HTTP 200, HTTPS); каталог: 55 321 товарна сторінка в карті сайту (18 підкарт по 3 000 URL + 1 321 у 19-й) і 3 868 категорій — 59 189 URL разом; при такому обсязі перша відповідь сервера — 840 мс, повне завантаження HTML — 997 мс; 6 типів JSON-LD, включно зі Store + Place + GeoCoordinates (локальне SEO) і WebSite/SearchAction (sitelinks searchbox); 8 способів оплати і 4 варіанти доставки.
Що входить

Повний перелік робіт і того, що ви отримуєте на виході

  • Зіставлення ваших категорій з кодами кінцевих категорій Епіцентру — позиція потрапляє у свою гілку з першого імпорту
  • Карта характеристик: ваші поля переводяться в коди атрибутів і значень із довідника майданчика
  • XML-генератор у форматі Епіцентру: назва й опис українською, російська версія за бажанням, опис лише з дозволеними тегами, габарити в міліметрах і грамах
  • Перевірка до відправлення: назва понад 150 символів, опис понад 1500, артикул понад 64 (понад 25, якщо частину товарів вантажите XLSX), позиція без української назви — усе це йде у звіт і не доходить до модерації
  • Артикул як ключ обміну: offer id у файлі дорівнює артикулу в кабінеті, інакше автооновлення цін свого товару не знайде
  • Посилання для автооновлення цін і наявності з інтервалом під ваш асортимент — від раз на добу до щогодини
  • Пакетне оновлення цін і наявності через API, якщо Епіцентр відкриє цей метод вашому кабінету: у специфікації він описаний, у довідці — ні
  • Забір замовлень через API в адмінку сайту чи вашу CRM: склад, покупець, доставка, коментарі — менеджер працює в одному вікні
  • Зворотний шлях статусів: підтвердження, скасування з причиною, номер ТТН — у кабінеті Епіцентру нічого не дублюється вручну
  • Журнал обміну: що відправлено й яку позицію майданчик пропустив і чому — поломку видно того ж дня
  • Гарантія 30 календарних днів на виконані роботи
Коли ця послуга не підходить

Що не входить у роботу — щоб не було сюрпризів на здачі

  • Реєстрація продавця, договір з Епіцентром і умови співпраці
  • Модерація карток і рішення майданчика щодо категорії чи бренду
  • Реєстрація нових брендів у системі Епіцентру
  • Написання описів, переклад і фотозйомка під вимоги до контенту
  • Реклама всередині маркетплейсу й робота з відгуками
Етапи роботи

Прозорі етапи з погодженням на кожному кроці

Загальний строк:7–22 днів

  1. Довідники й зіставлення категорій

    2–5 робочих днів

    Дерево категорій і набори атрибутів беремо з кабінету, а якщо вашому кабінету відкрито методи довідників у бета-API — знімаємо їх звідти автоматично. Складаємо таблицю: ваша гілка — код кінцевої категорії Епіцентру — обов'язкові для неї атрибути й допустимі значення.

  2. Генератор XML

    2–4 робочих дні

    Назва й опис українською, коди категорій, параметри з кодами атрибутів і значень, габарити, наявність трьома значеннями: в наявності, під замовлення, немає. Файл збирається фоновою задачею й віддається за постійним посиланням.

  3. Перше завантаження невеликою партією

    1–3 робочих дні

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

  4. Ціни й наявність

    1–3 робочих дні

    Посилання для автооновлення в кабінеті, запит на частіший інтервал через менеджера майданчика; якщо метод відкритий — пакетне оновлення через API з перевіркою результату кожного запиту.

  5. Замовлення — за потреби

    3–6 робочих днів

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

  6. Передача

    1 робочий день

    Інструкція для менеджера, доступ до журналу обміну, розбір першого тижня роботи разом із вами.

Перевірка каталогу на коди й межі Епіцентру

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

Що ми міряємо

  • Українська назва й описДовідка Епіцентру вимагає обидва поля українською. У 21 публічному фіді українських магазинів, які ми розібрали 08.09.2026, окремі українські поля були лише у 5. Це чужі фіди під Prom і Rozetka, не під Епіцентр, але картину ринку вони дають.
  • Довжина полівНазва до 150 символів, опис до 1500, артикул до 25 символів у XLSX-шаблоні і до 64 у XML. Рахуємо, скільки позицій виходять за ці межі і чи скорочуються вони правилом, без ручної правки кожної.
  • Характеристики окремими полямиЕпіцентр чекає параметри з кодами атрибутів зі свого довідника. У замірі тих самих 21 фіду 05.09.2026 у 15 не було жодного тега param: такий каталог спершу розбирають і тільки потім вивантажують.
  • Артикул як ідентифікаторЧи він унікальний, чи вкладається в межу — артикул до 25 символів у XLSX-шаблоні і до 64 у XML — і чи збігатиметься з полем «Артикул» у кабінеті. Від цього залежить, чи знайде автооновлення ваш товар.
  • Що вже заведено в кабінетіЯкщо частина товарів уже внесена вручну чи імпортом з Prom, дивимось, які там артикули й статуси, щоб обмін не наробив дублів і не стер дозаповнене.
  • Доступ до APIТокен генерує роль «Адміністратор компанії», а вкладку API, за описом у специфікації, відкриває категорійний менеджер. Метод оновлення цін вимагає ще й окремого дозволу. Перевіряємо, що саме відкрито вашому кабінету.

Що ви отримуєте

  • Звіт: скільки позицій проходять за обов'язковими полями й межами довжини, скільки ні і чому.
  • Чернетку зіставлення ваших основних категорій з кодами кінцевих категорій Епіцентру.
  • Відповідь, які методи API доступні саме вашому кабінету.
  • Оцінку робіт по етапах із поділом на обов'язкове й бажане.

Строк: 2–3 робочих дні

Чому це безкоштовно

Бо більша частина роботи тут — дані, і її обсяг видно лише на вашому каталозі. До того ж з Епіцентром ми ще не працювали, і називати суму наосліп було б нечесно.

Що далі

Після розбору даємо кошторис по етапах і перелік позицій, яким потрібна правка даних. Якщо виявиться, що вам вистачить штатного XLSX-імпорту з кабінету, скажемо це першим листом.

Коротка форма: контакт і адреса сайту

Працюємо офіційно

Договір, акт і рахунок — на кожен проєкт, а не тільки на великий. Без документів у вас немає ні прав на роботу, ні підстави провести витрати.

Нам довіряють6 брендів

Нам довіряють: Kvant Energy, GYPSUN, Naturel Cosmetics, Pancer Protection, LUGI, BeeTech

Умови, зафіксовані письмово8 пунктів
  • 01

    Договір, акт і гарантія 30 днів

    На кожен проєкт письмовий договір: обсяг, строки, сума, порядок приймання. Після здачі — акт і рахунок, а далі 30 календарних днів гарантії: помилки з нашої вини усуваємо безоплатно. Усне з дзвінка дублюємо письмово того ж дня.

  • 02

    ФОП і безготівковий розрахунок

    Виконавець — зареєстрований ФОП. Оплата на рахунок із закривними документами.

  • 03

    Права й доступи — ваші

    Код, дизайн і матеріали переходять до вас після повної оплати. Домен, хостинг, репозиторій, аналітику оформлюємо на вас.

  • 04

    Портал клієнта замість переписки

    На час роботи ви отримуєте доступ до порталу: договори, рахунки, акти й стан проєкту в одному місці.

  • 05

    Сайти в дев'яти країнах

    Наші сайти працюють у дев'яти країнах: крім України — Польща, Німеччина, Австрія, Англія, Норвегія, Болгарія, Молдова, Іспанія.

  • 06

    Цифри, які можна перевірити

    Кожен кейс у портфоліо — з посиланням на живий сайт і технічним виміром.

  • 07

    Спершу аудит, потім сума

    Прайсу на сайті немає навмисно: обсяг тієї самої роботи у двох клієнтів відрізняється в рази.

  • 08

    Кажемо «ні», коли не впевнені

    Якщо задача не наша або строк нереальний — скажемо одразу.

  • 01

    Договір, акт і гарантія 30 днів

    На кожен проєкт письмовий договір: обсяг, строки, сума, порядок приймання. Після здачі — акт і рахунок, а далі 30 календарних днів гарантії: помилки з нашої вини усуваємо безоплатно. Усне з дзвінка дублюємо письмово того ж дня.

  • 02

    ФОП і безготівковий розрахунок

    Виконавець — зареєстрований ФОП. Оплата на рахунок із закривними документами.

  • 03

    Права й доступи — ваші

    Код, дизайн і матеріали переходять до вас після повної оплати. Домен, хостинг, репозиторій, аналітику оформлюємо на вас.

  • 04

    Портал клієнта замість переписки

    На час роботи ви отримуєте доступ до порталу: договори, рахунки, акти й стан проєкту в одному місці.

  • 05

    Сайти в дев'яти країнах

    Наші сайти працюють у дев'яти країнах: крім України — Польща, Німеччина, Австрія, Англія, Норвегія, Болгарія, Молдова, Іспанія.

  • 06

    Цифри, які можна перевірити

    Кожен кейс у портфоліо — з посиланням на живий сайт і технічним виміром.

  • 07

    Спершу аудит, потім сума

    Прайсу на сайті немає навмисно: обсяг тієї самої роботи у двох клієнтів відрізняється в рази.

  • 08

    Кажемо «ні», коли не впевнені

    Якщо задача не наша або строк нереальний — скажемо одразу.

NDA підписуємо на запит. Після завершення співпраці наші доступи до ваших сервісів видаляємо самі.

Не знайшли свій випадок?

Опишіть, як це влаштовано у вас, — відповімо, чи підходить «Інтеграція з маркетплейсом Епіцентр» і що це означає у вашій ситуації. Без брифу й без дзвінка: одне питання, одна відповідь.

Що впливає на вартість

Чому дві однакові на вигляд задачі рахуються по-різному

  • Стан характеристикПараметри, що лежать окремими полями, зіставляються з кодами атрибутів таблицею за день-два. Характеристики всередині тексту опису доводиться спершу витягувати, і саме це з'їдає більшу частину строку.
  • Кількість кінцевих категорійКожна ваша гілка лягає на кінцеву категорію Епіцентру з власним набором атрибутів. Десяток категорій — робота на день; кілька сотень — окремий документ, який доведеться підтримувати, коли майданчик змінить дерево.
  • Мова каталогуЯкщо українські назви й описи вже є, генератор просто їх бере. Якщо немає, їх треба написати чи перекласти — це контентна робота, вона оцінюється окремо від розробки.
  • ЗамовленняЛишити обробку замовлень у кабінеті — мінус цілий етап. Забирати їх у CRM зі зворотними статусами й ТТН означає окремий обмін через API, найбільший за обсягом у цій роботі.
  • Джерело цін і залишківЯкщо залишки ведете в 1С чи BAS, обмін з Епіцентром спиратиметься на сайт, а сайт — на обліковку; друге плече рахується окремо.
Технології та інтеграції

На чому будуємо і з чим це з'єднується

Стек

  • XML yml_catalog з кодами категорій і атрибутів Епіцентру — окремий файл, не копія фіда Rozetka
  • Merchant API Епіцентру — REST із токеном у заголовку Authorization. Довідка підтверджує лише замовлення; довідники й пакетне оновлення цін є тільки в специфікації закритого бета-тесту і потребують окремого дозволу для кабінету. Тестового середовища немає.
  • OpenCart 3 / 4 — генератор файлу й обмін замовленнями пишемо модулем під ваш каталог; готових модулів під Епіцентр ми не перевіряли
  • WooCommerce — те саме окремим плагіном
  • PHP або Node.js — фонові задачі: збірка файлу, опитування замовлень
  • Журнал обміну — таблиця з кожним запитом, відповіддю майданчика й статусом позиції

Інтеграції

  • Епіцентр Маркетплейс — імпорт XML за посиланням
  • Merchant API Епіцентру — замовлення й довідники
  • KeyCRM або інша CRM — приймач замовлень
  • Нова Пошта / Укрпошта — номер ТТН у замовленні
  • 1С / BAS — джерело цін і залишків
  • Rozetka і Prom — суміжні фіди
Коли файл і API окупаються, а коли вистачить кабінету

Чим цей варіант відрізняється від альтернативи

Нова позиціяз'являється у файлі й іде наступним імпортом
Ціна й наявністьавтооновлення за посиланням, від раз на добу до щогодини
Характеристикикоди атрибутів підставляються з карти відповідностей
Замовленняприїжджають у CRM, статус і ТТН повертаються автоматично
Великий каталогтой самий обсяг роботи на сотні й на десятки тисяч позицій
Що потрібно від вас

Без цього не почнемо — краще підготувати заздалегідь

  1. Доступ до кабінету продавця Епіцентру або підтвердження, що договір підписано.
  2. Токен API: його генерує Адміністратор компанії в налаштуваннях компанії, вкладка API.
  3. Адмінку сайту з правом ставити модулі й доступ до сервера для фонових задач
  4. Перелік категорій, які виводите на Епіцентр, і тих, які ні.
  5. Правило ціни для майданчика, якщо вона відрізняється від сайту.
  6. Людину, яка підтверджує замовлення й веде картки на майданчику.

Якщо чогось із цього немає — скажіть, підкажемо, як зібрати або зробимо самі окремою задачею.

Часті питання

Те, що питають найчастіше — з конкретними відповідями

у нас уже є фід для Rozetka — Епіцентр його прочитає?

Зовні файли схожі: корінь yml_catalog, теги offer, price, param. Але категорію Епіцентр чекає кодом зі свого довідника, а характеристики — з кодом атрибута й кодом значення для списків. У фіді Rozetka цих кодів немає, тому ми беремо з нього дані, а файл для Епіцентру збираємо окремо. Для перенесення з Prom у кабінеті є штатний імпорт за посиланням на YML — але товари з нього приходять чернетками.

можна оновлювати ціни й залишки через API, без файлу?

Довідка Епіцентру відповідає на це питання так: API наразі лише для обробки замовлень. Водночас у специфікації API описаний метод пакетного оновлення ціни й наявності, до 1000 позицій за запит, а саму документацію позначено як закритий бета-тест для обмеженої кількості компаній. Тому на розборі перевіряємо, що відкрито саме вашому кабінету. Якщо метод закритий, працює автооновлення за посиланням — для більшості асортименту цього досить.

як часто Епіцентр забирає ціни за посиланням?

За замовчуванням раз на добу о 24:00 за UTC. Частіший інтервал — 12, 4 або 1 година — вмикається через менеджера майданчика чи підтримку. Оновлюються ціна, стара ціна й наявність. Товар механізм шукає за артикулом у кабінеті, тож позицію, якої там ще немає, він не створить — її заводить імпорт. Тому offer id у файлі має збігатися з полем «Артикул» у кабінеті.

замовлення обов'язково підтверджувати в кабінеті вручну?

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

ви вже робили інтеграцію з Епіцентром?

Ні. З маркетплейсів у нас є робота з Rozetka — вона в кейсі нижче. З Епіцентром не було жодного проєкту, тому все про майданчик тут узято з його довідки й специфікації API, перевірених 12.09.2026. Що в живому кабінеті працює інакше, покаже перша партія — тому вона й невелика.

чим небезпечний повторний імпорт з Prom?

Довідка попереджає прямо: якщо картки вже у статусах «Чернетка», «На розгляді» чи «Наповнення контентом», повторний імпорт стирає в них категорії й характеристики. Сценарій типовий — дозаповнили частину карток, натиснули імпорт ще раз і втратили цю роботу. Перед кожним імпортом ми звіряємо, які артикули вже є в кабінеті і в якому вони статусі.

фото якого розміру й опис якої довжини потрібні?

Тут довідка сама собі суперечить: у статті про XLSX-імпорт мінімум 500×500 пікселів, у статті про XML — 600×500. Так само з описом: вимоги до контенту кажуть 1500 символів, статті про XML і XLSX — 12 160. Опис ріжемо до 1500 символів, щоб не сперечатися з модерацією. Для фото орієнтуємось на більше значення, 600×500, і міряємо їх на розборі, щоб не дізнаватися про розмір із відмов модерації.

скільки часу займе інтеграція?

7–22 робочих дні після розбору. Зіставлення категорій 2–5 днів, генератор XML 2–4, перше завантаження 1–3, ціни й наявність 1–3, передача 1 — разом 7–16, якщо замовлення лишаються в кабінеті. Обмін замовленнями з CRM додає ще 3–6 днів. Ці строки — наша оцінка за роботою з фідами Rozetka, досвіду саме з Епіцентром за ними немає.

Надішліть посилання на каталог — перевіримо його під Епіцентр

За 2–3 робочих дні скажемо, скільки позицій проходять за обов'язковими полями й межами довжини, які методи API відкриті вашому кабінету і чи не вистачить вам штатного XLSX-імпорту без жодної розробки.

Дивитись кейси
  • Відповідь протягом 2 годин
  • Без зобов’язань
  • Працюємо за договором

Прайса на сайті немає навмисно: обсяг тієї самої роботи у двох клієнтів відрізняється в рази, і цифра «від» у такому разі нічого не пояснює. Спершу безкоштовний аудит — рахуємо ваші сторінки, дублі й швидкість, — потім називаємо суму й строк і фіксуємо їх у договорі.