API Kaspi изнутри: 5 сбоев, о которых знает интегратор

API Kaspi связывает ваш магазин с системой учёта, и когда связь рвётся, первым обычно ругают интегратора. Евгений Маймышев, директор компании FixCom, которая делает интеграцию Kaspi с МойСклад, в подкасте Артёма Бухонина в ноябре 2024 года рассказал, что видит его команда с технической стороны. Часть сбоев, по его словам, возникает на стороне Kaspi, и продавцу полезно уметь это отличать.

Коротко: API Kaspi отдаёт данные о заказах и товарах по запросу системы учёта, до 100 заказов за ответ. По словам Евгения Маймышева из FixCom, на момент записи дубли и долгое обновление статусов были связаны с тем, как API отдаёт заказы, а сбой у владельцев нескольких кабинетов начался после изменения Kaspi без предупреждения. Прежде чем менять интегратора, сверьте заказ в кабинете продавца.

Содержание

1. Как API Kaspi связывает магазин с учётом
2. Почему в учёте появляются дубли и чужие статусы
3. Изменения без предупреждения и сбой у нескольких кабинетов
4. Почему интеграторам трудно тестировать
5. 5 шагов, если синхронизация с Kaspi сломалась
6. Вопросы и ответы

FixCom пишет интеграции между системами учёта, и сейчас, по словам Евгения, ключевое направление компании маркетплейсы. Их приложение для связки Kaspi и МойСклад, по его оценке, входит в пятёрку самых популярных в магазине приложений МойСклад. Установок больше 1 000, активных пользователей больше 300. Сам Евгений не разработчик: он описывает процессы и логику, а код пишет команда.

Как API Kaspi связывает магазин с учётом

API Kaspi работает как переписка по строгому списку тем. Евгений объяснил это на примере WhatsApp: система учёта отправляет Kaspi сообщение, Kaspi отвечает. Спрашивать можно только то, что описано в документации. Вопрос не по списку Kaspi просто проигнорирует.

В Kaspi Гиде описаны три задачи API: добавлять новые товары, обрабатывать заказы и получать информацию о них, интегрировать систему учёта с магазином. Данные передаются в формате JSON (Kaspi Гид, «Что такое API в Магазине на Kaspi.kz?»). Среди систем, с которыми можно связать магазин, Гид называет 1С, Paloma и Umag.

Ключ к обмену называется токеном авторизации. Получить его может только руководитель компании: в веб-версии кабинета продавца раздел «Настройки», затем «Токен API» и кнопка «Сформировать». Kaspi предупреждает, что любой, у кого есть токен, сможет получать информацию о заказах и товарах из вашего кабинета, поэтому передавать его можно только своему техническому специалисту (там же, «Как получить токен авторизации»).

Почему в учёте появляются дубли и чужие статусы

Дубли заказов в учёте, по словам Евгения, на момент записи возникали из-за того, что Kaspi отвечал не тем, что у него спросили. Система учёта просит заказы на самовывозе, а в ответ приходят и самовывоз, и доставка, и так по нескольким статусам. У пользователей появляются дубли, неверное отображение, и претензии получает интегратор: «вы плохие, МойСклад плохой». Потом команда разбирается и выясняет, что запросили одни заказы, а пришли другие.

Вторая боль связана с объёмом. Kaspi отдаёт заказы порциями: в Гиде прямо написано, что на одной странице ответа может быть максимум 100 заказов (Kaspi Гид, «Как с помощью API получить список моих заказов?»). Евгений рассказал, что по предзаказам интеграции приходилось каждый раз перебирать все заказы за последние 30 дней, чтобы заметить смену статуса. Для магазина с 500 заказами в месяц это ерунда.

У продавцов с несколькими тысячами заказов, по подсчётам команды FixCom, одно обновление статусов занимало три-четыре часа. Всё это время учёт показывает устаревшую картину. Евгений считает, что Kaspi мог бы отдавать статусы по нужным заказам одним ответом.

Изменения без предупреждения и сбой у нескольких кабинетов

Изменения в API Kaspi интеграторы, по словам Евгения, узнают по факту, когда у клиентов что-то сломалось. Он привёл примеры: Kaspi обновил загрузку карточек товаров по шаблонам и добавил прочерк в поле с комментарием клиента. Предупреждений не было. Евгений предлагал Kaspi завести Telegram-канал для разработчиков и писать туда о каждом изменении, даже если оно случается редко.

Когда интеграция перестаёт работать, ему пишут все активные пользователи сразу. Объяснить каждому, что проблема не у интегратора, трудно. Евгений предполагает, что Kaspi развивался очень быстро и система обросла связями, поэтому любую правку сложно внести, ничего не задев.

Самая показательная история случилась с продавцами, у которых несколько кабинетов на Kaspi. Например, у человека есть ИП со своим магазином, а во втором юрлице он директор другого магазина. В какой-то момент заказы у таких продавцов перестали приходить или пошли как попало. Один из них, Фархад, общий знакомый Евгения и Артёма, начал выяснять. В поддержке ответили, что причина в одном руководителе на две компании, и посоветовали сменить руководителя во второй компании. Фархад поехал это делать.

Через несколько дней после встречи Фархада с руководством Kaspi выяснилось другое. Когда за одним человеком закреплено несколько кабинетов, в запрос нужно добавлять специальный технический заголовок. Тогда всё работает. На момент записи, по словам Евгения, об этом нигде в документации не было написано. Связь с правилом о токене здесь прямая: токен получает только руководитель, поэтому один руководитель на несколько компаний сразу касается обмена через API.

Почему интеграторам трудно тестировать

Тестовой среды у Kaspi, по словам Евгения, на момент записи не было. Проверить новую функцию или работу с заказами без живого магазина нельзя, а ошибки в таких местах неизбежны. Команда FixCom открыла отдельный магазин на Kaspi: создавала заказ, проверяла, как он прошёл в систему, и отменяла. Потом снова. Им позвонили и спросили, почему так много отмен. Евгений объяснил, что они тестируют интеграцию. В итоге кабинет заблокировали, и команда ждала разблокировки, чтобы продолжить проверку.

Официальный канал связи с интеграторами, по его словам, тоже не работает. На Kaspi есть раздел технологических партнёров. Евгений несколько раз подавал туда заявку, раньше через Google-форму, которую потом убрали. Партнёром компания так и не стала. По его оценке, половина партнёров из того списка уже не работает. Артём в выпуске рассказал похожую историю: он подавался в технологические партнёры, когда начинал обучение, и на письма ему так и не ответили.

Другие казахстанские площадки Евгений по технической части оценивает лучше. Первым он назвал Jusan: там можно передавать остатки по API. Но спрос на интеграции с ними, по его словам, мал. Около 98 % установок приложений FixCom приходится на Kaspi, а Halyk, Jusan и Forte вместе дают около 1 %. С ними команда сделала только выгрузку остатков в XML, без синхронизации заказов. Расклад сил между площадками мы разбирали в статье «Маркетплейсы Казахстана: кто выживет рядом с Kaspi».

5 шагов, если синхронизация с Kaspi сломалась

Начните со сверки с кабинетом продавца, а выводы делайте потом. Порядок по тому, что рассказал гость:

1. Сверьте заказ в кабинете Kaspi. Если в кабинете заказ один, а в учёте два, спросите интегратора, какие заказы система запрашивала и что вернул Kaspi.
2. Узнайте, как часто обновляются статусы. При тысячах заказов и порциях по 100 перепроверка может идти часами. Спросите, какую задержку считать нормой.
3. Сообщите интегратору о нескольких кабинетах. Если вы руководитель в двух компаниях с магазинами на Kaspi, скажите об этом сразу. Именно у таких продавцов, по словам Евгения, ломались заказы.
4. Держите токен под контролем. Получить его может только руководитель, а владелец токена видит заказы и товары кабинета. Передавайте его только тому, кто настраивает интеграцию.
5. Не тестируйте на основном магазине. Массовые отмены пробных заказов привели к блокировке даже тестового кабинета FixCom.

Полный выпуск: «Внутрянка каспи магазина — что не так с маркетплейс №1 в Казахстане?» на YouTube.

API Kaspi: вопросы и ответы

Кто может получить токен API Kaspi?

Только руководитель компании. Токен формируется в веб-версии кабинета продавца в разделе «Настройки», затем «Токен API». Любой, у кого есть токен, получает доступ к данным о заказах и товарах кабинета.

Сколько заказов API Kaspi отдаёт за один запрос?

По Kaspi Гиду, на одной странице ответа максимум 100 заказов. По словам Евгения Маймышева, у магазинов с несколькими тысячами заказов из-за этого обновление статусов занимало три-четыре часа.

Почему заказы Kaspi задваиваются в системе учёта?

По словам Евгения Маймышева, на момент записи Kaspi иногда возвращал заказы не тех статусов, что запрашивала система, например доставку вместо самовывоза. Сверьте заказ в кабинете продавца и передайте пример интегратору.

Что делать, если у вас несколько кабинетов на Kaspi?

Сообщите об этом интегратору. По словам гостя выпуска, у продавцов, где один человек руководит двумя компаниями, заказы перестали приходить, пока в запросы не добавили специальный технический заголовок.

Факты проверены 25.10.2026. Наблюдения о работе API приведены по словам Евгения Маймышева на ноябрь 2024 года и могли измениться. Правила токена и лимит заказов сверены с Kaspi Гидом 25.10.2026.

Источник: подкаст Артёма Бухонина с Евгением Маймышевым, 25.11.2024

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

Ошибки продавца на Kaspi: 5 уроков перезапуска магазинаKaspi марафон Туркестан: что это дало бизнесу РКKaspi Trade-in iPhone: до 270 тысяч тенге за смартфонBereke Fest на маркетплейсах: скидки до 50% для продавцов