Перейти к содержимому

Ошибки сервиса и ККТ

Общий список ошибок АТОЛ Онлайн v5 - ошибки сервиса (коды 0–56) и ошибки при работе с ККТ (agent, driver, system).

Ошибки сервиса

Номер кода продублирован в колонке «Описание»

Ошибки сервиса опознаются по имени (MissingToken, StateCheckNotFound), а числовой код - вспомогательный: в ответе он приходит в поле error.code. Чтобы строку можно было найти и по номеру, номер продублирован в тексте описания (« - код 34»). Это единственное назначение приписки: значения кодов и их имена не менялись, колонка «Код» остается первоисточником.

Не путайте эти номера с кодами ККТ из раздела ниже: там коды - строки с ведущими нулями (013, 034), и 034 ККТ никак не связан с сервисной ошибкой 34.

ОшибкаКодHTTPОписаниеУстранение
Undefined0400Неизвестная ошибка обработки - код 0Обратитесь к администратору с полученным error_id
IncomingChequeProcessingFailed1400Сервер не смог обработать входной чек - код 1Обратитесь к администратору с error_id
MissingToken10401Не распознан токен запроса - код 10Повторите запрос с тем же или новым external_id, указав корректный Token в заголовке
ExpiredToken11401Переданный токен не активен (срок действия 24 часа истек) - код 11Запросите новый токен
WrongLoginOrPassword12401Неверный логин или пароль - код 12Повторите запрос с корректными данными
ValidationException13400Ошибка валидации входящего запроса (с перечнем ошибочных полей) - код 13Повторите запрос с корректными данными
UserBlocked14403Пользователь заблокирован - код 14Обратитесь в техподдержку АТОЛ Онлайн для разблокировки
GroupCodeAndTokenDontMatch20401Код группы не соответствует токену - код 20Повторите запрос с корректным group_code, соответствующим токену
NotSupportedGroupCodeForProtocol21401Код группы не поддерживает данную версию протокола - код 21Кассы группы не поддерживают ФФД 1.2 / v5 - отправьте запрос на v4 (ФФД 1.05)
MissingUuid30400Передан некорректный UUID (статус Fail) - код 30Повторите запрос с корректным UUID
IncomingOperationNotSupported31400Операция не поддерживается - код 31Проверьте значение operation и повторите запрос
IncomingValidationException32400Ошибка валидации входного чека (статус Fail) - код 32Повторите запрос с корректными данными
IncomingExternalIdAlreadyExists33400Чек с таким external_id и group_code уже существует (статус Wait) - код 33Документ уже в базе - не дублируйте
StateCheckNotFound34200Состояние чека не найдено (статус Wait) - код 34Документ еще не обработан - повторите запрос результата позже. Повторно отправлять чек не нужно
BadRequest40400Некорректный запрос - код 40Проверьте HTTPS-запрос, заголовки и тело
UnsupportedMediaType41415Некорректный Content-Type - код 41Укажите Content-type: application/json; charset=utf-8
TSPIOTRequired42400В группе нет касс с ТС ПИоТ (статус Fail) - код 42Добавьте в группу кассу с ТС ПИоТ или укажите "use_tspiot": false в запросе и отправьте чек повторно
ErrorServerConfiguration50500Ошибка сервера - код 50Обратитесь к администратору
KKTRequired56400Нет касс в группе или все кассы неактивны (статус Fail) - код 56Чек не обработан: все кассы группы выключены или неактивны - обратитесь к администратору
- (timeout)1-Превышено время ожидания чека в очереди (тип Timeout, статус Fail) - код 11) Количество ККТ в группе не соответствует скорости поступления чеков - подключите дополнительные ККТ или снизьте поток. 2) Все кассы группы выключены или неактивны - обратитесь к администратору

Ошибки при работе с ККТ

Возвращаются в ответе метода report в объекте error. Поле error.type показывает источник: driver - ошибка кассы, agent - ошибка агента (сервиса на стороне ККТ), system - системная ошибка.

Ниже - полный перечень кодов из раздела 7.2 документа «АТОЛ Онлайн. Описание протокола v5 (ФФД 1.2)», версия 3.16 (211 кодов). Коды разделены по способу устранения: часть исправляется в самом чеке, остальные означают сбой кассы.

Коды ККТ - строки с ведущими нулями (013, 060), а не числа. Сравнивайте их как строки: error.code === "013".

Ошибки данных чека (исправьте чек и отправьте повторно)

По этим кодам чек не зарегистрирован: исправьте данные и отправьте документ заново. Допускается ли при этом тот же external_id, протокол явно не описывает; безопасный вариант - новый external_id с суффиксом попытки (order-42-sell-2).

КодОписаниеТипУстранение
2003ИНН, указанный в чеке не соответствует ИНН компании.agentПроверьте чек, измените ИНН, повторите попытку.
2006Некорректный формат JSONagentНекорректно указано значение одного из полей в запросе или поле отсутствует. Необходимо исправить чек и отправить повторно.
2007Некорректное значение в JSONagentНекорректно указано значение одного из полей в запросе или поле отсутствует. Необходимо исправить чек и отправить повторно.
2009ИНН в запросе не совпадает с ИНН на кассеagentВ чеке указан ИНН не соответствующий ИНН в кассе. Необходимо исправить чек и отправить повторно.
013Некорректное значение параметраdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
016Неверная цена (сумма)driverНеверная цена (сумма). Необходимо исправить чек и отправить повторно.
017Неверное количествоdriverНеверное количество в товарной позиции чека. Необходимо исправить чек и отправить повторно.
023Невозможно начислить скидку/надбавкуdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
024Неверный код товараdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
027Неверная длинаdriverНекорректно указано значение одного из полей в запросе или поле отсутствует. Необходимо исправить чек и отправить повторно.
041Недостаточное количество товараdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
048Неверный тип чекаdriverНеверный тип чека. Необходимо исправить чек и отправить повторно.
052Сумма не наличных платежей превышает сумму чекаdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
053Накопление меньше суммы возврата или аннулированияdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
060Неверный вид оплатыdriverНеверный вид оплаты. Необходимо исправить чек и отправить повторно.
066Чек оплачен не полностьюdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
098Невозможно закрыть чек данным типом оплатыdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
110Недопустимое кол- во позиций в чекеdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
128Некорректная сумма налогаdriverНекорректная сумма налога. Необходимо исправить чек и отправить повторно.
143Некорректная СНОdriverУказана некорректная система налогообложения. Исправьте чек и отправьте повторно.
144Недопустимый номер ставки налогаdriverНеверная ставка налога. Необходимо исправить чек и отправить повторно.
145Недопустимый тип оплаты товараdriverНеверный тип оплаты. Необходимо исправить чек и отправить повторно.
147Недопустима регистрация подакцизного товараdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
161Не указаны обязательные реквизитыdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
163Переполнение чисел с плавающей точкойdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
193Неверное значение GTINdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
215Недопустимое сочетание реквизитов 1212 и 1030driverНекорректный запрос. Необходимо исправить чек и отправить повторно.
216Некорректный признак способа расчетаdriverНеверный признак способа расчета. Необходимо исправить чек и отправить повторно.
217Некорректный признак предмета расчетаdriverНеверный признак предмета расчета. Необходимо исправить чек и отправить повторно.
228Запрещена одновременная передача КМ и реквизита 1162driverНекорректный запрос. Необходимо исправить чек и отправить повторно.
231Некорректная сумма акцизаdriverНекорректная сумма акциза. Необходимо исправить чек и отправить повторно.
243Некорректная сумма налогаdriverНекорректная сумма налога. Необходимо исправить чек и отправить повторно.
244Некорректное значение типа кода маркировкиdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
261Отсутствует позиция оплатыdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
265Подакцизный товар без акциза зарегистрирован в чекеdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
405Неверный код GS1driverНекорректный запрос. Необходимо исправить чек и отправить повторно.
408Переполнена таблица хранения КМdriverВ чеке указано более 128 КМ. ФН допускает включение в чек не более 128 КМ. Необходимо исправить чек и отправить повторно.
409Некорректный код маркировкиdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
412Некорректное значение единиц измеренияdriverНекорректный запрос. Необходимо исправить чек и отправить повторно.
-2146233033Ошибка форматирования чекаsystemНекорректно указано значение одного из полей в запросе или поле отсутствует. Необходимо исправить чек и отправить повторно.

Сбои кассы и сервиса (обратитесь к администратору)

Устранение для всех кодов ниже - «Произошел сбой кассы, обратитесь к администратору». Исключения: для 036 и 040 достаточно отправить чек повторно, 063 означает превышение лимита по сумме чека. В остальных случаях повторная отправка того же чека без вмешательства администратора, как правило, не помогает. Тексты ошибок приведены как в протоколе АТОЛ Онлайн.

КодОписаниеТип
2004Внутренняя ошибка сервиса.agent
2005Внутренняя ошибка сервиса.system
001Соединение не установленоdriver
002Нет связиdriver
003Порт занятdriver
004Порт недоступенdriver
005Некорректные данные от устройстваdriver
006Внутренняя ошибка библиотекиdriver
007Неподдерживаемое преобразование типа параметраdriver
008Не найден обязательный параметрdriver
009Некорректные настройкиdriver
010Драйвер не настроенdriver
011Не поддерживается в данной версии (драйвера или ККТ)driver
012Не поддерживается в данном режимеdriver
014Не удалось загрузить библиотекуdriver
015Неизвестная ошибкаdriver
018Переполнение счетчика наличностиdriver
019Невозможно сторно последней операцииdriver
020Сторно по коду невозможноdriver
021Невозможен повтор последней операцииdriver
022Повторная скидка на операцию невозможнаdriver
026Неверный формат командыdriver
028ККТ заблокирована в режиме ввода датыdriver
029Требуется подтверждение ввода датыdriver
030Нет больше данныхdriver
031Нет подтверждения или отмены продажиdriver
032Отчет о закрытии смены прерванdriver
034Вход в режим заблокированdriver
035Проверьте дату и времяdriver
036Переданные дата/время меньше даты/времени последнего фискального документаdriver
038Товар не найденdriver
040Переполнение буфера чекаdriver
042Сторнируемое количество больше проданногоdriver
043Товар не найденdriver
054Переполнение суммы платежейdriver
055Предыдущая операция незавершенаdriver
057Неверная величина скидки / надбавкиdriver
058Операция после скидки / надбавки невозможнаdriver
059Неверная секцияdriver
061Переполнение при умноженииdriver
062Операция запрещена в таблице настроекdriver
063Переполнение итога чекаdriver
064Открыт чек аннулирования – операция невозможнаdriver
065Переполнение буфера ЭЖdriver
067Открыт чек возврата – операция невозможнаdriver
068Смена превысила 24 часаdriver
069Открыт чек продажи – операция невозможнаdriver
070Переполнение ФПdriver
071Неверный парольdriver
072Идет обработка ЭЖdriver
073Смена закрыта - операция невозможнаdriver
077Неверная дата и/или времяdriver
078Неверная сумма сторноdriver
080В ККТ нет денег для выплатыdriver
081Чек закрыт – операция невозможнаdriver
082Чек открыт – операция невозможнаdriver
083Смена открыта, операция невозможнаdriver
086Неверный номер сменыdriver
089ККТ не зарегистрированаdriver
090Не задан серийный номерdriver
093Данные документа отсутствуютdriver
095Требуется выполнение общего гашенияdriver
097Невозможна отмена скидки/надбавкиdriver
104Ошибка обмена с фискальным модулемdriver
105Необходимо провести профилактические работыdriver
106Неверные номера смен в ККТ и ФНdriver
107Нет устройства, обрабатывающего данную командуdriver
109Ошибочное состояние ТРКdriver
111Ошибочный номер ТРКdriver
112Неверный делительdriver
115Ошибка обмена с ФН на уровне интерфейса I2Cdriver
116Ошибка формата передачи ФНdriver
117Неверное состояние ФНdriver
118Неисправимая ошибка ФНdriver
119Ошибка КС ФНdriver
120Закончен срок эксплуатации ФНdriver
121Архив ФН переполненdriver
122В ФН переданы неверная дата или времяdriver
123В ФН нет запрошенных данныхdriver
124Переполнение ФН (итог чека / смены)driver
125Буфер переполненdriver
127Требуется гашение ЭЖdriver
129Начисление налога на последнюю операцию невозможноdriver
131Сумма сторно налога больше суммы зарегистрированного налога данного типаdriver
132Операция невозможна, недостаточно питанияdriver
133Некорректное значение параметров команды ФНdriver
134Превышение размеров TLV данных ФНdriver
135Нет транспортного соединения ФНdriver
136Исчерпан ресурс КС ФНdriver
137Ресурс хранения ФД исчерпанdriver
138Сообщение от ОФД не может быть принято ФНdriver
139В ФН есть неотправленные ФДdriver
140Исчерпан ресурс ожидания передачи сообщения в ФНdriver
141Продолжительность смены ФН более 24 часовdriver
142Неверная разница во времени между двумя операциями ФНdriver
146Недопустимый тип кода товараdriver
148Ошибка программирования реквизитаdriver
149Неверный тип счетчикаdriver
154Недопустимое значение режима работы с налогомdriver
158Неразрешенные реквизитыdriver
159Ошибка интерфейса ФНdriver
160Дублирование данныхdriver
162Ошибка чтения документа из ФНdriver
165Внутренняя ошибка ККТdriver
166ФН не найденdriver
167Невозможно записать реквизит агентаdriver
168Недопустимое сочетания реквизитов 1002 и 1056driver
169Недопустимое сочетания реквизитов 1002 и 1017driver
172Кассир не зарегистрированdriver
177Закрытие чека прерваноdriver
178Получение документа из ФН прерваноdriver
179Сбой часовdriver
180Сбой памятиdriver
181Сбой микросхемыdriver
183Недопустимое значение MAC-адресаdriver
188Требуется перезагрузка ККТdriver
189Подходящие лицензии не найденыdriver
190Неверная версия ФФДdriver
191Параметр доступен только для чтенияdriver
192Неверный тип кода товараdriver
194Отрицательный результат математической операцииdriver
195Недопустимое сочетание реквизитовdriver
196Ошибка регистрации кассираdriver
197Данный канал Интернет отсутствует в ККТdriver
198Дата и время не синхронизированыdriver
199Ошибка электронного журналаdriver
200Документ открыт операция невозможнаdriver
201Документ закрыт операция невозможнаdriver
203Произошла критичная ошибка, документ необходимо отменитьdriver
204Регистры ККТ еще не инициализированыdriver
205Требуется регистрация итогаdriver
206Сбой таблицы настроекdriver
207Сбой счетчиков и регистров ККТdriver
208Сбой пользовательской памятиdriver
209Сбой сервисных регистровdriver
210Сбой реквизитов ККТdriver
211ККТ уже в режиме обновления конфигурацииdriver
212Конфигурация не прошла проверкуdriver
213Аппаратный канал отсутствует, выключен или еще не проинициализированdriver
214Сетевой интерфейс не подключен, или на нем не получен IP-адресdriver
221Сетевой интерфейс занятdriver
224Архив ФН закрытdriver
225Нужно выполнить регистрацию / перерегистрациюdriver
226Операция невозможна, идет обновление ПО ККТdriver
227Неверный итог чекаdriver
230Ошибка цифровой подписиdriver
241Соединение с ККТ потеряноdriver
245Аппаратная ошибка при сохранении лицензииdriver
246Подпись лицензии некорректнаdriver
247Лицензия не подходит для данной ККТdriver
248Срок действия лицензии истекdriver
249Документ был отмененdriver
251Длина клише превышает максимальное значениеdriver
258Ошибка чтения/записи данных кешаdriver
262Таймаут выполнения команды истекdriver
263Режим ФР выключенdriver
264Не найдена запись в OTPdriver
402Ошибка соединения с серверомdriver
404Некорректное значение статуса КМdriver
406Запрещена работа с маркированным товарамиdriver
407Работа с маркированными товарами временно заблокированаdriver
410Неверное состояниеdriver
411Ошибка обмена с сервером ОФД или ИСМdriver
413Операция не разрешена в данной версии ФФДdriver
414Операция не разрешена, при регистрации не был установлен признак ТМТdriver
418Требуется повторное проведение процедуры обновления ключейdriver
419Ошибка сервиса обновления ключей проверки КМdriver
420КМ не проверен в ФНdriver
421Истек таймаут проверки КМdriver
501Ошибка парсинга чека / запросаdriver
502Выполнение прервано из-за предыдущих ошибокdriver

Коды маркировки (ФФД 1.2) распределены по обеим таблицам: 405, 408, 409, 412 исправляются в чеке, а 404, 406, 407, 410, 411, 413, 414, 418–421 означают сбой кассы или обмена с ИСМ. Про 421 («Истек таймаут проверки КМ») см. параметр ism_optional в регистрации документа.