Епіцентр маркетплейс: інтеграція за API з CRM Bazify
Епіцентр підключається до Bazify як окремий канал продажів за ключем API. Замовлення можна підтягувати в CRM, статуси й ТТН передавати назад, а товари віддавати маркетплейсу XML-файлом із твого каталогу. Нижче розписано, як це працює, що потрібно від тебе і які в інтеграції є обмеження.
Оновлено:
Що це і кому підходить
Це канал продажів «Епіцентр» у Bazify. Він потрібен продавцям, які вже мають кабінет на маркетплейсі Епіцентру і хочуть не вести його окремо від решти магазину. Замовлення з Епіцентру лягають у той самий список, що й замовлення з сайту та інших каналів, а склад і доставка залишаються спільними.
Підходить підприємцю, який продає в кількох місцях і втомився від ручного перенесення замовлень, а також менеджеру, якому зручніше працювати в одній CRM. Якщо ти ще не став продавцем на Епіцентрі, спершу пройди реєстрацію і уклади договір з маркетплейсом: Bazify підключається до вже наявного кабінету.
- Імпорт замовлень Епіцентру в CRM за ключем API.
- Передача статусів замовлення та ТТН назад на маркетплейс.
- XML-файл з товарами, який можна вказати в кабінеті Епіцентру для імпорту товарів за посиланням.
Як це працює в Bazify
Доступ до Епіцентру Bazify отримує через ключ API, який ти створюєш у кабінеті продавця. Ключ зберігається в зашифрованому вигляді й назад в інтерфейсі не показується. Логін і пароль від кабінету не потрібні.

Замовлення. Bazify запитує у API Епіцентру список замовлень за період і створює їх у CRM. Перший запуск бере останні 7 днів, наступні починаються від попередньої синхронізації із запасом у годину. Якщо замовлень багато, список читається сторінками, а невичитаний залишок продовжується наступного разу з того ж місця. Дублів немає: ключ замовлення складається з каналу та номера замовлення Епіцентру, тому повторний імпорт просто оновлює наявний запис.
У картці замовлення ти бачиш клієнта, товари, суму та дані доставки. Нове замовлення отримує статус «Новий», а менеджер призначається автоматично, якщо ти задав його за замовчуванням. Якщо в Епіцентрі замовлення скасоване, у CRM воно теж стане «Скасовано». Інші статуси з маркетплейсу вже наявний статус замовлення в CRM не змінюють.
Товари, яких немає в каталозі Bazify, під час імпорту створюються чернетками, щоб замовлення не загубилося. На сайті такі товари не показуються, доки ти їх не заповниш і не опублікуєш. Залишки при цьому проходять через загальний облік складу.
Статуси назад. Коли ти змінюєш статус замовлення в Bazify, він передається в Епіцентр. За замовчуванням групи відповідають так: погодження та виробництво стають «підтверджено», доставка стає «відправлено», виконано стає «доставлено», скасовано стає «скасовано». Статус «Новий» назад не надсилається. Під час відправлення зі статусом «відправлено» разом зі статусом передається і ТТН, якщо вона є, а також служба доставки. Службу Bazify визначає за замовленням: це Нова Пошта, Укрпошта або Meest. Для іншої служби номер ТТН не передається, а статус іде. Так зроблено навмисно, щоб на маркетплейс не потрапила хибна служба доставки.
Файл з товарами. Окрема адреса вашого магазину /feeds/epicentr.xml віддає XML у стилі YML. Це всі опубліковані й не архівні товари з ціною та фото: назва, опис, виробник, категорії, характеристики, ціна, стара ціна (якщо є знижка), наявність і кількість. Варіанти товару йдуть окремими позиціями в одній групі. Відповідь кешується до 15 хвилин. Посилання потрібно вказати в кабінеті Епіцентру, у розділі імпорту товарів за посиланням, а далі маркетплейс сам забирає файл.
Що потрібно від тебе
- Кабінет продавця на маркетплейсі Епіцентру та договір з маркетплейсом. Цей крок виконуєш ти: Bazify його не замінює.
- Ключ API, створений у кабінеті продавця Епіцентру з правом на роботу із замовленнями.
- Каталог у Bazify з артикулами, цінами, фото та категоріями: з нього будується файл товарів.
- Доступ до розділу «Канали продажів» у кабінеті Bazify.
Порада. Підключай спершу тільки перевірку ключа, без автоімпорту. Переконайся, що перші замовлення зʼявляються правильно, і лише потім вмикай автоматичну синхронізацію.
Підключення за кроками
- 1
Створи ключ API
У кабінеті продавця Епіцентру створи ключ API з правом на замовлення і скопіюй його.
- 2
Додай канал в Bazify
У кабінеті Bazify відкрий Налаштування → Канали продажів, натисни «Додати канал» і вибери тип «Епіцентр».
- 3
Встав ключ і перевір
Встав ключ у поле «Ключ API Епіцентру» і натисни «Перевірити підключення». Bazify зробить один запит списку замовлень, нічого не змінюючи.
- 4
Вирішуй, чи вмикати автоімпорт
Галочка «Автоімпорт замовлень» за замовчуванням вимкнена. Вмикай її, коли переконаєшся, що ключ працює і замовлення виглядають правильно.
- 5
Підключи файл з товарами
Збережи канал, скопіюй посилання на файл з товарами для Епіцентру та встав його в кабінеті продавця в розділі імпорту товарів за посиланням.
- 6
Зроби першу синхронізацію
Запусти синхронізацію вручну, відкрий одне з нових замовлень і звір його з кабінетом Епіцентру.
Докладніше про підключення і типові помилки написано в довідці «Як підключити Епіцентр».
Чого інтеграція не робить
Пишемо відверто, щоб ти не чекав більшого, ніж є. Інтеграція з Епіцентром молодша за інші й побудована за відкритою інформацією про API. Частину назв статусів, службових полів і кодів служб доставки ми поки не звіряли на живому акаунті, тому перші замовлення обовʼязково перевір очима.
- Автоімпорт за замовчуванням вимкнений. Поки ти не поставиш галочку, замовлення самі не приходять.
- Автоімпорт працює за розкладом платформи, а не в реальному часі, тому нове замовлення зʼявляється з невеликою затримкою.
- Назви статусів Епіцентру (підтверджено, відправлено, доставлено, скасовано) прийняті за припущенням. Якщо в кабінеті вони інші, змінюй відповідність у налаштуваннях каналу.
- ТТН передається тільки для Нової Пошти, Укрпошти та Meest. Для інших служб на маркетплейс піде лише статус.
- Залишки і ціни на Епіцентрі оновлюються тільки через XML-файл, який маркетплейс забирає за своїм розкладом. Миттєвої передачі залишків немає.
- Товари з Епіцентру в Bazify не імпортуються. Каталог ведеш у Bazify, а на маркетплейс він іде файлом.
- Листування з покупцями, відгуки, повернення та фінансові звіти Епіцентру не синхронізуються.
- Комісії та умови маркетплейсу Bazify не рахує. Їх дивись у своєму договорі й на сторінці для продавців Епіцентру.
Увага. Не передавай ключ API стороннім людям. Він дає доступ до замовлень твого кабінету. Якщо ключ потрапив не туди, створи новий у кабінеті Епіцентру та заміни його в каналі.
Що змінюється в щоденній роботі
Менеджер бачить замовлення Епіцентру поруч з іншими. Береш його в роботу, створюєш ТТН, друкуєш наклейку і переводиш статус, а Bazify повідомляє про це маркетплейс. Не потрібно двічі вводити номер накладної та заходити в окремий кабінет заради кожної зміни.
Для власника головна користь у спільному складі й одному списку замовлень. Один товар у каталозі, один облік залишків і зрозуміла картина продажів по каналах.
Часті питання
- Що потрібно для підключення Епіцентру?
- Кабінет продавця на маркетплейсі Епіцентру, договір з ним і ключ API з правом на замовлення. Логін і пароль від кабінету вводити не треба.
- Де зберігається ключ API?
- У налаштуваннях каналу продажів, у зашифрованому вигляді. Назад в інтерфейсі він не показується, тому при зміні каналу введи новий ключ, якщо хочеш його замінити.
- Чому замовлення з Епіцентру самі не приходять?
- Галочка «Автоімпорт замовлень» за замовчуванням вимкнена. Увімкни її в налаштуваннях каналу або запускай синхронізацію вручну.
- Чи передаються статуси та ТТН на Епіцентр?
- Так. Зміна статусу замовлення в Bazify передається в Епіцентр, а зі статусом «відправлено» ще й ТТН та служба доставки (Нова Пошта, Укрпошта, Meest).
- Як товари потрапляють на Епіцентр?
- Через XML-файл за адресою /feeds/epicentr.xml твого магазину. Його посилання вставляється в кабінеті Епіцентру в розділі імпорту товарів, а далі маркетплейс сам забирає файл.
- Чи оновлюються залишки на Епіцентрі одразу після продажу?
- Ні. Залишки і ціни йдуть у файлі товарів, який маркетплейс забирає за власним розкладом. Між завантаженнями дані можуть трохи відставати.
Спробуйте Bazify 14 днів безкоштовно
Повний доступ без картки: сайт, CRM, склад, Нова Пошта і Checkbox.
Почати безкоштовно →