MeetingEntitlementNotificationV04

seev.003.001.04

Scope An account servicer sends the MeetingEntitlementNotification to an issuer, its agent, an intermediary or an account owner to advise the entitlement in relation to a shareholders meeting. Usage This message is sent to advise the quantity of securities held by an account owner. The balance is specified for the securities for which the meeting is taking place. This entitlement message is sent by the account servicer or the registrar to an intermediary, the issuer’s agent or the issuer. It is also sent between the account servicer and the account owner or the party holding the right to vote. The message is also used to amend a previously sent MeetingEntitlementNotification. To notify an update, the RelatedReference must be included in the message.

Message Construction

Every ISO20022 message has at the highest level what we call ‘building blocks’. Because the message is constructed as immutable records, the association is by composition. Below you can see the relationship between the message and its constituent building blocks: For comparison, see the ISO20022 official specification

classDiagram
     direction LR
%% MeetingEntitlementNotificationV04 recursion level 0 with max 0
MeetingEntitlementNotificationV04 *-- "1..1" MessageIdentification1 : Identification
MeetingEntitlementNotificationV04 *-- "0..1" MessageIdentification : RelatedReference
MeetingEntitlementNotificationV04 *-- "1..1" MeetingReference4 : MeetingReference
MeetingEntitlementNotificationV04 *-- "1..1" IPartyIdentification9Choice : NotifyingParty
MeetingEntitlementNotificationV04 *-- "1..200" SecurityPosition7 : Security
MeetingEntitlementNotificationV04 *-- "1..1" EligibilityDates1 : Eligibility
MeetingEntitlementNotificationV04 *-- "0..1" Extension2 : Extension
  

Now, we will zero-in one-by-one on each of these building blocks.

Identification building block

Identifies the notification of entitlement instruction. Identifies a message by a unique identifier and the date and time when the message was created by the sender. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% MessageIdentification1 recursion level 0 with max 1
class MessageIdentification1{
    Identification IsoMax35Text
    CreationDateTime IsoISODateTime
}
  

MessageIdentification1 members

RelatedReference building block

Identifies the meeting entitlement message to be modified. Unique and unambiguous identifier for a message, as assigned by the Sender. This unique identifier can be used for cross-referencing purposes in subsequent messages. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% MessageIdentification recursion level 0 with max 1
class MessageIdentification{
    Identification IsoMax35Text
}
  

MessageIdentification members

MeetingReference building block

Series of elements which allow to identify a meeting. Elements which allow to identify a meeting. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% MeetingReference4 recursion level 0 with max 1
class MeetingReference4{
    MeetingIdentification IsoMax35Text
    IssuerMeetingIdentification IsoMax35Text
    MeetingDateAndTime IsoISODateTime
    Type MeetingType2Code
}
MeetingReference4 *-- "0..1" IMeetingTypeClassification1Choice : Classification
MeetingReference4 *-- "0..5" PostalAddress1 : Location
%% IMeetingTypeClassification1Choice recursion level 1 with max 1
%% PostalAddress1 recursion level 1 with max 1
class PostalAddress1{
    AddressType AddressType2Code
    AddressLine IsoMax70Text
    StreetName IsoMax70Text
    BuildingNumber IsoMax16Text
    PostCode IsoMax16Text
    TownName IsoMax35Text
    CountrySubDivision IsoMax35Text
    Country CountryCode
}
  

MeetingReference4 members

NotifyingParty building block

Party notifying the entitlement. Identification of a party. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification9Choice recursion level 0 with max 1
  

PartyIdentification9Choice members

Security building block

Identifies the security for which the meeting is organised, the account and the positions of the security holder. Identifies the securities for which the meeting is organised. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SecurityPosition7 recursion level 0 with max 1
SecurityPosition7 *-- "1..1" SecurityIdentification11 : Identification
SecurityPosition7 *-- "0..1000" EligiblePosition4 : Position
%% SecurityIdentification11 recursion level 1 with max 1
class SecurityIdentification11{
    Description IsoMax140Text
}
SecurityIdentification11 *-- "1..1" ISecurityIdentification11Choice : Identification
%% EligiblePosition4 recursion level 1 with max 1
class EligiblePosition4{
    AccountIdentification IsoMax35Text
}
EligiblePosition4 *-- "0..1" PartyIdentification39 : AccountOwner
EligiblePosition4 *-- "0..10" HoldingBalance6 : HoldingBalance
EligiblePosition4 *-- "0..10" PartyIdentification39 : RightsHolder
  

SecurityPosition7 members

Eligibility building block

Defines the dates determining eligibility. Dates determining the entitlement. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% EligibilityDates1 recursion level 0 with max 1
class EligibilityDates1{
    EntitlementFixingDate IsoISODate
}
  

EligibilityDates1 members

Extension building block

Additional information that can not be captured in the structured fields and/or any other specific block. Additional information that can not be captured in the structured fields and/or any other specific block. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Extension2 recursion level 0 with max 1
class Extension2{
    PlaceAndName IsoMax350Text
}
Extension2 *-- "1..1" ExtensionEnvelope1 : ExtensionEnvelope
%% ExtensionEnvelope1 recursion level 1 with max 1
ExtensionEnvelope1 *-- "1..1" ExtensionContents1 : ExtensionContents
  

Extension2 members

Extensibility and generalization considerations

To facilitate generalized design patterns in the system, the MeetingEntitlementNotificationV04 implementation follows a specific implementaiton pattern. First of all, MeetingEntitlementNotificationV04 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, MeetingEntitlementNotificationV04Document implements IOuterDocument. Because MeetingEntitlementNotificationV04 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type MeetingEntitlementNotificationV04.

classDiagram
    class IOuterRecord
    MeetingEntitlementNotificationV04 --|> IOuterRecord : Implements
    MeetingEntitlementNotificationV04Document --|> IOuterDocument~MeetingEntitlementNotificationV04~ : Implements
    class IOuterDocument~MeetingEntitlementNotificationV04~ {
        MeetingEntitlementNotificationV04 Message
     }
  

Document wrapper for serialization

The only real purpose MeetingEntitlementNotificationV04Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:seev.003.001.04’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using MeetingEntitlementNotificationV04.ToDocument() method. The returned MeetingEntitlementNotificationV04Document value will serialize correctly according to ISO 20022 standards.

classDiagram
    MeetingEntitlementNotificationV04Document *-- MeetingEntitlementNotificationV04 : Document
  

Sample of message format

This is an abbreviated version of what the message should look like.

<Document xmlns="urn:iso:std:iso:20022:tech:xsd:seev.003.001.04">
    <MtgEntitlmntNtfctn>
        <Id>
            <!-- Identification inner content -->
        </Id>
        <RltdRef>
            <!-- RelatedReference inner content -->
        </RltdRef>
        <MtgRef>
            <!-- MeetingReference inner content -->
        </MtgRef>
        <NtifngPty>
            <!-- NotifyingParty inner content -->
        </NtifngPty>
        <Scty>
            <!-- Security inner content -->
        </Scty>
        <Elgblty>
            <!-- Eligibility inner content -->
        </Elgblty>
        <Xtnsn>
            <!-- Extension inner content -->
        </Xtnsn>
    </MtgEntitlmntNtfctn>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_Tme46dEwEd-BzquC8wXy7w_-1564035735"
  nextVersions="_xDAOGVtcEeSwKe7KuKvXhg"
  previousVersion="_TmVu9dEwEd-BzquC8wXy7w_-1804204687"
  name="MeetingEntitlementNotificationV04"
  definition="Scope&#xD;&#xA;An account servicer sends the MeetingEntitlementNotification to an issuer, its agent, an intermediary or an account owner to advise the entitlement in relation to a shareholders meeting.&#xD;&#xA;Usage&#xD;&#xA;This message is sent to advise the quantity of securities held by an account owner. The balance is specified for the securities for which the meeting is taking place.&#xD;&#xA;This entitlement message is sent by the account servicer or the registrar to an intermediary, the issuer's agent or the issuer. It is also sent between the account servicer and the account owner or the party holding the right to vote.&#xD;&#xA;The message is also used to amend a previously sent MeetingEntitlementNotification. To notify an update, the RelatedReference must be included in the message."
  registrationStatus="Registered"
  messageSet="_urpIICeJEeOCeO5e7islRQ"
  xmlTag="MtgEntitlmntNtfctn"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_Tme46tEwEd-BzquC8wXy7w_847313667"
    name="Identification"
    definition="Identifies the notification of entitlement instruction."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="Id"
    complexType="_Q7pG5Np-Ed-ak6NoX_4Aeg_-967008570" />
  <messageBuildingBlock
    xmi:id="_Tmop4NEwEd-BzquC8wXy7w_1924457442"
    nextVersions="_xDAOHVtcEeSwKe7KuKvXhg"
    name="RelatedReference"
    definition="Identifies the meeting entitlement message to be modified."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="RltdRef"
    complexType="_Q6l-Cdp-Ed-ak6NoX_4Aeg_1451391033" />
  <messageBuildingBlock
    xmi:id="_Tmop4dEwEd-BzquC8wXy7w_-2017625191"
    nextVersions="_xDAOH1tcEeSwKe7KuKvXhg"
    name="MeetingReference"
    definition="Series of elements which allow to identify a meeting."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="MtgRef"
    complexType="_Tj3tZtp-Ed-ak6NoX_4Aeg_-658253867" />
  <messageBuildingBlock
    xmi:id="_Tmop4tEwEd-BzquC8wXy7w_-2028723968"
    name="NotifyingParty"
    definition="Party notifying the entitlement."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="NtifngPty"
    complexType="_QRUXhtp-Ed-ak6NoX_4Aeg_967984948" />
  <messageBuildingBlock
    xmi:id="_Tmop49EwEd-BzquC8wXy7w_-1091429962"
    nextVersions="_xDAOI1tcEeSwKe7KuKvXhg"
    name="Security"
    definition="Identifies the security for which the meeting is organised, the account and the positions of the security holder."
    registrationStatus="Provisionally Registered"
    maxOccurs="200"
    minOccurs="1"
    xmlTag="Scty"
    complexType="_QSNvYtp-Ed-ak6NoX_4Aeg_-517737874" />
  <messageBuildingBlock
    xmi:id="_Tmop5NEwEd-BzquC8wXy7w_1359668345"
    nextVersions="_xDAOJVtcEeSwKe7KuKvXhg"
    name="Eligibility"
    definition="Defines the dates determining eligibility."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="Elgblty"
    complexType="_TmHJHdp-Ed-ak6NoX_4Aeg_742278644" />
  <messageBuildingBlock
    xmi:id="_Tmop5dEwEd-BzquC8wXy7w_113285778"
    name="Extension"
    definition="Additional information that can not be captured in the structured fields and/or any other specific block."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="Xtnsn"
    complexType="_QzJSNdp-Ed-ak6NoX_4Aeg_251191216" />
  <messageDefinitionIdentifier
    businessArea="seev"
    messageFunctionality="003"
    flavour="001"
    version="04" />
</messageDefinition>

ISO Building Blocks

The following items are used as building blocks to construct this message.