Держите заказы Kaspi под контролем прямо в чате

Агент работает с магазином через Shop API v2 — тот же интерфейс, что стоит за кабинетом продавца Kaspi.kz. Он читает заказы и их позиции, карточки товаров, отзывы, города и точки выдачи, а суммы считает в тенге, как они и приходят из казахстанского кабинета. Продажи сводятся по товарам и периодам, заказы — по статусам, и в ответ вы получаете разбор, а не выгрузку, которую нужно открывать в таблице.

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

Уведомлений Kaspi не присылает, так что новые и зависшие заказы агент видит в момент, когда вы спрашиваете или когда он проверяет их по расписанию. Прежде чем назвать заказ проблемным, он перечитывает текущее состояние — статус в Kaspi меняется быстрее, чем успевает устареть прошлая сводка. Ответы на отзывы агент готовит текстом и показывает вам: публикация остаётся вашим шагом в кабинете.

Токен уходит отдельным заголовком, без OAuth и без входа под вашей учётной записью, и отзывается в любой момент, что мгновенно закрывает агенту доступ. Видит агент ровно тот магазин, которому принадлежит токен, — чужой заказ по номеру он не достанет. Выборки идут постранично и с фильтром по датам на стороне Kaspi, поэтому длинный период не превращается в одну неподъёмную выгрузку. Частоту запросов агент выдерживает сам, а если раздел пуст или токен отозван — скажет об этом прямо, а не покажет пустую таблицу.