Интеграция со СБИС

Аннулирование документов в API-интерфейсе

Аннулирование документов в API-интерфейсе

Отправленный документ можно в любой момент аннулировать. Это происходит по обоюдному согласию двух сторон. Аннулирование может инициировать как отправитель, так и получатель документа.

При аннулировании создается формализованный документ-соглашение. В нем перечислены первичные документы всех редакций. Соглашение подписывают обе стороны документооборота.

Алгоритм аннулирования документа

Любая из сторон документооборота может инициировать процесс аннулирования. Сделать это можно для документа, у которого есть хотя бы одна утвержденная редакция. Отправитель документа-соглашения будет выступать «инициатором» аннулирования, а получатель — «согласующим».

  1. Инициатор подписывает и отправляет соглашение об аннулировании. В нем указывается причина аннулирования. В команде «СБИС.ПодготовитьДействие» нужно указать «Этап.Название» = «Аннулирование», а в «СБИС.ВыполнитьДействие» указать «Этап.Действие.Название» = «Аннулировать».
  2. Согласующий может:

Если аннулирование подтверждено, то состояние документа меняется на «Аннулирован по соглашению» (код 22).

Внимание!

После отправки запроса на аннулирование документа с завершенным документооборотом, статус документа (на обеих сторонах) не меняется до момента согласования.

Документооборот при аннулировании документа

  • На стороне инициатора:
  1. Прерывается документооборот последней редакции документа, если обмен документами еще не был завершен. Также это возможно при отправке уведомления об удалении документа.
  2. У последней утвержденной редакции создается событие «Отправка соглашения об аннулировании». К нему прикрепляется сгенерированное вложение «Соглашение об аннулировании электронного документа» и подпись инициатора под ним. В теле вложения указываются все вложения со всех редакции документа, которые не были удалены. Также на этом событии сохраняется комментарий, который был введен при отправке запроса на аннулирование.

    По наличию этого события можно проконтролировать факт отправки аннулирования и синхронизировать его.

  • На стороне согласующего:
  1. Прерывается документооборот последней редакции документа, если он еще не был завершен.
  2. У последней утвержденной редакции:
  • Создается событие «Получение соглашения об аннулировании». К нему прикрепляется пришедшее вложение «Соглашение об аннулировании электронного документа» и подпись инициатора под ним. Также на этом событии сохраняется комментарий, который был введен при отправке запроса на аннулирование.
  • Появляется активный этап «Аннулирование» с активными действиями: «Документ аннулирован» и «Аннулирование отклонено». Исполнитель события назначает ответственного за документ.
  1. При успешном выполнении действия «Документ аннулирован»:
  • К событию «Аннулирование» прикрепляется «Соглашение об аннулировании» и вторая подпись под ним. Это подпись согласующей стороны.
  • Создается событие «Отправка подтверждения соглашения об аннулировании». С этим событием ничего не связывается.
  • Состояние документа меняется на «Аннулирован по соглашению» (код 22).
  1. При успешном выполнении действия «Аннулирование отклонено»:
  • К событию «Аннулирование» прикрепляется сгенерированное вложение «Уведомление об уточнении электронного документа» и подпись согласующего под ним. На него записывается комментарий, который был введен при отклонении аннулирования.
  • Создается событие «Отправка отклонения соглашения об аннулировании». С этим событием вложения или подписи не связываются. На него также записывается комментарий, который был указан при отклонении аннулирования.
  • После согласования или отклонения аннулирования, на стороне инициатора:
  1. При подтверждении аннулирования:
  • Создается событие «Получение подтверждения соглашения об аннулировании». С ним связывается служебное вложение «Соглашение об аннулировании» и вторая подпись под ним. Это подпись согласущей стороны.
  • Создается событие «Аннулирование». К нему прикрепляется служебное вложение «Соглашение об аннулировании электронного документа».
  • Состояние документа меняется на «Аннулирован по соглашению» (код 22).
  1. При отклонении аннулирования:
  • Создается событие «Получение отклонения соглашения об аннулировании». С ним связывается «Уведомление об уточнении электронного документа» и подпись согласующего под ним.
  • Создается событие «Аннулирование». На него записывается комментарий, который введен при отклонении аннулирования.

Пример запроса на аннулирования документа

Пример подтверждения запроса на аннулирования документа

Пример отклонения запроса на аннулирования документа