ККТ
Для обновления должен присутствовать чековый рулон, крышка закрыта, в ККТ должен быть загрузчик минимально необходимой версии, а также должна быть закрыта смена. Продолжительность: около 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
|
Нет подключения к ККТ после завершающего перезапуска устройства |