Kaspi.kz и учётная система: как связать магазин, заказы и остатки
Автор: Ачо Сванидзе, сооснователь Caucasus ERPОпубликовано 9 мин чтения
Коротко
- Kaspi Магазин даёт продавцу два канала для интеграции: API (заказы, статусы, карточки товаров) и автоматическую загрузку прайс-листа в XML (цены и остатки по складам).
- Прайс-лист по ссылке Kaspi проверяет каждые 60 минут и загружает, если файл изменился. Значит, остатки на Kaspi отстают от учётной системы не больше чем на час, если файл обновляется вовремя.
- Заказы забираются через API, а перевод в статус «Выдан» требует кода, который покупатель получает в приложении Kaspi.kz.
- Фискальный чек за покупку в Kaspi Магазине продавец выдаёт сам, когда деньги поступили на счёт Kaspi Pay, то есть после статуса «Выдан».
- В стандартном Odoo нет коннектора к Kaspi. Его делают при внедрении: импорт заказов, выгрузка цен и остатков, статусы и учёт комиссии.

Зачем связывать Kaspi Магазин с учётной системой
Пока заказов десять в день, продавец справляется вручную: смотрит заказы в кабинете Kaspi, проверяет остаток на полке, вечером переносит продажи в учёт. Проблемы начинаются, когда растёт число товаров, складов или каналов продаж. Товар продали в розничном магазине, а на Kaspi он всё ещё «в наличии». Покупатель оформил заказ, продавец отменяет его с причиной «Товара нет в наличии», и такие отмены портят показатели магазина. Бухгалтер в конце месяца сверяет выплаты Kaspi Pay с заказами по выпискам и не может понять, откуда разница.
Интеграция решает три задачи:
- Остатки и цены из учётной системы автоматически попадают на Kaspi по каждому складу или пункту выдачи.
- Заказы с Kaspi автоматически появляются в учётной системе, резервируют товар и идут в сборку.
- Деньги и документы сходятся: продажа, комиссия Kaspi, фискальный чек и поступление на счёт видны в одном месте.
Какие каналы обмена даёт Kaspi
У Kaspi Магазина два официальных механизма, и в хорошей интеграции обычно используются оба.
API Магазина на Kaspi.kz
API позволяет добавлять товары, управлять заказами, получать данные о заказах и подключать собственную учётную систему. Данные передаются в формате JSON, авторизация идёт через заголовок X-Auth-Token.
Токен формирует руководитель компании в веб-версии кабинета продавца: Настройки, раздел «Токен API», кнопка «Сформировать». Kaspi предупреждает, что токен не меняется со временем и даёт доступ к заказам и товарам, поэтому его стоит хранить в учётной системе как секрет, а не пересылать в мессенджерах.
Что умеет API по заказам (по разделу «API» в Kaspi Гиде):
- получать список заказов с фильтрами по состоянию, статусу, дате создания и способу доставки, до 100 заказов на страницу;
- получать состав заказа: товары, количество, цену, стоимость доставки, пункт выдачи;
- принимать заказ, отменять его с указанием причины, отмечать сборку и выдачу;
- формировать накладную для передачи заказа в Kaspi Доставку;
- указывать IMEI для телефонов.
По товарам API позволяет получить схему и характеристики категории, добавить товар, проверить результат загрузки и добавить штрихкод.
Автоматическая загрузка прайс-листа (XML)
Второй канал нужен для цен и остатков. Продавец размещает XML-файл на своём HTTP- или HTTPS-сервере и указывает ссылку в кабинете: Товары, «Загрузить прайс-лист», «Автоматическая загрузка». Kaspi проверяет файл каждые 60 минут и загружает его, если в нём есть изменения.
Основные поля файла:
| Поле | Что означает | Откуда брать в учётной системе |
|---|---|---|
sku | Артикул продавца, до 20 символов, цифры и латинские буквы, уникален в прайсе | Внутренний артикул товара |
model, brand | Наименование и бренд | Карточка товара |
availabilities | Наличие по складам: available (yes/no), storeId, stockCount, preOrder | Свободный остаток по складу |
storeId (внутри availability) | Код склада или магазина из раздела «Склады и магазины» | Соответствие складов Kaspi и складов учёта |
cityprices / price | Цены по городам (с НДС, целым числом) или одна цена | Прайс-листы учётной системы |
Важная деталь: из-за часового цикла остаток на Kaspi всегда немного отстаёт от реального. Поэтому учётная система должна пересобирать файл часто, а для ходовых товаров лучше выгружать не весь остаток, а остаток минус страховой запас.
Жизненный цикл заказа и что делает учётная система
У заказа Kaspi два параметра: состояние (state: NEW, SIGN_REQUIRED, PICKUP, DELIVERY, KASPI_DELIVERY, ARCHIVE) и статус (status). Учётной системе важнее статус:
| Статус Kaspi | Что произошло | Что должно произойти в учёте |
|---|---|---|
APPROVED_BY_BANK | Банк одобрил покупку, заказ ждёт продавца | Создать заказ клиента, проверить остаток, принять или отменить |
ACCEPTED_BY_MERCHANT | Продавец принял заказ | Зарезервировать товар, отправить в сборку |
COMPLETED | Товар выдан покупателю | Списать товар со склада, отразить выручку, выдать фискальный чек |
CANCELLED | Заказ отменён | Снять резерв, закрыть заказ |
CANCELLING, KASPI_DELIVERY_RETURN_REQUESTED, RETURNED | Отмена в процессе, ожидание возврата или возврат | Ждать товар, оприходовать возврат, при необходимости сторнировать выручку |
При отмене продавец указывает одну из трёх причин: покупатель отменил заказ, не удалось связаться с покупателем или товара нет в наличии. Последняя причина как раз и появляется, когда остатки на Kaspi и на складе расходятся.
Статус «Выдан» и код покупателя
Перевести заказ в COMPLETED через API можно только с кодом покупателя. Первый запрос с пустым заголовком X-Security-Code и заголовком X-Send-Code: true отправляет код покупателю в мобильное приложение Kaspi.kz. Покупатель называет код, и второй запрос с этим кодом завершает заказ. На практике это поле ввода кода на экране выдачи в учётной системе: кладовщик или продавец пункта выдачи вводит код, и в одной операции закрываются заказ на Kaspi, списание со склада и чек.
Деньги, чек и комиссия: что важно бухгалтеру
Фискальный чек выдаёт продавец
По Kaspi Гиду, продавец обязан иметь ККМ и выдавать фискальный чек за каждую покупку в Магазине, оплаченную Kaspi Gold, Kaspi Red+ или Kaspi Kredit. В чеке указывается только стоимость товара, а способ оплаты отмечается как оплата картой. Выдать чек нужно, когда деньги поступили на текущий счёт Kaspi Pay, а это происходит после статуса «Выдан». Подходит бумажный чек, его фото или электронный чек.
По Kaspi Гиду, покупатель оплачивает доставку продавца по городу, если заказ стоит меньше 5 000 тенге. В этом случае нужен фискальный чек и на стоимость доставки.
Для интеграции это значит: событие COMPLETED должно запускать формирование чека через вашу онлайн-кассу. Если касса не связана с учётом, чеки по заказам Kaspi приходится пробивать вручную, и именно здесь чаще всего возникают пропуски. Про выбор кассы и связь с ОФД читайте в статье POS-система для магазина.
ЭСФ по продажам физлицам
С 2026 года случаи, когда счёт-фактуру можно не выписывать, определяет статья 491 нового Налогового кодекса. По общему правилу ЭСФ не выписывается при продаже физическим лицам с оплатой через терминал с чеком ККМ или электронным платежом. Исключения установлены пунктом 3 той же статьи со ссылкой на статью 208: это импортированные товары, товары, учтённые в модуле «Виртуальный склад» ИС ЭСФ, и товары, по которым ЭСФ требуют акты, принятые для исполнения международных договоров (например, товары из Перечня изъятий). Для таких товаров освобождение действует в более узких случаях, например при продаже физическим лицам для личного, семейного или домашнего потребления. Если вы продаёте их на Kaspi, подробнее читайте в статье Виртуальный склад ИС ЭСФ. Окончательно проверьте свою номенклатуру с бухгалтером.
Комиссия Kaspi
Комиссия фиксированная и зависит от категории товара. Она взимается только за продажу: если покупатель отменит заказ, комиссия вернётся на счёт компании. В период акций с рассрочкой 0-0-24 комиссия может меняться по условиям акции. Ставки собраны в таблице тарифов в Kaspi Гиде. Kaspi отображает комиссию за продажу без НДС, и, по Kaspi Гиду, комиссия без НДС не меняется (ответ обновлён 31.12.2025, перед сменой ставки НДС с 2026 года).
Для учёта важно не сворачивать продажу и комиссию в одну сумму: выручка отражается в полной сумме продажи, а комиссия маркетплейса отдельным расходом (так описывает учёт маркетплейсов Mybuh.kz). Тогда маржа по товару и по каналу считается правильно, а выплаты Kaspi сверяются по каждому заказу.
Схема интеграции: чек-лист перед запуском
- Справочник складов. Сопоставьте каждый склад и пункт выдачи в «Складах и магазинах» Kaspi со складом в учётной системе.
- Артикулы. Проверьте, что внутренние артикулы укладываются в 20 символов из цифр и латиницы и уникальны. Кириллица и пробелы в артикулах ломают сопоставление.
- Цены. Решите, одна цена на всю страну или разные по городам, и заведите соответствующие прайс-листы.
- Свободный остаток. Выгружайте остаток за вычетом резервов под другие каналы и страхового запаса.
- Частота. Обновление XML каждые 10–15 минут, опрос новых заказов через API каждые несколько минут.
- Приём заказов. Правило автоматического принятия (например, если товар есть на складе) и очередь заказов на ручную проверку.
- Выдача. Экран ввода кода покупателя, связанный со списанием и чеком.
- Чек. Подключение онлайн-кассы к событию выдачи.
- Сверка. Отчёт «заказы Kaspi против поступлений Kaspi Pay» с комиссией по каждому заказу.
- Мониторинг. Уведомление, если загрузка прайса или опрос заказов не прошли.
Как это работает в Odoo
Что есть в стандарте. Odoo закрывает учётную сторону: Продажи (заказ клиента с резервом), Склад (несколько складов, маршруты, резервирование, возвраты), Бухгалтерия с казахстанской локализацией l10n_kz (план счетов, налоги, в шаблоне есть ставки 12%, 20%, 0% и освобождение; актуальную ставку НДС 16% добавляем при внедрении). Прайс-листы позволяют держать разные цены по городам, а внутренний артикул товара становится sku для Kaspi.
Чего нет в стандарте. Готового коннектора к Kaspi.kz в Odoo нет. В магазине приложений Odoo есть сторонние модули, например платный модуль, который собирает XML-прайс с ценами и остатками. Но он решает только выгрузку каталога: заказы, статусы, чеки и комиссия остаются за рамками.
Что мы делаем при внедрении. Caucasus ERP настраивает обмен с Kaspi под процессы продавца:
- XML-прайс с ценами и свободными остатками по каждому складу Kaspi, который Odoo пересобирает по расписанию;
- импорт заказов через API в заказы клиента Odoo с резервом на нужном складе;
- автоматическое или ручное принятие и отмену заказа с причиной;
- экран выдачи с кодом покупателя, который одновременно закрывает заказ на Kaspi и проводит отгрузку;
- связку с онлайн-кассой для чека по выданным заказам и учёт комиссии Kaspi отдельным расходом;
- обмен с ИС ЭСФ там, где он нужен по вашей номенклатуре.
Если вы сейчас ведёте учёт в 1С и думаете о переходе, посмотрите пошаговый план перехода с 1С на Odoo.
Когда интеграция не нужна
Если у вас несколько десятков заказов в месяц, один склад и Kaspi единственный канал продаж, кабинета продавца и ручной загрузки прайса может хватить. Интеграция окупается, когда товаров сотни, складов или каналов несколько (розница, свой сайт, оптовые клиенты), когда отмены из-за отсутствия товара становятся регулярными или когда бухгалтерия тратит дни на сверку выплат. Ещё один момент: API Kaspi описан в Kaspi Гиде на уровне отдельных запросов, а лимиты частоты запросов в этих материалах мы не нашли. Поэтому интеграцию стоит строить с запасом по нагрузке и повторными попытками.
Хотите увидеть обмен с Kaspi на демо-базе Odoo? Оставьте заявку на странице для Казахстана, и мы покажем заказы, остатки и отчёт по сверке.
FAQ
Кто может получить API-токен Kaspi Магазина?
По Kaspi Гиду, токен формирует только руководитель компании в веб-версии кабинета продавца: Настройки, раздел «Токен API», кнопка «Сформировать». Токен не меняется со временем. Сообщайте его только техническому специалисту своей компании: любой, у кого есть токен, получает доступ к заказам и товарам кабинета.
Как часто обновляются остатки на Kaspi при автоматической загрузке прайс-листа?
Kaspi забирает XML-файл по вашей ссылке каждые 60 минут и загружает его, если в нём есть изменения. Поэтому учётная система должна обновлять файл чаще, например каждые 10–15 минут, а для быстро заканчивающихся товаров стоит держать страховой запас.
Можно ли автоматически переводить заказ Kaspi в статус «Выдан»?
Через API можно, но только с кодом покупателя. Первый запрос с пустым заголовком X-Security-Code отправляет покупателю код в мобильное приложение Kaspi.kz, второй запрос с этим кодом завершает заказ. Обычно сотрудник вводит код в учётной системе при выдаче товара.
Нужно ли выписывать ЭСФ по продажам физическим лицам через Kaspi Магазин?
По общему правилу ЭСФ при продаже физическим лицам с оплатой электронным платежом или с выдачей чека ККМ не обязателен (статья 491 нового Налогового кодекса). Но для импортированных товаров, товаров из модуля «Виртуальный склад» и товаров по международным договорам (например, из Перечня изъятий) действуют особые правила. Проверьте свою номенклатуру с бухгалтером.
Есть ли готовый модуль Kaspi для Odoo?
В стандартном Odoo его нет. В магазине приложений Odoo есть сторонние модули, например платный модуль для формирования XML-прайса с ценами и остатками. Полный обмен заказами, статусами и учётом комиссии обычно настраивают при внедрении под процессы конкретного продавца.
Источники
- Kaspi Гид: Что такое API в Магазине на Kaspi.kz?
- Kaspi Гид: Как получить токен авторизации в Магазине на Kaspi.kz?
- Kaspi Гид: Что нужно, чтобы использовать API в Магазине на Kaspi.kz
- Kaspi Гид: Как с помощью API получить список моих заказов
- Kaspi Гид: Как с помощью API получить основную информацию о заказе по коду
- Kaspi Гид: Как с помощью API изменить статус заказа
- Kaspi Гид: Как с помощью API изменить статус заказа на «Выдан»
- Kaspi Гид: Как с помощью API получить информацию о товарах в заказе
- Kaspi Гид: Автоматическая загрузка прайс-листа
- Kaspi Гид: Нужно ли давать клиенту фискальный чек за покупку в Магазине на Kaspi.kz (13.03.2025)
- Kaspi Гид: Фискальный чек за доставку по городу (01.08.2023)
- Kaspi Гид: Какая комиссия за продажи в Магазине на Kaspi.kz (06.01.2026)
- Kaspi Гид: Меняется ли комиссия за продажу без НДС (31.12.2025)
- Pro1c.kz: Счета-фактуры по новому Налоговому кодексу РК: основные нововведения
- Mybuh.kz: Торговля на маркетплейсах: как вести учёт и какой выбрать режим налогообложения (09.01.2026)
- Odoo Apps: Kazakhstan Kaspi Price (mp_kaspi_kz_pricing)
Подробнее о внедрении: решения Odoo по отраслям · переход с 1С на Odoo
Нужна консультация по Odoo?
Обсудим Odoo для вашего бизнеса?
- Бесплатная консультация специалиста
- Демо Odoo на ваших процессах
- Ответ в течение одного рабочего дня
Читайте также

Виртуальный склад ИС ЭСФ: остатки и отгрузки | Caucasus ERP
Как работает «Виртуальный склад» ИС ЭСФ в 2026 году: откуда берутся остатки, почему не выписывается ЭСФ или СНТ, формы списания и детализации, сверка с ERP.
Ачо Сванидзе · · 9 мин чтения

POS-система для магазина: как выбрать в 2026 | Caucasus ERP
Как выбрать POS-систему для магазина: фискализация через ОФД, коды НКТ и ИКПУ в чеке, работа без интернета, связь со складом. Чек-лист и разбор Odoo POS.
Ачо Сванидзе · · 9 мин чтения

Переход с 1С на Odoo в Казахстане: пошаговый план | Caucasus ERP
Как перейти с 1С на Odoo в Казахстане: восемь шагов, перенос остатков, дата перехода, ИС ЭСФ, Виртуальный склад, зарплата и что оставить в 1С на время.
Ачо Сванидзе · · 8 мин чтения