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

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

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

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

Меню

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

Інші входи

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

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

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

Підготувати

Client ID і Client secret застосунку з zDirect Partner Portal

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

Що потрібно від Zalando

Zalando приймає продавців лише за власним запрошенням. Спершу ви проходите відбір у партнерську програму Zalando й підписуєте договір партнера — тільки після цього відкривається доступ до zDirect Partner Portal і його API.

Ключі видає застосунок, створений у zDirect Partner Portal:

1. Продавець запрошує в zDirect свого технічного партнера.
2. Технічний партнер створює застосунок для API саме для цього продавця. Одна обліковка застосунку обслуговує одного продавця.
3. Портал показує дві частини ключа — Client ID і Client secret. Їх вставляють у шаблон Elbuz.

1

Client ID

2

Client secret

3

Країни продажу

4

Merchant ID

1. Поле «Client ID» — публічна половина ключів застосунку zDirect.
2. Поле «Client secret» — секретна половина, зберігається прихованою.
3. Поле «Країни продажу» — коди країн через кому, перша дає ціну й залишок каталогу.
4. Поле «Merchant ID» — лише коли в ключів кілька продавців.

Вставивши ключі, натисніть «Перевірити підключення». Elbuz запитає Zalando, кому належать ключі, і відповість рядком «Zalando» з кодами країн і Merchant ID. Так видно, що ключі скопійовано повністю.

Що приходить із каталогу Zalando

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

Галочка «Фото» на завантаження Zalando не впливає: зображень майданчик через цей канал не віддає. Назви, описи й фото заповніть в Elbuz самі або підтягніть з прайсу постачальника.

1

Товари

2

Замовлення

1. Товари — каталог: ціни, залишки й статуси за EAN.
2. Замовлення — завантаження замовлень із Zalando.

Що змінює повторний прогін

У товару, який уже є в каталозі, прогін оновлює тільки ціну, кількість і статус. Назву, опис, категорію, фото й решту полів він не чіпає — навіть якщо назва ще «Zalando ‹EAN›». Тож перейменуйте картку, і прогін цю назву не поверне.

Свою картку прогін знаходить за прив'язкою до EAN, яку поставило перше завантаження або публікація з Elbuz. Від решти оновлення закривають перемикачі в картці товару, секція «Захист під час імпорту»:

• «Не оновлювати» — прогін Zalando не змінює картку зовсім;
• «Фіксована ціна» — прогін не перезаписує ціну, а кількість і статус оновлює.

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

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

Кожне замовлення Zalando лягає документом «Замовлення покупця» з номером замовлення. У документ потрапляють:

• номер, дата створення й дата зміни, код статусу Zalando;
• ім'я та прізвище отримувача, пошта й номер покупця;
• адреса доставки — рядки адреси, місто, індекс, країна;
• позиції з ціною й кількістю, валюта.

Кількість позиції — замовлене мінус скасоване на Zalando. Телефону покупця, служби доставки й способу оплати Zalando не передає, тому ці поля лишаються порожніми.

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

Статус приходить кодом Zalando. Зіставте коди зі своїми статусами кнопкою «Статуси замовлення» в картці «Повʼязані налаштування» форми шаблону.

1

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

2

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

1. Кнопка «Статуси замовлення» — зіставлення кодів статусів Zalando зі своїми.
2. Кнопка «Налаштування розкладу» — розклад автоматичного завантаження.

Elbuz нічого не підтверджує на Zalando сам: трек-номер і відвантаження назад не передаються. Відправлення позначайте в zDirect, а Elbuz підхопить новий статус наступним прогоном.

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

Зворотний напрямок — окремий шаблон вивантаження типу «Zalando». У ньому ті самі Client ID і Client secret, а поле «Версія API (параметри майданчика)» задає країни: de,at. Якщо ключі обслуговують кількох продавців, Merchant ID пишуть після риски: de,at|ваш-merchant-id.

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

Вивантаження оновлює тільки товари, прив'язані до EAN Zalando. Прив'язку ставить завантаження каталогу або публікація. Решту товарів без галочки «Публікувати нові товари» вивантаження пропускає без рядка в журналі.

Код 104 — не помилка

Підсумок прогону журнал показує рядком «Zalando: ціни та залишки надіслано, прийнято: N, чекають онбордингу EAN: K (помилок: M)». K — це товари з кодом 104: EAN ще не пройшов онбординг на Zalando. Ціну Zalando застосує, коли картку буде схвалено, а Elbuz і далі надсилатиме її кожним прогоном.

Помилки рахуються тільки для відхилених позицій. Кожна з них — окремий червоний рядок «Zalando: prices — «назва» відхилено, код …: причина» (для залишків — «stocks»).

Публікація товарів на Zalando

З галочкою «Публікувати нові товари» у шаблоні вивантаження Elbuz публікує товари, ще не прив'язані до Zalando. Для кожного потрібен штрихкод EAN щонайменше з 8 цифр. Далі є два шляхи:

Нова картка: силует і що в неї потрапляє

Силует (outline) — тип товару в Zalando: сукня, кросівки, сумка. Його зіставляють з вашою категорією у вікні «Зіставлення з маркетплейсами»: виберіть чип «Zalando», натисніть «Завантажити довідник майданчика» — підтягнеться список силуетів вашого акаунта — і заповніть колонку «Силует Zalando». Детальніше: зіставлення категорій з маркетплейсами.

1

Чип «Zalando»

2

Силует Zalando

3

Завантажити довідник майданчика

1. Чип «Zalando» перемикає колонки таблиці на цей майданчик.
2. Колонка «Силует Zalando»: силует, за яким Elbuz подає нову картку.
3. Кнопка «Завантажити довідник майданчика» тягне список силуетів з вашого акаунта.

У нову картку Elbuz кладе назву товару, виробника як бренд, повний опис і до 12 фото. Обмеження нової картки:

• Без варіацій. Один товар Elbuz — одна картка з одним кольором і одним розміром. Розміри одного фасону стануть окремими картками.
• Без розмірних сіток і без обов'язкових атрибутів силуету — коду кольору, сезону, статі. Якщо силует їх вимагає, Zalando відмовить, і причина буде в журналі.
• Бренд іде назвою виробника, а Zalando чекає код бренду зі свого довідника. Тоді картку приймуть із зауваженням («картку прийнято із зауваженнями: …») або відхилять.

Відповідь «надіслано» означає лише первинну перевірку. Остаточний висновок Zalando дає за кілька хвилин чи годин. Наступні вивантаження самі дивляться результат і до схвалення надсилають ціну й залишок з кодом 104.

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

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

Zalando обмежує частоту звернень: замовлення — 40 на хвилину, ціни — 30, залишки — 60. Отримавши відмову через ліміт, Elbuz чекає стільки, скільки сказав майданчик (до хвилини), і повторює до чотирьох разів.

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

Сценарії

Ви продаєте лише на Zalando й хочете бачити залишки в Elbuz

Що ввімкнути. Заповніть «Client ID», «Client secret» і «Країни продажу», у картці «Вибір даних для завантаження» — «Товари» й «Замовлення».

Що вийде. Кожен EAN ляже карткою «Zalando ‹EAN›» з ціною й залишком першої країни в категорії «Zalando». Назви, фото й опис додайте самі — наступні прогони їх не зітруть.

Каталог ведете в Elbuz, Zalando — один із каналів

Що ввімкнути. У шаблоні завантаження — лише «Замовлення». У шаблоні вивантаження — країни в полі «Версія API (параметри майданчика)», формулу ціни в євро й галочку «Публікувати нові товари».

Що вийде. Товари, картки яких на Zalando уже є, отримають ваш офер і прив'язку за EAN, без дублів у каталозі. Решта піде на перевірку як нові картки, якщо їхній категорії зіставлено силует.

Продаєте в Німеччині й Польщі

Що ввімкнути. Два шаблони вивантаження з тими самими ключами: у першому — de,at і ціна в євро, у другому — pl і ціна в злотих.

Що вийде. Кожна країна отримає ціну у своїй валюті, залишок — однаковий з каталогу.

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

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

Чи можна зареєструватися на Zalando самому?

Ні. Zalando приймає партнерів лише за власним запрошенням. Ключі API з'являються після підписання договору (що потрібно від Zalando).

Чому товари з Zalando називаються «Zalando 4006…»?

API Zalando не віддає назв, лише EAN і цифри офера. Перейменуйте картки в Elbuz — повторний прогін назву не змінить (повторний прогін).

Чи можна опублікувати сукню в кількох розмірах однією карткою?

Ні. Elbuz подає один товар як картку з одним розміром. Картку з розмірною сіткою створіть у zDirect, тоді Elbuz додасть до неї офери за EAN (нова картка).

Що означає код 104?

EAN ще проходить онбординг на Zalando. Це не помилка: ціна застосується після схвалення картки (код 104).

Elbuz передає на Zalando трек-номер?

Ні. Відвантаження позначайте в zDirect, новий статус замовлення Elbuz підхопить наступним прогоном (замовлення).

Чому на Zalando ціна в десятки разів більша?

Ціна пішла в гривнях, а Zalando прочитав її в євро: курс Elbuz не перераховує. Задайте формулу ціни в шаблоні вивантаження (вивантаження).

Суміжні теми

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