Интеграция со СБИС

Справочник кодов ошибок API-интерфейса

Справочник кодов ошибок API-интерфейса

Расширенные коды ошибок внешнего API-интерфейса СБИС имеют вид:

  • 00000000-0000-0000-0000-1XXXXXXXXXXX, где X — шестнадцатиричное значение (0..9, А..F).
  • 00000000-0000-0000-0000-100000000000 — ошибка общего вида, не имеющая классификации. Как правило, фатальная.

Фатальные ошибки — не подразумевают исправление. При повторной отправке запроса без изменения его тела имеют вид — 00000000-0000-0000-0000-1FAXXXXXXXXX.Символы «FA» в коде означают «fatal».

  • 00000000-0000-0000-0000-1FA00001XXXX — фатальные ошибки входных параметров.
  • 00000000-0000-0000-0000-1FA00002XXXX — ошибки, которые связаны с криптографией.
  • 00000000-0000-0000-0000-1FA00003XXXX — ошибки модуля работы с формализованными документами.
  • 00000000-0000-0000-0000-1FA00004XXXX — ошибки запуска в документооборот.
  • 00000000-0000-0000-0000-1FA0000FXXXX — ошибки форматно-логического контроля.
  • 00000000-0000-0000-0000-1FA000001000 — код фатальной ошибки при аутентификации.
  • 00000000-0000-0000-0000-1FA000001001 — ошибка аутентификации. Возникает если данные в полях «Логин»/«Пароль» не указаны или указаны неверно.
  • 00000000-0000-0000-0000-1FA000001002 — код фатальной ошибки аутентификации. Возникает, когда для дальнейшей работы требуется подтверждение действий от пользователя.
  • 00000000-0000-0000-0000-1FA0000A0001 — «невозможно выполнить преобразование». Возникает при попытке получить архив,PDF-файл, PDF или HTML-представление документа, имеющее вложение с испорченным или недоспустимым содержимым.

Нефатальные ошибки — подразумевают исправление. При повторной отправке запроса изменения тела запроса не требуется.

  • 00000000-0000-0000-0000-1AAXXXXXXXX — общая маска ошибок.
  • 00000000-0000-0000-0000-1AA00001XXXX — ошибки внутренних сервисов.
  • 00000000-0000-0000-0000-1AA0000F1002 — предупреждение о необходимости повторить запрос через 3-5 секунд. Повтор нужен для получения результата асинхронного запроса.
  • 00000000-0000-0000-0000-1AA000001000 — код нефатальной ошибки аутентификации.