Проверить состояние исходящих документов в API

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

1. Получите список изменившихся документов, по которым произошли события документооборота в Saby. Это можно сделать с помощью команды «СБИС.СписокИзменений».
2. Если событие получено не по исходящему документу, то есть поле «Документ.Направление» не равно «Исходящий», его нужно пропустить.
3. При получении события с извещением об удалении документа противоположной стороной («Документ.Событие.Название» = «Уведомление об удалении на стороне получателя») остановите документооборот и пометьте документ в вашей ИС как удаленный.
4. При получении события с запросом на аннулирование («Документ.Событие.Название» = «Получение соглашения об аннулировании») предусмотрите возможность ответа (запрос ответственного по документу на подтверждение/отклонение аннулирования).
5. Если ваша система:
   • поддерживает версионность документов (несколько редакций):
     • синхронизируйте состояние редакции документооборота (поле «Документ.Редакция.Идентификатор») в вашей ИС с состоянием, которое получено с online.sbis.ru. Состояние передается в поле «Документ.Состояние» для редакции, которая ассоциирована с полученным событием;
     • определите и синхронизируйте актуальную редакцию (поле «Документ.Редакция.Актуален»);
     • синхронизируйте необходимые вложения.
   • не поддерживает версионность документов (несколько редакций):
     • если редакция неактуальна («Документ.Редакция.Актуален» = «Нет»), пропустите обработку события;
     • если актуальна — обработайте событие.

Комментарий

• С событием может быть ассоциирована одна или несколько ЭП (поле «Документ.Вложение.Ссылка» — заполнено, а «Документ.Вложение.Подпись.Ссылка» — нет). Это означает, например, отправку подписи под первичным документом при утверждении.
• Чтобы получить содержимое вложения, выполните HTTP GET-запрос по URL-адресу, который указан в поле «Документ.Событие.Вложение.Ссылка».
• Для получения содержимого ЭП выполните HTTP GET-запрос по URL-адресу, который указан в поле «Документ.Событие.Вложение.Подпись.Ссылка».
• «Документ.Состояние» описывает состояние для редакции, по которой зарегистрировано событие. Это нужно учесть при обработке события.
• «Документ.Событие.Состояние» описывает состояние вложений для редакции, по которой зарегистрировано событие.
• Наличие флага «Документ.Событие.Состояние.НеполнаяОбработка» со значением «Да» обозначает, что есть необработанные полученные или отправленные вложения.
• Наличие флага «Документ.Событие.Состояние.Сложное» со значением «Да» обозначает, что у полученных или отправленных вложений есть различные состояния.
• Описанные алгоритмы работы являются примерными и могут не охватывать все возможные действия, которые необходимы для полноценной интеграции вашей ИС.

Лицензия

Тариф «Обмен с контрагентами» сервиса «Электронный документооборот».