Изменения в документообороте по входящим документам можно отследить с помощью набора событий, которые возвращаются после вызова функции «СБИС.СписокИзменений». Например, при поступлении входящего документа сервером online.sbis.ru было сгенерировано событие «Получение». Нужно загрузить все входящие вложения (первичные и служебные) и сохранить под каждым вложением связанные с этим событием ЭП.
- Получите список измененных документов, по которым произошли события документооборота в СБИС. Сделать это можно с помощью команды «СБИС.СписокИзменений».
- Если событие получено не по входящему документу, то есть «Документ.Направление» не равно «Входящий», его нужно пропустить.
- При получении события с извещением об удалении документа противоположной стороной («Документ.Событие.Название» = «Уведомление об удалении на стороне отправителя») — остановите документооборот и пометьте документ в вашей ИС как удаленный.
- При получении события с запросом на аннулирование («Документ.Событие.Название» = «Получение соглашения об аннулировании») предусмотрите возможность ответа (запрос ответственного по документу на подтверждение/отклонение аннулирования).
- Если событие получено не по исходящему документу, то есть Документ.Направление не равно «Исходящий», его нужно пропустить.
- Пропустите события со значением поля «Документ.Событие.Название» отличными от «Получение».
- Если ваша система:
- поддерживает версионность документов (несколько редакций):
- определите наличие предыдущих редакций документа. Поиск в вашей информационной системе производится по полю «Документ.Идентификатор»;
- если редакции найдены, пометьте их как неактуальные. При необходимости, синхронизируйте состояния редакции документа в вашей информационной системе и с сайтом online.sbis.ru. Для этого используйте команду «СБИС.ПрочитатьДокумент» с адресацией по полю «Документ.Редакция.Идентификатор».
- зарегистрируйте новую редакцию документа по полю «Документ.Редакция.Идентификатор».
- не поддерживает версионность документов (несколько редакций):
- определите наличие документа в вашей ИС. Поиск в вашей системе производится по полю «Документ.Идентификатор». При наличии документа, переместите его в архив;
- если редакция неактуальна (значние поля «Документ.Редакция.Актуален» = «Нет») — пропустите обработку.
- если редакция актуальна (значение поля «Документ.Редакция.Актуален» = «Да») — зарегистрируйте документ как новый входящий.
- поддерживает версионность документов (несколько редакций):
- Загрузите вложения входящего документа в вашу информационную систему:
- Получите и сохраните в локальный архив содержимое входящих вложений («Документ.Событие.Вложение.Направление» = «Входящий»), которые ассоциированны с событием:
- первичных («Документ.Событие.Вложение.Служебный» = «Нет»;
- служебных («Документ.Событие.Вложение.Служебный» = «Да»), (HTTP GET-запрос по URL-адресу, который указан в поле «Документ.Событие.Вложение.Файл.Ссылка»).
- получите и сохраните в локальный архив содержимое ЭП, которые ассоциированы с вложениями события:
- под входящими вложениями («Документ.Событие.Вложение.Направление» = «Входящий»);
- под вложениями, по которым есть входящие подписи («Документ.Событие.Вложение.Файл.Ссылка» — пустая, «Документ.Событие.Вложение.Подпись.Файл.Ссылка» — не пустая).
- Получите и сохраните в локальный архив содержимое входящих вложений («Документ.Событие.Вложение.Направление» = «Входящий»), которые ассоциированны с событием:
Комментарий
- С событием может быть ассоциирована одна или несколько ЭП («Документ.Вложение.Ссылка» — пустая, а «Документ.Вложение.Подпись.Ссылка» — не пустая). Это означает, например, отправку подписи под первичным документом при утверждении.
- Чтобы получить содержимое вложения, выполните HTTP GET-запрос по URL-адресу, который указан в поле «Документ.Событие.Вложение.Ссылка».
- Для получения содержимого ЭП, выполните HTTP GET-запрос по URL-адресу, который указан в поле «Документ.Событие.Вложение.Подпись.Ссылка».
- «Документ.Состояние» описывает состояние для редакции, по которой зарегистрировано событие. Это нужно учесть при обработке события.
- Описанные алгоритмы работы являются примерными и могут не охватывать все возможные действия, которые необходимы для полноценной интеграции вашей ИС.