Интеграция с информационной системой

Справочник кодов ошибок 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 представление для вложения с испорченным или недопустимым содержимым.

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

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