Справочник кодов ошибок API Saby

В справочнике собраны коды ошибок, которые могут вернуть методы внешнего API Saby. Используйте его для диагностики проблем.

Расширенные коды ошибок имеют вид:

• 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-1FA000010002 — ошибка адресации связанного документа;
  • 00000000-0000-0000-0000-1FA000010004 — ошибка из-за неполной или неверной информации о сертификате;
  • 00000000-0000-0000-0000-1FA000010005 — ошибка из-за неверно указанного или несуществующего типа документа;
  • 00000000-0000-0000-0000-1FA000010007 — ошибка адресации документа или редакции документа;
• 00000000-0000-0000-0000-1FA00002XXXX — ошибки, которые связаны с криптографией;
• 00000000-0000-0000-0000-1FA00003XXXX — ошибки модуля работы с формализованными документами;
• 00000000-0000-0000-0000-1FA00004XXXX — ошибки запуска в документооборот;
• 00000000-0000-0000-0000-1FA00008XXXX — ошибки поиска абонентского ящика;
• 00000000-0000-0000-0000-1FA0000DXXXX — ошибки лицензирования;
• 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 — «невозможно выполнить преобразование». Например нарушена структура вложения или оно повреждено вирусом.

Нефатальные ошибки

Чтобы исправить ошибку, достаточно повторить запрос. Изменять параметры запроса не требуется.

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

Ошибка с любым другим кодом считается фатальной.