seev.007.001.08
Scope The MeetingVoteExecutionConfirmation message is sent by an issuer, its agent or an intermediary to another intermediary, a party holding the right to vote, a registered security holder or to a beneficial holder to confirm, to the Sender of the MeetingInstruction message, that their vote has been recorded and counted by the Issuer. Usage This message is sent after the shareholders meeting has taken place. The Sender of this message confirms the execution of the vote at the meeting. This messages is sent if the Sender of the MeetingInstruction message has requested such a confirmation or if market practice or regulation stipulates the need for a full audit trail. This message definition is intended for use with the Business Application Header (BAH).
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
%% MeetingVoteExecutionConfirmationV08 recursion level 0 with max 0
class MeetingVoteExecutionConfirmationV08{
MeetingInstructionIdentification IsoMax35Text
VoteInstructionsConfirmationURLAddress IsoMax2048Text
}
MeetingVoteExecutionConfirmationV08 *-- "1..1" MeetingReference10 : MeetingReference
MeetingVoteExecutionConfirmationV08 *-- "1..1" SecurityIdentification19 : FinancialInstrumentIdentification
MeetingVoteExecutionConfirmationV08 *-- "0..1" DetailedInstructionStatus17 : VoteInstructions
MeetingVoteExecutionConfirmationV08 *-- "0..1" SupplementaryData1 : SupplementaryData
Now, we will zero-in one-by-one on each of these building blocks.
MeetingInstructionIdentification building block
Identification of the original meeting instruction message for which the vote execution confirmation is provided. Specifies a character string with a maximum length of 35 characters. For comparison, see the ISO20022 official specification This message is declared as Max35Text in the ISO specification. In our implementation, it is represented in source code as IsoMax35Text. Due to global using directives, it is treated as a System.String by the compiler and runtime.
MeetingReference building block
Set of elements to allow the unambiguous identification of a meeting. Identification of a meeting. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% MeetingReference10 recursion level 0 with max 1
class MeetingReference10{
MeetingIdentification IsoMax35Text
IssuerMeetingIdentification IsoMax35Text
MeetingDateAndTime IsoISODateTime
Type MeetingType4Code
}
MeetingReference10 *-- "0..1" IMeetingTypeClassification2Choice : Classification
MeetingReference10 *-- "0..5" PostalAddress1 : Location
MeetingReference10 *-- "0..1" IPartyIdentification129Choice : Issuer
%% IMeetingTypeClassification2Choice 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
}
%% IPartyIdentification129Choice recursion level 1 with max 1
MeetingReference10 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| MeetingIdentification | Identification assigned to the general meeting by the party that provides the meeting notification. It must be unique to the party providing the notification. | IsoMax35Text - Required 1..1 |
| IssuerMeetingIdentification | Identification assigned to the meeting by the issuer. It must be unique for the issuer. | IsoMax35Text - Optional 0..1 |
| MeetingDateAndTime | Date and time at which the meeting will take place. | IsoISODateTime - Required 1..1 |
| Type | Type of meeting for which instructions are sent. | MeetingType4Code - Required 1..1 |
| Classification | Classification type of the meeting. | IMeetingTypeClassification2Choice - Optional 0..1 |
| Location | Place of the company meeting for the scheduled meeting date. | PostalAddress1 - Collection 0..5 |
| Issuer | Institution that is the issuer of the security to which the meeting applies. | IPartyIdentification129Choice - Optional 0..1 |
FinancialInstrumentIdentification building block
Security for which the meeting is organised. Identification of a security. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% SecurityIdentification19 recursion level 0 with max 1
class SecurityIdentification19{
ISIN IsoISINOct2015Identifier
Description IsoMax140Text
}
SecurityIdentification19 *-- "0..0" OtherIdentification1 : OtherIdentification
%% OtherIdentification1 recursion level 1 with max 1
class OtherIdentification1{
Identification IsoMax35Text
Suffix IsoMax16Text
}
OtherIdentification1 *-- "1..1" IIdentificationSource3Choice : Type
SecurityIdentification19 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| ISIN | International Securities Identification Number (ISIN). A numbering system designed by the United Nation’s International Organisation for Standardisation (ISO). The ISIN is composed of a 2-character prefix representing the country of issue, followed by the national security number (if one exists), and a check digit. Each country has a national numbering agency that assigns ISIN numbers for securities in that country. | IsoISINOct2015Identifier - Optional 0..1 |
| OtherIdentification | Identification of a security by proprietary or domestic identification scheme. | OtherIdentification1 - Unknown 0..0 |
| Description | Textual description of a security instrument. | IsoMax140Text - Optional 0..1 |
VoteInstructions building block
Specifies how a party has voted for each agenda item. Information about a meeting instruction vote. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% DetailedInstructionStatus17 recursion level 0 with max 1
class DetailedInstructionStatus17{
SingleInstructionIdentification IsoMax35Text
AccountIdentification IsoMax35Text
SubAccountIdentification IsoMax35Text
StandingInstruction IsoYesNoIndicator
}
DetailedInstructionStatus17 *-- "0..1" IPartyIdentification231Choice : AccountOwner
DetailedInstructionStatus17 *-- "0..250" IPartyIdentification237Choice : RightsHolder
DetailedInstructionStatus17 *-- "0..1" IPartyIdentification232Choice : Proxy
DetailedInstructionStatus17 *-- "1..1" IModalityOfCounting1Choice : ModalityOfCounting
DetailedInstructionStatus17 *-- "0..1" IDateAndDateTime1Choice : VoteReceiptDateTime
DetailedInstructionStatus17 *-- "0..1000" Vote13 : VotePerResolution
%% IPartyIdentification231Choice recursion level 1 with max 1
%% IPartyIdentification237Choice recursion level 1 with max 1
%% IPartyIdentification232Choice recursion level 1 with max 1
%% IModalityOfCounting1Choice recursion level 1 with max 1
%% IDateAndDateTime1Choice recursion level 1 with max 1
%% Vote13 recursion level 1 with max 1
class Vote13{
IssuerLabel IsoMax35Text
Withdrawn IsoYesNoIndicator
}
Vote13 *-- "0..1" IFinancialInstrumentQuantity18Choice : For
Vote13 *-- "0..1" IFinancialInstrumentQuantity18Choice : Against
Vote13 *-- "0..1" IFinancialInstrumentQuantity18Choice : Abstain
Vote13 *-- "0..1" IFinancialInstrumentQuantity18Choice : Withhold
Vote13 *-- "0..1" IFinancialInstrumentQuantity18Choice : WithManagement
Vote13 *-- "0..1" IFinancialInstrumentQuantity18Choice : AgainstManagement
Vote13 *-- "0..1" IFinancialInstrumentQuantity18Choice : Discretionary
Vote13 *-- "0..1" IFinancialInstrumentQuantity18Choice : OneYear
Vote13 *-- "0..1" IFinancialInstrumentQuantity18Choice : TwoYears
Vote13 *-- "0..1" IFinancialInstrumentQuantity18Choice : ThreeYears
Vote13 *-- "0..1" IFinancialInstrumentQuantity18Choice : NoAction
Vote13 *-- "0..1" IFinancialInstrumentQuantity18Choice : Blank
Vote13 *-- "0..4" ProprietaryVote2 : Proprietary
DetailedInstructionStatus17 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| SingleInstructionIdentification | Identification of the specific individual instruction from the original meeting instruction message for which the confirmation is provided. | IsoMax35Text - Required 1..1 |
| AccountIdentification | Identification of the safekeeping account. | IsoMax35Text - Optional 0..1 |
| AccountOwner | Party that legally owns the account. | IPartyIdentification231Choice - Optional 0..1 |
| SubAccountIdentification | Identification of the subaccount within the safekeeping account. | IsoMax35Text - Optional 0..1 |
| RightsHolder | Owner of the voting rights. | IPartyIdentification237Choice - Collection 0..250 |
| Proxy | Identification of the person appointed by the security holder as the proxy. | IPartyIdentification232Choice - Optional 0..1 |
| StandingInstruction | Indicates whether standing instructions have been applied or not. | IsoYesNoIndicator - Optional 0..1 |
| ModalityOfCounting | Modality through which the votes that have been recorded and counted were received by the issuer, including whether this is ahead of the meeting or at the meeting. | IModalityOfCounting1Choice - Required 1..1 |
| VoteReceiptDateTime | Date or date and time at which the votes that have been recorded and counted were received. | IDateAndDateTime1Choice - Optional 0..1 |
| VotePerResolution | Details of the vote. | Vote13 - Collection 0..1000 |
VoteInstructionsConfirmationURLAddress building block
Address to use over the www (HTTP) service where the confirmations of the vote instructions can be found. Specifies a character string with a maximum length of 2048 characters. For comparison, see the ISO20022 official specification This message is declared as Max2048Text in the ISO specification. In our implementation, it is represented in source code as IsoMax2048Text. Due to global using directives, it is treated as a System.String by the compiler and runtime.
SupplementaryData building block
Additional information that cannot 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
%% SupplementaryData1 recursion level 0 with max 1
class SupplementaryData1{
PlaceAndName IsoMax350Text
}
SupplementaryData1 *-- "1..1" IsoSupplementaryDataEnvelope1 : Envelope
%% IsoSupplementaryDataEnvelope1 recursion level 1 with max 1
SupplementaryData1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| PlaceAndName | Unambiguous reference to the location where the supplementary data must be inserted in the message instance. In the case of XML, this is expressed by a valid XPath. | IsoMax350Text - Optional 0..1 |
| Envelope | Technical element wrapping the supplementary data. | IsoSupplementaryDataEnvelope1 - Required 1..1 |
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the MeetingVoteExecutionConfirmationV08 implementation follows a specific implementaiton pattern. First of all, MeetingVoteExecutionConfirmationV08 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, MeetingVoteExecutionConfirmationV08Document implements IOuterDocument. Because MeetingVoteExecutionConfirmationV08 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type MeetingVoteExecutionConfirmationV08.
classDiagram
class IOuterRecord
MeetingVoteExecutionConfirmationV08 --|> IOuterRecord : Implements
MeetingVoteExecutionConfirmationV08Document --|> IOuterDocument~MeetingVoteExecutionConfirmationV08~ : Implements
class IOuterDocument~MeetingVoteExecutionConfirmationV08~ {
MeetingVoteExecutionConfirmationV08 Message
}
Document wrapper for serialization
The only real purpose MeetingVoteExecutionConfirmationV08Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:seev.007.001.08’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using MeetingVoteExecutionConfirmationV08.ToDocument() method. The returned MeetingVoteExecutionConfirmationV08Document value will serialize correctly according to ISO 20022 standards.
classDiagram
MeetingVoteExecutionConfirmationV08Document *-- MeetingVoteExecutionConfirmationV08 : 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.007.001.08">
<MtgVoteExctnConf>
<MtgInstrId>
<!-- MeetingInstructionIdentification inner content -->
</MtgInstrId>
<MtgRef>
<!-- MeetingReference inner content -->
</MtgRef>
<FinInstrmId>
<!-- FinancialInstrumentIdentification inner content -->
</FinInstrmId>
<VoteInstrs>
<!-- VoteInstructions inner content -->
</VoteInstrs>
<VoteInstrsConfURLAdr>
<!-- VoteInstructionsConfirmationURLAddress inner content -->
</VoteInstrsConfURLAdr>
<SplmtryData>
<!-- SupplementaryData inner content -->
</SplmtryData>
</MtgVoteExctnConf>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_lKgSuxrdEeyhRdHRjakS2w"
nextVersions="_nIzIDTQ7Ee22Z83HpR5E8w"
previousVersion="_sV77O_EkEeqRfth943bvEA"
name="MeetingVoteExecutionConfirmationV08"
definition="Scope
The MeetingVoteExecutionConfirmation message is sent by an issuer, its agent or an intermediary to another intermediary, a party holding the right to vote, a registered security holder or to a beneficial holder to confirm, to the Sender of the MeetingInstruction message, that their vote has been recorded and counted by the Issuer.
Usage
This message is sent after the shareholders meeting has taken place. The Sender of this message confirms the execution of the vote at the meeting.
This messages is sent if the Sender of the MeetingInstruction message has requested such a confirmation or if market practice or regulation stipulates the need for a full audit trail.
This message definition is intended for use with the Business Application Header (BAH)."
registrationStatus="Registered"
messageSet="_G6F4oTktEeqRy8MTwqUMxA"
xmlTag="MtgVoteExctnConf"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<messageBuildingBlock
xmi:id="_lKgSwxrdEeyhRdHRjakS2w"
nextVersions="_nIzIFTQ7Ee22Z83HpR5E8w"
previousVersion="_sV77Q_EkEeqRfth943bvEA"
name="MeetingInstructionIdentification"
definition="Identification of the original meeting instruction message for which the vote execution confirmation is provided."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="MtgInstrId"
simpleType="_YW1tKdp-Ed-ak6NoX_4Aeg_1913463446" />
<messageBuildingBlock
xmi:id="_lKgSxRrdEeyhRdHRjakS2w"
nextVersions="_nIzIFzQ7Ee22Z83HpR5E8w"
previousVersion="_sV77RfEkEeqRfth943bvEA"
name="MeetingReference"
definition="Set of elements to allow the unambiguous identification of a meeting."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="MtgRef"
complexType="_UP25gfKxEeqRfth943bvEA" />
<messageBuildingBlock
xmi:id="_lKgSxxrdEeyhRdHRjakS2w"
nextVersions="_nIzIGTQ7Ee22Z83HpR5E8w"
previousVersion="_sV77R_EkEeqRfth943bvEA"
name="FinancialInstrumentIdentification"
definition="Security for which the meeting is organised."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="FinInstrmId"
complexType="_ho6XQYlXEeWPSZi0kAOXhg" />
<messageBuildingBlock
xmi:id="_lKgSyRrdEeyhRdHRjakS2w"
nextVersions="_nIzIGzQ7Ee22Z83HpR5E8w"
previousVersion="_sV77SfEkEeqRfth943bvEA"
name="VoteInstructions"
definition="Specifies how a party has voted for each agenda item."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="VoteInstrs"
complexType="_hZw3RxuUEeyhRdHRjakS2w" />
<messageBuildingBlock
xmi:id="_lKgSyxrdEeyhRdHRjakS2w"
nextVersions="_nIzIHTQ7Ee22Z83HpR5E8w"
previousVersion="_sV77S_EkEeqRfth943bvEA"
name="VoteInstructionsConfirmationURLAddress"
definition="Address to use over the www (HTTP) service where the confirmations of the vote instructions can be found."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="VoteInstrsConfURLAdr"
simpleType="_YYxm1dp-Ed-ak6NoX_4Aeg_-227354214" />
<messageBuildingBlock
xmi:id="_lKgSzRrdEeyhRdHRjakS2w"
nextVersions="_nIzIHzQ7Ee22Z83HpR5E8w"
previousVersion="_sV77TfEkEeqRfth943bvEA"
name="SupplementaryData"
definition="Additional information that cannot be captured in the structured fields and/or any other specific block."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="SplmtryData"
complexType="_Qn0zC9p-Ed-ak6NoX_4Aeg_468227563" />
<messageDefinitionIdentifier
businessArea="seev"
messageFunctionality="007"
flavour="001"
version="08" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.