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

СБИС.ПрочитатьДокумент

СБИС.ПрочитатьДокумент

Команда СБИС.ПрочитатьДокумент возвращает последнюю редакцию документа с заданным идентификатором документа либо редакции.

Адрес для выполнения запроса: https://online.sbis.ru/service/?srv=1

Параметры строки запроса

  • "Документ": объект
    • "Идентификатор"*: строка, идентификатор обрабатываемого документа.
    • "Редакция": объект
      • "Идентификатор"*: строка, идентификатор обрабатываемой редакции документа

* — обязательные параметры.

Результат запроса:

  • "Документ": объект, отражает текущее состояние документа (последнюю редакцию) при определении по Документ.Идентификатор или состояние редакции при определении по Документ.Редакция.Идентификатор.

Комментарий

В случае чтения документа с многостраничным вложением данные, возвращаемые по ссылке "Документ.Вложение.Файл.Ссылка", содержат zip-архив со следующего содержания:

  • Файлы страниц. Имена файлов не изменяются и сохраняются в архив "как есть". Если происходит совпадение имён файлов, к имени дописывается "(1)", "(2)", ... .
  • Файл «description.xml» с описанием вложения задаёт порядок нумерации страниц и имеет формат:

При чтении ссылки в параметре "Документ.Вложение.Подпись.Файл.Ссылка" возвращается zip архив с подписями под страницами вложения. Архив содержит только файлы подписей. Имя подписи формируется следующим образом:

  • берётся имя файла подписанной страницы;
  • если это не единственная подпись под файлом, дописывается номер подписи (нумерация с единицы);
  • дописывается расширение .sgn. Например, для архива страниц выше, в архиве подписей могли быть файлы: "page1.jpg.sgn", "page1.jpg.2.sgn", "page1.jpg.3.sgn", "page1(1).jpg.sgn", "page2.jpg.sgn". Не рекомендуется часто вызывать метод СБИС.ПрочитатьДокумент, т.к. это создаёт повышенную нагрузку на БД.

Настройки прав доступа

Для выполнение команды СБИС.ПрочитатьДокумент у пользователя внешнего API-интерфейса в кабинете СБИС должны быть права на работу с документами (уровень доступа «Просмотр», «Полный» или «Администрирование»).

Пример запроса

Пример ответа