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

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

Адрес запроса: https://online.sbis.ru/service/?srv=1

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

"Документ": объект:

• "Идентификатор"*: строка, идентификатор обрабатываемого документа
• "ДопПоля": строка со значением «ДополнительныеПоля». Позволяет получить информацию из дополнительных полей документа
• "Редакция": объект:
  • "Идентификатор"*: строка, идентификатор обрабатываемой редакции документа

Результат

"Документ": объект

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

Комментарий

1. Объект «Документ» в ответе от сервера будет содержать:
   • текущее состояние документа (последнюю редакцию) — при определении по «Документ.Идентификатор»;
   • состояние редакции — при определении по «Документ.Редакция.Идентификатор».
2. Чтобы отслеживать состояние обработки документа с маркированным товаром в ГИС МТ, в запросе передайте в параметре «ДопПоля» значение «Расширение».
3. В документе с многостраничным вложением данные по ссылке в «Документ.Вложение.Файл.Ссылка» будут содержать zip-архив. В него входят:
   • файлы страниц. Имена файлов сохраняются в архиве без изменений. При совпадении имен файлов к имени дописывается «(1)», «(2)» и так далее;
   • файл «description.xml» с описанием вложения. Он задает порядок нумерации страниц в формате:
4. При чтении ссылки в параметре «Документ.Вложение.Подпись.Файл.Ссылка» возвращается zip-архив с подписями под страницами вложения. Архив содержит только файлы подписей. Порядок формирования имени подписи:
   • берется имя файла подписанной страницы;
   • если это не единственная подпись под файлом, добавляется номер подписи. Нумерация начинается с 1;
   • добавляется расширение .sgn. Например, для архива страниц, который указан выше, в архиве подписей могли быть файлы: «page1.jpg.sgn», «page1.jpg.2.sgn», «page1.jpg.3.sgn», «page1(1).jpg.sgn», «page2.jpg.sgn».
5. Ссылки на вложения и электронные подписи, которые возвращаются методом, действительны один месяц. Затем попытка получить файл по ссылке приведет к ошибке «HTTP 403 Forbidden».

При вызове команды «СБИС.ПрочитатьДокумент» обрабатывается большой объем данных. Это создает повышенную нагрузку и замедляет работу системы.

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

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

Пример запроса на чтение документа от владельца сертификата в состоянии «Ожидает подписания»

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

Ответ с объектом «Доверенность»