> Источник: https://apipay.kz/guides/otchet-po-kassovoy-smene-kaspi · Обновлено: 2026-09-27 · apipay.kz
> ApiPay — независимый сервис приёма платежей поверх вашего Kaspi Pay.

# Отчёт по кассовой смене Kaspi: получить в кабинете и по API

**TL;DR.** Итоги кассовой смены ведёт сама Kaspi Касса (ОФД): вручную их смотрят в приложении Kaspi Pay, в разделе кассы в «Настройках», — см. [справку Kaspi](https://guide.kaspi.kz/). Если к вашему Kaspi Pay подключён ApiPay, отчёт по любой смене скачивается PDF-файлом в кабинете ApiPay — раздел «Касса», кнопка «Отчёт» у нужной смены. Автоматически — через API ApiPay: `GET /cashbox/shifts` находит смену, `GET /cashbox/shifts/{shift}/report` отдаёт ссылку на PDF, которая живёт около 15 минут.

## Где найти итоги смены в кабинете ApiPay?

Откройте в кабинете ApiPay раздел «Касса». В списке смен у каждой видны номер, дата открытия, выручка и число операций. Кнопка «Отчёт» у смены даёт PDF-отчёт, кнопка «Сверить со счетами» ставит итог кассы рядом с вашими оплаченными счетами — «[Сверка кассы со счетами ApiPay](/guides/sverka-kassy-so-schetami-apipay)».

В рабочем режиме раздел работает через подключённого кассира Kaspi. Если кассира ещё нет — «[Подключить кассира Kaspi](/connect-cashier)».

## Какая касса нужна, чтобы видеть смены?

Смены и отчёты по ним мы получаем от Kaspi Кассы (ОФД) — той же, что включает каталог товаров.

Если продажи идут через Kaspi Pos без ОФД, кассовых смен у организации не существует: раздела «Касса» в кабинете нет, а `GET /cashbox/shifts` отвечает `409 cashbox_kkm_unknown`. Что это меняет и как перейти — «[Переход на каталог товаров](/guides/perehod-na-katalog-tovarov)».

Если Kaspi Касса подключена, а раздела «Касса» нет — нажмите в настройках «Обновить информацию об организации»: состояние пересверяется в этот момент.

⚠️ Этим же действием включается каталог товаров: после него QR-счета выставляются только с составом покупки, а уже напечатанные QR-листы без состава перестают работать — переиздать их нельзя. Сначала убедитесь, что ваша интеграция умеет передавать состав, — «[Переход на каталог товаров](/guides/perehod-na-katalog-tovarov)».

В песочнице кассовые запросы отвечают всегда — тестовыми данными и независимо от того, есть ли касса в бою. Раздел «Касса» в кабинете тестовой организации появляется, если вы ответили, что касса есть. Проверяйте интеграцию и на боевой организации.

## Как найти смену через API?

```
GET /api/v1/cashbox/shifts?date_from=2026-08-09&date_to=2026-08-09
```

Обе границы обязательны, окно — не длиннее 31 дня, иначе придёт `422`. В ответе список смен и состояние автозакрытия:

| Поле | Что в нём |
|---|---|
| `id` | Идентификатор смены — он же нужен для отчёта и сверки |
| `shift_number` | Номер смены, который видно на кассе |
| `start_date` | Дата открытия |
| `is_current` | `true` у открытой смены |
| `total_income` | Итог смены суммой `"N.NN"` |
| `total_income_raw` | Тот же итог в готовом виде от Kaspi — для показа человеку |
| `transactions_count` | Сколько операций в смене |

Запрос идёт в кассу Kaspi, поэтому отвечает не мгновенно — закладывайте в свой клиент таймаут с запасом.

## Как скачать отчёт по смене через API?

```
GET /api/v1/cashbox/shifts/118275707/report
→ { "url": "https://…", "expires_at": "2026-08-10T09:15:00+05:00" }
```

Ссылка живёт около **15 минут**. Это не файл, а подписанный адрес: скачайте файл по `url` до `expires_at`, а не складывайте ссылку в базу. Понадобится позже — запросите ссылку заново; действует общий кассовый лимит: до 30 запросов в минуту на ключ.

Ссылка открывается без API-ключа: отчёт скачает любой, у кого она есть, пока не истёк срок. Не публикуйте её, не пересылайте в переписке и не пишите в логи — отозвать выданную ссылку нельзя.

## Как получать отчёт за вчера без ручной работы?

Открывать кабинет каждое утро неудобно, если точек несколько, если отчёт ждёт бухгалтер или его нужно складывать во внутреннее хранилище. Тогда это делает скрипт по расписанию:

1. В 9 утра запросить `GET /cashbox/shifts` за вчерашний день.
2. Для каждой смены получить ссылку `GET /cashbox/shifts/{shift}/report` и **сразу** скачать файл.
3. Положить файл к себе и разослать, кому нужно.

Смена с `is_current: true` ещё открыта — её отчёт неполный. Чтобы к утру смены были закрыты, включите автозакрытие — «[Автозакрытие кассовой смены Kaspi](/guides/avtozakrytie-kassovoy-smeny-kaspi)».

Ключ API выдаётся в кабинете ApiPay. Все параметры — в [документации API](/docs). Код такого скрипта напишет ваш ИИ-агент — дайте ему [apipay.kz/for-ai](/for-ai).

Отдельного «отчёта за период» в кассе нет: отчёт всегда по конкретной смене. Если нужны итоги по точкам по вашим счетам ApiPay, а не по кассе, — «[Разделить счета по точкам](/guides/razdelnaya-otchetnost-po-tochkam)».

## Чего нет в отчёте по смене?

Отчёт по смене — это цифры кассы Kaspi. Он не знает, какие из ваших счетов ApiPay оплачены: чтобы увидеть обе стороны рядом, есть сверка — «[Сверка кассы со счетами ApiPay](/guides/sverka-kassy-so-schetami-apipay)».

## Для вашего ИИ-агента

Смотрите: `GET /cashbox/shifts?date_from&date_to` — обе границы обязательны, окно ≤ 31 дня, иначе `422`; `GET /cashbox/shifts/{shift}/report` отдаёт `{url, expires_at}`, а не файл — скачивать сразу, ссылку не хранить; `total_income` — сумма строкой `"N.NN"`, `total_income_raw` — готовое форматирование для показа, не парсить; при недоступности отчёта приходит `cashbox_report_unavailable` (503) — повторить позже; лимит кассовых запросов — до 30 в минуту на ключ.

## Частые вопросы

**Можно получить отчёт по открытой смене?**
Отчёт запрашивается по любой смене из списка, но у открытой смены цифры продолжают меняться.

**Ссылка перестала открываться — что делать?**
Запросить отчёт заново: срок жизни ссылки истёк, файл никуда не делся.

**Нужен ли для отчёта подключённый кассир?**
Да, в рабочем режиме весь раздел «Касса» работает через подключённого кассира Kaspi — «[Как подключить кассира](/guides/podklyuchenie-kassira-kaspi)». В песочнице раздел отвечает тестовыми данными по вашим sandbox-счетам: кассир там не нужен, смена одна на календарный день, а идентификаторы смен синтетические.

**Как посмотреть чеки, пробитые в Kaspi Pos?**
Чеки, пробитые в Kaspi Pos мимо ApiPay, ищите в самом Kaspi — по [справке Kaspi](https://guide.kaspi.kz/). Как выбить чек через ApiPay — «[Выбить фискальный чек Kaspi](/guides/vybit-fiskalnyy-chek-kaspi)».

---

ApiPay — независимый сервис и не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки их правообладателя.
База знаний: https://apipay.kz/guides