WEB3смарт-контракты / dApp / токенизация активовWeb3-разработка →

Интеграция Kaspi Магазина с 1С: прайс, остатки и заказы без ручной работы

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

Ноутбук с каталогом товаров и телефон с новыми заказами: обмен Kaspi Магазина с учётной системой

Если вы продаёте на 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. 1С по расписанию формирует XML-файл с товарами, ценами и остатками. Kaspi прямо пишет, что такой файл можно сгенерировать в 1С.
  2. Файл лежит на вашем сервере и открывается по ссылке http или https.
  3. В веб-версии кабинета продавца ссылка указана в разделе «Товары → Загрузить прайс-лист → Автоматическая загрузка».
  4. 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. Разбор. Смотрим конфигурацию 1С, склады, города, типы цен и то, как сейчас обрабатывают заказы Kaspi.
  2. Таблица соответствий. Артикулы, склады и города 1С против кодов Kaspi. Согласуем с тем, кто ведёт номенклатуру.
  3. Прайс-лист. Настраиваем формирование XML по расписанию и публикацию по ссылке, проверяем загрузку в кабинете: что распознано, а что нет.
  4. Заказы. Подключаем API с вашим токеном, проверяем на копии базы, затем на реальных заказах под наблюдением.
  5. Журнал обмена. Видно, какой заказ или товар не прошёл и почему, ответственный получает уведомление.

Типовая связка двух систем, например 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 с общими остатками.

Читайте также

Обсудим ваш проект?

Ответим, сколько стоит и сколько займёт. Цена фиксируется в договоре.

Ваш выборKaspi магазинот 270 000 ₸
Заявку получает команда, ответим в рабочее время.Цена фиксируется в договоре до оплаты.Созвон, только если попросите.
Заявка на расчёт
Бюджет проекта
Заявка уходит команде. Ответим на почту, без холодных звонков.

Есть задача? Напишите нам.

Опишите проект в WhatsApp или по почте. Ответим в рабочее время и назовём цену после брифа.