Как выбить фискальный чек Kaspi из кабинета ApiPay

Что понадобится до начала

1. Подключённый кассир Kaspi. Если касса не подключена — сначала подключите её (или попросите об этом администрацию через WhatsApp поддержки).
2. Открытая смена. Смена открывается в приложении Kaspi Pos на телефоне кассы. Пока смена закрыта, чек выбить нельзя.
3. Товары в каталоге с НТИН. В чек попадают только товары, у которых есть НТИН (код Нацкаталога) и штрихкод. Как их завести — в статье Каталог, корзина и Нацкаталог.

Как выбить чек: по шагам

1. Откройте «Создать счёт». В кабинете ApiPay зайдите в раздел создания счёта.
2. Переключитесь в режим «Фискальный чек (без счёта)». Это отдельный режим на той же странице — без выставления счёта покупателю, только чек.
3. Выберите способ оплаты: «Наличные» или «POS другого банка». Выбирайте так, как покупатель фактически заплатил.
4. Добавьте товары из каталога. Выбирайте позиции так же, как в обычном счёте с корзиной. Товары без НТИН будут недоступны для выбора — рядом появится подсказка «нет НТИН, добавьте в Нацкаталоге». Укажите количество по каждой позиции.
5. Для наличных укажите «Получено». Впишите сумму, которую дал покупатель — кабинет сам посчитает сдачу. Для оплаты через POS другого банка это поле не нужно.
6. Нажмите «Показать превью». Кабинет покажет, как будет выглядеть чек: сумма, способ оплаты, позиции. Это удобно, чтобы проверить всё перед выбиванием.
7. Нажмите «Выбить чек». Кнопка сработает один раз — не нажимайте повторно, даже если кажется, что «ничего не произошло»: чек уже выбивается, и двойного чека не будет.
8. Дождитесь результата. Обычно это занимает секунду-другую. Появится карточка с готовым чеком: сумма, номер операции и ссылка на чек Kaspi OFD.
9. Откройте, сохраните или покажите чек. По ссылке чек можно открыть, скопировать её или показать покупателю по QR-коду.

Важно: фискальный чек необратим — отменить или переделать его нельзя. Если ошиблись, это решается возвратом по правилам ОФД, а не удалением чека. Поэтому перед выбиванием проверяйте превью.

Если что-то пошло не так

Кабинет покажет понятное сообщение. Вот что делать при самых частых:

• «Смена на кассе закрыта». Откройте смену в приложении Kaspi Pos на телефоне кассы и повторите.
• «У позиции нет НТИН». Товар не зарегистрирован фискально — добавьте его в Нацкаталоге (по штрихкоду), затем выберите заново. Подробнее — Каталог, корзина и Нацкаталог.
• «Нет активного кассира Kaspi». Касса отвязалась — переподключите (переавторизуйте) кассира в настройках или обратитесь в поддержку.
• «Несколько активных касс — выберите кассу». У вас подключено больше одной кассы — выберите нужную из списка и повторите.
• «Kaspi недоступен, повторите». Временный сбой на стороне Kaspi — подождите минуту и попробуйте снова.

Если ничего не помогло — напишите в поддержку и приложите скриншот сообщения.

Как потренироваться в тестовом режиме

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

• Нет товаров? На экране «Выбить чек» появится кнопка «Заполнить тестовыми данными» — она создаст несколько товаров. Один из них намеренно без НТИН — на нём видно, как выглядит отказ по нефискальной позиции.
• Хотите заранее увидеть ошибку? Поставьте галочку «Проверить, как себя ведёт чек при ошибке», выберите исход (чек выбит / ошибка) и саму ошибку — «Смена на кассе закрыта», «У товара нет НТИН» или «Kaspi отклонил чек». Кабинет покажет ровно то, что увидит кассир в реальной работе.

Правила в тестовом режиме те же, что и в рабочем: товар попадает в чек, только если у него есть и штрихкод, и НТИН. Так тест не «зеленеет» там, где бой покажет ошибку.

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