Сущность сообщения

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

Каждая сущность имеет идентификатор, тип и бинарное представление, которое интерпретируется в зависимости от типа сущности. Например, бинарным представлением счета-фактуры является массив байтов XML-файла в формате и кодировке, определенных ФНС. А бинарным представлением электронной подписи является массив байтов отсоединенной подписи в соответствии со стандартом CMS в DER-кодировке.

Связи между сущностями

Между сущностями в Диадоке могут устанавливаться связи двух типов:

  1. Ссылки между родительской и дочерней сущностью.

    Эта связь задается атрибутом ParentEntityId и устанавливает ссылки между сущностями внутри одного сообщения (при этом они могут находиться в разных дополнениях).

    ../_images/entity_parent.png

    На рисунке сообщение A содержит две сущности — U и V. Сущность U является родительской по отношению к сущности V, потому что ее поле ParentEntityId содержит значение U.

    Таким способом связываются, например, документ и электронная подпись под ним (U – документ, V – подпись) или счет-фактура и подтверждение о его получении (U – счет-фактура, V – подтверждение).

  2. Ссылки между сущностями из разных сообщений.

    Эта связь задается атрибутом InitialDocumentId и устанавливает ссылки между документами, находящимися в разных сообщениях.

    ../_images/entity_initial_document.png

    На рисунке сущность X в сообщении B связана с сущностью U в сообщении A с помощью поля InitialDocumentId. В качестве значения этого поля используется пара идентификаторов – сообщения и сущности (A:U).

    Так связываются, например, корректирующий счет-фактуры и исходный счет-фактура или дополнительное соглашение с основным договором.

См. также

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

  • Entity — данные сущности, входящей в сообщение или в дополнение к сообщению

Методы для работы с сущностью:

  • GetEntityContent (V4) — возвращает содержимое указанной сущности