Коды ответов и ошибки

Перечень кодов с описанием

По коду ответа можно узнать результат выполнения операции. В таблице приведен список кодов, которые поддерживаются в API ОФД.

HTTP-код Код ошибки Сообщение Описание
200 - OK Успешный запрос.
204 - No Content Успешный запрос. Ответ не содержит тела сообщения.
405 0 The method is not allowed for the requested URL HTTP-метод запрещен для данного ресурса.
401 1 Incorrect Yandex Key Ошибка авторизации по заголовку X-Yandex-Key.
401 1 Incorrect X-Yandex-Uid header Ошибка авторизации по заголовку X-Yandex-Uid.
401 2 Incorrect Ofd Key Ошибка авторизации по заголовку X-Ofd-Key.
401 2 User is not associated with a client К пользователю не привязан клиент.
403 3 Company not found К запрошенной компании нет доступа или она не существует.
403 4 Cash Register not found К запрошенной кассе нет доступа или она не существует.
400 5 Bad Request Ошибочные данные в запросе. Возможные причины:
  • синтаксическая ошибка в запросе;
  • ошибка в параметре запроса (параметр отсутствует или значение параметра задано неверно);
  • слишком большой запрос.
422 7 Invalid payload structure Неверная структура тела запроса. Возможные причины см. ниже.
403 18 Registration was not found Диалог не найден.
403 22 Retail point was not found Точка продаж не найдена.
403 23 Wrong registration status Регистрация в неправильном статусе чтобы вызывать этот метод.
403 25 Document not found Документ не найден.
500 26 Nalog.ru request error Ошибка соединения с ФНС.
403 27 Vendor not found Поставщик не найден.
403 29 Sign not found КСКПЭП не найден.
403 34 Client has no access for the offer У клиента нет доступа к данному предложению.
500 35 Cannot create sign registration request Не удалось создать запрос на регистрацию.
500 36 Incorrect data for registration Неудачная попытка регистрации.
500 37 File was not sent Файл не был передан.
500 38 Cannot add document to sign registration Не удалось добавить документ к запросу на регистрацию.
503 39 Sign service is unavailable. Please retry the request Вышло время ожидания подписи документов.
500 39 Sign registration not found Запрос на регистрацию не найден.
500 40 Cannot send sign registration Не удалось отправить заявку в сервис получения электронной подписи (ЗАО «Калуга Астрал»).
400 41 Kaluga answered with error Сервис получения электронной подписи (ЗАО «Калуга Астрал») ответил ошибкой.
400 42 Sign request has wrong status Заявка находится в неверном состоянии.
400 43 Unable to get certificate Не удалось получить сертификат.
503 47 Unable to download document Не удалось скачать файл.
400 48 Unknown aggregation group type Неизвестный тип группировки для агрегации.
500 51 Cannot create sign edit request Не удалось создать запрос на изменение.
500 55 Cannot delete request Не удалось удалить заявку.
403 60 FiscalCorrection not found Перерегистрация ККТ не найдена.
400 60 File has incorrect format Неверный формат файла.
400 62 CashboxImport has wrong status Заявка на заведение ККТ находится в неверном состоянии.
403 63 FiscalCorrection not found Перерегистрация ККТ не найдена.
403 64 User passport linked to another client Пользователь привязан к другому клиенту.
400 65 General user assosiation error Ошибка привязки клиента к пользователю.
403 66 Subpartner not found К запрошенному субпартнеру нет доступа или он не существует.
403 67 User not found Пользователь не найден.
403 68 Role not found Роль не найдена.
403 69 Permission not found Право доступа не найдено.
400 70 User passport linked to this client Пользователь привязан к этому клиенту.
400 71 User passport not found Пользователь не найден в биллинге.
400 72 Client not found in billing Клиент не найден в биллинге.
400 73 User already exists Пользователь уже существует.
403 74 FiscalCorrection is active please stop it before starting new dialogue Перерегистрация в процессе ожидания.
403 75 Cant stop not active FiscalCorrection Перерегистрация не активна.
500 76 Cannot authenticate by OAuth Ошибка при обращению к ЧЯ.
401 77 Invalid x-token Ошибка авторизации по OAuth.

Вложенные коды ошибки 422 (Invalid payload structure)

HTTP-код Код ошибки Сообщение Описание
422 1 ERR_FORMAT Некорректный формат параметра.
2 ERR_INVALID Неверный тип параметра.
3 ERR_REQUIRED Отсутствует обязательный параметр.
4 ERR_NULL <параметр> <Параметр> не может иметь значение «NULL».
5 ERR_NOT_FOUND Неизвестное параметр.
6 ERR_DUPLICATE Параметр не найден.
7 ERR_NOT_ALLOWED К параметру нет доступа.
8 ERR_COUPON_DISABLED Купон отключен.
9 ERR_COUPON_USED Купон выключен.
10 ERR_COUPON_INN Некорректный ИНН для применяемого купона.
11 ERR_COUPON_QUOTA Превышена квота по купонам.
12 ERR_DIFFERENT_COMPANIES В визард переданы ККТ из разных компаний.

Формат сообщения об ошибке

Если во время выполнения запроса произошла ошибка, API отвечает одним из кодов (таблица кодов приведена выше) и возвращает информацию об ошибке в теле ответа:

{
    "description": "{Описание ошибки}",
    "message": "{Сообщение}",
    "code": {Код ошибки}
}

Ошибки от системы электронного документооборота

Описание ошибок от системы электронного документооборота (ЭДО), которые возвращаются в запросах регистрации и перерегистрации ККТ в ФНС.

Параметры:

Код Сообщение Описание
1 IRUD error Ошибка ИРУД (ошибка проверка подписей или ошибка регистрации пользователей в ИРУД).
2 Rejected to accept declaration Заявление на регистрацию кассы не принято ЭДО.
3 Rejected to register Заявление на регистрацию отклонено отделением ФНС.
4 Rejected to accept Документ не принят ЭДО.
5 Wrong report В ЭДО передан некорректный тип документа.
6 Wrong fiscal sign error У отчета о регистрации указан невалидный фискальный признак.