Skip to main content

ККТ

Обновление программного обеспечения (прошивки)

Для обновления должен присутствовать чековый рулон, крышка закрыта, в ККТ должен быть загрузчик минимально необходимой версии, а также должна быть закрыта смена. Продолжительность: около 45 секунд при отсутствии ошибок, до 3 минут в случае некоторых ошибок.

Критически важно чтобы на протяжении обновления не пропадало электропитание ККТ и терминала, в противном случае высока вероятность выведения ККТ из строя и потребуется помощь специалиста ЦТО для его восстановления. Кроме этого, открытие крышки в процессе обновления приведет к сбою и необходимости проведения восстановления.

В начале и конце обновления ККТ печатает чек, информирующий о запуске обновлении прошивки и о статусе завершения (успешно или с ошибкой); при определенных ошибках печать завершающего чека может оказаться невозможной.

В случае ошибки на подготовительном этапе - до начала записи прошивки в ККТ - обновление отменяется. ККТ остается в исходном состоянии, но может потребоваться до 1 минуты для его самостоятельного возвращения в штатный режим. Код ответа - 412

В случае ошибки при обновлении и ошибки при откате ККТ оказывается в нерабочем состоянии. Код ответа - 503. До перезагрузки терминала еще есть шанс вернуть ККТ в штатный режим, см. метод Попытка восстановления ККТ

Код ответа
Значение
200 Успешное обновление прошивки
400 Error parsing request body as JSON Ошибка в формате тела запроса
400 Missing 'firmware' parameter В теле запроса не найден параметр firmware
400 KKT firmware is already at the required version Заданная версия прошивки уже установлена в ККТ
404 Backup file {name} not found on server На сервере не найден файл текущей прошивки
404 Upgrade file {name} not found on server На сервере не найден файл целевой прошивки
412 Error text

Ошибка на подготовительном этапе, обновление отменено

  • Нет исходного подключения к ККТ
  • Ошибка проверки состояния бумаги и крышки
  • Отсутствует бумага
  • Крышка открыта
  • Ошибка проверки версии загрузчика
  • Загрузчик слишком старой версии
  • Ошибка проверки состояния смены
  • Смена открыта
  • Ошибка сохранения таблиц с параметрами
  • Ошибка переключения ККТ в режим обновления прошивки (DFU mode)
  • Не найдено устройств в режиме обновления прошивки (до 1 минуты на самостоятельное возвращение ККТ в штатный режим)
422 Error text

Ошибка установки и настройки обновления, восстановлена исходная версия прошивки

  • Ошибка записи прошивки
  • Нет подключения к ККТ после записи прошивки
  • Ошибка выполнения технологического обнуления
  • Ошибка установки даты и времени
  • Ошибка восстановления таблиц с параметрами
  • Ошибка при запросе перезапуска ККТ
  • Нет подключения к ККТ после завершающего перезапуска устройства
500 Error getting files from server Ошибка при попытке получения файлов с сервера S3
503 Initial error: {error text}. Rollback error: {error text}

Ошибка установки и настройки обновления, ошибка восстановления исходной версия прошивки

Ответ содержит текст ошибки обновления и текст ошибки отката. Сами ошибки те же, что и для кодов 412 и 422

Попытка восстановления ККТ

Если при обновлении прошивки произошла ошибка в результате которой ККТ оказался в нерабочем состоянии данный метод позволяет попробовать вернуть ККТ в штатный режим (нет гарантии успеха).

Метод запустится только если в redis существует запись с параметрами ККТ, т.е. только после обновления с ошибкой и до перезагрузки терминала.

Перед вызовом метода имеет смысл проверить кабели подключения ККТ и вручную выключить-включить ККТ кнопкой на его панели.

Используя текущую прошивку метод проводит техобнуление, восстанавливает дату и время и восстанавливает параметры ККТ из redis, после чего ККТ перезапускается; все ошибки обмена сообщениями с ККТ игнорируются.

Код ответа
Значение
200 Процесс отработал успешно (высокая вероятность восстановления, но не 100% гарантия)
412 No saved parameters tables found, unable to recover Нет записи с параметрами в redis, восстановление невозможно
412 No initial connection to KKT, unable to recover Нет исходного подключения к ККТ, восстановление невозможно
503 No connection to KKT after final device reboot Нет подключения к ККТ после завершающего перезапуска устройства
Back to top