# Kaspi.kz Держите заказы Kaspi под контролем прямо в чате Магазин на Kaspi.kz — заказы, позиции, товары, отзывы, города и точки выдачи (Shop API v2, JSON:API) ## Как агент работает с Kaspi.kz Агент работает с магазином через Shop API v2 — тот же интерфейс, что стоит за кабинетом продавца Kaspi.kz. Он читает заказы и их позиции, карточки товаров, отзывы, города и точки выдачи, а суммы считает в тенге, как они и приходят из казахстанского кабинета. Продажи сводятся по товарам и периодам, заказы — по статусам, и в ответ вы получаете разбор, а не выгрузку, которую нужно открывать в таблице. Устройство данных здесь трёхступенчатое: сам заказ не несёт списка товаров — сначала агент забирает его позиции, а от каждой позиции переходит к карточке товара. Поэтому вопрос «что именно у нас купили за неделю» стоит нескольких обходов, и агент проходит их постранично, а не пытается вытянуть всё одним запросом. Фильтр по состоянию заказа он ставит на стороне Kaspi, чтобы не тащить архив ради свежих сделок. Уведомлений Kaspi не присылает, так что новые и зависшие заказы агент видит в момент, когда вы спрашиваете или когда он проверяет их по расписанию. Прежде чем назвать заказ проблемным, он перечитывает текущее состояние — статус в Kaspi меняется быстрее, чем успевает устареть прошлая сводка. Ответы на отзывы агент готовит текстом и показывает вам: публикация остаётся вашим шагом в кабинете. Токен уходит отдельным заголовком, без OAuth и без входа под вашей учётной записью, и отзывается в любой момент, что мгновенно закрывает агенту доступ. Видит агент ровно тот магазин, которому принадлежит токен, — чужой заказ по номеру он не достанет. Выборки идут постранично и с фильтром по датам на стороне Kaspi, поэтому длинный период не превращается в одну неподъёмную выгрузку. Частоту запросов агент выдерживает сам, а если раздел пуст или токен отозван — скажет об этом прямо, а не покажет пустую таблицу. ## Сценарии интеграции ### Контроль заказов Kaspi по статусам Агент проверит новые заказы, найдёт зависшие в обработке и напомнит, где горят сроки передачи в доставку. ### Анализ продаж магазина Агент сведёт продажи по товарам и периодам, покажет топ-позиции и динамику выручки в тенге. ### Мониторинг отзывов Агент соберёт свежие отзывы по товарам, выделит негатив и подготовит ответы. ### Города и точки выдачи Агент разложит заказы по городам и точкам выдачи и покажет, где забирают чаще всего, а в какие точки доставка почти не идёт. ### Что в среднем чеке Агент пройдёт по позициям заказов, посчитает средний чек и число товаров в заказе и покажет, какие позиции чаще всего берут вместе. ### Разбор отказов Агент отберёт заказы в отменённых состояниях, сведёт их по карточкам товаров и покажет, на каких позициях отказы повторяются чаще остальных. ## Как подключить **Перед подключением** - Статус продавца Kaspi.kz с доступом в кабинет магазина - Магазин в казахстанском кабинете: суммы и заказы берутся оттуда ### Войдите в веб-версию кабинета продавца Кабинет открывается на kaspi.kz/mc по тому же телефону и паролю, что и приложение Kaspi Pay. В мобильном приложении раздела с токеном нет. ### Войдите под учётной записью руководителя Токен выдаётся только руководителю компании: у сотрудника нужного пункта в настройках просто не будет. Тогда попросите руководителя выпустить ключ. ### Откройте «Настройки» → «Токен API» В меню кабинета выберите «Настройки», затем «Токен API». Это единственное место, где выпускается ключ: заявку писать и ждать одобрения не нужно. ### Нажмите «Сформировать» и скопируйте токен Токен приходит одной строкой и не меняется: если потеряли, вернитесь на ту же страницу и скопируйте снова. Он открывает заказы и товары магазина. ## Частые вопросы ### Что нужно для подключения Kaspi.kz? API-токен из кабинета продавца Kaspi (Shop API v2). Токен хранится в зашифрованном виде и отзывается в кабинете в любой момент. ### Какие разделы кабинета видит агент? Заказы и позиции, товары, отзывы, города и точки выдачи — то, что отдаёт Shop API. Агент работает с данными по запросу и не выгружает их «про запас». ### Подходит ли для продавцов из Казахстана? Да, коннектор рассчитан на продавцов Kaspi.kz: суммы в тенге, статусы заказов и логика точек выдачи соответствуют казахстанскому кабинету. [Открыть Kaspi.kz](https://kaspi.kz/mc/)