Версии и совместимость

С какой версии кассы работает каждая возможность и что менялось в API.

Какую версию кассы ставить

Для новых подключений ставьте самую свежую версию, но не старше 2.2.09.403. С ней работают все возможности из таблицы ниже, кроме сверки сумм по TCP: она появилась в 2.2.09.412.

Сервер выкладывается отдельно от кассы. По TCP достаточно версии кассы, по HTTP возможность должна поддерживать и касса, и сервер. На 02.11.2026 методы receipt-find-v4, shift-v2 и cash-v2 отвечают и на демо, и на рабочем контуре.

Что с какой версии

Номер это первая версия кассы, в которой возможность точно есть.

Возможность	Версия кассы	На более старой кассе
Обмен v4 по TCP, HTTP и TCP одновременно	2.2.09.371	только синхронный `/gate/receipt`, переключатели взаимоисключающие
Блок `print` в документе, `needPrint`	2.2.09.371	поля игнорируются, чек пробивается как обычно
`skip_bank`	2.2.09.373	поле игнорируется, касса вызовет банк и спросит оплату
Обмен валюты через кассу	2.2.09.375	пробьётся обычный товарный чек, `EXPENDITURE` будет отклонён
`/payment`: вторая оплата получает отказ	2.2.09.381	вторая оплата затирает первую
Смена по TCP	2.2.09.384	документ примут за чек, смена не выполнится, ответа не будет
`kkmID` в ответах, `receipt-find-v4`	2.2.09.387	поля нет, ищите чек по статусу
Ответ при любом исходе, таймаут обработки 3 минуты	2.2.09.392	часть отказов приходит только по таймауту
Возврат на карту по `rrn`	2.2.09.395	возврат уходит в банк оплатой
`receiptNumber` в ответе	2.2.09.395	поля нет
Оповещения о чеках, источник чека `source`	2.2.09.400	настройки на кассе нет
Повтор с тем же `id` после `ERROR`	2.2.09.403	документ не примут заново, нужен новый `id`
Сверка сумм смешанной оплаты по TCP	2.2.09.412	чек пробивается, даже если суммы оплаты не сходятся с позициями

Версия видна в меню кассы вверху: v 411 это 2.2.09.411. Проверить свежесть обмена можно и запросом: отправьте тестовый документ и посмотрите, есть ли kkmID в ответе на приём.

История изменений

02.11.2026

Смешанная оплата по TCP: касса сверяет cash_sum + cashless_sum с суммой позиций и отклоняет документ при приёме. Запрос только с cashless_sum больше не записывает в чек ещё и наличные на всю сумму.

28.09.2026

shift-v2: в balanceDetails поля sell, buy, sellKGS, buyKGS теперь полные суммы за смену без вычета возвратов, как в Z-отчёте. Возвраты отдельно: sellReturn, sellReturnKGS, buyReturn, buyReturnKGS.
cash-v2: смену открывает любая операция с наличностью, в том числе сразу после закрытия предыдущей.
shift-v2: копия документа открытия смены, link в ответе на open и shiftOpenLink на всех командах.
Z-отчёт обменного пункта: продажа и покупка по каждой валюте всего, возвраты отдельными строками.

25.09.2026

В ответе на чек появился receiptNumber, порядковый номер чека в смене.
Z-отчёт и копия чека обменного пункта выглядят так же, как на кассе.

24.09.2026

Возврат продажи по безналу: касса возвращает деньги на карту по rrn исходной оплаты, чек после успеха в банке. Без rrn и без skip_bank документ отклоняется при приёме.
Сервер передаёт поле rrn кассе, раньше он его отбрасывал.

11.09.2026

cash-v2: изъятие сомов больше остатка отклоняется, раньше уводило баланс в минус.

08.09.2026

shift-v2: поля shiftOpenTime, shiftCloseTime, balanceDetails.
receipt-v2: в ответе shiftNumber, у валютного чека balance.
receipt-v2 и cash-v2: необязательное поле operatorTime.

02.09.2026

kkmID во всех ответах по документу, новый метод receipt-find-v4.

18.08.2026

Смена по TCP документом в receipt-v4.

08.08.2026

Обмен валюты без кассы: receipt-v2, cash-v2, shift-v2.

31.07.2026

Блок print в документе и needPrint в ответах.