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

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

Адрес запроса: https://online.saby.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.
6. При вызове команды «СБИС.ПрочитатьДокумент» обрабатывается большой объем данных. Если количество вложений, событий или подписей в документе перегружает ресурсы Saby, может включиться ограничение на получение данных. В этом случае в ответе метода вернется поле «ЧастичныеДанные» со значением «Да». Недостающие данные можно получить методом «СБИС.СписокИзменений» с фильтром по документу или по его редакции и с дополнительным полем «СписокПоДокументу».

Примеры

Прочитать документ

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

Прочитать документ с маркированным товаром