Разбирайте документы СБИС, по которым ждут вашего решения

Агент обращается к сервисным методам СБИС: запрашивает списки документов с фильтром по типу и постраничной навигацией, читает вложения и состояния документооборота, свои организации и подразделения, контрагентов и приглашения, задачи и служебные этапы, сертификаты и машиночитаемые доверенности. Из этого собираются реестр исходящих отгрузочных за период и список входящего, по которому ждут вашего решения, — с контрагентом, суммой и датой поступления.

Выборка в СБИС всегда идёт через фильтр и страницы, поэтому «все документы за период» — это обход, а не один запрос, и агент следит, что дошёл до конца, а не выдал первую страницу за итог. Вторая особенность предметной области: обмен двусторонний, и документ не уйдёт контрагенту, который к ЭДО не подключён. Поэтому готовность второй стороны агент проверяет по ИНН и КПП заранее и готовит список приглашений.

На запись агент идёт ровно настолько, насколько приложению выданы права: сохранить документ, приложить вложения, собрать пакет к отправке. С подписью граница проходит по типу ключа: квалифицированную подпись с носителя ставит человек, и здесь агент доводит документ до подписи и останавливается, а серверный сертификат компании он активирует и подписывает им сам. Запускает он это только по прямой команде — подпись юридически значима и шагом конвейера не бывает. Сроки действия серверных сертификатов агент сверяет заранее и показывает, какие заканчиваются раньше ближайшей отчётной даты.

Сервисный ключ агент обменивает на сессионный токен и продлевает его сам: сессия в СБИС живёт недолго, и по её истечении запрос повторяется с новым токеном, а не падает вам на руки. Права приложения ограничивают выборку на стороне сервиса — закрытый раздел возвращает отказ, а не пустой список, и агент отличает одно от другого. Частоту запросов он выдерживает сам, а если документов за период действительно нет, говорит об этом прямо.