Как выгрузить цены и наличие товаров на Kaspi.kz?

Выгрузка формирует XML-прайс-лист для Магазина на Kaspi.kz. Прайс-лист обновляет цены и наличие товаров, но не создает карточки: товары, которых нет в каталоге Kaspi, попадают в нераспознанные, и их нужно привязать к карточкам Kaspi вручную в кабинете продавца. Картинки, описания, категории и характеристики в прайс-лист не передаются.

Официальное описание прайс-листа — в Kaspi Гиде.

1. В списке товаров нажмите "Выгрузить"

После загрузки товаров на парсер, находясь на странице со списком товаров, нажмите кнопку "Выгрузить".

Как выгрузить товары на Kaspi.kz - Шаг 1

2. Задайте настройки формата

В появившемся окне выберите формат "Kaspi.kz (XML)" и заполните обязательные настройки: название магазина, ID продавца и коды складов. Без них выгрузка завершится ошибкой. Описание каждой настройки — ниже на этой странице.

3. Загрузите прайс-лист в кабинет продавца

Когда файл сформируется, загрузите его в кабинете продавца Kaspi или укажите ссылку на файл для автоматической загрузки. После загрузки проверьте нераспознанные товары и привяжите их к карточкам Kaspi.

Товары, которых нет в прайс-листе, снимаются с продажи

Если товар продавца не попал в прайс-лист, Kaspi снимает его с продажи. Поэтому товары не в наличии не исключаются из файла, а выгружаются с available="no".

Будьте осторожны со всем, что уменьшает число товаров в файле:

фильтрация и удаление товаров, частичная выгрузка — товары, не попавшие в выгрузку, будут сняты с продажи;
разбивка на несколько файлов (по категориям, брендам или числу товаров) — каждый файл становится отдельным прайс-листом. Если Kaspi загружает только один из них, товары из остальных файлов будут сняты с продажи;
товары без цены — Kaspi требует цену, поэтому такие товары в файл не попадают.

Если товар закончился, лучше измените его наличие, а не удаляйте его из выгрузки.

Цены и валюта

Kaspi принимает только целые цены, поэтому цена округляется математически: 99.50 → 100, 100.49 → 100. Валюта при выгрузке не пересчитывается: цена попадает в файл в той валюте, в которой она у товара. Цены на Kaspi указываются в тенге, поэтому перед выгрузкой приведите их к тенге модификаторами цен: конвертацией валюты или изменением цен.

Наличие и остатки

Для каждого склада из настройки "Коды складов" выгружается отдельный тег availability с одинаковыми значениями. Товар в наличии получает available="yes", не в наличии — available="no". Если наличие у товара неизвестно, он считается в наличии.

Остаток stockCount выгружается из поля "Остаток", только если он известен. Срок предзаказа preOrder — из настройки "Предзаказ" для товаров в наличии.

Код товара (sku)

Kaspi принимает в sku только латинские буквы и цифры, не длиннее 20 символов, и sku должен быть уникальным в файле. По умолчанию sku строится из артикула: из него убираются все символы, кроме латинских букв и цифр (например, AB-12/3 → AB123). Если артикула нет, в нем есть русские буквы, он длиннее 20 символов или sku уже занят другим товаром, используется код из 20 символов, построенный по артикулу или ссылке на товар. Такой код не меняется между выгрузками.

Kaspi различает товары по sku, поэтому после привязки товаров не меняйте настройку "Формировать sku из" и артикулы товаров: иначе Kaspi примет их за новые товары.

Вариации

Если у товара есть характеристики с несколькими значениями (например, несколько цветов или размеров), для каждой комбинации значений выгружается отдельный товар. К названию model через запятую добавляются значения характеристик, например "Платье, Красный, 44". Код sku вариации строится по артикулу (или ссылке) и значениям характеристик. Цена и наличие у всех вариаций одинаковые.

Бренд

Тег brand заполняется брендом товара. Тег обязателен, поэтому если бренда нет, выгружается "Без бренда". Задать бренд можно в редактировании товаров.

Настройки формата

Название магазина (company) — название вашего магазина на Kaspi. Обязательная настройка.

ID продавца (merchantid) — ID продавца из кабинета Kaspi. Обязательная настройка.

Коды складов через запятую — коды складов и пунктов выдачи из раздела "Склады и магазины" в кабинете Kaspi, например PP1, PP2. Обязательная настройка.

Предзаказ, дней — через сколько дней товар будет у вас после заказа: целое число от 0 до 30. Оставьте пустым, если товары есть на складе.

Формировать sku из — способ построения кода товара: из артикула, из хеша артикула или из хеша ссылки на товар.

Общие настройки

Разбить на несколько файлов — позволяет разбить выгрузку на несколько файлов: по категориям или по брендам.

Разбить по числу товаров — максимум товаров в одном файле. Например, при значении 5000 первые 5000 товаров попадут в первый файл, следующие — во второй (с окончанием --2) и т.д. Работает вместе с разбивкой по категориям и брендам: лимит действует внутри каждого файла категории или бренда. Пустое значение — без ограничения.

Файловое хранилище — позволяет сделать выгрузку файлов в произвольное хранилище на FTP или S3 (подробнее)

Нашли ошибку в выгрузке в этот формат?

Если вы обнаружили ошибку в формате выгрузки Kaspi.kz (XML), пожалуйста, сообщите нам на почту или в чат на сайте. Мы постараемся исправить выгрузку как можно скорее.