Предопределенный титул получателя
Схема обмена двухтитульными документами подразумевает, что
- отправитель готовит первый титул документа, подписывает его и отправляет вместе с подписью получателю,
- получатель готовит ответный титул, подписывает и отправляет его вместе с подписью отправителю.
Но существует схема, позволяющая отправителю приложить сразу оба титула — схема через предопределенный титул. Получателю останется только проверить свой титул и подписать его или отказать в подписи.
Не все версии документов поддерживают такую схему работы. Узнать, доступен ли предопределенный титул получателя для выбранного типа документа, функции и версии можно из ответа метода GetDocumentTypes (V3): информация хранится в поле DocumentTypeDescriptionV3.Functions[].Versions[].SupportsPredefinedRecipientTitle. Инструкция о получении данных из метода GetDocumentTypes приведена на странице Получение информации о типе документа.
Отправить документ с двумя титулами можно через шаблон.
Пример использования C# SDK
Ниже приведен пример кода на C# с использованием SDK для работы с предопределенным титулом получателя.
-
Отправитель создает шаблон
var senderTitle = File.ReadAllBytes("C:\\path\\to\\sender\\title.xml");var recipientTitle = File.ReadAllBytes("C:\\path\\to\\recipient\\title.xml");var documentAttachmentWithTwoTitles = new TemplateDocumentAttachment{// Укажите тип, для версии которого разрешен предопределенный титул получателя// Саму версию явно можно не указывать, т.к. она должна быть указана под узлом ВерсФорм в XML.TypeNamedId = "typenamedid",UnsignedContent = new UnsignedContent{Content = senderTitle},PredefinedRecipientTitle = new PredefinedRecipientTitle{UnsignedContent = new UnsignedContent{Content = recipientTitle}}};var templateToPost = new TemplateToPost{FromBoxId = fromBoxId,ToBoxId = toBoxId,// MessageFromBoxId — ящик организации, которая будет создавать документ из шаблонаMessageFromBoxId = messageFromBoxId,MessageToBoxId = messageToBoxId,DocumentAttachments = {documentAttachmentWithTwoTitles}};var template = api.PostTemplate(authToken, templateToPost); -
Отправитель создает документ из шаблона
var templateDocumentToTransform = template.Entities.FirstOrDefault(e => e.DocumentInfo?.TypeNamedId == "typenamedid");if (templateDocumentToTransform == null){throw new InvalidOperationException("Документ в шаблоне не найден");}var transformationToPost = new TemplateTransformationToPost{// Должен совпадать с TemplateToPost.MessageFromBoxId — только этот ящик может создать документBoxId = messageFromBoxId,TemplateId = template.MessageId,DocumentTransformations ={new DocumentTransformation{DocumentId = templateDocumentToTransform.EntityId}}};var message = api.TransformTemplateToMessage(authToken, transformationToPost); -
Отправитель генерирует подпись и прикрепляет ее к своему титулу.
// entityId титула отправителя в только что созданном сообщенииvar senderTitleEntityId = message.Entities.First(e => e.DocumentInfo?.TypeNamedId == "typenamedid").EntityId;var signatureForSenderTitlePatch = new MessagePatchToPostV2{BoxId = messageFromBoxId,MessageId = message.MessageId,Signatures ={new DocumentSignature{ParentEntityId = senderTitleEntityId,// Отправитель подписывает локальный файл титула, который сам подготовил на шаге 1Signature = crypt.Sign(senderTitle, senderCertificateContent)}}};api.PostMessagePatchV4(authToken, signatureForSenderTitlePatch);Получатель документа получит подписанный титул отправителя и неподписанный предопределенный титул получателя. С его стороны нужно сгенерировать и отправить подпись к предопределенному титулу.
-
Получатель генерирует подпись и прикрепляет ее к своему титулу.
var messageWithContent = api.GetMessage(authToken,recipientBoxId,messageId,injectEntityContent: true);var recipientTitle = messageWithContent.Entities.FirstOrDefault(e => e.EntityId == recipientTitleEntityId);if (recipientTitle?.Content == null){throw new InvalidOperationException("Используйте GetEntityContent: содержимое не попало в ответ");}var signatureForRecipientTitlePatch = new MessagePatchToPostV2{BoxId = recipientBoxId,MessageId = messageId,Signatures ={new DocumentSignature{// Можно указать и entityId титула отправителя — сервер принимает оба вариантаParentEntityId = recipientTitle.EntityId,Signature = crypt.Sign(recipientTitle.Content.Data, recipientCertificateContent)}}};api.PostMessagePatchV4(authToken, signatureForRecipientTitlePatch);Идентификатор сущности предопределенного титула получателя
entityIdможно получить с помощью метода GetMessage (V6).