Как выгрузить товары на Kaspi Магазин: пошаговая инструкция для продавца
Разбираем выгрузку товаров на Kaspi Магазин: как подготовить каталог, заполнить Excel, выбрать XML или API, исправить ошибки и синхронизировать цены с остатками.

Выгрузить товары на Kaspi Магазин можно вручную через шаблон Excel или автоматизировать обмен через XML-фид и API. Для небольшого каталога достаточно подготовить категории, SKU, цены, остатки, фотографии и обязательные характеристики. При сотнях позиций лучше связать площадку с учётной системой или интернет-магазином, чтобы не обновлять данные вручную.
Что подготовить до выгрузки товаров на Kaspi Магазин
Перед первой загрузкой соберите единую таблицу товаров и проверьте её по актуальному шаблону Kaspi. В ней должны быть уникальные SKU, корректные категории, реальные цены и остатки, рабочие ссылки на изображения и обязательные характеристики. Если данные уже хранятся в 1С или CRM, сначала очистите их от устаревших позиций.
Не начинайте с копирования случайного прайс-листа поставщика. В нём часто смешаны внутренние артикулы, закупочные цены, старые остатки и названия, понятные только менеджеру. Для маркетплейса нужна товарная база, которую сможет обработать система и без дополнительного объяснения понять покупатель.
- Название - бренд, модель, тип товара и существенная характеристика. Например: «Смартфон Samsung Galaxy A55 256 ГБ, чёрный». Не добавляйте рекламные обещания, номера телефонов и слова вроде «самый лучший».
- SKU - уникальный артикул, который не меняется при каждом обновлении. Один SKU нельзя присваивать двум цветам, размерам или комплектациям, если они продаются как отдельные позиции.
- Категория - выбирайте раздел из актуального дерева Kaspi, а не ближайшее значение из своей CMS. Набор обязательных характеристик зависит от категории.
- Цена - конечная цена продажи в тенге. Проверьте, не попали ли в ячейку символ ₸, текст, лишние пробелы или цена поставщика вместо розничной.
- Остаток - фактическое количество доступных единиц. Если товар находится на другом складе или продаётся под заказ, это должно соответствовать настройкам магазина и реальному процессу исполнения.
- Фото и описание - изображения должны открываться по рабочим ссылкам, а текст описывать именно эту модификацию. Не используйте одну фотографию для разных цветов, если внешний вид заметно отличается.
Требования к длине описания, формату фотографий и обязательным атрибутам могут различаться по категориям. Ориентируйтесь на шаблон и подсказки в кабинете продавца. Если для товара нужны документы или подтверждение соответствия, подготовьте сведения заранее. Позиции из категорий с дополнительными ограничениями могут отклонить даже при корректном файле.
Какой способ выгрузки выбрать: Excel, XML или API
Excel подходит для первого запуска и небольшого ассортимента, XML - для регулярного обновления каталога, а API - для связи с учётной системой, сайтом и заказами. Если товаров несколько десятков и цены меняются редко, ручной загрузки достаточно. При сотнях позиций таблицы становятся неудобными, особенно при нескольких складах.
| Способ | Когда использовать | Что потребуется | Ограничение |
|---|---|---|---|
| Excel | Старт, тестовый ассортимент, редкие изменения | Шаблон Kaspi и подготовленная таблица | Цены и остатки нужно обновлять вручную |
| XML-фид | Сотни товаров и регулярные изменения | Генерация файла и стабильный адрес на сервере | Нужно сопоставить поля и категории |
| API | Связь с сайтом, ERP, 1С или своей системой | Разработка интеграции и доступы | Требует технической настройки и контроля обмена |
Excel не означает плохую организацию. Это рабочий вариант, если каталог небольшой, а остатки контролирует один сотрудник. При нескольких складах, продажах через офлайн-точку и частом изменении цен задержка между реальным остатком и данными в Kaspi становится причиной отмен и обращений покупателей.
XML-фид обычно формирует сайт, учётная программа или отдельный сервис. Kaspi получает данные по указанному адресу, поэтому файл должен быть доступен без авторизации и не менять URL после каждого обновления. API требует больше работ на старте, зато позволяет передавать изменения без ручной загрузки.
Пошаговая инструкция: как загрузить товары через Excel
Для ручной загрузки откройте кабинет продавца, перейдите в раздел товаров и скачайте актуальный шаблон для нужной категории или операции. Заполняйте его без переименования столбцов, сохраните в поддерживаемом формате и загрузите обратно. После обработки откройте отчёт: факт отправки файла ещё не означает публикацию всех позиций.
- 1. Сформируйте исходную таблицу. Оставьте только товары, которые готовы к продаже: с понятной ценой, остатком, комплектностью и описанием.
- 2. Скачайте шаблон из кабинета Kaspi. Не используйте старый файл из переписки или предыдущей загрузки: набор полей и подсказки могли измениться.
- 3. Сопоставьте свои поля с колонками шаблона. Отдельно проверьте обязательные характеристики категории, варианты цвета, размера, объёма и комплектации.
- 4. Заполните SKU, название, категорию, цену, остаток, описание и ссылки на фото. Дополнительные обязательные поля также должны содержать значения.
- 5. Проверьте таблицу фильтрами. Найдите пустые ячейки, повторяющиеся SKU, нулевые или отрицательные остатки, подозрительно низкие цены и нерабочие ссылки.
- 6. Сохраните файл в требуемом формате и загрузите через кабинет. Дождитесь статуса обработки, не закрывая страницу сразу после отправки.
- 7. Скачайте отчёт об ошибках и исправьте исходную таблицу. После повторной загрузки убедитесь, что изменения применились к нужным карточкам, а не создали дубликаты.
Фото в Excel чаще всего передаются не вложением, а ссылкой. Откройте её в режиме инкогнито или на устройстве, где вы не авторизованы на своём сайте. Если изображение видно только после входа в админку, Kaspi его не прочитает. Для основного снимка выбирайте чистый фон, а дополнительные фотографии используйте для деталей, размера и комплектации.
После публикации проверьте карточку глазами покупателя: название, цену, наличие, характеристики, фотографии и способ доставки. Найдите товар через поиск Kaspi, а не только по прямой ссылке. Так можно заметить неправильную категорию, неудачный заголовок или отсутствие позиции в выдаче.
Как настроить XML или API для автоматической синхронизации
Автоматическая выгрузка нужна, когда данные меняются чаще, чем сотрудник успевает обновлять Excel. Сначала определите источник правды - 1С, складская программа, сайт или ERP, - затем сопоставьте его поля со структурой Kaspi. Тестируйте обмен на небольшой группе товаров и только после проверки подключайте весь каталог.
Для XML порядок обычно такой: система формирует файл по требованиям Kaspi, размещает его на постоянном адресе, а продавец указывает этот адрес в настройках кабинета. Сервер должен стабильно отвечать, не требовать логин и пароль и отдавать актуальную версию файла. При сбое генерации нужен контроль даты и результата обновления.
API имеет смысл, если требуется синхронизировать не только товары, но и заказы, статусы, остатки по складам или правила расчёта цен. Это не настройка одной кнопки. Разработчик получает доступы, изучает документацию, обрабатывает ошибки, предусматривает повторную отправку запросов и сохраняет журнал изменений.
- Определите, где хранится актуальный остаток. Если сайт показывает одно число, а менеджер ведёт другое, автоматизация будет передавать ошибку быстрее.
- Задайте правила округления и минимальной цены. Формула скидки или наценки не должна случайно превращать цену в ноль.
- Разделите товары по статусам: в наличии, под заказ, снят с продажи. Удаление строки из фида не всегда равно корректному отключению карточки.
- Настройте журнал обмена. В нём должны быть время запуска, количество отправленных позиций, ошибки и причина отказа.
- Проведите тест на товарах разных типов. Отдельно проверьте вариации, наборы, размеры и позиции с несколькими фотографиями.
Если интернет-магазин уже работает, интеграцию можно строить от его каталога, но только при актуальных данных. Мы не советуем автоматически передавать весь каталог без очистки: устаревшие товары, неправильные остатки и неполные характеристики создают больше проблем, чем решают.
Почему Kaspi отклоняет товары и как исправить ошибки
Чаще всего товары отклоняют из-за несовпадения данных: неверной категории, пустого обязательного поля, повторяющегося SKU или недоступного фото. Сначала прочитайте отчёт Kaspi и исправьте конкретную причину, а не перезаливайте тот же файл. Если ошибок много, проверьте структуру исходного каталога целиком и найдите общий источник проблемы.
| Ошибка | Что проверить | Как исправить |
|---|---|---|
| Неверная категория | Раздел товара и обязательные характеристики | Выбрать категорию из актуального справочника Kaspi |
| Дублирующийся SKU | Повторы артикулов в таблице и учётной системе | Назначить каждому товару уникальный SKU |
| Не заполнено обязательное поле | Пустые ячейки и поля из шаблона | Добавить значение или отложить позицию |
| Некорректная цена | Текст, пробелы, символ валюты, разделитель | Оставить числовое значение в тенге |
| Фото не загружается | Открытие ссылки без авторизации и адрес | Разместить фото на доступном сервере |
| Карточка не публикуется | Ограничения категории и документы | Проверить правила и подготовить сведения |
Отдельно проверяйте запятые и точки в числах. При переносе данных из Excel цена может стать текстом, а остаток - дробным значением. Не маскируйте проблему добавлением случайных символов или изменением названия столбца. Шаблон нужно заполнять в формате, который ожидает система.
Если после исправлений карточка всё равно не появляется, проверьте остаток, цену, категорию и дополнительные требования к товару. Сохраните отчёт и точный текст ошибки. С такой информацией проще обратиться в поддержку или передать задачу разработчику, чем описывать проблему общими словами.
Как оформить карточку, чтобы товары находили и покупали
Корректная выгрузка только публикует товар, но не гарантирует продажи. На выбор покупателя влияют цена, наличие, рейтинг продавца, полнота характеристик, фотографии, отзывы и обработка заказа. Сначала приведите в порядок базовые данные, затем сравните карточку с аналогичными предложениями в своём регионе и проверьте, нет ли лишних обещаний.
Название должно отвечать на запрос, а не выглядеть рекламным слоганом. Для одежды укажите бренд, модель, тип, материал или важную особенность и размер, если он относится к конкретной позиции. Для электроники полезны модель, объём памяти, цвет и комплектация. Не переносите в заголовок весь текст описания.
В описании снимите основные сомнения: что входит в комплект, для кого подходит товар, какие есть ограничения, размеры, гарантия, способ использования и реальные характеристики. Не обещайте того, чего нет в документах или на упаковке. Условия доставки и самовывоза должны совпадать с реальным процессом исполнения.
- Сравните итоговую цену с аналогичными предложениями, включая стоимость доставки и условия акции.
- Проверяйте остатки утром и после заметных продаж, если синхронизация пока ручная.
- Добавьте фотографии упаковки, разъёмов, маркировки или размера, если они помогают отличить модели.
- Не накручивайте отзывы и не просите покупателей нарушать правила площадки. Сосредоточьтесь на корректной обработке заказов и ответах на вопросы.
- Следите за отменами: обещанное наличие, фактический склад и сроки передачи заказа должны совпадать.
Kaspi не заменяет собственный сайт. Маркетплейс даёт готовый канал продаж, но продавец зависит от правил площадки, комиссии, формата карточки и доступных инструментов. Интернет-магазин нужен для бренда, расширенного каталога, SEO и сценариев, которые невозможно разместить внутри маркетплейса.
Сколько стоит автоматизация выгрузки и когда нужен подрядчик
Цена автоматизации зависит от состояния каталога, количества складов, источника данных и состава обмена. Простую ручную загрузку небольшого файла сотрудник может выполнить самостоятельно. XML или API требуют технической настройки, тестирования и контроля ошибок. Точную стоимость разработки нельзя надёжно определить по одному числу товаров без анализа процессов и систем.
Не путайте цену интеграции с разработкой интернет-магазина. Если сайта нет, а ассортимент большой, практичнее создать систему, где каталог редактируется один раз и передаётся в нужные каналы. У нас интернет-магазин стоит от 500 000 ₸, срок - от 30 дней. Цена фиксируется после брифа и зависит от состава функций.
Подрядчик нужен не только при большом количестве товаров. Помощь оправдана, если каталог ведут несколько сотрудников, остатки хранятся в разных местах, были массовые отклонения или продажи идут одновременно через сайт, офлайн-магазин и Kaspi. Поддержка и доработки у нас начинаются от 50 000 ₸ в месяц.
- Попросите показать список работ: очистка каталога, сопоставление категорий, разработка фида, тестирование и контроль после запуска.
- Уточните, кто отвечает за ошибки после обновления требований Kaspi и входит ли их исправление в сопровождение.
- Попросите тестовый отчёт по нескольким товарам, а не обещание загрузить весь каталог за один день.
- Проверьте, где будут храниться доступы, кто владеет кодом интеграции и сможете ли вы сменить подрядчика.
- Не соглашайтесь на решение без резервного сценария. При сбое обмена должен быть понятен порядок восстановления и ручной проверки.
В Pozhidayev мы разрабатываем интернет-магазины на Next.js и React, предусматриваем SEO-структуру, быструю загрузку и удобную админку. На проект действует гарантия 12 месяцев, предусмотрены два бесплатных круга правок. Домен .kz, хостинг и SSL на первый год входят в стоимость разработки. Работаем из Алматы по всему Казахстану, в том числе удалённо.
Частые вопросы
При первой загрузке чаще всего спрашивают о сайте, SKU, лимитах Excel, причинах отсутствия карточки и выборе между ручным обменом и API. Ответы ниже помогут определить следующий шаг, но перед работой всё равно сверяйте требования с текущими подсказками в кабинете Kaspi: отдельные категории и форматы могут обновляться.
- Можно ли выгрузить товары на Kaspi без интернет-магазина? Да. Для небольшого каталога достаточно кабинета продавца и корректно заполненного шаблона Excel. Сайт понадобится позже, если потребуется автоматическое обновление или единая витрина.
- Сколько товаров можно загрузить через Excel? Фактические ограничения зависят от текущего шаблона и правил кабинета. Для небольшого ассортимента ручной файл удобен, а при сотнях позиций стоит оценить XML или API.
- Нужно ли указывать SKU, если артикул уже есть у поставщика? Да, у каждой продаваемой позиции должен быть стабильный уникальный идентификатор. Артикул поставщика можно использовать, если он не повторяется и не меняется.
- Почему товар есть в файле, но его не видно в магазине? Проверьте отчёт обработки, цену, остаток, категорию, обязательные поля и доступность фото. Строка в загруженном Excel не подтверждает успешную публикацию.
- Можно ли одновременно продавать на Kaspi и через свой сайт? Да, но нужен единый источник актуальных цен и остатков. Иначе один товар могут продать дважды или на одной площадке останется старая цена.
- Нужно ли сразу подключать API? Нет. API оправдан при сложной интеграции и постоянных изменениях. Для старта с небольшим ассортиментом сначала наладьте структуру каталога и обработку заказов.
С чего начать выгрузку товаров на Kaspi
Начните с тестовой выборки из 5-10 товаров разных типов и проверьте её по актуальному шаблону Kaspi. Затем загрузите позиции через Excel, изучите отчёт ошибок и только после этого переносите весь ассортимент. Если данные меняются ежедневно, заранее определите источник остатков и решите, нужна ли автоматическая синхронизация.
Мы помогаем подготовить каталог, разработать интернет-магазин и связать его с нужными каналами продаж. Если задача выходит за рамки таблицы, начните с брифа: по нему станет понятно, достаточно ли доработки существующей системы или нужен интернет-магазин с автоматическим обменом.



