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

СБИС.СписокДокументов

СБИС.СписокДокументов

Команда «СБИС.СписокДокументов» возвращает список документов указанного типа, например «Реализация», «Корреспонденция» и другие. Список сортируется по дате документа и включает только информацию о вложениях последней редакции. Информация возвращается страницами. За форматирование страниц отвечает параметр «Навигация».

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

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

  • "Фильтр": объект:
    • "ДатаС": строка в формате "ДД.ММ.ГГГГ"
    • "ДатаПо": строка в формате "ДД.ММ.ГГГГ"
    • "Тип"*: строка, тип документа, обязательный параметр
    • "Направление": строка, значение "Входящий"/"Исходящий"
    • "Состояние": строка, текстовое состояние документа
    • "Маска": строка, фильтр по полю "Документ.Примечание", "Документ.Номер"
    • "НашаОрганизация": объект:
    • "Контрагент": объект или массив объектов:
    • "Подразделение": объект:
      • "Название": строка, название подразделения
      • "Идентификатор": строка, код подразделения
    • "Ответственный": объект:
      • "Фамилия": строка
      • "Имя": строка
      • "Отчество": строка
      • "Идентификатор": строка, табельный номер (идентификатор)

    • "Навигация": объект:
      • "РазмерСтраницы": строка, количество записей, которые будут возвращены. Значение — целое число, в диапазоне от 1 до 200, по умолчанию — 20
      • "Страница": строка, номер страницы запрашиваемой выборки. Целое число, нумерация начинается с 0

Результат

В результате вызова возвращаются все основные реквизиты пакета и неслужебных документов. ЭП, события, сертификаты для действий этапов не возвращаются.

  • "Документ": массив объектов:
  • "Навигация": объект:
    • "РазмерСтраницы": строка, целочисленное значение. Указывает размер запрошенной выборки
    • "Страница": строка, номер текущей страницы
    • "ЕстьЕще": строка "Да"/Нет". "Да" означает наличие последующих записей

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

Синий — только для чтения.

Комментарий

  1. Поле «Состояние» входного фильтра может содержать «Название» из «Состояния документа», а также специфичные для метода «СБИС.СписокДокументов» значения. Они имеют код состояния документа из справочника кодов состояния.
    • «Неотправленные» — только для исходящих. Код 0, 1, 19, 20.
    • «Недоставленные» — только для исходящих. Код 2, 3.
    • «Не получен ответ» — только для исходящих. Код 2, 3.
    • «Внутренняя обработка» — только для исходящих. Код 10.
    • «Требующие ответа» — только для входящих. Код 10.
    • «Утвержденные» — код 7.
    • «Отклоненные» — код 9.
    • «С ошибками» — код 6.
    • «Удалено контрагентом» — код 20.
    • «Незакрепленные».
    • «Аннулированные» — код 19, 20, 22.
    • «Удаленные».
  2. Параметр «Направление» принимает по умолчанию одно из значений, отмеченное как «только для входящих/исходящих». Если указать значение недопустимое для выбранного состояния, вернется ошибка.
  3. В результат выполнения команды попадают документы в состоянии «черновик».
  4. По умолчанию (если в фильтре не указано состояние «Удаленные») в список не попадают удаленные документы.
  5. Ссылки на вложения и электронные подписи, которые возвращаются методом, действительны один месяц. Затем попытка получить файл по ссылке приведет к ошибке «HTTP 403 Forbidden».

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

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

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