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

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

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

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

Меню

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

Інші входи

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

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

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

Підготувати

client key і secret key з кабінету продавця Kaufland

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

1

Client key (Shop-Client-Key)

2

Secret key

3

Майданчик (storefront)

1. Client key (Shop-Client-Key) — публічна половина пари ключів доступу до Seller API.
2. Secret key — секретна половина пари ключів, зберігається прихованою.
3. Майданчик (storefront) — код країни маркетплейсу: de, at, cz, sk або pl.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1

Не оновлювати

2

Фіксована ціна

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1

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

2

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Сценарії

1

Товари

2

Фото

3

Замовлення

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

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

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

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

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

Що ввімкнути. Галочку «Замовлення»; у картці «Повʼязані налаштування» — кнопкою «Статуси замовлення» зіставити коди Kaufland зі своїми статусами, кнопкою «Налаштування розкладу» задати регулярні запуски.

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

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

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

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

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

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

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

Код країни: de, at, cz, sk або pl; порожнє поле — Німеччина. Для кількох країн заведіть шаблон на кожну.

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

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

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

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

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

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

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

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

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

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

Суміжні теми

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