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

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

1. Изменения в параметрах НДС

ВАЖНО! Числовые идентификаторы ставок (id) остаются неизменными:
{
“tax”: {
“id”: 1, // ID=1 -> означает ставку 22%
      “name”: “TAX_20” // Название сохраняется для совместимости
   }
}

Соответствие ID и ставок:

id: 1 → ставка 22% (ранее 20%)
id: 3 → ставка 22/122 (ранее 20/120)
Остальные ID без изменений

2. Новое поле в запросах: useTax20

Для формирования чеков со старой ставкой после 2026 года:
{
   “items”: [
      {
           “tax”: {“id”: 1}
      }
   ],
   “useTax20”: true // Опционально: true = использовать старую ставку НДС 20%
}

Доступно в эндпоинтах:

POST /api/v2/Receipts – создание чека
POST /api/v2/CorrectionReceipts – создание чека коррекции
POST /api/v2/Orders – создание заказа

Правила применения:

– Поле игнорируется в запросах до 01.01.2026
– После 01.01.2026:
– Не передано или false → применяется ставка 22%
– true → применяется ставка 20% (для чека коррекции)

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

В ответах от API GET v2/Receipts и GET v4/Receipts/{id} запроса чеков появится поле useTax20:

Пример:
{
   “id”: “чек_123”,
   “date”: “2026-01-15T10:30:00”,
   “useTax20”: false, // false = использована ставка 22%

}

Ключ к интерпретации:

useTax20: null или отсутствует → чек сформирован до обновления, ставка 20%
useTax20: false → чек сформирован после обновления, ставка 22%
useTax20: true → чек сформирован после обновления, но ставка 20%

5. Важные замечания

Обратная совместимость: Ваши текущие запросы продолжат работать, но с 2026 года будут применять новые ставки

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

1. 1.  Обновить устройство до актуальных версий приложений. Чтобы проверить, необходимы ли обновления, откройте в кассе Каталог приложений и обновите в нём страницу.
   2. Приобрести лицензию через партнерский канал или отправить заказ на sales@aqsi.ru.

Активация лицензии пройдет автоматически. С новой тарифной политикой aQsi Вы можете ознакомиться здесь.

• Убедиться, что лицензия активировалась. Пройдите на устройстве в раздел Настройки – Тех.обслуживание ККТ – Лицензии и действующие тарифы
  

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

  
• Информация по API

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