Імпорт замовлень з Епіцентру через API

31 хв

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

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

Де це у програмі

У вікні імпорту створіть шаблон і оберіть тип «Епіцентр». Це API-джерело: файл не потрібен, підключення відбувається за токеном. Один шаблон — одне підключення до одного кабінету продавця.

Форма підключення шаблону «Мій магазин Епіцентр»
1Поле «Токен»
2Кнопка «Перевірити підключення»
  1. Поле «Токен» — сюди вставляється токен із кабінету Епіцентра.
  2. Кнопка «Перевірити підключення» перевіряє з'єднання з маркетплейсом за введеним токеном.

Де взяти токен: крок за кроком

ДеЩо зробити
Кабінет продавця ЕпіцентрУвімкнути перемикач API в додаткових налаштуваннях — після цього з'явиться потрібна вкладка
Там само«Налаштування» → «Налаштування компанії» → вкладка «API» → кнопка «Згенерувати»
Там самоСкопіювати токен іконкою праворуч від поля
ElbuzВікно завантаження → ваш шаблон «Епіцентр» → картка «Підключення» → поле «Токен»

Генерувати токени може адміністратор компанії. Кількість не обмежена — усі створені ключі активні одночасно, тож під інтеграцію з Elbuz зручно завести окремий токен і не змішувати його з іншими сервісами.

Токени Епіцентру не мають терміну дії й працюють, доки ви їх не видалите. Це зручно (нічого не «протухає»), але й небезпечно: будь-хто, у кого опиниться токен, отримає доступ до ваших замовлень. Передавайте його лише технічному спеціалісту й не пересилайте у відкритих чатах. Якщо ключ скомпрометовано — видаліть його в кабінеті іконкою кошика (обмін за ним одразу припиниться) і згенеруйте новий.

Кнопка «Оновити ключ» у кабінеті видає новий токен, а попередній лишається у списку активних — тобто старі інтеграції продовжать працювати, доки ви не видалите їхній ключ вручну.

Як підключити крок за кроком

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

Перемикачів «що саме завантажувати» в шаблоні Епіцентру немає й не потрібно: це підключення вміє тільки замовлення. Збережіть шаблон і запустіть завантаження.

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

Що приходить із замовленням

З кожного замовлення Епіцентру Elbuz бере ось що:

Дані ЕпіцентруПоле документа в Elbuz
номер замовленняЗовнішній номер
внутрішній ідентифікатор замовленняКлюч, за яким замовлення впізнається повторно
ім'я, по батькові, прізвище отримувачаІм'я, по батькові, прізвище
ідентифікатор покупцяПрив'язка контрагента до джерела
телефон і поштаТелефон, пошта
дані доставкиАдреса доставки
сума замовленняСума документа
коментар до замовленняОпис замовлення
ознака оплатиСтатус оплати: «Оплачено» або «Чекання»
статус замовленняСтатус документа (див. таблицю нижче)
дати створення й зміниДати замовлення на майданчику

У рядках замовлення приходять назва, артикул, ціна, кількість, сума рядка, одиниця виміру, а також посилання на товар і його зображення на майданчику.

Як позиції зв'язуються з вашим каталогом

Разом із рядком замовлення Епіцентр повертає ідентифікатор товару у вашій системі — тобто рівно те значення, яке ви самі передали майданчику в полі ідентифікатора свого XML-фіду. Що саме там стоїть, вирішуєте ви в шаблоні вивантаження: це може бути внутрішній номер товару, його код або артикул.

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

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

Порядок перевірок такий: спершу картка, яку Elbuz сам завів під цю пропозицію Епіцентру на одному з минулих завантажень, потім внутрішній код товару, потім артикул із назвою, потім сама назва, і лише наостанок — номер товару; цю перевірку проходить тільки ідентифікатор, що складається з самих цифр. Перша перевірка, що спрацювала, і вирішує. Тому, якщо у фід ви ставите номер товару, а в каталозі є дві картки з однаковою назвою, позиція ляже на картку, знайдену за назвою, ще до перевірки номера.

НіНіНіНіНіТакТакТакТакТакРядок замовленняЕпіцентруДля цієї пропозиціїЕпіцентру вжезаведено картку минулимзавантаженням?Ідентифікатор збігаєтьсяз внутрішнім кодомтовару?Збігаються артикул іназва?Збігається сама назва?Ідентифікаторскладається з цифрі збігається з номеромтовару?Нова картка в категорії«Товари - epicentr - назвашаблону»Позиція лягає назнайдений товар
Читайте зверху вниз: кожна гілка «Так» веде до знайденого товару, і далі перевірки не йдуть. Нова картка — лише коли всі п'ять відповіли «Ні»

Картки зі службової категорії: що з ними робити

Позиція замовлення, якій не знайшлося відповідника в каталозі, не губиться: Elbuz заводить під неї картку товару й кладе в службову категорію з назвою «Товари - epicentr - ‹назва вашого шаблону›». Категорія створюється вимкненою і без позначки на вивантаження, тож на вітрину й у фіди такі товари самі не поїдуть.

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

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

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

Щоб таких карток з'являлося менше, вивантажуйте каталог на Епіцентр засобами Elbuz: тоді в рядку замовлення приходить ідентифікатор, за яким товар знаходиться точно, і нова картка не потрібна.

Статуси і їх зіставлення

В Епіцентру власний набір станів замовлення, і Elbuz зводить їх до ваших статусів. Це зіставлення вбудоване в саме підключення:

Статус в ЕпіцентріКод майданчикаСтатус документа в Elbuz
НовийnewНовий
Підтверджений продавцемconfirmed_by_merchantУзгодження
ПідтвердженийconfirmedПідтвердження
ВідправленийsentВідвантажено
Готовий до видачіdeliveredДоставлено
ОтриманийreceivedВидано
Завершений; Закритийcompleted; closedВиконано
Скасований; Скасований продавцемcanceled; canceled_by_merchantСкасовано
ПоверненийreturnedПовернуто
Запит на поверненняreturn_requestedЧекає рішення щодо повернення
Завершений і Закритий (відмова продавця)completed_merchant_rejection; closed_merchant_rejectionВідхилено

Середня колонка тут не для довідки: саме ці коди Elbuz складає в колонку «Статус документа (сайт)» списку замовлень. Тобто поруч зі своїм статусом ви бачите не українську назву стану Епіцентру, а його код — confirmed_by_merchant, sent і подібні. Звірятися з таблицею вище доведеться, зате видно рівно те, що сказав майданчик.

У картці «Пов'язані налаштування» є кнопки ручного зіставлення статусів і видів оплати та доставки. Порядок такий самий, як у Kaspi та Prom: спершу спрацьовує вбудоване зіставлення з таблиці вище, а ваші ручні правила добирають лише те, для чого відповідності не знайшлося.

Зверніть увагу на дві особливості Епіцентру. По-перше, замовлення, яке довго лишається в проміжному статусі, майданчик сам переводить у «Завершено» — тож у Elbuz воно теж оновиться при черговому завантаженні. По-друге, оплату Епіцентр передає не статусом, а ознакою «оплачено»: якщо вона стоїть, документ отримує статус оплати «Оплачено», інакше — «Чекання».

Що зробить повторне завантаження з вашою правкою

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

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

Якщо документ не проведено, Elbuz порівнює код статусу Епіцентру з тим, який запам'ятав минулого разу:

  • код той самий — на майданчику нічого не змінилося, і ваш статус лишається; правку менеджера не чіпають;
  • код інший — статус документа перезаписується за таблицею зіставлення вище, навіть якщо менеджер щойно поставив свій;
  • коду ще не запам'ятали — статус не чіпають узагалі, лише запам'ятовують поточний код; правило почне діяти з наступного завантаження.
НіТакТакНіНіТакНіТакЗамовлення прийшло зЕпіцентруДокумент із такимідентифікаторомЕпіцентру вже є?Новий непроведенийдокументДокумент проведено?Нічого не змінюєтьсяКод статусу Епіцентрузапам'ятали минулогоразу?Статус не чіпають,код запам'ятовуютьКод змінився і для ньогоє зіставлення?Ваш статус лишаєтьсяСтатус перезаписуєтьсяза зіставленням
Ваш статус перезаписується тільки в одній гілці: документ не проведено, код Епіцентру змінився і для нового коду є зіставлення

Незалежно від статусу в непроведений документ лягає те, що сказав майданчик: код статусу Епіцентру в колонку «Статус документа (сайт)», а також код і назва способу оплати та доставки. Статус оплати, статус доставки й тип оплати оновлюються тільки тоді, коли для них знайшлася відповідність: значення «не зіставлено» уже проставлене в документі не затирає.

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

Картку покупця прогін теж не переписує: у знайденого контрагента дописуються лише порожні пошта й телефон, а ім'я, адреса й решта полів лишаються вашими.

Якщо замовлення зникло з кабінету Епіцентру

У завантаженні немає жодної дії, яка видаляє чи деактивує документ: воно тільки створює нові замовлення й оновлює знайдені. Звідси три варіанти:

  • замовлення видалили або приховали в кабінеті — документ у Elbuz лишається таким, яким був після останнього вдалого завантаження: свій статус, статус майданчика, рядки, сума;
  • замовлення скасували на майданчику — це не зникнення: приходить код скасування, і непроведений документ переходить у «Скасовано» (проведений — ні, див. розділ вище);
  • замовлення просто більше не змінюється — Elbuz забирає лише те, що змінилося після попереднього завантаження, тож документ лишається на місці й не оновлюється.

Окремого сигналу «цього замовлення на майданчику вже немає» не буде: про зникнення програма не дізнається. Єдиний орієнтир — колонка «Статус документа (сайт)»: у ній стоїть останній код, який Епіцентр устиг передати. Видаляти такий документ чи лишати для історії, вирішуєте ви.

Коли замовлення доходить до складу й резерву

Завантажене замовлення лягає документом типу «Замовлення покупця» і непроведеним. Поки його не провели, складу й резерву воно не стосується взагалі.

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

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

Резерв перераховується, коли документ проводять, знімають проведення або міняють його статус у самому Elbuz. Зайнятим товар лишається доти, доки замовлення не перейде в статус, за якого резерв знімається: «Виконано», «Завершено», «Видано», «Скасовано», «Скасоване повернення», «Відхилено», «Повернуто», «Повернення товару», «Анульовано», «Невдача», «Прострочено», «Не актуально». У решті станів — зокрема у «Відвантажено» і «Доставлено» — резерв тримається. Якщо в налаштуваннях увімкнено «Часткові відвантаження», резерв зменшується ще й тоді, коли на підставі замовлення проводять розхідну накладну: зайнятою лишається тільки та кількість, яку ще не відвантажили.

Розклад і оновлення

Епіцентр працює опитуванням: Elbuz сам звертається до нього за розкладом — миттєвих сповіщень (вебхуків) тут немає. Розклад задають кнопкою налаштування завдання в картці «Пов'язані налаштування». Частоту обирайте за оборотом: активному магазину має сенс перевіряти замовлення кілька разів на годину, спокійному вистачить кількох разів на добу.

Щоб не тягнути одне й те саме двічі, Elbuz веде інкремент за датою зміни: майданчик віддає лише ті замовлення, які змінилися після попереднього завантаження. Перший запуск забирає історію за останні 30 днів — цього досить, щоб підхопити все, що зараз в обробці. Замовлення читаються сторінками, тож великий обсяг вантажиться поступово; кожен запуск лишає слід у журналі: скільки замовлень отримано й чи були помилки.

Скільки замовлень бере один прогін

Замовлення приходять сторінками по 100 штук, і за один прогін Elbuz читає не більше 200 сторінок — тобто до 20 000 замовлень. Якщо їх виявиться більше, цикл зупиниться на цій межі, а решта приїде наступним запуском: точка відліку зсувається на те, що вже збережено.

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

На кожен запит до майданчика відведено 30 секунд на з'єднання і 180 секунд на відповідь. Якщо Епіцентр відповів помилкою сервера або «забагато запитів» (код 429), Elbuz повторює запит — усього до трьох спроб, із паузою, що зростає з кожною. Не вийшло й після третьої — прогін зупиняється, а в журнал червоним лягає рядок «Епіцентр: помилка звернення до API» з текстом причини від майданчика.

НіТакНіТакТакНіТакНіЗапуск шаблону ЕпіцентрПоле «Токен»заповнене?Червоний рядок«Епіцентр: не вказанотокен доступу», домайданчика незвертаютьсяЗапит сторінки до 100замовлень, зміненихпісля точки відліку або заостанні 30 днівЕпіцентр віддав сторінку?На 429 і збій сервера —до трьох спробЧервоний рядок«Епіцентр: помилказвернення до API»,прогін зупиняється,незаписана порція незберігаєтьсяНабралося200 замовлень?Порція записується в базуСторінка не порожня, єнаступна, прочитаноменше 200 і не натиснуто«Зупинити»?Записується решта, рядок«Епіцентр: завантаженнязамовлень завершено,усього: N»
Цикл іде по сторінках, поки є наступна, і кожні 200 замовлень записує в базу, не чекаючи кінця прогону. Помилка майданчика обриває цикл, а те, що не дійшло до запису, забере наступний запуск

Вікно списку завантажень при цьому можна закрити: журнал прогону ведеться в Центрі операцій, і рядки видно з будь-якого місця програми. Що в них пишеться: на кожну сторінку — «Епіцентр: сторінка N, отримано замовлень: M»; на кожну збережену порцію — «Отримано замовлень: N»; далі «Всього товарів завантажено: N» (це нові картки в службовій категорії) і «Всього замовлень завантажено: N» (це нові документи); наприкінці — «Епіцентр: завантаження замовлень завершено, усього: N» і «Завантаження даних завершено!». Журнал минулих прогонів лишається доступним у списку шаблонів, у вікні історії операцій.

Як призупинити завантаження і що при цьому лишиться

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

Список шаблонів завантаження: колонка «Стан» і рядок шаблону «Мій магазин Епіцентр»
1Стан шаблону
  1. Стан шаблону «Мій магазин Епіцентр» — «Вимкнений»; клік по пілюлі одразу вмикає або вимикає шаблон.

Вимкнений шаблон планувальник пропускає — за розкладом замовлення більше не приходять. А от ручний запуск кнопкою працює й далі: вимкнення зупиняє автоматику, а не саме підключення.

Недоторканим лишається все інше: уже завантажені документи, створені контрагенти й картки товарів, прив'язки покупців і товарів до цього джерела, ручне зіставлення статусів, сам токен і точка відліку. Вимкнення нічого не видаляє.

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

Якщо прогін зробили помилково

Прогін лишає слід у трьох місцях, і в кожному є за чим його знайти. У сітці «Документи» це колонки «Джерело: назва» (там стоїть назва вашого шаблону), «Джерело (код)» (для цього підключення — epicentr) і «Джерело: ID» (номер шаблону). Такі самі колонки джерела є в «Товарах» («Джерело: назва», «Джерело: код», «Джерело: ID») і в «Контрагентах» («Джерело - назва», «Джерело - код»). Відбір за ними показує рівно те, що приїхало з Епіцентру, і нічого зайвого.

Документи прибирають у вікні «Документи»: відмітьте рядки й видаліть. Три речі, які варто знати до того:

  • Проведені документи не видаляються. Програма пропустить їх і скаже: «Проведені документи не видалено (N). Спершу скасуйте проведення». Порядок такий і є: зняти проведення, потім видаляти;
  • видалене складається в «Кошик документів» — пункт меню того самого вікна. Одразу після видалення з'являється кнопка «Скасувати», яка повертає всю пачку цілком, а кошик тримає знімки 30 днів;
  • контрагенти й картки товарів разом із документами не зникають: їх прибирають окремо у своїх вікнах, так само відібравши за джерелом.

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

Чого це підключення не робить

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

Сценарії

Замовлення мають приходити самі, без ручного запуску

Вставте токен у поле «Токен» картки «Підключення», натисніть «Перевірити підключення», задайте розклад кнопкою «Налаштування розкладу» і переконайтесь, що в колонці «Стан» стоїть «Активний». Кожен прогін за розкладом забирає замовлення, змінені після попереднього завантаження, а перший — за останні 30 днів; нові лягають непроведеними документами. Чого не буде: статус на Епіцентрі не зміниться від ваших дій у Elbuz, каталог не завантажиться, а залишок не зрушить, доки документ не проведуть.

Менеджер веде свої статуси, але скасування на майданчику має їх перебивати

Вмикати нічого не треба: вбудоване зіставлення вже переводить код canceled у «Скасовано». Кнопки ручного зіставлення статусів у картці «Пов'язані налаштування» знадобляться лише для кодів, яких немає в таблиці вище. Поки код на Епіцентрі той самий, статус, який поставив менеджер, лишається; змінився код — непроведений документ отримує статус за зіставленням. Чого не буде: проведений документ не зміниться взагалі, а код без зіставлення ваш статус не перезапише.

Позиції замовлень мають лягати на наявні картки, а не плодити нові

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

Призупинити прийом замовлень і нічого не пропустити

Натисніть пілюлю в колонці «Стан», щоб вона стала «Вимкнений». Розклад цей шаблон пропускатиме, а ручний запуск кнопкою працюватиме й далі. Точка відліку за паузу не зсувається, тож після повернення в «Активний» наступний прогін забере все, що змінилося на Епіцентрі за цей час. Чого не буде: вимкнення не видаляє ні документів, ні карток, ні токена.

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

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

Часті труднощі

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

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

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

Розбір частих повідомлень
Що ви бачитеЧому такЩо зробити
«Епіцентр: не вказано токен доступу» У шаблоні порожнє поле «Токен» — до майданчика навіть не зверталися Вставте токен із кабінету й збережіть шаблон (де його взяти)
«Підключення не вдалося: …» Майданчик не прийняв ключ: токен скопійований не повністю або видалений у кабінеті Скопіюйте токен заново іконкою біля поля й натисніть «Перевірити підключення» ще раз
«Епіцентр: помилка звернення до API» Майданчик не відповів або віддав помилку три спроби поспіль; текст причини стоїть у тому ж рядку журналу Запустіть прогін ще раз — те, що не встигло приїхати, забере наступне завантаження (межі прогону)
«Скасовано завантаження за розкладом, причина - завантажується інший шаблон (конфлікт обробки даних).» У цей момент за розкладом уже йде інше завантаження — два одночасно не запускаються Нічого: наступне спрацювання розкладу забере замовлення. Якщо це повторюється, рознесіть розклади шаблонів
«Проведені документи не видалено (N). Спершу скасуйте проведення.» Проведений документ не видаляється — він уже відображений в обліку Зніміть проведення й повторіть видалення (як прибрати помилковий прогін)

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

Чи можна цим підключенням завантажити товари в каталог?

Ні. Це підключення приносить лише замовлення. Товари рухаються у зворотному напрямку: ви вивантажуєте каталог на Епіцентр XML-фідом — про це окрема стаття про вивантаження на Епіцентр.

Чи потрібно оновлювати токен раз на певний період?

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

Чи змінюється статус замовлення на Епіцентрі, коли я обробляю його в Elbuz?

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

Скільки токенів можна створити?

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

За який період підтягнуться замовлення під час першого запуску?

За останні 30 днів — цього досить, щоб підхопити все, що зараз в обробці. Далі працює інкремент: беруться лише замовлення, змінені після попереднього завантаження.

Чи змінює завантажене замовлення залишок на складі?

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

Як прибрати документи, завантажені помилково?

У вікні «Документи» відберіть рядки за колонкою «Джерело: назва» — там стоїть назва вашого шаблону — і видаліть їх. Проведені доведеться спершу розпровести: програма їх пропускає. Видалене потрапляє в «Кошик документів» і повертається кнопкою «Скасувати» протягом 30 днів. А от самі замовлення повторним прогоном не повернуться: Епіцентр віддає тільки змінені після попереднього завантаження.

Чому в кабінеті немає вкладки «API»?

Вкладка з'являється після ввімкнення відповідного перемикача в додаткових налаштуваннях, а генерувати токени може адміністратор компанії. Якщо вкладки немає — швидше за все, у вашого користувача інша роль.

Чи була стаття корисною?