Подпись

Электронная подпись (ЭП) — цифровой аналог рукописной подписи, который содержит информацию об авторе документа и подтверждает отсутствие изменений в документе после подписания. Электронная подпись формируется закрытым ключом, соответствующим сертификату, и средствами криптографической защиты информации.

Работа с подписью в Диадоке

С помощью API Диадока нельзя создать подпись для документа, так как для ее создания используется закрытый ключ, который нельзя передавать третьим лицам. Подпись нужно сгенерировать самостоятельно.

С документом и его подписью в Диадоке работают следующие методы:

  • метод отправки сообщения PostMessage: передайте подпись в поле Signature структуры SignedContent;

  • метод отправки дополнения к сообщению PostMessagePatch: передайте подпись в поле Signature структуры DocumentSignature;

  • метод отправки черновика SendDraft: передайте подпись в поле Signature структуры DocumentSenderSignature.

Эти методы принимают файл подписи в формате CMS SignedData в DER-кодировке.

Под документом могут стоять следующие подписи:

  • подписи отправителя — для отправки документов, сохраненных без отправки,

  • подписи получателя — для двусторонних документов с запросом подписи,

  • согласующие подписи,

  • ответные подписи под запросом на аннулирование документа.

Согласующая подпись

Диадок позволяет нескольким сотрудникам организации поставить свои подписи под одним документом. Такие подписи называются согласующими.

Согласующие подписи можно ставить как со стороны отправителя, так и со стороны получателя. В день под документом можно поставить не больше 500 согласующих подписей. Диадок проверит и доставит все подписи контрагенту.

Согласующую подпись можно поставить до или после отправки в зависимости от типа документа:

  • для неформализованного документа — до или после отправки. Если поставить согласующую подпись до отправки, то в ящик получателя она доставится только после отправки, вместе с документом и подписью отправителя. Если поставить согласующую подпись после отправки — получатель получит ее сразу.

  • для формализованного документа — только после отправки, потому что при отправке формализованного документа поле «Подписант» заполняется данными из сертификата и меняется содержимое документа.

Отправитель сразу получит все подписи получателя под документом.

Отправить запрос на подписание документа согласующей подписью можно с помощью метода PostMessagePatch. Для этого заполните поле ResolutionRequests структуры MessagePatchToPost.

Подписать документ согласующей подписью можно с помощью метода PostMessagePatch. Для этого передайте файл подписи в поле Signature структуры DocumentSignature и укажите флаг IsApprovementSignature = true.

Определить, что подпись является согласующей, можно по флагу IsApprovementSignature в структуре Entity.

Функциональность недоступна по умолчанию. Чтобы получить возможность использовать согласующую подпись, обратитесь к вашему менеджеру или в техническую поддержку.

Представление в API

В API подписи представлены структурами:

  • SignatureV3 — содержит информацию о подписи под документом

  • SignatureInfo — содержит информацию о подписи и сертификате

Методы для работы с подписями:

  • GetSignatureInfo — возвращает информацию о подписи и сертификате в сообщении

Структуры для работы с подписями:

  • DocumentSignature — предназначена для представления ЭП к некоторым данным в отправляемом сообщении

  • DocumentSenderSignature — предназначена для представления ЭП к документам отправляемого черновика