Документация по изменению SDK

В связи с изменением основной ставки НДС с 20% до 22% с 1 января 2026 года в нашем SDK вводятся необходимые изменения для корректной работы.

1. Изменения в перечислении TaxRate

ID ставок остаются неизменными для обратной совместимости, но смысловое значение обновляется:

ВАЖНО! Ваш код остается таким же:
product.setTaxRate(TaxRate.TAX_20);

Но с 01.01.2026 это будет означать:

// TAX_20 (id=1) -> применяется ставка 22%
// TAX_20_120 (id=3) -> применяется ставка 22/122

Что нужно сделать:

– Продолжайте использовать те же константы (TAX_20, TAX_20_120)

2. Новое поле useTax20 в моделях

Для особых случаев (формирование чека коррекции (старых чеков)) добавлено поле useTax20:

– Поле имеет тип Boolean и может принимать три значения: true, false или null.

– Для явного указания использовать старую ставку 20% (С 1 января 2026)
cheque.setUseTax20(true);

– Для явного указания использовать новую ставку 22% (С 1 января 2026))
cheque.setUseTax20(false);

– Если не устанавливать, то поле останется null, что будет интерпретировано как отсутствие указания.

До 1 января 2026 года это не имеет эффекта, после, система будет использовать новую ставку 22% (как если бы было false).

Где доступно:
SDK v1: Order, OrderLkModel, Cheque, CorrectionReceipt
SDK v2: Order, ReceiptReq, CorrectionReceiptReq, Receipt, CorrectionReceipt

3. Интерпретация исторических чеков

При получении чеков из истории используйте поле useTax20 для определения фактической ставки:

– useTax20 == null -> чек создан до внедрения поддержки НДС 22%, использовалась ставка 20%
– useTax20 == true -> чек создан после внедрения с явным указанием использовать ставку 20%
– useTax20 == false -> чек создан после внедрения с использованием новой ставки 22%

4. Рекомендации по обновлению

– Обновите зависимости SDK до актуальной версии.
– Добавьте обработку поля useTax20 в сценариях коррекции чеков

Для того чтобы Ваш программно-аппаратный комплекс aQsi начал работать согласно новым ставкам необходимо:

1.  Обновить устройство до актуальных версий приложений. Чтобы проверить, необходимы ли обновления, откройте в кассе Каталог приложений и обновите в нём страницу.
2. Приобрести лицензию через партнерский канал или отправить заказ на sales@aqsi.ru.
3. . Активация лицензии пройдет автоматически. С новой тарифной политикой aQsi Вы можете ознакомиться здесь.
4. Убедиться, что лицензия активировалась. Пройдите на устройстве в раздел Настройки – Тех.обслуживание ККТ – Лицензии и действующие тарифы
   

   Отображение новой ставки в чеке

   
5. Информация по SDK

Если у Вас возникли сложности или вопросы, обратитесь в службу технической поддержки по контактам, указанным на сайте организации. Наши специалисты помогут вам оперативно решить вопросы.