.. _annex_at:

Приложение А Перечень типовых ошибок и пути их решения
========================================================

.. table:: Ошибки при выполнении запросов от ИС Потребителя к Агенту СМЭВ4

    +---------------+---------------------------------------------+---------------------------------------------------------------+----------------------------------------------------------------------+
    | Код ошибки для| Код ошибки в СЦЛ                            | Описание и возможные причины                                  | Решение                                                              |
    | ИС Потребителя|                                             |                                                               |                                                                      |
    +------+--------+                                             |                                                               |                                                                      |
    | REST | JDBC   |                                             |                                                               |                                                                      |
    |      |        |                                             |                                                               |                                                                      |
    +======+========+=============================================+===============================================================+======================================================================+
    | 202  | n/a    | ``RESULT_NOT_FOUND_BY_ID``;                 | результат по заданному идентификатору SQL-запроса             | повторить запрос на получение результата асинхронного запроса позже  |
    |      |        |                                             | еще не поступил (для асинхронных запросов)                    |                                                                      |
    |      |        | ``RESULT_DELETED``.                         |                                                               |                                                                      |
    +------+--------+---------------------------------------------+---------------------------------------------------------------+----------------------------------------------------------------------+
    | 400  | 17473, | ``QUERY_NOT_VALID_CALL`` ;                  | ошибка в запросе:                                             | скорректировать запрос в соответствии с:                             |
    |      | 17521, |                                             |                                                               |                                                                      |
    |      | 17800  | ``QUERY_NOT_SUPPORTED_YET``;                | - 400: ошибка в запросе,                                      | - описанием интерфейса Агента СМЭВ4;                                 |
    |      |        |                                             |   информация об ошибке содержится в параметре «error»;        | - описанием метаданных SQL-РЗ;                                       |
    |      |        | ``QUERY_NOT_SUPPORTED_ALREADY``.            | - 17473: запрос не прошел проверку корректности;              | - спецификацией REST-сервиса ИС Ответчика.                           |
    |      |        |                                             | - 17521: заданный таймаут превышает допустимый;               |                                                                      |
    |      |        |                                             | - 17800: запрос содержит указание на неподдерживаемую Витрину.|                                                                      |
    +------+--------+---------------------------------------------+---------------------------------------------------------------+----------------------------------------------------------------------+
    | 401  | 17001  | ``INTERNAL_ERROR``                          | ошибка аутентификации и авторизации:                          | - проверить настройки Агента СМЭВ4 на соответствие                   |
    |      |        |                                             |                                                               |   Руководству Администратора Агента;                                 |
    |      |        |                                             | - отсутствие подписи;                                         | - указать мнемонику ИС, от которой выполняется запрос,               |
    |      |        |                                             | - невалидный сертификат;                                      |   в заголовке ``X-PODDв случае блокировки -CLIENT-SYSTEM-MNEMONIC``; |
    |      |        |                                             | - некорректная подпись;                                       | - обратиться в СЦ для уточнения причин блокировки.                   |
    |      |        |                                             | - в спецификации REST-сервиса ИС Ответчика присутствует       |                                                                      |
    |      |        |                                             |   заголовок ``X-PODD-CLIENT-SYSTEM-MNEMONIC``,                |                                                                      |
    |      |        |                                             |   в котором Инициатор передал значение,                       |                                                                      |
    |      |        |                                             |   отличное от мнемоники своей ИС;                             |                                                                      |
    |      |        |                                             | - потребитель заблокирован (ликвидация организации            |                                                                      |
    |      |        |                                             |   или отсутствие категории участника взаимодействия).         |                                                                      |
    +------+--------+---------------------------------------------+---------------------------------------------------------------+----------------------------------------------------------------------+
    | 403  | 17472, | ``PERMISSION_NOT_FOUND``;                   | нет полномочий на выполнение запроса,                         | - проверить наличие прав доступа                                     |
    |      | 17404, |                                             | в том числе при блокировке полномочий                         |   к регламентированному запросу в ЛК УВ;                             |
    |      | 17405, | ``PERMISSION_BLOCKED``.                     | на стороне Поставщика                                         | - обратиться к Поставщику запроса за утверждением полномочий.        |
    |      | 17406  |                                             |                                                               |                                                                      |
    +------+--------+---------------------------------------------+---------------------------------------------------------------+----------------------------------------------------------------------+
    | 404  | n/a    | ``QUERY_NOT_FOUND``;                        | - истекло время жизни ответа;                                 | - для асинхронных запросов повторить исходный запрос,                |
    |      |        |                                             | - спецификация REST-сервиса ИС Ответчика не зарегистрирована; |   при необходимости указав больший таймаут;                          |
    |      |        | ``QUERY_VERSION_NOT_FOUND``.                | - в Агенте отключена функция (профиль) Потребителя SQL-РЗ.    | - проверить наличие спецификации REST-сервиса ИС Ответчика в ЛК УВ;  |
    |      |        |                                             |                                                               | - обновить настройки Агента СМЭВ4 в соответствии с                   |
    |      |        |                                             |                                                               |   Руководством Администратора Агента СМЭВ4.                          |
    +------+--------+---------------------------------------------+---------------------------------------------------------------+----------------------------------------------------------------------+
    | 406  | n/a    | ``QUERY_NOT_VALID_SPEC``                    | неподдерживаемая версия протокола                             | скорректировать запрос в соответствии с                              |
    |      |        |                                             |                                                               | описанием интерфейса Агента СМЭВ4                                    |
    +------+--------+---------------------------------------------+---------------------------------------------------------------+----------------------------------------------------------------------+
    | 429  | 17471  | ``CONSUMER_IS_BLOCKED_BY_REQUEST_VOLUME``;  | ИС УВ временно заблокирована в связи с                        | повторить запрос позже с меньшей частотой                            |
    |      |        |                                             | превышением лимитов                                           | или меньшим объемом передаваемых данных                              |
    |      |        | ``CONSUMER_IS_BLOCKED_BY_RESPONSE_VOLUME``; |                                                               |                                                                      |
    |      |        |                                             |                                                               |                                                                      |
    |      |        | ``CONSUMER_IS_BLOCKED_BY_COUNT``.           |                                                               |                                                                      |
    +------+--------+---------------------------------------------+---------------------------------------------------------------+----------------------------------------------------------------------+
    | 500  | 17001  | ``INTERNAL_ERROR``                          | внутренняя ошибка                                             | - действие в соответствии с текстом ошибки;                          |
    |      |        |                                             |                                                               | - проверить настройки Агента СМЭВ4 на соответствие                   |
    |      |        |                                             |                                                               |   Руководству Администратора Агента СМЭВ4;                           |
    |      |        |                                             |                                                               | - обратиться в СЦ, в случае необходимости.                           |
    +------+--------+---------------------------------------------+---------------------------------------------------------------+----------------------------------------------------------------------+
    | 408, | 17520  | ``CANCEL_BY_TIMEOUT``                       | превышен таймаут на исполнение запроса                        | - указать больший таймаут в запросе;                                 |
    | 503  |        |                                             |                                                               | - обратиться в СЦ, если ошибка регулярно повторяется.                |
    +------+--------+---------------------------------------------+---------------------------------------------------------------+----------------------------------------------------------------------+
    | 503  | 17503  | ``INTERNAL_ERROR``                          | Поставщик заблокирован (ликвидация организации                | - обратиться в СЦ для уточнения причин блокировки                    |
    |      |        |                                             | или отсутствие категории участника взаимодействия)            |                                                                      |
    +------+--------+---------------------------------------------+---------------------------------------------------------------+----------------------------------------------------------------------+