Як підключити Mirakl до Elbuz: Leroy Merlin, Conforama, home24 одним шаблоном

Що вміє підключення Mirakl

• Одне підключення на всі площадки Mirakl — відрізняються лише адреса кабінету й ключ.
• Завантаження оферів — назва, бренд, артикул, EANНомер штрихкоду товару з 13 (іноді 8) цифр. Однаковий у всіх продавців, тому за ним зручно знаходити той самий товар у різних постачальників., ціна, залишок і категорія.
• Замовлення з автоприйняттям — нові замовлення приймаються на площадці, адреса покупця дописується наступним прогоном.
• Ціни й залишки назад на площадку — одним файлом за запуск, результат — у журналі.
• Нові офери — на наявні картки площадки за штрихкодом.
• Відвантаження й скасування — ваш статус замовлення відправляє на площадку трек-номер, відправку або скасування.

Де це і хто має доступ

Меню

Довідники → Операції → Завантаження даних → новий шаблон типу «Mirakl (Leroy Merlin, Conforama, home24…)»

Інші входи

Довідники → Операції → Вивантаження даних — шаблон того самого типу для цін, залишків і статусів

Право доступу

вікно «Завантаження» у «Правах груп»

Підготувати

адресу кабінету продавця площадки й ключ API магазину

Один шаблон — одна площадка. Продаєте і на Leroy Merlin, і на Conforama — заведіть два шаблони з різними адресами.

Що потрібно від площадки

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

1

Адреса кабінету продавця площадки

2

Обрати зі списку

3

Ключ API магазину

4

Shop ID

5

Код стану товару

6

Термін відвантаження

1. Адреса кабінету продавця площадки — адреса з рядка браузера кабінету.
2. Обрати зі списку — підставляє адресу відомої площадки Mirakl.
3. Ключ API магазину — з кабінету: ваше ім'я → My user settings → API Key.
4. Shop ID — лише якщо ключ відкриває кілька магазинів.
5. Код стану товару — на завантаження не впливає.
6. Термін відвантаження — на завантаження не впливає.

Адреса кабінету

Відкрийте кабінет продавця площадки й скопіюйте адресу з рядка браузера цілком — Elbuz сам відріже шлях після домену й допише https://, якщо його немає.

Для частини площадок адреса вже є в програмі: кнопка «Обрати зі списку» під полем показує Leroy Merlin, Conforama, BUT, Maisons du Monde, Vente-unique (усі — Франція), home24 (Німеччина) й ePrice (Італія). Вибраний рядок підставляється в поле, і його можна правити руками.

Кнопка «Обрати зі списку» з'являється у вже збереженому шаблоні. Площадки, якої немає в списку (La Redoute, Decathlon, Castorama, Carrefour, MediaMarkt, PCComponentes тощо), вписуйте адресою з браузера.

Ключ API

Ключ створюється в кабінеті продавця: ваше ім'я → My user settings → API Key. Mirakl Connect для цього не потрібен: Elbuz працює з кабінетом площадки напряму. Новий ключ скасовує попередній — створивши його, замініть ключ і в шаблоні завантаження, і в шаблоні вивантаження.

Вставивши адресу й ключ, дочекайтеся напису «Усі зміни збережено» — перевірка бере збережені значення — і натисніть «Перевірити підключення». Elbuz запитає в площадки дані магазину й відповість «Підключення працює. Mirakl ‹адреса› — ‹назва магазину› #‹номер›». Якщо магазин на площадці не відкритий, після номера в дужках стоїть його стан. Неправильний ключ дає «Підключення не вдалося: HTTP 401: …».

Що переноситься в картку

Elbuz забирає список ваших оферів на площадці — сторінками по 100 — і кладе кожен у базовий каталог карткою товару.

Опису, фото й характеристик офер не містить, тож у картку вони з Mirakl не приходять. Галочки «Фото», «Атрибути» й решта на шаблон Mirakl не впливають — діють лише «Товари» й «Замовлення». Офер без категорії ляже в службову категорію «Товари - mirakl», яка створюється вимкненою й не бере участі у вивантаженнях (службові категорії).

1

Товари

2

Замовлення

1. Товари — завантажувати ваші офери в каталог.
2. Замовлення — завантажувати й приймати замовлення.

Що перезапише повторний прогін

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

Щоб прогін не чіпав картку зовсім, увімкніть у ній перемикач «Не оновлювати» (секція «Захист під час імпорту»); щоб не чіпав лише ціни — «Фіксована ціна». Офер, якого в прогоні не було, лишається в каталозі з останніми ціною й залишком.

Як приходять і приймаються замовлення

Замовлення лягає документом «Замовлення покупця», непроведеним. Перше завантаження бере замовлення за останні 30 днів. Далі Elbuz бере змінені від дати в полі «Завантаження замовлень починаючи з дати (РРРР-ММ-ДД)» блоку «Розширене», із запасом у 12 годин. Наявне замовлення впізнається за номером і оновлюється, а не дублюється.

У документ потрапляють номер замовлення, дати створення й зміни, ім'я, телефон і пошта покупця, адреса доставки й платника, спосіб доставки й оплати, вартість доставки, валюта й позиції. Сума документа — разом із доставкою. Якщо в замовленні кілька рядків, скасовані й відхилені рядки в документ не потрапляють.

Автоматичне прийняття

Замовлення, яке чекає вашого підтвердження (статус WAITING_ACCEPTANCE), Elbuz приймає на площадці сам, усіма рядками, під час того самого завантаження. Наявність товару на складі при цьому не перевіряється. У документ таке замовлення лягає зі статусом площадки SHIPPING.

Не вдалося прийняти — у журналі червоний рядок «Mirakl: замовлення ‹номер› не прийнято автоматично — ‹причина›», а замовлення все одно завантажується в поточному статусі. Наступне завантаження спробує прийняти його знову: замовлення, що чекають прийняття, Elbuz перевіряє щоразу, незалежно від дати останнього завантаження. Якщо площадка відмовляє й далі, прийміть замовлення в кабінеті площадки.

Чому в новому замовленні немає адреси

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

Статуси замовлення

Статус площадки зіставляється з вашим кнопкою «Статуси замовлення» в картці «Повʼязані налаштування» шаблону завантаження: у колонку «Код (назва) на сайті (API)» навпроти свого статусу впишіть код Mirakl.

1

Статуси замовлення

2

Налаштування розкладу

3

Види доставки

1. Статуси замовлення — зіставлення кодів Mirakl зі своїми статусами в обидва боки.
2. Налаштування розкладу — як часто запускати завантаження.
3. Види доставки — код перевізника площадки для трек-номера.

1

Код (назва) на сайті (API)

2

SHIPPED

1. Код (назва) на сайті (API) — сюди вписується код статусу Mirakl.
2. SHIPPED навпроти «Відвантажено» — цей статус вивантаження передасть на площадку як відправку.

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

Ваш статус повторне завантаження змінює, лише коли статус на площадці змінився з минулого разу або статус документа після завантаження ще ніхто не міняв. Що відбувається з проведеним замовленням і резервом, описано в статті імпорт замовлень через API.

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

Зворотний напрямок — окремий шаблон вивантаження того самого типу. У ньому два поля: «Адреса кабінету площадки» й «Ключ API магазину». Shop ID, код стану й термін відвантаження вивантаження бере з шаблону завантаження цієї ж площадки (за адресою кабінету). Шаблону завантаження немає — без Shop ID, стан 11 (новий), відвантаження за 2 дні.

Продаєте на кількох площадках Mirakl — заведіть пару шаблонів на кожну. Прив'язки товарів у площадок окремі: товар, прив'язаний до однієї площадки, на іншу піде новим офером за штрихкодом.

1

Адреса кабінету площадки

2

Ключ API магазину

3

Мова описів

1. Адреса кабінету площадки — та сама, що в шаблоні завантаження.
2. Ключ API магазину — той самий ключ.
3. Мова описів — якою мовою йдуть назва й опис нових оферів; без перекладу — основна.

Оновлюються товари, прив'язані до оферів, тому спершу один раз завантажте каталог з площадки. Без галочки «Публікувати нові товари» товар без прив'язки пропускається без рядка в журналі. Що йде на площадку:

• Ціна — числом із шаблону вивантаження, з двома знаками після коми, не менше нуля. Валюту Elbuz не перераховує: ціни у відборі мають бути у валюті вашого магазину на площадці.
• Залишок — кількість товару, не менше нуля.
• Стан і термін відвантаження — з полів «Код стану товару» й «Термін відвантаження» шаблону завантаження цієї площадки.
• Які товари — визначає відбір шаблону вивантаження, як і для інших каналів.

Чому результат приходить не одразу

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

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

Знімати офери Elbuz не вміє: товар, що випав із відбору, просто перестане оновлюватися. Щоб зупинити продаж, вивантажте нульовий залишок або зніміть офер у кабінеті площадки.

Нові офери за штрихкодом

З галочкою «Публікувати нові товари» Elbuz виставляє офер для товару, у якого на площадці офера ще немає. Офер чіпляється до наявної картки площадки за EAN, тому в товару має бути штрихкод щонайменше з 8 цифр. Нових карток Elbuz на Mirakl не створює: якщо картки з таким EAN немає, площадка відхилить рядок.

1

Товари

2

Публікувати нові товари

3

Замовлення

1. Товари — ціни й залишки прив'язаних оферів.
2. Публікувати нові товари — офери на наявні картки площадки за EAN.
3. Замовлення — відвантаження з трек-номером і скасування.

• Код офера — артикул товару. Без артикула або з артикулом довшим за 40 символів — ID товару в Elbuz.
• Немає штрихкоду — рядок «Mirakl: у товару «…» немає штрихкоду (EAN) — офер не створено», товар рахується помилкою.
• Поки площадка обробляє новий офер, товар у наступні файли не йде — у журналі «Mirakl: нові офери ще обробляються площадкою: N».
• Опубліковано — рядок «Mirakl: офер «назва» (код) опубліковано», товар прив'язано до офера.
• Відхилено — прив'язка знімається, і наступний запуск спробує виставити товар знову.

Відвантаження, трек-номер і скасування

Галочка «Замовлення» в шаблоні вивантаження передає на площадку дві події з ваших замовлень Mirakl:

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

Трек-номер — поле «Сервіс доставки: номер» у картці «Доставка» документа (розгорніть «Більше полів»). Перевізник береться з кнопки «Види доставки» шаблону завантаження, якщо там зіставлено код перевізника площадки; інакше Elbuz передає назву служби доставки з документа. Поле номера порожнє — площадка отримає відправку без трек-номера.

Кожна подія відправляється один раз: після відправки Elbuz запам'ятовує новий статус площадки, і повторний запуск замовлення не чіпає. Не відправляються й замовлення, які на площадці вже відправлені, отримані, закриті, скасовані чи відхилені. У журналі — рядки «Mirakl: замовлення ‹номер› → SHIPPED» і підсумок «Mirakl: статусів замовлень передано: N, помилок: M».

Оновлення за розкладом

Миттєвих сповіщень Mirakl не надсилає: Elbuz сам звертається до площадки за розкладом, який задає кнопка «Налаштування розкладу» в картці «Повʼязані налаштування».

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

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

Пілюля «Активний» / «Вимкнений» знімає шаблон із розкладу (вимкнути шаблон). Вивантаження — окремий шаблон зі своїм перемикачем.

Якщо прогін обірвався

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

Повтор безпечний. Загальні правила: якщо прогін обірвався.

Сценарії

Перенести каталог площадки в Elbuz

Що ввімкнути. Заповніть «Адреса кабінету продавця площадки» й «Ключ API магазину», після «Усі зміни збережено» натисніть «Перевірити підключення», у картці «Вибір даних для завантаження» залиште «Товари».

Що вийде. Кожен офер ляже карткою з назвою, брендом, артикулом, штрихкодом, ціною, залишком і категорією. Опис і фото додайте в Elbuz або з іншого джерела.

Приймати замовлення й відвантажувати з Elbuz

Що ввімкнути. У шаблоні завантаження — галочку «Замовлення», зіставлення кнопкою «Статуси замовлення» (щонайменше SHIPPING, SHIPPED, CANCELED) і розклад кілька разів на годину. У шаблоні вивантаження з тією самою адресою — галочку «Замовлення».

Що вийде. Нові замовлення приймаються на площадці самі, адреса покупця з'являється наступним прогоном. Менеджер вписує трек-номер у «Сервіс доставки: номер» і ставить статус, зіставлений із SHIPPED, — найближче вивантаження передасть відправку.

Площадка як канал для каталогу, який ви ведете в Elbuz

Що ввімкнути. Один раз запустіть завантаження з галочкою «Товари» — воно прив'яже картки до оферів. Далі лишіть у шаблоні завантаження тільки «Замовлення», інакше прогін каталогу перезаписуватиме ціну й залишок цифрами площадки. У шаблоні вивантаження — «Товари», за потреби «Публікувати нові товари».

Що вийде. Ціни й залишки прив'язаних товарів підуть на площадку файлом, а товари зі штрихкодом без офера виставляться на наявні картки площадки.

Що робити, коли площадка не віддає чи не приймає дані

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

Моєї площадки немає в списку адрес — її можна підключити?

Так, якщо вона працює на Mirakl. Скопіюйте адресу кабінету продавця з рядка браузера (адреса кабінету).

Чи можна вимкнути автоматичне прийняття замовлень?

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

Чому в замовленні немає адреси покупця?

Площадка віддає її після прийняття. Наступне завантаження допише адресу й телефон (адреса).

Чому в товарах з Mirakl немає опису й фото?

Офер їх не містить, а Elbuz бере саме офери. Заповніть опис і фото в Elbuz або з іншого джерела (що переноситься).

Чи створює Elbuz нові картки товарів на площадці?

Ні, лише офери на наявних картках за штрихкодом. Нову картку створіть у кабінеті площадки, потім вивантаження прив'яже до неї офер (нові офери).

Ціни в каталозі в гривнях — що піде на площадку?

Те саме число, без перерахунку валюти. Ціни у відборі шаблону вивантаження мають бути у валюті магазину на площадці (вивантаження).

Суміжні теми

• Якщо потрібна загальна механіка завантаження — розклад, обрив, службові категорії: огляд завантаження даних.
• Якщо менеджер веде замовлення в Elbuz і важливо, що перезапише прогін: імпорт замовлень через API.
• Якщо продаєте ще й на Cdiscount чи Kaufland: підключення Cdiscount, підключення Kaufland.