Интеграция Kaspi Магазина с 1С: прайс, остатки и заказы без ручной работы
Как устроен обмен Kaspi Магазина с 1С: XML прайс-лист с ценами и остатками, API заказов и статусов, артикулы, склады, частые сбои и порядок запуска.

Если вы продаёте на Kaspi.kz и ведёте учёт в 1С, рано или поздно кто-то в команде начинает жить между двумя окнами. Утром переносит новые заказы из кабинета продавца в 1С, днём правит цены в Excel и загружает прайс-лист, вечером вспоминает, что последний товар продали в магазине, а на Kaspi он всё ещё «в наличии». Ошибка в одном месте превращается в отмену заказа, а отмены по вине продавца Kaspi учитывает в показателях качества.
Интеграция убирает этот ручной перенос. Но под словом «интеграция» прячутся две разные вещи, и путаница между ними стоит денег. Разбираем, как на самом деле устроен обмен Kaspi Магазина с 1С: что идёт через прайс-лист, что через API, где обычно ломается и в каком порядке это запускать. Факты о Kaspi взяты из Kaspi Гида для партнёров и проверены 16 ноября 2026 года.
Два канала обмена, а не один
У Магазина на Kaspi.kz два независимых способа связаться с вашей учётной системой, и работают они в разные стороны.
| Что передаём | Канал | Направление |
|---|---|---|
| Цены, остатки, наличие по складам, предзаказ | Прайс-лист XML по ссылке | Из 1С на Kaspi |
| Новые заказы, состав, склад, статусы | API продавца | С Kaspi в 1С, статусы обратно |
| Новые карточки товаров, штрихкоды | API товаров | Из вашей системы на Kaspi |
Сам Kaspi в гиде предлагает передавать остатки из системы учёта именно прайс-листом: система учёта выгружает XML-файл на ваш сервер, а ссылку на него вы указываете в кабинете (раздел об остатках). Заказы и их статусы идут через API продавца. Среди систем, с которыми можно интегрировать магазин, Kaspi прямо называет 1С (общие вопросы об API).
Отсюда первое правило: связка 1С с Kaspi это не одна кнопка, а две задачи. Выгрузить каталог и принять заказы.
Прайс-лист: как цены и остатки уходят из 1С на Kaspi
Прайс-лист бывает в двух форматах. Excel подходит, чтобы загрузить данные руками: файл обрабатывается, и каталог обновляется в течение 15 минут. Но Excel недоступен, если у вас разные цены или сроки предзаказа по городам, больше пяти складов или склады названы не PP1-PP5. Чтобы данные обновлялись сами, нужен XML.
Автоматическая загрузка устроена так:
- 1С по расписанию формирует XML-файл с товарами, ценами и остатками. Kaspi прямо пишет, что такой файл можно сгенерировать в 1С.
- Файл лежит на вашем сервере и открывается по ссылке http или https.
- В веб-версии кабинета продавца ссылка указана в разделе «Товары → Загрузить прайс-лист → Автоматическая загрузка».
- Kaspi забирает файл каждые 60 минут, если в нём есть изменения.
Что лежит в файле по каждому товару:
- артикул (sku): только цифры и латинские буквы, до 20 символов, уникальный в пределах прайс-листа;
- название (model) и бренд (brand);
- наличие по складам: код склада (storeId) из раздела «Склады и магазины», есть товар или нет, количество на складе (stockCount) и срок предзаказа в днях, не больше 30;
- цена (price), одна на все города, или цены по городам (cityprices) с кодом города.
Цены по городам и разные сроки предзаказа для складов можно задать только в XML и только если склады находятся в разных городах. Склады в одном городе получают единую цену и срок предзаказа.
Две детали, о которых обычно узнают слишком поздно. Если товар раньше добавляли вручную, его нужно включить в прайс-лист, иначе он будет снят с продажи. А товары из файла, которых ещё нет в продаже, попадают в «Нераспознанные товары → Без привязки», и выставлять их на продажу нужно самостоятельно. Подробности в разделе о прайс-листе.
Артикулы и склады: всё решает сопоставление
Технически сформировать XML из 1С несложно. Сложно договориться, какой товар в 1С соответствует какой карточке на Kaspi. На этом спотыкается большая часть самодельных выгрузок.
- Код товара в 1С не всегда годится в артикул Kaspi. В 1С встречаются кириллица, дефисы, длинные коды. Артикул для Kaspi состоит из латиницы и цифр и не длиннее 20 символов, поэтому часто заводим отдельный реквизит или таблицу соответствий.
- Размеры и цвета. Если в 1С это один товар с характеристиками, а на Kaspi разные позиции, каждой характеристике нужен свой артикул.
- Склады. Каждому складу 1С, с которого вы продаёте на Kaspi, сопоставляется код точки из кабинета. Склад, которого нет в связке, на Kaspi не виден.
- Тип цен. Решите, какой тип цен из 1С уходит на Kaspi, и отдельно, нужны ли цены по городам.
Таблицу соответствий лучше один раз согласовать с тем, кто ведёт номенклатуру в 1С, чем потом выяснять, почему половина ассортимента «не распознана».
Заказы: что даёт API продавца
API продавца работает по токену. Получить его может только руководитель компании: в веб-версии кабинета продавца раздел «Настройки → Токен API», кнопка «Сформировать». Токен не меняется, и любой, у кого он есть, видит заказы и товары вашего кабинета. Поэтому токен хранится в настройках связки, а не пересылается в мессенджерах (как получить токен).
Через API связка может:
- забирать список заказов с фильтрами по состоянию (новые, нужно подписать документы, самовывоз, ваша доставка, Kaspi Доставка, архив) и по дате создания, до 100 заказов на странице;
- принимать заказ: переводить его из статуса APPROVED_BY_BANK («продавец должен принять») в ACCEPTED_BY_MERCHANT;
- получать состав заказа и склад, с которого покупатель заказал товар;
- формировать накладную для передачи заказа на Kaspi Доставку;
- отменять заказ с указанием причины;
- завершать заказ: статус COMPLETED ставится с кодом, который покупатель получает в приложении Kaspi.kz.
В 1С это выглядит так: новый заказ с Kaspi появляется документом заказа с покупателем, товарами и складом, менеджер собирает его в привычном интерфейсе, а статус уходит обратно на Kaspi. Важно, что правила Kaspi запрещают обрабатывать заказы вне кабинета продавца, кроме обработки через API (правила работы). То есть связка через API это нормальный, разрешённый путь, а «перепечатать заказ из кабинета в Excel, а оттуда в 1С» нет.
Есть и API товаров: через него добавляют новые товары на продажу (артикул, название, бренд, код категории, описание, ссылки на фото, характеристики), проверяют результат загрузки и привязывают штрихкоды. Это полезно при большом и часто меняющемся ассортименте. Если новых позиций мало, карточки проще завести в кабинете.
Остатки: где обычно ломается
Задержка между продажей и обновлением. Kaspi забирает прайс-лист раз в 60 минут, если файл изменился. Если тот же товар продаётся в магазине или на сайте, за этот час последняя единица может уйти дважды. Лечится запасом: на последние штуки выгружайте меньше, чем есть на складе, или снимайте позицию заранее.
Отмены. Что происходит с остатком при отмене, зависит от доставки (раздел об остатках). При своей доставке и самовывозе количество обновится автоматически. При Kaspi Доставке в статусах «Новые», «На подписании», «Предзаказ» и «Упаковка» остатки восстановятся сами, а если заказ уже в «Передаче» или передан на Kaspi Доставку, товар нужно забрать из пункта приёма и обновить остатки. Связка должна отражать то же самое в 1С, иначе учёт и витрина разойдутся.
Остатки обязательны не всем, но многим. Тем, кто подключился к Магазину на Kaspi.kz после 21 октября 2025 года или имеет показатели качества на отметке «Плохо» и ниже, указывать количество товара нужно. Остальные могут не указывать, но тогда сами снимают товар с продажи, когда он закончился.
Рейтинг. У Kaspi есть требования к качеству работы продавца: рейтинг от 4 звёзд, отмены по вине продавца ниже 3%, задержки при передаче на Kaspi Доставку меньше 10%, возвраты по качеству ниже 2%. За нарушения возможны ограничения вплоть до прекращения сотрудничества (почему отключают). Неверные остатки быстрее всего бьют по отменам, поэтому точная выгрузка это не удобство, а защита магазина.
Типовой модуль или связка под вашу 1С
Готовые модули обмена с Kaspi есть у партнёров 1С, и для типовой конфигурации с одним складом их часто достаточно. Связку под себя имеет смысл делать, когда:
- конфигурация 1С доработана, и модуль не встаёт без правок;
- складов несколько, цены разные по городам, нужен предзаказ;
- кроме Kaspi есть свой сайт, и остатки должны быть общими (как связать 1С с сайтом, разобрали в статье об интеграции 1С с сайтом);
- учёт ведётся не только в 1С, например склад в МойСклад, а клиенты в CRM;
- после продажи нужно закрывать документы, например счёт-фактуру в ИС ЭСФ.
Если вы только выбираете, где продавать, начните с разбора каналов: Kaspi или свой интернет-магазин и как открыть интернет-магазин в Казахстане. Как 1С работает центром для всех витрин, описано на странице интеграции 1С.
Как мы запускаем связку
- Разбор. Смотрим конфигурацию 1С, склады, города, типы цен и то, как сейчас обрабатывают заказы Kaspi.
- Таблица соответствий. Артикулы, склады и города 1С против кодов Kaspi. Согласуем с тем, кто ведёт номенклатуру.
- Прайс-лист. Настраиваем формирование XML по расписанию и публикацию по ссылке, проверяем загрузку в кабинете: что распознано, а что нет.
- Заказы. Подключаем API с вашим токеном, проверяем на копии базы, затем на реальных заказах под наблюдением.
- Журнал обмена. Видно, какой заказ или товар не прошёл и почему, ответственный получает уведомление.
Типовая связка двух систем, например Kaspi и 1С, стоит от 270 000 ₸. Если складов и витрин больше или 1С сильно доработана, считаем после разбора и фиксируем цену в договоре. Подробнее на странице сколько стоит интеграция 1С с Kaspi. На сделанное даём гарантию 6 месяцев, код и доступы остаются у вас. Со старыми версиями 1С тоже работаем: в проекте Хоту-Ас связали приложение лояльности с 1С 7.7.
Что мы делаем по теме
Коротко и по делу.
Как часто Kaspi обновляет цены и остатки из 1С?
При автоматической загрузке Kaspi забирает XML прайс-лист по вашей ссылке каждые 60 минут, если в файле есть изменения. Excel-файл, загруженный вручную, обрабатывается в течение 15 минут. Поэтому на последние единицы товара стоит оставлять запас.
Можно ли передавать остатки на Kaspi через API?
Для автоматической передачи остатков из системы учёта Kaspi в своём гиде предлагает XML прайс-лист по ссылке. Через API продавца идут заказы и их статусы, через API товаров добавляют новые карточки.
Кто может получить токен API Kaspi?
Только руководитель компании: в веб-версии кабинета продавца, раздел «Настройки → Токен API». Токен не меняется, и с ним видны заказы и товары кабинета, поэтому передавайте его только техническому специалисту.
Сколько стоит интеграция Kaspi Магазина с 1С?
Типовая связка двух систем от 270 000 ₸. Если складов, городов или витрин больше, считаем после разбора конфигурации 1С и фиксируем цену в договоре.
Подойдёт ли готовый модуль вместо своей связки?
Для типовой конфигурации 1С и одного склада часто да. Своя связка нужна, если 1С доработана, складов и городов несколько или кроме Kaspi есть сайт и CRM с общими остатками.
Читайте также
Автоматизация9 мин чтенияИнтеграция 1С с сайтом: как устроен обмен товарами, ценами, остатками и заказамиКак связать 1С с сайтом: типовой обмен CommerceML, OData и HTTP-сервисы, что синхронизировать и как часто, где обмен ломается и что учесть в Казахстане.
Автоматизация7 мин чтенияРазрозненные сервисы тормозят рост: как собрать бизнес в единую системуCRM не знает о складе, склад о сайте, сайт о Kaspi. Разбираем, во что обходятся разрозненные системы, как их связать и с чего начать интеграцию.
Автоматизация9 мин чтенияАвтоматизация бизнес-процессов: что автоматизировать первым и как посчитать окупаемостьКакие процессы автоматизировать первыми, когда хватит роботов CRM, а когда нужна связка с 1С и Kaspi, как посчитать окупаемость и не наделать ошибок.Обсудим ваш проект?
Ответим, сколько стоит и сколько займёт. Цена фиксируется в договоре.