seev.007.001.09
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
%% MeetingVoteExecutionConfirmationV09 recursion level 0 with max 0
class MeetingVoteExecutionConfirmationV09{
VoteExecutionConfirmationIdentification IsoMax35Text
MeetingInstructionIdentification IsoMax35Text
VoteInstructionsConfirmationURLAddress IsoMax2048Text
}
MeetingVoteExecutionConfirmationV09 *-- "0..1" Pagination1 : Pagination
MeetingVoteExecutionConfirmationV09 *-- "1..1" MeetingReference10 : MeetingReference
MeetingVoteExecutionConfirmationV09 *-- "1..1" SecurityIdentification19 : FinancialInstrumentIdentification
MeetingVoteExecutionConfirmationV09 *-- "0..1" DetailedInstructionStatus18 : VoteInstructions
MeetingVoteExecutionConfirmationV09 *-- "0..1" SupplementaryData1 : SupplementaryData
Now, we will zero-in one-by-one on each of these building blocks.
Pagination building block
Page number of the message and continuation indicator to indicate that the multi-part vote execution confirmation message is to continue or that the message is the last page of the multi-part vote execution confirmation. Number used to sequence pages when it is not possible for data to be conveyed in a single message and the data has to be split across several pages (messages). For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% Pagination1 recursion level 0 with max 1
class Pagination1{
PageNumber IsoMax5NumericText
LastPageIndicator IsoYesNoIndicator
}
Pagination1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| PageNumber | Page number. | IsoMax5NumericText - Required 1..1 |
| LastPageIndicator | Indicates the last page. | IsoYesNoIndicator - Required 1..1 |
VoteExecutionConfirmationIdentification building block
Unique identification of the group of vote execution confirmation messages when the vote execution confirmation is split in multiple (paginated) messages. 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.
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
%% DetailedInstructionStatus18 recursion level 0 with max 1
class DetailedInstructionStatus18{
SingleInstructionIdentification IsoMax35Text
AccountIdentification IsoMax35Text
SubAccountIdentification IsoMax35Text
StandingInstruction IsoYesNoIndicator
}
DetailedInstructionStatus18 *-- "0..1" IPartyIdentification231Choice : AccountOwner
DetailedInstructionStatus18 *-- "0..250" IPartyIdentification246Choice : RightsHolder
DetailedInstructionStatus18 *-- "0..1" IPartyIdentification232Choice : Proxy
DetailedInstructionStatus18 *-- "1..1" IModalityOfCounting1Choice : ModalityOfCounting
DetailedInstructionStatus18 *-- "0..1" IDateAndDateTime1Choice : VoteReceiptDateTime
DetailedInstructionStatus18 *-- "0..1000" Vote17 : VotePerResolution
%% IPartyIdentification231Choice recursion level 1 with max 1
%% IPartyIdentification246Choice 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
%% Vote17 recursion level 1 with max 1
class Vote17{
IssuerLabel IsoMax35Text
SubStatus ResolutionSubStatus1Code
Withdrawn IsoYesNoIndicator
}
Vote17 *-- "0..0" ItemDescription1 : Description
Vote17 *-- "0..1" IFinancialInstrumentQuantity18Choice : For
Vote17 *-- "0..1" IFinancialInstrumentQuantity18Choice : Against
Vote17 *-- "0..1" IFinancialInstrumentQuantity18Choice : Abstain
Vote17 *-- "0..1" IFinancialInstrumentQuantity18Choice : Withhold
Vote17 *-- "0..1" IFinancialInstrumentQuantity18Choice : WithManagement
Vote17 *-- "0..1" IFinancialInstrumentQuantity18Choice : AgainstManagement
Vote17 *-- "0..1" IFinancialInstrumentQuantity18Choice : Discretionary
Vote17 *-- "0..1" IFinancialInstrumentQuantity18Choice : OneYear
Vote17 *-- "0..1" IFinancialInstrumentQuantity18Choice : TwoYears
Vote17 *-- "0..1" IFinancialInstrumentQuantity18Choice : ThreeYears
Vote17 *-- "0..1" IFinancialInstrumentQuantity18Choice : NoAction
Vote17 *-- "0..1" IFinancialInstrumentQuantity18Choice : Blank
Vote17 *-- "0..4" ProprietaryVote2 : Proprietary
DetailedInstructionStatus18 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. | IPartyIdentification246Choice - 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. | Vote17 - 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 MeetingVoteExecutionConfirmationV09 implementation follows a specific implementaiton pattern. First of all, MeetingVoteExecutionConfirmationV09 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, MeetingVoteExecutionConfirmationV09Document implements IOuterDocument. Because MeetingVoteExecutionConfirmationV09 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type MeetingVoteExecutionConfirmationV09.
classDiagram
class IOuterRecord
MeetingVoteExecutionConfirmationV09 --|> IOuterRecord : Implements
MeetingVoteExecutionConfirmationV09Document --|> IOuterDocument~MeetingVoteExecutionConfirmationV09~ : Implements
class IOuterDocument~MeetingVoteExecutionConfirmationV09~ {
MeetingVoteExecutionConfirmationV09 Message
}
Document wrapper for serialization
The only real purpose MeetingVoteExecutionConfirmationV09Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:seev.007.001.09’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using MeetingVoteExecutionConfirmationV09.ToDocument() method. The returned MeetingVoteExecutionConfirmationV09Document value will serialize correctly according to ISO 20022 standards.
classDiagram
MeetingVoteExecutionConfirmationV09Document *-- MeetingVoteExecutionConfirmationV09 : 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.09">
<MtgVoteExctnConf>
<Pgntn>
<!-- Pagination inner content -->
</Pgntn>
<VoteExctnConfId>
<!-- VoteExecutionConfirmationIdentification inner content -->
</VoteExctnConfId>
<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="_nIzIDTQ7Ee22Z83HpR5E8w"
previousVersion="_lKgSuxrdEeyhRdHRjakS2w"
name="MeetingVoteExecutionConfirmationV09"
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="_aYSVkfZkEemdMY5FVzFKKA"
xmlTag="MtgVoteExctnConf"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<messageBuildingBlock
xmi:id="_rnQA4TUFEe2tRf29bleifQ"
name="Pagination"
definition="Page number of the message and continuation indicator to indicate that the multi-part vote execution confirmation message is to continue or that the message is the last page of the multi-part vote execution confirmation."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="Pgntn"
complexType="_xhMHQa6XEees_ufOy2ci-g" />
<messageBuildingBlock
xmi:id="_52KWoDUFEe2tRf29bleifQ"
name="VoteExecutionConfirmationIdentification"
definition="Unique identification of the group of vote execution confirmation messages when the vote execution confirmation is split in multiple (paginated) messages."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="VoteExctnConfId"
simpleType="_YW1tKdp-Ed-ak6NoX_4Aeg_1913463446" />
<messageBuildingBlock
xmi:id="_nIzIFTQ7Ee22Z83HpR5E8w"
previousVersion="_lKgSwxrdEeyhRdHRjakS2w"
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="_nIzIFzQ7Ee22Z83HpR5E8w"
previousVersion="_lKgSxRrdEeyhRdHRjakS2w"
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="_nIzIGTQ7Ee22Z83HpR5E8w"
previousVersion="_lKgSxxrdEeyhRdHRjakS2w"
name="FinancialInstrumentIdentification"
definition="Security for which the meeting is organised."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="FinInstrmId"
complexType="_ho6XQYlXEeWPSZi0kAOXhg" />
<messageBuildingBlock
xmi:id="_nIzIGzQ7Ee22Z83HpR5E8w"
previousVersion="_lKgSyRrdEeyhRdHRjakS2w"
name="VoteInstructions"
definition="Specifies how a party has voted for each agenda item."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="VoteInstrs"
complexType="__hC9MTUCEe2tRf29bleifQ" />
<messageBuildingBlock
xmi:id="_nIzIHTQ7Ee22Z83HpR5E8w"
previousVersion="_lKgSyxrdEeyhRdHRjakS2w"
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="_nIzIHzQ7Ee22Z83HpR5E8w"
previousVersion="_lKgSzRrdEeyhRdHRjakS2w"
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="09" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.