СБИС.ИНФОРМАЦИЯОСЛУЖЕБНЫХЭТАПАХ

СБИС.ИнформацияОСлужебныхЭтапах

Команда СБИС.ИнформацияОСлужебныхЭтапах возвращает список «наших организаций», по которым есть необработанные служебные этапы. 

Адрес для выполнения запроса: https://online.sbis.ru/service/?srv=1

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

  • "Фильтр": объект:
    • "ТолькоНаличиеСобытий": строка "Да"/"Нет"
    • "НашаОрганизация": объект
      • "СвЮЛ": объект
        • "ИНН": строка, 10 символов
        • "КПП": строка, 9 символов
        • "КодФилиала": строка, не обязательно
      • "СвФЛ": объект
        • "ИНН": строка, 12 символов

Результат запроса

  • "НашаОрганизация": массив объектов (может отсутствовать).
  • "ПрекратитьЗапросы": строка "Да"/"Нет".
  • "ЧислоНеобработанныхЭтапов": строка, которая содержит число необработанных на момент запроса служебных документов для текущего пользователя.

Комментарий

  • Рекомендуется передавать "Да" в "Фильтр.ТолькоНаличиеСобытий", так как это существенно снижает нагрузку на сайт online.sbis.ru и минимизирует время выполнения метода. 
  • Если метод не вернул совсем или вернул пустой список организаций, следует на 1-5 минут приостанвоить запросы.
  • Значение "ЧислоНеобработанныхЭтапов" является ориентировочным. Возможна ситуация, что метод вернет положительное значение, а последующий метод СБИС.СписокСлужебныхЭтапов вернет пустой список. При передаче "Да" в "Фильтр.ТолькоНаличиеСобытий" содержит счетчик числа организаций, по которым есть необработанные служебные документы.
  • Значение "Да" в поле "ПрекратитьЗапросы" означает, что следует прекратить вызовы для текущего пользователя, так как недостаточно прав на подписание служебных документов или на «наших организациях» назначены выделенные сотрудники для обработки служебных событий, к которым пользователь не относится.

Настройка прав доступа

Для выполнения команды СБИС.ИнформацияОСлужебныхЭтапах у пользователя внешнего API-интерфейса в кабинете СБИС должны быть настроены права на изменение документов (уровень доступа «Полный» или «Администрирование»).

Если у пользователя настроены права только на «Просмотр», то в результате вызова метода СБИС.ИнформацияОСлужебныхЭтапах будет возвращено пустое значение, даже при наличии необрабортанных служебных этапов.

Внимание!

Результат запроса существенно зависит от заполнения полей "НашаОрганизация.СвЮЛ.КодФилиала".

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

Запрос списка «наших организаций», у которых необходимо выполнить обработку служебных этапов.

{
    "jsonrpc": "2.0",
    "method": "СБИС.ИнформацияОСлужебныхЭтапах",
    "params":
    {
        "Фильтр":
        {
            "ТолькоНаличиеСобытий": "Да"
        }
    },
    "id": 0
}
 

Скачать пример

Запрос наличия событий по конкретной «нашей организации» без подсчета числа событий.

{
    "jsonrpc": "2.0",
    "method": "СБИС.ИнформацияОСлужебныхЭтапах",
    "params":
    {
        "Фильтр":
        {
            "НашаОрганизация":
            {
                "СвЮЛ":
                {
                    "ИНН": "7605016030",
                    "КПП": "222545001"
                }
            },
            "ТолькоНаличиеСобытий": "Да"
        }
    },
    "id": 0
}
 

Скачать пример

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

Ответ с информацией о двух организациях, по которым требуется подписание служебных документов.

{
    "jsonrpc": "2.0",
    "result":
    {
        "НашаОрганизация": [
        {
            "СвЮЛ":
            {
                "ИНН": "7605016030",
                "КПП": "760450001",
                "Название": "\"Компания \"Тензор\" ООО"
            }
        },
        {
            "СвЮЛ":
            {
                "ИНН": "7604094283",
                "КПП": "760401001",
                "Название": "УЦ Тензор, ООО"
            }
        }],
        "ПрекратитьЗапросы": "Нет",
        "ЧислоНеобработанныхЭтапов": "2"
    },
    "id": 0
}
 

Скачать пример

Ответ с информацией об отсутствии необработанных служебных этапов.

{
    "jsonrpc": "2.0",
    "result":
    {
        "ПрекратитьЗапросы": "Нет",
        "ЧислоНеобработанныхЭтапов": "0"
    },
    "id": 0
}
 

Скачать пример

Ответ с информацией об отсутствии необработанных служебных этапов из-за невозможности пользователем обрабатывать служебные документы.

{
    "jsonrpc": "2.0",
    "result":
    {
        "ПрекратитьЗапросы": "Да",
        "ЧислоНеобработанныхЭтапов": "0"
    },
    "id": 0
}
 

Скачать пример

0
0
Оставьте свой отзыв:
ОТПРАВИТЬ