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

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

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

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

Адрес для выполнения запроса: 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-интерфейса в кабинете СБИС должны быть права на работу с документами (уровень доступа «Просмотр», «Полный» или «Администрирование»).

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

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