Что понадобится до начала
- Подключённый кассир Kaspi. Если касса не подключена — подключите её.
- Открытая смена. Смена открывается в приложении Kaspi Pos на телефоне кассы. Пока смена закрыта, чек выбить нельзя.
- Товары в каталоге с НТИН. В чек попадают только товары, у которых есть НТИН (код Нацкаталога) и штрихкод. Как их завести — в статье Каталог, корзина и Нацкаталог.
- Оплаченный тариф ApiPay. Пока подписка не активна, кнопки «Показать превью» и «Выбить чек» заблокированы. История уже выбитых чеков остаётся доступной.
Как выбить чек: по шагам
- Откройте «Создать счёт». В кабинете ApiPay зайдите в раздел создания счёта.
- Переключитесь в режим «Фискальный чек (без счёта)». Это отдельный режим на той же странице — без выставления счёта покупателю, только чек.
- Выберите способ оплаты: «Наличные» или «POS другого банка». Выбирайте так, как покупатель фактически заплатил.
- Добавьте товары из каталога. Выбирайте позиции так же, как в обычном счёте с корзиной. Товары без НТИН будут недоступны для выбора — рядом появится подсказка «нет НТИН, добавьте в Нацкаталоге». Укажите количество по каждой позиции.
- Для наличных укажите «Получено». Впишите сумму, которую дал покупатель — кабинет сам посчитает сдачу. Для оплаты через POS другого банка это поле не нужно.
- Нажмите «Показать превью». Кабинет покажет, как будет выглядеть чек: сумма, способ оплаты, позиции.
- Нажмите «Выбить чек». Кнопка сработает один раз — не нажимайте повторно, даже если кажется, что «ничего не произошло»: чек уже выбивается, и двойного чека не будет.
- Дождитесь результата. Карточка с готовым чеком появится сама — сумма, номер операции и ссылка на чек Kaspi OFD. Обновлять страницу не нужно.
- Откройте, сохраните или покажите чек. По ссылке чек можно открыть, скопировать её или показать покупателю по QR-коду.
Важно: фискальный чек необратим — отменить или переделать его нельзя. Если ошиблись, это решается возвратом по правилам ОФД, а не удалением чека. Поэтому перед выбиванием проверяйте превью.
Если что-то пошло не так
Кабинет покажет понятное сообщение. Вот что делать при самых частых:
- «Смена на кассе закрыта». Откройте смену в приложении Kaspi Pos и повторите.
- «У позиции нет НТИН». Добавьте товар в Нацкаталоге (по штрихкоду), затем выберите заново.
- «Нет активного кассира Kaspi». Касса отвязалась — переподключите (переавторизуйте) кассира в настройках.
- «Несколько активных касс — выберите кассу». У вас подключено больше одной кассы — выберите нужную из списка и повторите.
- «Kaspi недоступен, повторите». Временный сбой на стороне Kaspi — подождите минуту и попробуйте снова.
- Не уверены, выбился чек или нет. Не выбивайте заново — сначала проверьте историю чеков: если нужный чек там есть, повторять не нужно.
Если ничего не помогло — напишите в поддержку и приложите скриншот сообщения.
Как потренироваться в тестовом режиме
Пока организация в тестовом режиме, чеки не уходят в Kaspi — можно попробовать всё описанное выше, ничего не выбивая по-настоящему (про режимы — Песочница и рабочий режим).
- Нет товаров? Кнопка «Заполнить тестовыми данными» создаст несколько товаров. Один из них намеренно без НТИН — на нём видно, как выглядит отказ по нефискальной позиции.
- Хотите заранее увидеть ошибку? Поставьте галочку «Проверить, как себя ведёт чек при ошибке», выберите исход (чек выбит / ошибка) и саму ошибку.
Ссылка в карточке тестового чека — заглушка песочницы: настоящий чек по ней не откроется.
Программисту то же самое через API — Фискальный чек Kaspi для наличных и чужого POS.