Как подключить Kaufland к порталу: ключи, витрины, трек-номерБета

Интеграция в бета-версии: работает по официальной документации площадки, возможны ошибки — проверяйте заказы и остатки в кабинете площадки.

Kaufland подключается по паре ключей из Seller Portal: Client Key и Secret Key. Портал забирает заказы выбранных витрин в канбан (каждый в валюте своей витрины), отмечает заказ отправленным с трек-номером, отменяет его с причиной Kaufland и выгружает остатки и цены на основную витрину.

1. Что умеет интеграция

Интеграция сделана по документации и спецификации Kaufland Seller API. Живой кабинет ещё проверяется, первые заказы просматривайте внимательно.

2. Что нужно заранее

• Кабинет продавца Kaufland Global Marketplace с активным договором.
• Товары на нужных витринах: остатки и цены портал обновляет у уже созданных предложений.
• Артикулы предложений в Kaufland, совпадающие с артикулами ваших товаров в портале (если артикула нет, портал найдёт товар по EAN).
• Тариф Web Plus: раздел «Маркетплейсы» доступен на нём (сейчас в бете).
• Право «Подключения к площадкам» у вашей роли в мастерской.

3. Где взять ключи

1. Откройте Kaufland Seller Portal.
2. Перейдите в Settings → API.
3. Создайте пару ключей: Client Key и Secret Key.
4. Сразу скопируйте оба. Secret Key показывается один раз и не восстанавливается. Потеряли его: создайте новую пару и замените ключи в подключении.

Отдавайте ключи только порталу. Если они утекли, отзовите пару в Seller Portal и создайте новую.

4. Подключение у нас

1. Откройте раздел «Маркетплейсы» → «Подключения» и нажмите «Подключить» у Kaufland.
2. Вставьте Client Key и Secret Key. Страна, валюта и часовой пояс подставляются сами (Германия, евро, Берлин) и правятся в настройках подключения.
3. Портал проверит ключи и сохранит их только после успешной проверки. Проверяются только ключи; витрины выбираются следующим шагом.
4. Нажмите «Открыть настройки» и в блоке «Витрины Kaufland» отметьте витрины, с которых нужны заказы: Германия, Австрия, Чехия, Словакия, Польша, Франция, Италия. Рядом с каждой показана её валюта. Ничего не отмечено: заказы берутся со всех витрин вашего кабинета.
5. Выберите «Основную витрину»: на неё выгружаются остатки и цены. Не выбрана: первая из отмеченных витрин.
6. Включите нужные виды записи: «Действия с заказами», «Остатки», «Цены».

Выбирать склад не нужно: остатки Kaufland привязаны к витрине. Портал сам выставляет нужный служебный параметр склада при сохранении витрин.

5. Заказы

• Один заказ Kaufland может состоять из нескольких штук (units). Статус заказа в портале сводный: по ещё живым штукам берётся самый ранний этап. Если штуки в разных статусах, это видно в сведениях о заказе.
• Валюта. Сумма заказа хранится в валюте витрины: Германия, Австрия, Словакия, Франция, Италия — евро; Чехия — кроны (CZK); Польша — злотые (PLN). В карточку заказа, на склад и в финансы сумма идёт в валюте вашей мастерской по курсу дня, когда заказ впервые появился в портале. Курс потом не меняется. Две витрины в одном подключении дают заказы с разными валютами и курсами.
• Склад. Связанное изделие списывается один раз при появлении заказа, при отмене остаток возвращается один раз. Заказ, пришедший уже выполненным, склад не списывает.
• Срок. Дата, до которой нужно отправить заказ, попадает в карточку заказа, календарь и «Дела».
• Частичная отмена — см. ниже (раздел 7).

Действия на странице заказа

Все действия идут через очередь, результат и понятная подсказка при ошибке видны в «Журнале».

• «Собрать» (отметить отправленным). Kaufland принимает отправку только с трек-номером и кодом перевозчика, поэтому окно «Собрать» для Kaufland показывает поля «Трек-номер» (можно несколько) и «Код перевозчика». Частые перевозчики выбираются из списка: DHL, DPD, GLS, Hermes, UPS, DHL_FREIGHT, Deutsche Post, PostNL; других нет в списке: выберите «Другой» и впишите код как в Seller Portal. Если в заказе мастерской уже есть трек-номер, он подставляется сам. Без трека и кода кнопка недоступна. Отмечаются все ещё не отправленные штуки заказа; уже отправленный заказ повторно не отправляется.
• Отмена. Причина выбирается из списка Kaufland (10 причин: «Нет в наличии», «Покупатель попросил отменить», «Ошибка в цене» и другие). Комментария у отмены Kaufland нет. Отменяются только штуки, которые ещё не отправлены.

6. Остатки и цены

• Выгружается одна витрина — основная. Остатки и цены остальных витрин портал не трогает.
• Цены уходят в валюте основной витрины. Если основная витрина польская, цены отправляются в злотых, если чешская — в кронах. Проверьте, что цена в портале соответствует этой валюте.
• Товар Kaufland находится по артикулу (id offer), а если его нет, по EAN.
• Пачки до 150 товаров за запрос; ответ Kaufland разбирается по каждому товару, ошибка одного не останавливает остальные.
• Выгрузка идёт только при включённых переключателях «Остатки»/«Цены», открытой записи на площадку и снятой паузе подключения.

7. Ограничения

• Остатки и цены выгружаются только на основную витрину.
• Частичная отмена. Если покупатель или Kaufland отменили часть штук заказа, в отправлении площадки остаются только оставшиеся штуки. Отмена части позиции уменьшает количество изделий и выручку заказа на отменённые штуки.
• Создать или изменить карточку товара нельзя: только в Seller Portal. Тикеты и этикетки Kaufland Shipment Solutions не поддерживаются.
• Возврат не пополняет склад сам: проверьте изделие и верните его вручную.
• Живой кабинет Kaufland пока проверяется.

8. Частые ошибки

9. Безопасность

• Ключи хранятся в зашифрованном виде и не показываются после сохранения; в запросы Kaufland уходит только подпись, не сам Secret Key.
• Запись в Kaufland включается отдельно: по умолчанию портал только читает.
• Подключение можно поставить на паузу.
• Запросы к Kaufland идут через сервер портала в Финляндии.
• Права: «Заказы площадок», «Товары на площадках», «Финансы площадок».

10. Изменения

• 26.10.2026 — первая версия инструкции.