Перейти к основному содержимому

Предопределенный титул получателя

Схема обмена двухтитульными документами подразумевает, что

  • отправитель готовит первый титул документа, подписывает его и отправляет вместе с подписью получателю,
  • получатель готовит ответный титул, подписывает и отправляет его вместе с подписью отправителю.

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

Не все версии документов поддерживают такую схему работы. Узнать, доступен ли предопределенный титул получателя для выбранного типа документа, функции и версии можно из ответа метода GetDocumentTypes (V3): информация хранится в поле DocumentTypeDescriptionV3.Functions[].Versions[].SupportsPredefinedRecipientTitle. Инструкция о получении данных из метода GetDocumentTypes приведена на странице Получение информации о типе документа.

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

Пример использования C# SDK

Ниже приведен пример кода на C# с использованием SDK для работы с предопределенным титулом получателя.

  1. Отправитель создает шаблон

    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);
  2. Отправитель создает документ из шаблона

    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);
  3. Отправитель генерирует подпись и прикрепляет ее к своему титулу.

    // 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,
    // Отправитель подписывает локальный файл титула, который сам подготовил на шаге 1
    Signature = crypt.Sign(senderTitle, senderCertificateContent)
    }
    }
    };

    api.PostMessagePatchV4(authToken, signatureForSenderTitlePatch);

    Получатель документа получит подписанный титул отправителя и неподписанный предопределенный титул получателя. С его стороны нужно сгенерировать и отправить подпись к предопределенному титулу.

  4. Получатель генерирует подпись и прикрепляет ее к своему титулу.

    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).

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года