Пока у вас 30 товаров, цены и остатки на Kaspi можно обновлять руками. Когда их становится 500, а продажи идут ещё через сайт, Instagram и офлайн-точку, ручная работа начинает стоить денег. Товар заканчивается на складе, но продолжает висеть на Kaspi. Заказ приходит, а отдать нечего. Отмена бьёт по показателям качества продавца.
Решение одно: связать Kaspi с вашей учётной системой, чтобы данные ходили туда и обратно сами. Ниже разбираем, какие инструменты для этого даёт Kaspi, чем отличаются готовые сервисы от своей интеграции и что поменялось в 2026 году.
Какие инструменты интеграции есть у Kaspi
У Kaspi Магазина два официальных канала автоматизации, и их часто путают.
Первый - прайс-лист в формате XML. Через него передаются товары, цены и остатки. Kaspi сам забирает файл по ссылке, которую вы указываете в кабинете продавца.
Второй - API. Это программный интерфейс, через который ваша система может добавлять товары, получать заказы и управлять ими. Данные передаются в формате JSON.
В нормальной интеграции работают оба канала: прайс-лист отвечает за витрину, API за заказы.
Цены и остатки: XML-прайс-лист
Прайс-лист можно загружать вручную в Excel, но для автоматизации нужен XML. Файл можно выгрузить из кабинета продавца как шаблон, написать вручную или генерировать автоматически, например в 1С. В файле для каждого товара указываются артикул, название, бренд, цена и остатки по складам, которые обозначаются кодами PP1-PP5. Если цены отличаются по городам, используется отдельный формат с кодами городов.
Дальше файл кладут на ваш сервер, а ссылку на него указывают в кабинете: Товары, Загрузить прайс-лист, Автоматическая загрузка. Ваша система обновляет файл, когда меняются цены или остатки, а Kaspi его забирает.
Тут есть две детали, о которых стоит знать заранее.
- Kaspi проверяет XML-файл примерно раз в 60 минут, поэтому новая цена появится на площадке не мгновенно.
- Если товара нет в XML-файле, Kaspi может снять его с продажи.
Поэтому перед включением автозагрузки нужно проверить, что все товары, которые должны продаваться, попадают в выгрузку. Иначе можно за час «потерять» половину каталога.
Заказы: API Kaspi Магазина
Чтобы начать работать с API, руководитель компании формирует токен в веб-версии кабинета продавца: Настройки, Токен API, Сформировать (Kaspi Гид). Сформировать токен может только руководитель (SelSup). Этот токен потом указывается в вашей системе, и храниться он должен так же бережно, как пароль от банка.
Через API можно получать новые заказы и их состав, менять статус на «Выдан», отменять заказ, формировать накладную для Kaspi Доставки, узнавать адрес склада и даже указывать IMEI для телефонов. На практике это значит, что менеджер может работать с заказами Kaspi из своей CRM или 1С и не переключаться между окнами.
Важный момент из правил Kaspi: заказы запрещено обрабатывать вне кабинета продавца, но обработка через API - разрешённое исключение (Kaspi Гид). То есть интеграция через API - это официальный путь, а не обходной.
Честно о сложностях. Документация у Kaspi есть, но API ведёт себя не всегда очевидно. Разработчики, которые интегрировали интернет-магазин Haier с Kaspi, описывали, например, что фильтр по одному статусу заказа возвращает заодно и заказы с другим статусом. Такие вещи выясняются только на тестах, поэтому закладывайте на них время.
Что изменилось в 2026 году
Национальный каталог товаров
С 1 января 2026 года Kaspi Касса интегрирована с Национальным каталогом товаров, а в кабинете Kaspi Магазина у товара можно указать штрихкод GTIN или NTIN, и система найдёт его в каталоге. Сам каталог быстро растёт: к июлю 2026 года в нём было 29 млн товаров, из них 16,2 млн с кодом GTIN.
Для интеграции это значит простую вещь: штрихкоды должны храниться в вашей учётной системе и уходить на Kaspi вместе с остальными данными. Если штрихкоды живут в отдельной таблице у менеджера, их пора перенести.
Тарифы доставки
С 1 января 2026 года стоимость доставки для продавцов зависит от суммы заказа, веса и габаритов, типа доставки и категории товара. Если вы считаете маржу по каждому товару, вес и габариты тоже стоит держать в системе, а не вспоминать при каждом заказе.
Задайте вопрос или оставьте заявку
Пришлите, где сейчас ведётся учёт и сколько у вас товаров. Подскажем, хватит ли готового модуля или нужна своя интеграция.
Отправляя форму, вы соглашаетесь с обработкой персональных данных.
Готовый сервис или своя интеграция
Самый быстрый путь - готовый сервис. У Kaspi есть официальный перечень технологических партнёров, которые занимаются интеграциями, а учётные системы вроде МойСклад предлагают готовые модули для Kaspi. Если вы небольшой продавец, работаете в одной из таких систем и вам нужно просто синхронизировать цены, остатки и заказы, готовый модуль почти всегда выгоднее разработки.
Своя интеграция оправдана, когда процессы не укладываются в стандарт:
- у вас собственная учётная система или самописный сайт;
- товары продаются сразу в нескольких каналах, и остатки нужно делить между ними по правилам;
- цены должны пересчитываться автоматически от закупки, курса и стоимости доставки;
- вам нужна аналитика продаж Kaspi в одной панели с остальными каналами.
В таких случаях готовый модуль начинает мешать, и вы платите за подписку, а работаете всё равно наполовину вручную.
Как проходит разработка
Работа начинается с аудита. Мы смотрим, где сейчас хранятся товары, цены, остатки и штрихкоды, кто и как их меняет, откуда приходят заказы. Очень часто выясняется, что «главная» таблица существует в трёх версиях у трёх сотрудников, и сначала нужно договориться, какая из них правильная.
Потом проектируем обмен: какие данные идут на Kaspi, какие забираем оттуда, как часто, что делать при ошибке. Например, что будет, если товар закончился на складе в ту минуту, когда на него пришёл заказ.
Дальше разработка и тесты на небольшой части каталога. Только когда всё работает на 20-30 товарах, интеграцию включают на весь ассортимент.
Последний этап - мониторинг: система должна сама сообщать, если выгрузка не прошла или Kaspi вернул ошибку, а не ждать, пока это заметит покупатель.
Что дальше
Интеграция с Kaspi окупается тогда, когда ручная работа начинает приводить к отменам, ошибкам в ценах и потерянным заказам. Для простых случаев хватит готового модуля, для нестандартных процессов нужна своя интеграция.
Источники
- Kaspi Гид - что такое API Магазина
- Kaspi Гид - как начать работать с API
- Kaspi Гид - работа с заказами через API
- Kaspi Гид - условия работы продавцов
- Kaspi Гид - XML-прайс-лист
- Kaspi Гид - Kaspi Касса и Национальный каталог товаров
- SelSup - особенности интеграции с Kaspi
- Хабр - опыт интеграции интернет-магазина с Kaspi
- Bizmedia - Национальный каталог товаров, июль 2026
- Digital Business - тарифы доставки Kaspi с 2026 года