Для продавца на Kaspi.kz доступен API Магазина: он позволяет программно получать заказы, управлять товарами и статусами вместо ручной работы в кабинете. Токен авторизации продавец генерирует сам в кабинете (Настройки → Токен API), после чего запросы идут с заголовком X-Auth-Token. На практике интеграция закрывает три задачи: заказы автоматически попадают в CRM или учётную систему, остатки и цены синхронизируются между сайтом, 1С и Магазином, а статусы обновляются без ручного ввода.
Содержание
Зачем интегрироваться, если есть кабинет
Кабинет продавца работает, пока заказов немного. Дальше начинается знакомая картина, и каждая её операция — время сотрудника и источник ошибок. Интеграция превращает ручные операции в фоновые:
Только кабинет
- Менеджер переносит заказы в таблицу или CRM руками
- Остатки в Магазине расходятся с реальным складом
- Цены обновляются с задержкой в день
С интеграцией
- Заказ появился — сделка создалась
- Товар уехал — остаток списался
- Цена изменилась в учёте — обновилась на витрине
Бизнес при этом продолжает пользоваться кабинетом, просто перестаёт дублировать в него данные.
Что даёт API Магазина
Официальный API продавца Kaspi Магазина соответствует спецификации JSON API и предназначен для работы с заказами, товарами и сопутствующими данными. Базовые возможности, на которых строится большинство интеграций:
- Получение списка заказов и их деталей — основа для автоматического создания сделок в CRM или документов в учётной системе.
- Работа со статусами заказов — обновление хода выполнения без ручных действий в кабинете.
- Загрузка и обновление товаров — цены, наличие, характеристики из вашей системы-источника.
Три типовых сценария
По нашему опыту, запросы казахстанского бизнеса сводятся к трём связкам:
- 01Kaspi Магазин
- 02API · X-Auth-Token
- 03CRM
- 041С / склад
Заказы → CRM
- Как работает
- Обращения с Магазина падают в общую воронку рядом с заявками с сайта и из мессенджеров
- Что даёт
- Менеджер работает в одном окне, аналитика по каналам становится честной
Склад ↔ Магазин ↔ сайт
- Как работает
- Один источник правды по остаткам и ценам (чаще всего 1С или учётная система), остальные площадки синхронизируются автоматически
- Что даёт
- Исчезают продажи того, чего нет
Документы и учёт
- Как работает
- По факту заказа формируются нужные документы
- Что даёт
- Данные попадают в бухгалтерию без повторного ввода
Подводные камни
Честно о том, что усложняет такие проекты:
- Ограничения и лимиты платформы: интеграция должна корректно обрабатывать ошибки и повторы, а не «падать» на первом неответе.
- Расхождения данных: нужен журнал операций и понятные правила, чья версия главная при конфликте — иначе разбирательства съедят экономию.
- Изменения на стороне платформы: API живёт своей жизнью, поэтому интеграцию закладывают с запасом на поддержку, а не как разовую работу.
- Доступ: подключиться к API могут только зарегистрированные продавцы Магазина — токен и права проверяются до начала разработки.
Как мы это делаем
Порядок работы стандартный для интеграционных проектов:
Аудит
Что за системы, где источник правды, какие объёмы и какие процессы завязаны.
Проектирование обмена
Какие данные, в какую сторону, как часто, что при ошибках.
Разработка и обкатка
Разработка и обязательная обкатка на тестовых данных.
Перевод боевого потока
Только после обкатки на тестовых данных.
Обязательные части, которые мы не сокращаем:
- Журналирование операций — видно, что прошло и что упало
- Повторные попытки при сбоях
- Уведомления ответственному, когда что-то требует внимания человека
Без них интеграция ломается тихо — и это замечают по расхождению цифр через неделю.
Оценку по вашей задаче даём после брифа: объём зависит от числа систем, качества номенклатуры и требуемой частоты обмена.
