Як підключити ManoMano до Elbuz: офери, ціни й замовлення за ключем API

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

• Підключення ключем API — без прив'язки застосунку, один шаблон на контракт.
• Завантаження оферів — артикул, ціна, залишок і ознака продажу.
• Замовлення з автоприйняттям — нові замовлення приймаються на площадці під час завантаження.
• Ціни й залишки назад на площадку — пачками, результат у журналі.
• Нові офери за штрихкодом — на картки, які вже є на ManoMano.
• Відвантаження, відмова, повернення коштів — вашим статусом замовлення.

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

Меню

Довідники → Операції → Завантаження даних → новий шаблон типу «ManoMano»

Інші входи

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

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

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

Підготувати

ключ API з Toolbox і номер контракту (Seller contract ID)

Один шаблон — один контракт ManoMano. Продаєте у Франції й Іспанії або маєте два способи доставки — заведіть стільки шаблонів, скільки контрактів. Прив'язки товарів у контрактів окремі й не змішуються.

Що взяти в Toolbox

Ключ API створює користувач Toolbox із роллю Admin: Settings → API keys → Create API key. Toolbox показує ключ лише один раз — одразу скопіюйте його в шаблон. Номер контракту (Seller contract ID) теж є в Toolbox: один контракт означає одну країну й один спосіб доставки.

1

Ключ API

2

Seller contract ID

3

Мова пошуку карток за EAN

4

Сітка доставки нових оферів

1. Ключ API — з Toolbox: Settings → API keys, показується один раз.
2. Seller contract ID — номер контракту: країна й спосіб доставки.
3. Мова пошуку карток за EAN — каталог якої країни перевіряти для нових оферів.
4. Сітка доставки нових оферів — назва сітки з Toolbox і термін у днях.

Мову пошуку й сітку доставки використовує лише вивантаження нових оферів. Для каталогу й замовлень достатньо ключа й номера контракту.

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

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

Elbuz забирає ваші офери контракту — і ті, що в продажу, і зняті з продажу. API ManoMano віддає по оферу лише код, ціну й залишок, тому в картку лягає небагато:

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

Офер без прив'язки стає новою карткою з назвою, рівною коду, у службовій категорії (службові категорії). Прив'язати наявні картки до оферів простіше вивантаженням за штрихкодом — сценарій.

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

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

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

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

Сума документа — позиції разом із доставкою.

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

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

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

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

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

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

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

Зворотний напрямок — окремий шаблон вивантаження типу «ManoMano». У ньому два поля:

• Seller contract ID — номер контракту. Порожнє поле — контракт береться з шаблону завантаження з тим самим ключем.
• Ключ API — той самий ключ із Toolbox.

Мову пошуку за EAN і сітку доставки вивантаження бере з шаблону завантаження цього контракту.

1

Seller contract ID

2

Ключ API

1. Seller contract ID — порожньо: береться з шаблону завантаження з тим самим ключем.
2. Ключ API — той самий ключ із Toolbox.

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

• Ціна — з ПДВ, числом із шаблону вивантаження, з двома знаками після коми. Валюту Elbuz не перераховує: ціни у відборі мають бути у валюті контракту.
• Залишок — кількість товару, не менше нуля.
• Які товари — визначає відбір шаблону вивантаження, як і для інших каналів.

Ціни й залишки йдуть пачками до тисячі оферів. Офер, у якого ні ціна, ні залишок не змінилися, помилкою не рахується. Відмову по оферу площадка пояснює, і в журналі стоїть рядок «ManoMano: «‹код›» відхилено: ‹причина›». Підсумок запуску — «ManoMano: ціни й залишки — успішно: N, помилок: M».

Ліміт запитів

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

Нові офери і нові картки

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

Новий офер отримує ціну, залишок, вагу товару для розрахунку доставки й сітку доставки з шаблону завантаження. Код офера — артикул товару; без артикула — ID товару в Elbuz.

Якщо по оферах саме йде імпорт фіду в Toolbox, площадка не приймає змін: у журналі «ManoMano: по оферах іде імпорт фіду, не змінено: N — повтор наступним запуском». Прив'язки не створюються, наступний запуск відправить ці товари знову.

Як створити нову картку

Нових карток ManoMano через API не створює: вони з'являються лише з фіду, який ви підключаєте в Toolbox. Зробіть у Elbuz фід-вивантаження з потрібними товарами й вкажіть його посилання в Toolbox. Коли площадка створить картки з фіду, вивантаження типу «ManoMano» прив'яже до них ваші товари за штрихкодом і далі оновлюватиме ціни й залишки.

Відвантаження, відмова й повернення коштів

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

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

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

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

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

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

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

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

Сценарії

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

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

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

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

Що ввімкнути. Шаблон вивантаження з відбором потрібних товарів, галочки «Товари» й «Публікувати нові товари». У товарів мають бути штрихкоди. Для товарів, яких на ManoMano ще немає, — фід-вивантаження, підключене в Toolbox.

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

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

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

Чому завантажені з ManoMano товари названі кодами?

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

Продаю у Франції й Іспанії — скільки шаблонів потрібно?

Пару шаблонів на кожен контракт: завантаження й вивантаження. Ключ API може бути один (де це).

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

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

Чи створює Elbuz нові картки на ManoMano?

Ні, лише офери на наявних картках за штрихкодом. Нові картки площадка створює з фіду в Toolbox (нова картка).

Загубив ключ API — де його подивитися?

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

Суміжні теми

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