Kaufland Marketplace — майданчик мережі Kaufland: Німеччина, Австрія, Чехія, Словаччина та Польща. Кожна країна там окремий майданчик (storefront) зі своїм каталогом і своїми замовленнями. Elbuz підключається до акаунта продавця через офіційний Seller API і працює в обидва боки: забирає ваші офери в базовий каталог, приймає замовлення й повертає на майданчик свіжі ціни та залишки.
Ця стаття — про підключення саме Kaufland. Загальний порядок для всіх API-джерел каталогу описано в огляді імпорту каталогу через API, а спільні правила приймання замовлень — в огляді імпорту замовлень; тут — те, що стосується тільки Kaufland.
Де це у програмі
У вікні завантаження створіть шаблон і оберіть тип «Kaufland». Це API-джерело: файл не потрібен, підключення відбувається парою ключів. Один шаблон — один майданчик: якщо ви продаєте і в Німеччині, і в Польщі, заведіть два шаблони з різним значенням поля «Майданчик».
1
Client key (Shop-Client-Key)2
Secret key3
Майданчик (storefront)- Client key (Shop-Client-Key) — публічна половина пари ключів доступу до Seller API.
- Secret key — секретна половина пари ключів, зберігається прихованою.
- Майданчик (storefront) — код країни маркетплейсу: de, at, cz, sk або pl.
Що потрібно для підключення
Kaufland — один із небагатьох майданчиків, де підключення відбувається без прив'язки застосунку: ви просто вставляєте два ключі з кабінету продавця. Полів у картці «Підключення» п'ять, і обов'язкові з них лише перші два:
| Поле у шаблоні | Що це |
|---|---|
| Client key (Shop-Client-Key) | Публічна половина пари ключів. Обов'язкове |
| Secret key | Секретна половина: нею підписується кожен запит. Обов'язкове |
| Майданчик (storefront) | Країна: de, at, cz, sk або pl. Якщо не заповнити, буде de |
| ID групи доставки | Потрібен тільки для публікації нових оферів |
| Ставка ПДВ (vat_indicator) | Теж для публікації; за замовчуванням standard_rate |
Коли ключі вставлено, натисніть «Перевірити підключення» — Elbuz зробить один легкий підписаний запит і відповість назвою майданчика. Це найшвидший спосіб переконатися, що ключі скопійовано повністю й обрано правильну країну.
Документація майданчика для продавців: Kaufland Seller API. Ключі видаються в кабінеті продавця, у розділі налаштувань API.
Що приходить у каталог
Каталог Kaufland влаштовано інакше, ніж у звичайного магазину, і це варто розуміти одразу. На майданчику є спільна картка товару (її веде Kaufland) і ваш офер до неї — ціна, залишок, стан. Elbuz забирає список ваших оферів і до кожного дотягує картку товару, щоб у базовому каталозі опинився не голий рядок з ціною, а повноцінний товар.
| Дані Kaufland | Поле товару в Elbuz |
|---|---|
| назва картки товару | Назва |
| опис і короткий опис картки | Опис, короткий опис |
| виробник | Виробник |
| id_offer — ваш код офера | Артикул |
| EAN картки | Штрихкод |
| ціна офера (в центах) | Ціна (переводиться у валюту) |
| залишок офера | Кількість |
| стан офера | Статус: доступний — увімкнений товар |
| категорія картки | Категорія |
| головне фото і решта зображень | Фотографії (якщо ввімкнено відповідну галочку) |
Майданчик передає й приймає гроші в центах: 5999 означає 59,99. Elbuz переводить їх в обидва боки автоматично, і в каталозі ви бачите звичайну ціну. Пам'ятати про це варто в одному випадку: якщо ви звіряєте цифри з викладкою Kaufland і бачите чотиризначне число там, де очікували двозначне, — усе гаразд, це центи.
З Kaufland не приходять характеристики товару — картку веде майданчик, і її атрибути через цей канал не віддаються. Тож якщо каталог в Elbuz для вас основний, характеристики доведеться заповнити у себе або підтягнути з іншого джерела (наприклад, з прайсу постачальника чи власного магазину).
Замовлення
Замовлення Kaufland віддає рядками: не документ із позиціями, а окремі записи «одиниця замовлення». Elbuz збирає їх назад у документ за номером замовлення — шапку бере з першого рядка, решту додає позиціями й підсумовує суму. Практичний наслідок цієї механіки: якщо покупець узяв три однакові товари, у замовленні буде три рядки по одній штуці, а не один рядок із кількістю три.
У документ потрапляють номер замовлення, дати створення й зміни, ім'я та прізвище отримувача, телефон, пошта покупця, адреса доставки (вулиця, будинок, місто, індекс, країна), валюта, коментар і зовнішній статус замовлення. Статус приходить кодом майданчика — зіставити його зі своїми статусами можна кнопками в картці «Пов'язані налаштування» у формі шаблону.
Перше завантаження проходить по всіх сторінках замовлень і переносить історію — для великого кабінету це помітно довго. Далі Elbuz просить у майданчика лише те, що змінилося з моменту минулого запуску, з запасом у дванадцять годин: запас потрібен на випадок, коли рядок змінився вже після того, як його сторінку прочитали.
Уже завантажені замовлення при цьому оновлюються, а не дублюються — упізнавання йде за номером замовлення. Тому розклад можна ставити щільно: кілька разів на годину для активного магазину цілком нормально.
Оновлення цін і залишків на майданчику
Зворотний напрямок — окремий шаблон вивантаження того самого типу. Elbuz надсилає ціни й залишки пачками (до 150 позицій за раз), майданчик відповідає за кожною позицією окремо, і в журнал потрапляє, скільки рядків пройшло, а скільки відбито. Ключ, за яким оновлюється офер, Elbuz запам'ятовує ще на завантаженні каталогу — тому найнадійніший порядок: спершу один раз завантажити каталог з Kaufland, потім налаштовувати вивантаження.
Якщо товар в Elbuz є, а офера на майданчику для нього ще немає, увімкнена галочка створення товарів дає Elbuz право опублікувати офер. Тут працює правило маркетплейсу: офер чіпляється до наявної картки за EAN. Тому у товару обов'язково має бути штрихкод (щонайменше 8 цифр) і має бути заповнений ID групи доставки в шаблоні — без нього публікація не почнеться взагалі, про що Elbuz одразу напише в журнал.
Окремий випадок — коли картки такого товару в каталозі Kaufland ще немає (ви виробник або перший продавець). Тоді Elbuz надсилає дані картки на перевірку майданчика: назву, опис, виробника, фотографії та сопоставлену категорію Kaufland. Це асинхронна процедура — картка з'явиться не миттєво, а офер до неї Elbuz створить на одному з наступних запусків, коли Kaufland картку прийме.
Розклад
Kaufland працює поллінгом: миттєвих сповіщень немає, Elbuz сам звертається до майданчика за розкладом. Розклад задають кнопкою налаштування завдання просто у формі шаблону. Розумний орієнтир — замовлення забирати кілька разів на годину (після першого запуску кожен наступний бере лише зміни), каталог оновлювати раз на добу, а ціни й залишки вивантажувати за власним графіком: частіше, якщо у вас рухливі залишки.
Навіщо зводити Kaufland в Elbuz
Кабінет Kaufland добре показує сам Kaufland. Але якщо ви продаєте ще десь — на іншому маркетплейсі, у власному магазині, офлайн, — залишки й замовлення розповзаються по різних кабінетах, і хтось неодмінно продасть те, чого вже немає. Звівши майданчик у Elbuz, ви отримуєте один каталог, з якого ціни й залишки роз'їжджаються на всі канали, і одну чергу замовлень для менеджерів. А для німецького ринку це ще й зручний спосіб тримати п'ять країн Kaufland у єдиному місці замість п'яти вкладок.
Часті питання
Де взяти client key і secret key?
Обидва ключі видає сам Kaufland у кабінеті продавця, у розділі налаштувань API. Це пара: публічний ключ ідентифікує магазин, секретний підписує запити. Вставте їх у поля «Client key» і «Secret key» у картці «Підключення» й натисніть «Перевірити підключення».
Що писати в полі «Майданчик»?
Дволітерний код країни, у якій ви продаєте: de, at, cz, sk або pl. Якщо поле порожнє, Elbuz працює з німецьким майданчиком. Для продажів у кількох країнах заведіть окремий шаблон на кожну — каталоги й замовлення там різні.
Чому в товарах немає характеристик?
Kaufland не передає атрибути картки через цей канал — картку веде майданчик, а продавцю віддається його офер. Назва, опис, виробник, фото й категорія приходять, характеристики — ні. Заповніть їх в Elbuz або підтягніть з іншого джерела.
Чому не публікується новий товар?
Найчастіші дві причини, і обидві видно в журналі. Перша — у товару немає штрихкоду EAN: офер на маркетплейсі чіпляється до чужої картки саме за ним. Друга — не заповнено ID групи доставки в шаблоні; без нього публікація не стартує. Якщо ж картки товару в каталозі Kaufland узагалі немає, Elbuz надішле її дані на перевірку майданчика, і офер створиться пізніше.
Чому в замовленні три рядки по одній штуці замість одного на три?
Так влаштований API Kaufland: він віддає замовлення окремими одиницями, кожна з яких — одна штука. Elbuz збирає їх в один документ за номером замовлення, тому сума й склад замовлення правильні, а рядків більше, ніж звично.