Як підключити Епіцентр до HugeProfit
Інтеграція з маркетплейсом Епіцентр (epicentrm.com.ua): замовлення Епіцентра приходять у HugeProfit, підтвердження, ТТН і скасування з причиною передаються назад, наявність і ціни оновлюються з вашого складу. Нові товари на Епіцентр вивантажуються XML-фідом у шаблоні Епіцентра з вашим зіставленням категорій. Для підключення потрібен токен API з кабінету продавця Епіцентра.
Що синхронізується
| Що | Як працює |
|---|---|
| Замовлення | З Епіцентра в HugeProfit, разом із покупцем, доставкою й оплатою. Товар резервується під замовлення. |
| Статуси і ТТН | З HugeProfit на Епіцентр: підтвердження, ТТН Нової Пошти чи Укрпошти, скасування з причиною. Далі доставку Епіцентр відстежує сам. |
| Наявність і ціни | З HugeProfit на Епіцентр по прив’язаних товарах: «в наявності», «під замовлення» чи «немає в наявності», ціна й стара ціна. |
| Нові товари | XML-фідом: посилання з HugeProfit вставляєте в кабінеті Епіцентра. Створити товар через API Епіцентр не дозволяє. |
1. Токен у кабінеті Епіцентра
У кабінеті продавця Епіцентра відкрийте «Налаштування компанії» → «API».
Згенеруйте токен і скопіюйте його. Токен починається з mp_.
💡 Немає вкладки «API»? Її відкриває категорійний менеджер Епіцентра: напишіть йому, що підключаєте CRM через API.
2. Підключення в HugeProfit
«Налаштування» → «Інтеграції» → «Маркетплейси» → Епіцентр → «Підключити».

- «Токен доступу» — токен з кабінету Епіцентра.
- Склад — з нього беруться наявність і ціни для Епіцентра й товари для фіду, з нього списуються замовлення. Після збереження змінити склад не можна.
- «Яку ціну вивантажувати?» — базова чи одна з додаткових цін. Епіцентр приймає ціни лише в гривнях.
- «Стара ціна» — яку додаткову ціну передавати як закреслену. Передається, лише якщо вона більша за ціну продажу.
- «Оновлювати залишки» і «Оновлювати ціни» — передавати наявність і ціни на Епіцентр.
- «Оновлювати статуси в замовленнях» — передавати підтвердження, ТТН і скасування. Без цієї галочки ТТН на Епіцентр не потрапить.
- «Віртуальний склад», «Канал продажів», «Не отримувати замовлення», «Відключити резервування товару» — як у Prom.
Після збереження HugeProfit запропонує «Вигрузити в XML» — це фід для кабінету Епіцентра (крок 3). На картці підключеної інтеграції з’являться кнопки «Налаштувати зіставлення категорій» і «Завантажити список статусів». Кнопки завантаження товарів з Епіцентра немає: список своїх товарів Епіцентр через API не віддає.
3. Товари на Епіцентр: XML-фід
Фід HugeProfit збирає у шаблоні Епіцентра: категорії й характеристики підставляються кодами з довідників Епіцентра, тож товар приходить у кабінет одразу з категорією, брендом і характеристиками.
Зіставлення категорій
«Налаштувати зіставлення категорій» — на картці інтеграції або у вікні вивантаження XML.

- Для кожної своєї категорії знайдіть у пошуку кінцеву категорію Епіцентра. Підкатегорія без власного зіставлення бере категорію найближчого батьківського розділу, це видно під полем: «від «Смартфони»: Смартфони».
- «Країна» — країна-виробник для товарів категорії. Не вказали — береться «Країна-виробник за замовчуванням».
- «Характеристики: 2 з 5» — скільки характеристик категорії Епіцентра знайшлося у ваших товарах. Клікніть, щоб побачити, яким не знайшлося відповідника і яких «Для модерації не вистачає». Характеристики зіставляються за точною назвою: атрибут чи додаткове поле товару має називатися так само, як характеристика на Епіцентрі.
- «При нульовому залишку» — «Немає в наявності» чи «Під замовлення». Діє і на фід, і на оновлення наявності через API.
Червона плашка «… товарів без категорії Епіцентра» означає, що такі товари теж потраплять у фід, але нові з них Епіцентр не створить. Наявні на Епіцентрі товари вони оновлять.
Посилання на фід
- «Товари» → вкладка складу інтеграції → значок вивантаження праворуч від пошуку → «XML» (див. Імпорт і експорт товарів).
- «Тип XML»: Epicentr → «Відкрити». Скопіюйте адресу сторінки, що відкрилася: це постійне посилання на фід з актуальними залишками й цінами.
- У кабінеті Епіцентра: «Товари» → «Імпорт» → спосіб «Посилання», режим «Оновити все».
- Те саме посилання додайте в «Автооновлення залишків», щоб Епіцентр сам оновлював ціни й наявність за розкладом.
Що потрапляє у фід:
- Артикул — за ним Епіцентр знаходить товар у кабінеті. Товари без артикула у фід не потрапляють.
- Назва (до 150 символів), опис, фото, ціна, стара ціна (якщо на товар діє акційна ціна, нижча за звичайну), бренд (якщо такий є в довіднику Епіцентра), країна, одиниця виміру, габарити й вага, штрих-код, характеристики.
- Наявність: залишок більше нуля — «в наявності», інакше за налаштуванням «При нульовому залишку».
⚠️ Нові товари з’являються в кабінеті Епіцентра в статусі «Чернетка». Перевірте їх, заповніть обов’язкові характеристики й відправте на модерацію — публікує їх Епіцентр. Різновиди (колір, розмір) файлом не об’єднуються: кожен варіант приходить окремим товаром, а об’єднують їх у кабінеті Епіцентра вручну.
4. Як товари Епіцентра зв’язуються з вашими
Наявність і ціни через API оновлюються лише для товарів, прив’язаних до інтеграції. Прив’язка з’являється так:
- З замовлення. Коли товар уперше приходить у замовленні Епіцентра, HugeProfit шукає його на складі інтеграції за артикулом, потім за назвою, і прив’язує. Тому найпростіше, коли артикули на Епіцентрі й у HugeProfit однакові: так буде, якщо товари потрапили на Епіцентр з фіду HugeProfit.
- З вивантаження кабінету. Вивантажте товари в кабінеті Епіцентра у XLSX і імпортуйте файл у HugeProfit як звичайний Excel (Імпорт з Excel). HugeProfit розпізнає вивантаження Епіцентра за заголовками і прив’язує товари за колонкою id Епіцентра. Це спрацює, якщо у вас підключена одна інтеграція Епіцентра. Характеристики з файлу стають додатковими полями товару.
- Вручну — див. Прив’язка товарів.
Поки товар не прив’язаний, замовлення на нього все одно приходять, але наявність і ціна на Епіцентрі для нього оновлюються лише фідом.
5. Замовлення, статуси і ТТН
Нові замовлення Епіцентра з’являються в Замовленнях зі статусом «Нове». Ім’я й телефон покупця Епіцентр відкриває лише після підтвердження продавцем, тому в новому замовленні їх ще немає.
- Підтвердження. Переведіть замовлення в статус «Підтверджено продавцем» або у ваш статус, зіставлений з ним. HugeProfit передасть підтвердження і за хвилину-півтори сам перезавантажить замовлення вже з контактами покупця.
- ТТН. Створіть ТТН Нової Пошти чи Укрпошти в продажу або впишіть готовий номер. HugeProfit переведе замовлення на Епіцентрі в «Підтверджено» і запише туди ТТН.
- Далі — Епіцентр. Він сам відстежує ТТН і ставить «Відправлено», коли посилку передали перевізнику, і «Завершено», коли покупець її отримав.
Відповідність ваших статусів статусам Епіцентра перевірте кнопкою «Завантажити список статусів» і шестернею поруч на картці інтеграції. Статуси, яких на Епіцентрі немає («Продано», «Відмова», ваші власні), змінюються лише в HugeProfit.
⚠️ Через API Епіцентр приймає номер ТТН лише Нової Пошти та Укрпошти. Для Meest і точок видачі Meest-Епіцентр накладну створюйте в кабінеті Епіцентра.
Скасування з причиною
Якщо скасовуєте замовлення чи продаж Епіцентра, виберіть причину: «Немає товару в наявності», «Неактуальна ціна», «Товар з браком», «Доставка недоступна» чи «Замовлення неактуальне». HugeProfit передасть скасування з цією причиною на Епіцентр.
Якщо щось не працює
| Проблема | Що зробити |
|---|---|
| Помилка авторизації, інтеграція вимкнулася | Токен видалено чи перевипущено в кабінеті Епіцентра. Згенеруйте новий і вставте в налаштуваннях інтеграції. |
| Товар не з’явився в кабінеті Епіцентра | Перевірте, що в товару є артикул, а його категорію зіставлено з категорією Епіцентра. Подивіться звіт імпорту в кабінеті: там вказано, якої характеристики бракує. |
| Наявність чи ціна на Епіцентрі не оновилися | Перевірте галочки «Оновлювати залишки» і «Оновлювати ціни» і що товар прив’язаний до інтеграції. Однакове оновлення Епіцентр повторно приймає не раніше ніж за 30 хвилин, тож швидка зміна туди й назад може дійти із затримкою. |
| У замовленні немає імені й телефону покупця | Замовлення ще не підтверджене. Підтвердіть його: контакти з’являться після перезавантаження замовлення. |
| ТТН не передалася | Увімкніть «Оновлювати статуси в замовленнях». ТТН Meest Епіцентр через API не приймає. |
| У зіставленні категорій попередження про валюту | Валюта акаунта не гривня, а Епіцентр приймає ціни лише в гривнях. Фід передає ціни без перерахунку, тому для Епіцентра ведіть ціни в гривнях. |
Продаєте не лише на Епіцентрі? У HugeProfit замовлення Епіцентра, Prom, Rozetka, Kasta і сайту падають в один список, залишки списуються з одного складу, а ТТН створюється з картки продажу й сама передається на Епіцентр. Детальніше — автоматизація маркетплейсів.
Документація CRM
ENУвійти