--- metadata: - name: generator content: Diplodoc Platform v5.50.3 alternate: - https://yandex.ru/dev/ofd/doc/ru/concepts/response-codes.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/ofd/doc/ru/llms.txt # Коды ответов и ошибки {% note alert %} Новые ключи выдаются в новом формате. Подробнее ознакомиться можно в [Справке API Яндекс ОФД](https://yandex.ru/support/ofd-api/ru/). {% endnote %} ## Перечень кодов с описанием {#codes} По коду ответа можно узнать результат выполнения операции. В таблице приведен список кодов, которые поддерживаются в 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|Неверная структура тела запроса. Возможные причины см. [ниже](#422errors).|| ||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) {#422errors} 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|В визард переданы ККТ из разных компаний. ## Формат сообщения об ошибке {#error-format} Если во время выполнения запроса произошла ошибка, API отвечает одним из кодов (таблица кодов приведена [выше](#codes)) и возвращает информацию об ошибке в теле ответа: ```json { "description": "{Описание ошибки}", "message": "{Сообщение}", "code": {Код ошибки} } ``` ## Ошибки от системы электронного документооборота {#error-codes} Описание ошибок от системы электронного документооборота ([ЭДО](*ЭДО)), которые возвращаются в запросах регистрации и перерегистрации ККТ в ФНС. Параметры: Код|Сообщение|Описание --|--|-- 1|IRUD error|Ошибка [ИРУД](*ИРУД) (ошибка проверка подписей или ошибка регистрации пользователей в ИРУД). 2|Rejected to accept declaration|Заявление на регистрацию кассы не принято ЭДО. 3|Rejected to register|Заявление на регистрацию отклонено отделением ФНС. 4|Rejected to accept|Документ не принят ЭДО. 5|Wrong report|В ЭДО передан некорректный тип документа. 6|Wrong fiscal sign error|У отчета о регистрации указан невалидный фискальный признак. [*ИРУД]: Информационный реестр участников документооборота. Позволяет проводить автоматическую регистрацию и актуализацию регистрационных данных участников информационной системы ФНС России. [*ЭДО]: Электронный документооборот. Представляет собой юридически значимый обмен электронными документами, подписанными [КЭП](https://yandex.ru/dev/ofd/doc/ru/concepts/glossary.md#kap).