Caucasus ERP
ERP и автоматизация

Kaspi.kz и учётная система: как связать магазин, заказы и остатки

Автор: Ачо Сванидзе, сооснователь Caucasus ERPОпубликовано 9 мин чтения

Коротко

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

Зачем связывать Kaspi Магазин с учётной системой

Пока заказов десять в день, продавец справляется вручную: смотрит заказы в кабинете Kaspi, проверяет остаток на полке, вечером переносит продажи в учёт. Проблемы начинаются, когда растёт число товаров, складов или каналов продаж. Товар продали в розничном магазине, а на Kaspi он всё ещё «в наличии». Покупатель оформил заказ, продавец отменяет его с причиной «Товара нет в наличии», и такие отмены портят показатели магазина. Бухгалтер в конце месяца сверяет выплаты Kaspi Pay с заказами по выпискам и не может понять, откуда разница.

Интеграция решает три задачи:

  1. Остатки и цены из учётной системы автоматически попадают на Kaspi по каждому складу или пункту выдачи.
  2. Заказы с Kaspi автоматически появляются в учётной системе, резервируют товар и идут в сборку.
  3. Деньги и документы сходятся: продажа, комиссия 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 сверяются по каждому заказу.

Схема интеграции: чек-лист перед запуском

  1. Справочник складов. Сопоставьте каждый склад и пункт выдачи в «Складах и магазинах» Kaspi со складом в учётной системе.
  2. Артикулы. Проверьте, что внутренние артикулы укладываются в 20 символов из цифр и латиницы и уникальны. Кириллица и пробелы в артикулах ломают сопоставление.
  3. Цены. Решите, одна цена на всю страну или разные по городам, и заведите соответствующие прайс-листы.
  4. Свободный остаток. Выгружайте остаток за вычетом резервов под другие каналы и страхового запаса.
  5. Частота. Обновление XML каждые 10–15 минут, опрос новых заказов через API каждые несколько минут.
  6. Приём заказов. Правило автоматического принятия (например, если товар есть на складе) и очередь заказов на ручную проверку.
  7. Выдача. Экран ввода кода покупателя, связанный со списанием и чеком.
  8. Чек. Подключение онлайн-кассы к событию выдачи.
  9. Сверка. Отчёт «заказы Kaspi против поступлений Kaspi Pay» с комиссией по каждому заказу.
  10. Мониторинг. Уведомление, если загрузка прайса или опрос заказов не прошли.

Как это работает в 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-прайса с ценами и остатками. Полный обмен заказами, статусами и учётом комиссии обычно настраивают при внедрении под процессы конкретного продавца.

Источники

  1. Kaspi Гид: Что такое API в Магазине на Kaspi.kz?
  2. Kaspi Гид: Как получить токен авторизации в Магазине на Kaspi.kz?
  3. Kaspi Гид: Что нужно, чтобы использовать API в Магазине на Kaspi.kz
  4. Kaspi Гид: Как с помощью API получить список моих заказов
  5. Kaspi Гид: Как с помощью API получить основную информацию о заказе по коду
  6. Kaspi Гид: Как с помощью API изменить статус заказа
  7. Kaspi Гид: Как с помощью API изменить статус заказа на «Выдан»
  8. Kaspi Гид: Как с помощью API получить информацию о товарах в заказе
  9. Kaspi Гид: Автоматическая загрузка прайс-листа
  10. Kaspi Гид: Нужно ли давать клиенту фискальный чек за покупку в Магазине на Kaspi.kz (13.03.2025)
  11. Kaspi Гид: Фискальный чек за доставку по городу (01.08.2023)
  12. Kaspi Гид: Какая комиссия за продажи в Магазине на Kaspi.kz (06.01.2026)
  13. Kaspi Гид: Меняется ли комиссия за продажу без НДС (31.12.2025)
  14. Pro1c.kz: Счета-фактуры по новому Налоговому кодексу РК: основные нововведения
  15. Mybuh.kz: Торговля на маркетплейсах: как вести учёт и какой выбрать режим налогообложения (09.01.2026)
  16. Odoo Apps: Kazakhstan Kaspi Price (mp_kaspi_kz_pricing)

Подробнее о внедрении: решения Odoo по отраслям · переход с 1С на Odoo

Поделиться:
Гид: что такое CRM-система простыми словами

Нужна консультация по Odoo?

Написать в WhatsApp

Обсудим Odoo для вашего бизнеса?

  • Бесплатная консультация специалиста
  • Демо Odoo на ваших процессах
  • Ответ в течение одного рабочего дня

Нажимая кнопку, вы соглашаетесь на обработку персональных данных.

или напишите нам в WhatsApp

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

WhatsApp