Присоединяйтесь!

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

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

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

Адрес запроса: 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».

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

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

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

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

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

Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.