↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Завантаження даних
    4. Маркетплейси ЄС і США

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

    29 хв читанняОновлено

    Elbuz підключається до акаунта продавця Kaufland Marketplace (Німеччина, Австрія, Чехія, Словаччина, Польща) парою ключів: забирає ваші офери в базовий каталог, приймає замовлення й повертає на майданчик ціни та залишки.

    Коли це знадобиться:

    • Продаєте на Kaufland і ще деінде — залишки й замовлення всіх каналів ведуться в одному каталозі.
    • Кілька країн Kaufland — кожна підключається своїм шаблоном.
    • Менеджер веде замовлення в Elbuz — повторний прогін не затирає його статуси, проведений документ не змінюється.
    • Ціни рахуєте в Elbuz — вивантаження відправляє їх на Kaufland і публікує нові офери за EAN.

    З чого почати: візьміть client key і secret key у кабінеті продавця й вставте їх у шаблон типу «Kaufland».

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

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

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

    Поле у шаблоніЩо це
    Client key (Shop-Client-Key)Публічна половина пари ключів. Обов'язкове
    Secret keyСекретна половина: нею підписується кожен запит. Обов'язкове
    Майданчик (storefront)Код країни: de, at, cz, sk, pl та інші вітрини, відкриті вашому акаунту. Кнопка «Обрати зі списку» під полем показує їх і підставляє вибрану. Якщо не заповнити, буде de
    групи доставкиЗавантаження його не використовує. Для публікації нових оферів задається в шаблоні вивантаження (вивантаження)
    Ставка ПДВ (vat_indicator)Так само: на завантаження не впливає, для публікації задається в шаблоні вивантаження

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

    «Активний» і «Замовлення» в новому шаблоні вже ввімкнені: за 5 хвилин після збереження ключів Elbuz почне забирати всю історію замовлень. Статуси майданчика Elbuz зводить до ваших сам, за назвою; що прийшло і як зведено, видно у вікні «Статуси замовлення» шаблону. Хочете спершу перевірити — зніміть «Замовлення».

    Документація майданчика для продавців: Kaufland Seller API. Ключі видаються в кабінеті продавця, у розділі налаштувань .

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

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

    Дані KauflandПоле товару в Elbuz
    назва картки товаруНазва
    опис і короткий опис карткиОпис, короткий опис
    виробникВиробник
    id_offer — ваш код офераАртикул
    EAN карткиШтрихкод
    ціна офера (в центах)Ціна (переводиться у валюту)
    залишок офераКількість
    стан офераСтатус: доступний — увімкнений товар
    категорія карткиКатегорія
    головне фото і решта зображеньФотографії (якщо ввімкнено відповідну галочку)

    Майданчик передає й приймає гроші в центах: 5999 означає 59,99. Elbuz переводить їх в обидва боки сам, і в каталозі ви бачите звичайну ціну. Чотиризначне число у викладці Kaufland там, де ви чекали двозначне, — це центи.

    Характеристики й категорії

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

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

    • «Товари - kaufland» — для оферів, у картки яких категорії немає;
    • «Товари - kaufland - ‹назва шаблону›» — для товарів із замовлень, яких не було в каталозі.

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

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

    Свою картку повторне завантаження шукає за назвою, яку віддав Kaufland: артикула виробника й посилання на товар майданчик не передає. Знайдену картку прогін змінює так:

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

    Виправили назву в Elbuz — наступний прогін поверне назву картки Kaufland без попередження. Ведете стару ціну руками — шаблон Kaufland стиратиме її на кожному прогоні.

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

    Група «Захист під час імпорту» в картці товару
    1Не оновлювати
    2Фіксована ціна
    1. Не оновлювати — закриває картку від прогону Kaufland цілком.
    2. Фіксована ціна — закриває ціни картки від перезапису прогоном.

    Офер зник із майданчика або змінив стан

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

    Офер, який ще приходить, але змінив стан:

    • стан AVAILABLE — товар в Elbuz увімкнений;
    • інший стан і залишок нуль — товар вимикається;
    • інший стан, але залишок більший за нуль — товар лишається увімкненим.

    Якщо товар веде не тільки Kaufland

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

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

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

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

    У документ потрапляють:

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

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

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

    Що робить повторний прогін із замовленням

    Документ упізнається за номером замовлення разом із кодом джерела. Переписує прогін небагато:

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

    У проведеному документі повторне завантаження не змінює жодного поля. Провели — майданчик у нього більше не пише.

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

    Замовлення, залишок і резерв

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

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

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

    Скасування на Kaufland доїжджає звичайним прогоном і міняє статус документа — тільки якщо документ не проведено. Проведене замовлення лишиться з попереднім статусом і триматиме резерв, доки ви не зміните статус самі. Розбіжність між кабінетом Kaufland і Elbuz шукайте на скасуваннях.

    Картка «Повʼязані налаштування» у формі шаблону Kaufland
    1Статуси замовлення
    2Налаштування розкладу
    1. Статуси замовлення — зіставлення кодів Kaufland зі своїми статусами.
    2. Налаштування розкладу — розклад каталогу; замовлення Elbuz забирає сам кожні 5 хвилин.

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

    Зворотний напрямок — окремий шаблон вивантаження того самого типу. Elbuz надсилає ціни й залишки пачками до 150 позицій, майданчик відповідає за кожною окремо, і в журналі видно, скільки пройшло, а скільки відбито. Ключ офера Elbuz запам'ятовує на завантаженні каталогу, тому спершу один раз завантажте каталог з Kaufland, потім налаштовуйте вивантаження.

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

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

    Публікація нових оферів

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

    ID групи доставки, ставку ПДВ і майданчик задає поле «Версія API (параметри майданчика)» шаблону вивантаження: майданчик|ID групи доставки|ставка ПДВ, наприклад de|3457|standard_rate. Порожній майданчик означає de, порожня ставка — standard_rate.

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

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

    Кожен опублікований офер журнал показує рядком «Kaufland: опубліковано товар «…» (юніт …)».

    Що має збігтися, щоб новий офер поїхав на Kaufland. Жовтий ромб — розвилка, і на кожній із них публікація може зупинитися
    НіТакНіТакНіТакТакНіТовар є в Elbuz,офера на майданчику немаєУвімкнено галочку«Публікувати нові товари»?Офер не публікуєтьсяУ товару є штрихкод EAN,щонайменше 8 цифр?Публікація не почнеться —запис у журналіЗаповнено ID групидоставки в шаблонівивантаження?Публікація не почнеться —запис у журналіКартка з таким EANуже є в каталозі Kaufland?Офер чіпляєтьсядо наявної карткиДані картки їдутьна перевірку майданчикаПеревірка асинхронна: оферстворитьсяна одному з наступних запусків
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

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

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

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

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

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

    • Каталог пишеться пачками по 500 оферів: що встигло лягти — оновлене, решта зі старими даними. Оферів менше п'ятисот — пачка одна, і не запишеться нічого.
    • Замовлення — усе або нічого: Elbuz вичитує всі сторінки й зберігає одним заходом. Дата, від якої береться наступна порція, зсувається лише після збереження, тож повтор забере той самий проміжок.
    • Вивантаження обривається пачками по 150: що пішло, те на майданчику змінене.
    Один прогін замовлень. Ліва гілка — перший запуск, права — усі наступні. Зверніть увагу на помилку посередині: вона обриває прогін до збереження, тому дата не зсувається і наступний запуск забере той самий проміжок
    Ні — перший запускТакТакНіТакНіНіТакПрогін замовленьЗаповнено дату в полі«Завантаження замовленьпочинаючи з дати»?Беруться всі рядки замовленьБеруться рядки, змінені від цієїдатимінус дванадцять годинСторінка по 100 рядків —рядки збираються в документи заномеромМайданчик відповів помилкою?Прогін зупиняється — незбереженожодного замовлення, дата незсуваєтьсяЄ ще сторінки і не натиснуто«Зупинити»?Зібрано хоч однезамовлення?Нічого не зберігається,дата не зсуваєтьсяУсі зібрані замовленнязберігаються разомДата в полі зсуваєтьсяна найпізнішу зміну з прочитаних
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

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

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

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

    ЩоСкільки
    Сторінка оферів і сторінка рядків замовлень100 за запит
    Запис у базовий каталогпачками по 500 оферів
    Пачка на оновленні цін і залишків150 позицій — жорсткий ліміт Kaufland
    Очікування однієї відповіді120 секунд, на з'єднання — 30
    Повтори при відмові через ліміт зверненьдо трьох, із паузою, що зростає
    Фотографії при відправці нової картки на перевіркудо 12
    Штрихкод EAN для публікації оферане коротший за 8 цифр

    Сценарії

    Картка «Вибір даних для завантаження» у формі шаблону Kaufland
    1Товари
    2Фото
    3Замовлення
    1. Товари — завантажувати офери Kaufland до каталогу.
    2. Фото — завантажувати зображення карток.
    3. Замовлення — отримувати замовлення з Kaufland.

    Перенести каталог Kaufland у Elbuz

    Що ввімкнути. Заповніть «Client key (Shop-Client-Key)», «Secret key» і «Майданчик», у картці «Вибір даних для завантаження» — «Товари», для зображень ще й «Фото».

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

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

    Що ввімкнути. Галочку «Замовлення»; статуси Elbuz зведе сам, кнопка «Статуси замовлення» в картці «Повʼязані налаштування» — для уточнень. Розклад шаблону не потрібен: замовлення приходять самі кожні 5 хвилин.

    Що вийде. Перший прогін забере історію, наступні — зміни від дати в полі «Завантаження замовлень починаючи з дати (РРРР-ММ-ДД)» у блоці «Розширене», із запасом у дванадцять годин. Ваш статус змінюється лише тоді, коли статус на Kaufland змінився і його зіставлено; проведений документ не змінюється.

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

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

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

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

    Розбір частих проблем
    Що ви бачитеЧому такЩо зробити
    «Перевірити підключення» не відповідає назвою майданчика Ключ скопійовано не повністю або обрано не ту країну Перевставте обидва ключі й код країни (що потрібно від Kaufland)
    «Kaufland: помилка API — HTTP 429: rate limit» Ліміт звернень вичерпано й після трьох повторів Запустіть шаблон пізніше — повтор безпечний (якщо прогін обірвався)
    «Kaufland: «…» — немає штрихкоду EAN, публікація на Kaufland неможлива» Офер чіпляється до картки майданчика за EAN Заповніть у товарі штрихкод від 8 цифр (публікація нових оферів)
    «Kaufland: не вказано ID групи доставки (id_shipping_group) — публікація неможлива. Заповніть його в шаблоні» Без групи доставки офер не створюється Впишіть у поле «Версія API (параметри майданчика)» шаблону вивантаження, наприклад de|3457|standard_rate
    «Kaufland: ціни та залишки оновлено, оферів: N (помилок: M)» з ненульовим M Майданчик відбив частину позицій Виправте ціни й залишки в каталозі й запустіть вивантаження ще раз — офер оновиться за тим самим ключем
    Прогін каталогу перезаписав не те Масового скасування немає, старі значення не зберігаються Зачеплені картки — колонка «Дата оновлення», створені — «Джерело: назва»; ціну видно в «Історії ціни товару» (якщо завантажили не те)
    Офер опубліковано помилково Elbuz не вміє знімати офери, прив'язка лишається Зніміть офер у кабінеті Kaufland і приберіть товар із відбору шаблону вивантаження
    Товари в категорії «Товари - kaufland» не вивантажуються Службова категорія створюється вимкненою Перенесіть товари у свої категорії (категорії)
    Зник вписаний менеджером «Сервіс доставки» Kaufland його не передає, прогін пише порожнє Проведіть документ — у проведений прогін не пише (повторний прогін замовлення)

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

    Що писати в полі «Майданчик»?

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

    Чому в товарах немає характеристик?

    Kaufland не передає атрибути картки через цей канал. Заповніть їх в Elbuz або підтягніть з іншого джерела (характеристики).

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

    API Kaufland віддає замовлення окремими одиницями. Сума й склад замовлення правильні, просто рядків більше (замовлення).

    Чому зникає стара ціна, яку я ставлю руками?

    Kaufland не передає стару ціну, і прогін щоразу пише порожнє. Закріпіть картку прапором «Не оновлювати» (повторний прогін).

    Замовлення скасували на Kaufland — що буде в Elbuz?

    Непроведений документ отримає ваш статус зі зіставлення. Проведений лишиться як був і триматиме резерв (резерв).

    Товар зник із Kaufland — Elbuz його видалить?

    Ні. Позиція лишиться з останньою ціною й залишком, прибирайте її руками (зниклий офер).

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

    Меню
    Довідники → Операції → Завантаження даних → новий шаблон типу «Kaufland»
    Інші входи
    Довідники → Операції → Вивантаження даних — шаблон для цін і залишків
    Право доступу
    вікно «Завантаження даних» у «Правах груп»
    Підготувати
    client key і secret key з кабінету продавця Kaufland

    Один шаблон — один майданчик: продаєте і в Німеччині, і в Польщі — заведіть два шаблони з різним значенням поля «Майданчик».

    Картка «Підключення» форми шаблону Kaufland
    1Client key (Shop-Client-Key)
    2Secret key
    3Майданчик (storefront)
    1. Client key (Shop-Client-Key) — публічна половина пари ключів доступу до Seller API.
    2. Secret key — секретна половина пари ключів, зберігається прихованою.
    3. Майданчик (storefront) — код країни вітрини; доступні вашому акаунту підставляє кнопка «Обрати зі списку».

    Суміжні теми

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

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно