What is the latest version of seev.012?

The latest version in the ISO 20022 e-Repository release of 24 April 2025 is seev.012.001.01.

What is the root element of seev.012?

The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:seev.012.001.01, and its message element is AgtCAElctnAdvc (AgentCAElectionAdvice).

Is there an MT equivalent of seev.012?

No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

seev: Securities Events

seev.012 Agent CA Election Advice

Written and maintained by ZagTrader. Last reviewed 21 October 2026. How this page is sourced and checked

seev.012 is the ISO 20022 AgentCAElectionAdvice message in the Securities Events business area (seev). The latest version is seev.012.001.01.

Message: AgentCAElectionAdvice
Latest version: seev.012.001.01
Submitting organisation: Not read from the catalogue
MT equivalent: None listed

In use: published in the current ISO 20022 catalogue.

What seev.012 is for

This message is sent by a CSD to the issuer (or its agent) to provide information about the clients' election instruction, the registration details, the delivery details, etc. In case of an election with underlying resource movements, it also confirms that these have been completed. This message may also be sent in case of an amendment of an election, once the CSD has completed the required resource movements.
This message can be used for a new election advice or an amended election advice.
If this message is used for a new election advice, the function of the message must be 'new election'.
If this message is used for an amended election advice, the function of the message must be 'option change' and the identification of the previously sent election advice must be present.
This message can include the cash movements and/or securities movements in the case of an election with underlying resource movements. Additionally, this message can include delivery, certification and beneficial owner details.
Note: this information can be also sent separately in the Agent Corporate Action Information advice message.

Definition from the ISO 20022 e-Repository, release of 24 April 2025.

seev.012 versions

Every version published in the e-Repository, newest first. A message keeps its business purpose across versions; each new version is a separate schema with its own namespace.

Version	Registration status	Published in
seev.012.001.01latest	Registered	Latest version set

seev.012 message structure

The building blocks of seev.012.001.01 to three levels, with multiplicity ([0..1] optional, [1..1] mandatory, * any number) and the data type or component. Element names and definitions are from the ISO 20022 repository; usage guidelines such as CBPR+ or a market infrastructure's rules can restrict them further.

Document [1..1]
- AgtCAElctnAdvc AgentCAElectionAdvice [1..1]
  - Id Identification [1..1]DocumentIdentification8
    Identification assigned by the Sender to unambiguously identify the advice.
    - Id Identification [1..1]Max35Text
      Unique identification of the document.
    - CreDtTm Creation Date Time [0..1]ISODateTime
      Date/time of the creation of the document.
  - ElctnAdvcTpAndLkg Election Advice Type And Linkage [1..1]ElectionAdviceFunction1
    Provides information about the type of election advice and linked messages.
    - ElctnTp Election Type [1..1]ElectionType1Code
      Type of election advice.
    - PrvsAgtCAElctnAdvcId Previous Agent CA Election Advice Identification [0..1]DocumentIdentification8
      Identification of the previous Agent Corporate Action Election Advice that is being amended.
      - Id Identification [1..1]Max35Text
      - CreDtTm Creation Date Time [0..1]ISODateTime
    - AgtCAElctnStsAdvcId Agent CA Election Status Advice Identification [0..1]DocumentIdentification8
      Identification of the Agent Corporate Action Election Status Advice by which the issuer (agent) accepts the election amendment request.
      - Id Identification [1..1]Max35Text
      - CreDtTm Creation Date Time [0..1]ISODateTime
    - AgtCAElctnAmdmntReqId Agent CA Election Amendment Request Identification [0..1]DocumentIdentification8
      Identification of the Agent Corporate Action Election Amendment Request by which the CSD request the authorisation to amend an election.
      - Id Identification [1..1]Max35Text
      - CreDtTm Creation Date Time [0..1]ISODateTime
  - CorpActnGnlInf Corporate Action General Information [1..1]CorporateActionInformation1
    General information about the corporate action event.
    - AgtId Agent Identification [1..1]PartyIdentification2Choice (choice)
      Identification of the issuer agent.
      - BICOrBEI BIC Or BEI [1..1]AnyBICIdentifier
      - PrtryId Proprietary Identification [1..1]GenericIdentification1
      - NmAndAdr Name And Address [1..1]NameAndAddress5
    - IssrCorpActnId Issuer Corporate Action Identification [0..1]Max35Text
      Reference given to the event by the CA event issuer (agent).
    - CorpActnPrcgId Corporate Action Processing Identification [0..1]Max35Text
      Reference assigned by the account servicer to unambiguously identify a corporate action event.
    - EvtTp Event Type [1..1]CorporateActionEventType2FormatChoice (choice)
      Type of corporate action event.
      - Cd Code [1..1]CorporateActionEventType2Code
      - Prtry Proprietary [1..1]GenericIdentification13
    - MndtryVlntryEvtTp Mandatory Voluntary Event Type [1..1]CorporateActionMandatoryVoluntary1FormatChoice (choice)
      Specifies whether the event is mandatory, mandatory with options or voluntary.
      - Cd Code [1..1]CorporateActionMandatoryVoluntary1Code
      - Prtry Proprietary [1..1]GenericIdentification13
    - EvtPrcgTp Event Processing Type [0..1]CorporateActionEventProcessingType1FormatChoice (choice)
      Type of processing involved by a Corporate Action.
      - Cd Code [1..1]CorporateActionEventProcessingType1Code
      - Prtry Proprietary [1..1]GenericIdentification13
    - UndrlygScty Underlying Security [1..1]FinancialInstrumentDescription3
      Identification of the underlying financial instrument, ie, the financial instrument affected by the corporate action event.
      - SctyId Security Identification [1..1]SecurityIdentification7
      - PlcOfListg Place Of Listing [0..1]MICIdentifier
      - SfkpgPlc Safekeeping Place [0..1]PartyIdentification2Choice (choice)
  - ElctnDtls Election Details [1..1]CorporateActionElection3
    Provides information about the election(s).
    - AcctDtls Account Details [0..1]SecuritiesAccount7
      Provides information about the account.
      - AcctOwnrId Account Owner Identification [0..1]PartyIdentification2Choice (choice)
      - AcctId Account Identification [1..1]Max35Text
    - OptnTp Option Type [0..1]CorporateActionOption1FormatChoice (choice)
      Specifies the corporate action options available to the account owner.
      - Cd Code [1..1]CorporateActionOptionType1Code
      - Prtry Proprietary [1..1]GenericIdentification13
    - OptnNb Option Number [0..1]Exact3NumericText
      Number identifying the available corporate action options.
    - InstdUndrlygSctiesQty Instructed Underlying Securities Quantity [0..1]UnitOrFaceAmount1Choice (choice)
      Quantity of underlying securities to which this instruction applies.
      - Unit Unit [1..1]DecimalNumber
      - FaceAmt Face Amount [1..1]ActiveCurrencyAndAmount
    - InstdSctiesQtyToRcv Instructed Securities Quantity To Receive [0..1]UnitOrFaceAmount1Choice (choice)
      Quantity of the benefits that the account owner wants to receive, eg, as a result of dividend reinvestment.
      - Unit Unit [1..1]DecimalNumber
      - FaceAmt Face Amount [1..1]ActiveCurrencyAndAmount
    - PropsdRate Proposed Rate [0..1]PercentageRate
      Rate proposed in a remarketing of variable rate notes.
    - CshMvmntDtls Cash Movement Details [0..*]CorporateActionCashMovements2
      Provides information about the cash movement resulting from the election instruction.
      - PstngId Posting Identification [0..1]Max35Text
      - PstngDtTm Posting Date Time [0..1]DateAndDateTimeChoice (choice)
      - PstngAmt Posting Amount [1..1]ActiveCurrencyAndAmount
      - AcctDtls Account Details [1..2]CashAccount19
    - SctiesMvmntDtls Securities Movement Details [0..*]CorporateActionSecuritiesMovement2
      Provides information about the securities movement resulting from the election instruction.
      - SctyId Security Identification [1..1]SecurityIdentification7
      - PstngDtTm Posting Date Time [0..1]DateAndDateTimeChoice (choice)
      - PstngId Posting Identification [0..1]Max35Text
      - PstngQty Posting Quantity [1..1]UnitOrFaceAmount1Choice (choice)
      - AcctDtls Account Details [1..2]SecuritiesAccount9
  - AddtlInf Additional Information [0..1]CorporateActionAdditionalInformation1
    Provides additional information about the delivery details, beneficial owner details, etc.
    - BnfclOwnrDtls Beneficial Owner Details [0..*]BeneficialOwner1
      Provides information about the beneficial owner of the securities.
      - BnfclOwnrId Beneficial Owner Identification [1..1]PartyIdentification2Choice (choice)
      - AddtlId Additional Identification [0..1]GenericIdentification16
      - Ntlty Nationality [0..1]CountryCode
      - DmclCtry Domicile Country [0..1]CountryCode
      - NonDmclCtry Non Domicile Country [0..1]CountryCode
      - CertfctnInd Certification Indicator [0..1]YesNoIndicator
      - CertfctnTp Certification Type [0..1]BeneficiaryCertificationType1FormatChoice (choice)
      - DclrtnDtls Declaration Details [0..1]Max350Text
      - SctyId Security Identification [0..1]SecurityIdentification7
      - ElctdSctiesQty Elected Securities Quantity [1..1]UnitOrFaceAmount1Choice (choice)
    - RegnDtls Registration Details [0..1]Max350Text
      Provides information required for the registration.
    - RcvrId Receiver Identification [0..1]PartyIdentification2Choice (choice)
      Identification of the receiver of outturned resources (cash/securities) in case the resources need to be delivered outside the CSD.
      - BICOrBEI BIC Or BEI [1..1]AnyBICIdentifier
      - PrtryId Proprietary Identification [1..1]GenericIdentification1
      - NmAndAdr Name And Address [1..1]NameAndAddress5
    - CertfctnInd Certification Indicator [0..1]YesNoIndicator
      Whether or not certification is required from the account owner.
    - CertfctnTp Certification Type [0..1]BeneficiaryCertificationType1FormatChoice (choice)
      Type of certification which is required.
      - Cd Code [1..1]BeneficiaryCertificationType1Code
      - Prtry Proprietary [1..1]GenericIdentification13
    - DlvryDtls Delivery Details [0..*]ProceedsDelivery1
      Provides information about the delivery details of proceeds.
      - SctiesAcctId Securities Account Identification [1..1]Max35Text
      - CshAcctId Cash Account Identification [1..1]CashAccountIdentification1Choice (choice)
      - AcctOwnrId Account Owner Identification [0..1]PartyIdentification2Choice (choice)
      - AcctSvcrId Account Servicer Identification [0..1]PartyIdentification2Choice (choice)
    - AddtlInstr Additional Instruction [0..1]Max350Text
      Provides additional details pertaining to the corporate action instruction.
  - CtctDtls Contact Details [0..1]ContactPerson1
    Contact responsible for the transaction identified in the message.
    - CtctPrsn Contact Person [1..1]ContactIdentification4
      Provides additional information regarding the party, eg, the contact unit or person responsible for the transaction identified in the message.
      - Nm Name [1..1]Max350Text
      - NmPrfx Name Prefix [0..1]NamePrefix1Code
      - GvnNm Given Name [0..1]Max350Text
      - Role Role [0..1]Max35Text
      - PhneNb Phone Number [0..1]PhoneNumber
      - FaxNb Fax Number [0..1]PhoneNumber
      - EmailAdr Email Address [0..1]Max256Text
    - InstnId Institution Identification [0..1]PartyIdentification2Choice (choice)
      Identification of the institution that the contact person represents.
      - BICOrBEI BIC Or BEI [1..1]AnyBICIdentifier
      - PrtryId Proprietary Identification [1..1]GenericIdentification1
      - NmAndAdr Name And Address [1..1]NameAndAddress5

Have a seev.012 message? Paste it into the parser to see every element with its name and definition, and format checks on BICs, IBANs, dates and amounts.

seev.012 questions

What is the latest version of seev.012?: The latest version in the ISO 20022 e-Repository release of 24 April 2025 is seev.012.001.01.
What is the root element of seev.012?: The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:seev.012.001.01, and its message element is AgtCAElctnAdvc (AgentCAElectionAdvice).
Is there an MT equivalent of seev.012?: No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

All ISO 20022 messages · ISO 20022 code sets · MT messages

The ISO 20022 message definitions, element names and definitions on this page are reproduced from material published at iso20022.org under the ISO 20022 Intellectual Property Rights policy. This is not the official source: the up-to-date ISO 20022 standards and repository material are published only at iso20022.org. Explanations in our own words are by ZagTrader. ZagTrader is not affiliated with or endorsed by ISO or Swift.