seev: Securities Events
seev.009 Agent CA Notification Advice
Written and maintained by ZagTrader. Last reviewed . How this page is sourced and checked
seev.009 is the ISO 20022 AgentCANotificationAdvice message in the Securities Events business area (seev). The latest version is seev.009.001.02, and 2 versions are in the repository.
- Message
- AgentCANotificationAdvice
- Latest version
- seev.009.001.02
- Submitting organisation
- Not read from the catalogue
- MT equivalent
- None listed
In use: published in the current ISO 20022 catalogue.
What seev.009 is for
This message is sent by an issuer (or its agent) to a CSD to:
- Provide a CSD with the details of a corporate action along with the possible options available to the clients of that CSD; and
- to update a corporate action notification. A notification advice can be initially sent as a preliminary advice and subsequently replaced by another notification advice with updated information.
This message is used:
- to provide a CSD with the details of a corporate action along with the possible options available to the clients of that CSD. The information can be complete or incomplete.
- to update a corporate action notification advice. A notification advice can be initially sent as a preliminary advice and subsequently replaced by another notification advice with updated information. As per SMPG recommendation, all the information should be provided in the update, not only updated information.
An Agent Corporate Action Notification Status Advice is sent in reply to the Agent Corporate Action Notification Advice.
Note: The amendment of a corporate action notification is done through a replacement mechanism in line with both the ISO 15022 messages used in the flow between the CSD and its clients, and the ISO 20022 proxy voting messages.
seev.009 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.009.001.02latest | Registered | Latest version set |
| seev.009.001.01 | Registered | Archive |
seev.009 message structure
The building blocks of seev.009.001.02 and the elements directly under them, 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]AgtCANtfctnAdvcAgentCANotificationAdvice [1..1]PgntnPagination [0..1]Pagination1Page number of the message and continuation indicator to indicate that the multi-part notification is to continue or that the message is the last page of the multi-part notification.
PgNbPage Number [1..1]Max5NumericTextPage number.
LastPgIndLast Page Indicator [1..1]YesNoIndicatorIndicates the last page.
NtfctnGnlInfNotification General Information [1..1]CorporateActionNotification12General information about the event notification type, status and contents.
NtfctnIdNotification Identification [0..1]Max35TextUnique identification of the group of corporate action notification messages when the notification is split in multiple (paginated) messages.
NtfctnTpNotification Type [1..1]CorporateActionNotificationType1CodeSpecifies the type of notification.
PrcgStsProcessing Status [1..1]CorporateActionProcessingStatus7Choice (choice)Specifies the status of the details of the corporate action event.
PrvsNtfctnIdPrevious Notification Identification [0..1]DocumentIdentification31Identification of the previously sent notification document.
IdIdentification [1..1]Max35TextIdentifies the document.
LkgTpLinkage Type [0..1]ProcessingPosition7Choice (choice)Specifies when this document is to be processed relative to another referred document.
AgtInfAgent Information [1..*]CorporateActionAgent2Agent institution identification, exact role and contact person.
IssrAgtIssuer Agent [0..1]PartyIdentification289Party appointed to administer the event on behalf of the issuer company/offeror.
PngAgtPaying Agent [0..1]PartyIdentification289Agent (principal or fiscal paying agent) appointed to execute the payment for the corporate action event on behalf of the issuer company/offeror.
RegarRegistrar [0..1]PartyIdentification289Party/agent responsible for maintaining the register of the security.
RmktgAgtRemarketing Agent [0..1]PartyIdentification289Agent who remarkets the security whereby the outstanding does not get reduced.
SlctnAgtSolicitation Agent [0..1]PartyIdentification289Trust company, bank or similar financial institution assigned by an issuer to maintain records of investors and account balances and transactions for...
InfAgtInformation Agent [0..1]PartyIdentification289Trust company, bank or similar financial institution assigned by an Issuer to provide information and copies of the offering documentation.
IssrIssuer [0..1]PartyIdentification289Issuer of the financial instrument.
TrfAgtTransfer Agent [0..1]PartyIdentification289Trust company, bank or similar financial institution appointed by a fund management company to maintain records of investors and account balances.
RedAgtRedemption Agent [0..1]PartyIdentification289Depository or any bank or trust company appointed to receive and send redemption proceeds.
CorpActnGnlInfCorporate Action General Information [1..1]CorporateActionGeneralInformation172General information about the corporate action event.
AgtCorpActnEvtIdAgent Corporate Action Event Identification [1..1]Max35TextReference assigned by the account servicer to unambiguously identify a corporate action event.
CorpActnEvtIdCorporate Action Event Identification [0..1]Max35TextReference assigned by the account servicer to unambiguously identify a corporate action event.
OffclCorpActnEvtIdOfficial Corporate Action Event Identification [0..1]Max35TextOfficial and unique reference assigned by the official central body/entity within each market at the beginning of a corporate action event.
EvtPrcgTpEvent Processing Type [0..1]CorporateActionEventProcessingType2CodeType of processing involved by a corporate action.
EvtTpEvent Type [1..1]CorporateActionEventType106Choice (choice)Type of corporate action event.
SubEvtTpSub Event Type [0..1]DTCCSubEventType9CodeDTCC (The Depository Trust and Clearing Corporation) native corporate action sub event type name further defines the event type.
MndtryVlntryEvtTpMandatory Voluntary Event Type [1..1]CorporateActionMandatoryVoluntary3Choice (choice)Specifies whether the event is mandatory, mandatory with options or voluntary.
UndrlygSctyUnderlying Security [1..*]FinancialInstrumentAttributes126Security concerned by the corporate action.
CorpActnDtlsCorporate Action Details [1..1]CorporateAction83Provides details information about the CA event.
DtDtlsDate Details [0..1]CorporateActionDate83Provides information about the dates related to a corporate action event.
EvtBalDtlsEvent Balance Details [0..1]CorporateActionBalanceDetails47Balances related to the corporate action event.
AmtDtlsAmount Details [0..1]CorporateActionAmounts70Provides information about the amounts related to a corporate action event.
PrdDtlsPeriod Details [0..1]CorporateActionPeriod16Provides information about the periods related to a corporate action event.
RateAndAmtDtlsRate And Amount Details [0..1]CorporateActionRate122Provides information about rates and amounts related to a corporate action event.
PricDtlsPrice Details [0..1]CorporateActionPrice85Provides information about the prices related to a corporate action event.
SctiesQtySecurities Quantity [0..1]CorporateActionQuantity11Provides information about securities quantity linked to a corporate action.
IntrstAcrdNbOfDaysInterest Accrued Number Of Days [0..1]Max3NumberNumber of days used for calculating the accrued interest amount.
AccptncPrtyLvlAcceptance Priority Level [0..1]Exact3UpperCaseAlphaNumericTextLevel of priority of the given offer which will be accepted by the issuer/agent within the tiered structure of the event.
ChrgsApldIndCharges Applied Indicator [0..1]YesNoIndicatorIndicates whether charges apply to the holder, for instance redemption charges.
RstrctnIndRestriction Indicator [0..1]YesNoIndicatorIndicates whether restrictions apply to the corporate action event or not.
AcrdIntrstIndAccrued Interest Indicator [0..1]YesNoIndicatorIndicates whether the holder is entitled to accrued interest.
SplmtryIndctrsSupplementary Indicators [0..1]CorporateActionSupplementaryIndicators1Identification of a supplementary data element.
FrftrOfIntrstIndForfeiture Of Interest Indicator [0..1]YesNoIndicatorIndicates that bondholders who convert between record date and payable date will forfeit their interest.
DvddTpDividend Type [0..1]DividendTypeFormat9Choice (choice)Specifies the conditions in which a dividend is paid.
OcrncTpOccurrence Type [0..1]DistributionTypeFormat7Choice (choice)Specifies the conditions in which the instructions and/or payment of the proceeds occurs.
OfferTpOffer Type [0..*]OfferTypeFormat14Choice (choice)Specifies the conditions that apply to the offer.
RnncblEntitlmntStsTpRenounceable Entitlement Status Type [0..1]RenounceableEntitlementStatusTypeFormat3Choice (choice)Specifies whether terms of the event allow resale of the rights.
EvtStagEvent Stage [0..*]CorporateActionEventStageFormat13Choice (choice)Stage in the corporate action event life cycle.
AddtlBizPrcIndAdditional Business Process Indicator [0..*]AdditionalBusinessProcessFormat17Choice (choice)Specifies the type of the additional business process linked to the corporate action event such as a claim compensation or tax refund.
ChngTpChange Type [0..*]CorporateActionChangeTypeFormat5Choice (choice)Specifies the type of change announced.
IntrmdtSctiesDstrbtnTpIntermediate Securities Distribution Type [0..1]IntermediateSecuritiesDistributionTypeFormat15Choice (choice)Type of intermediates securities distribution.
CptlGnInOutIndCapital Gain In Out Indicator [0..1]CapitalGainFormat3Choice (choice)Specifies whether the capital gain is in the scope of the EU Savings directive for the income realised upon the sale, refund or redemption of shares...
TaxblIncmPerShrClctdTaxable Income Per Share Calculated [0..1]TaxableIncomePerShareCalculatedFormat3Choice (choice)Specifies whether the financial instrument calculates the taxable income per dividend/taxable income per share.
LtryTpLottery Type [0..1]LotteryTypeFormat4Choice (choice)Specifies the type of lottery announced.
CertfctnTpCertification Type [0..1]CertificationTypeFormat3Choice (choice)Specifies the certification format required, this is, physical or electronic format.
CnsntTpConsent Type [0..1]ConsentTypeFormat4Choice (choice)Specifies the type of consent announced.
InfTpInformation Type [0..1]InformationTypeFormat4Choice (choice)Specifies the type of information event.
TaxOnNonDstrbtdPrcdsIndTax On Non Distributed Proceeds Indicator [0..*]GenericIdentification30Specifies the tax regulation being attributed to the non-distributed proceeds event or to any other event.
DtchAuctnTpDutch Auction Type [0..1]DutchAuctionTypeFormat1Choice (choice)Specifies whether a Dutch auction is modified or unmodified.
NewPlcOfIncorprtnNew Place Of Incorporation [0..1]Max350TextNew company's place of incorporation.
NtceTpNotice Type [0..1]RedemptionAnnouncementNoticeType1CodeSpecifies whether a redemption announcement refers to certificates held only at depository or also outside of depository.
PrratnRtrMinQtyTrtmntProration Return Minimum Quantity Treatment [0..1]ProrationReturnQuantityTreatment1CodeIndicates how prorated instructions will be handled when the prorated entitlement results in less than the minimum denomination.
CertDtlsCertificate Details [0..*]CorporateActionSD26Details of certificates that have been called for redemption.
AddtlInfAdditional Information [0..1]CorporateActionNarrative58Provides additional information.
CorpActnOptnDtlsCorporate Action Option Details [0..*]CorporateActionOption235Provides detailed information about the option of the CA event.
OptnNbOption Number [1..1]Exact3NumericTextNumber identifying the available corporate action options.
OptnTpOption Type [1..1]CorporateActionOption37Choice (choice)Specifies the corporate action options available to the account owner.
FrctnDspstnFraction Disposition [0..1]FractionDispositionType26Choice (choice)Specifies how fractions resulting from derived securities will be processed or how prorated decisions will be rounding, if provided with a pro ration...
OfferTpOffer Type [0..*]OfferTypeFormat14Choice (choice)Specifies the conditions that apply to the offer.
OptnFeatrsOption Features [0..*]OptionFeaturesFormat28Choice (choice)Specifies the features that may apply to a corporate action option.
SplmtryOptnFeatrsSupplementary Option Features [0..*]ExtendedOptionFeature2CodeUsed for options that have particular proprietary features.
OptnAvlbtyStsOption Availability Status [0..1]OptionAvailabilityStatus3Choice (choice)Specifies the status of the option.
CertfctnBrkdwnTpCertification Breakdown Type [0..*]BeneficiaryCertificationType13Choice (choice)Type of certification/breakdown.
CcyOptnCurrency Option [0..1]ActiveCurrencyCodeCurrency in which cash proceeds are to be credited/debited.
DfltOptnIndDefault Option Indicator [1..1]YesNoIndicatorIndicates whether the option, for example, currency option, will be selected by default if no instruction is provided by the account owner.
AccptncPrtyLvlAcceptance Priority Level [0..1]Exact3UpperCaseAlphaNumericTextLevel of priority of the given offer which will be accepted by the issuer/agent within the tiered structure of the event.
CertfctnBrkdwnIndCertification Breakdown Indicator [0..1]YesNoIndicatorIndicates whether certification/breakdown is required from the account owner.
WdrwlAllwdIndWithdrawal Allowed Indicator [0..1]YesNoIndicatorIndicates whether withdrawal of instruction is allowed.
OvrsbcptChrgIndOversubscription Charge Indicator [0..1]YesNoIndicatorIndicates whether the cash debit for the oversubscription charge is made at the time of instruction submission.
PrtctChrgIndProtect Charge Indicator [0..1]YesNoIndicatorIndicates whether the cash debit for the protect charge is made at the time of instruction submission.
SbcptChrgIndSubscription Charge Indicator [0..1]YesNoIndicatorIndicates whether the cash debit for the subscription charge is made at the time of instruction submission.
StepUpChrgIndStep Up Charge Indicator [0..1]YesNoIndicatorIndicates whether the cash debit for the step-up charge is made at the time of instruction submission.
FinInstrmIdFinancial Instrument Identification [0..1]SecurityIdentification19Identifies the financial instrument.
DtDtlsDate Details [0..1]CorporateActionDate104Provides information about the dates related to a corporate action option.
PrdDtlsPeriod Details [0..1]CorporateActionPeriod12Provides information about the periods related to a corporate action option.
RateAndAmtDtlsRate And Amount Details [0..1]CorporateActionRate124Provides information about rates and amounts related to a corporate action option.
PricDtlsPrice Details [0..1]CorporateActionPrice87Provides information about the prices related to a corporate action option.
SctiesQtySecurities Quantity [0..1]SecuritiesOption81Provides information about securities quantity linked to a corporate action option.
TaxCtgyTax Category [0..99]TaxCategory1Identification of the tax category as issuers, their agents, or tax authorities may require a breakdown of holders at a category level that have...
PrratnBlwMinQtyProration Below Minimum Quantity [0..1]ProrationBelowMinimumQuantity2Choice (choice)Specifies how instructions prorated below the minimum quantity to instruct will be processed.
PrratnRndgIndProration Rounding Indicator [0..1]FractionDispositionType12CodeIndicates how fractional positions will be handled for events with prorated options.
PrratnFrctnProration Fraction [0..1]DecimalNumberDecimal above which numbers are rounded for prorated options.
PrratnRtrMinQtyTrtmntProration Return Minimum Quantity Treatment [0..1]ProrationReturnQuantityTreatment1CodeIndicates how prorated instructions will be handled when the prorated entitlement results in less than the minimum denomination.
SctiesMvmntDtlsSecurities Movement Details [0..*]SecuritiesOption114Provides information about the securities movement linked to the corporate action option.
CshMvmntDtlsCash Movement Details [0..*]CashOption108Provides information about the cash movement linked to the corporate action option.
AddtlInfAdditional Information [0..1]CorporateActionNarrative66Provides additional information.
AddtlInfAdditional Information [0..1]CorporateActionNarrative2Provides additional information.
InfCondsInformation Conditions [0..1]Max350TextProvides conditional information related to the event, eg, an offer is subject to 50% acceptance, the offeror allows the securities holder to set...
InfToCmplyWthInformation To Comply With [0..1]Max350TextProvides information conditions to the account owner that are to be complied with, eg, not open to US/Canadian residents, QIB or SIL to be provided.
TaxtnCondsTaxation Conditions [0..1]Max350TextProvides taxation conditions that cannot be included within the structured fields of this message and has not been mentioned in the SLA.
DclrtnDtlsDeclaration Details [0..1]Max350TextProvides declaration details narrative relative to the financial instrument, eg, beneficial ownership.
RegnDtlsRegistration Details [0..1]Max350TextProvides information required for the registration.
AddtlTxtAdditional Text [0..1]Max350TextProvides additional information or specifies in more detail the content of a message.
Have a seev.009 message? Paste it into the parser to see every element with its name and definition, and format checks on BICs, IBANs, dates and amounts.
External code sets used in seev.009
These elements take their values from ISO 20022 external code sets, which are published separately and updated every quarter without a new message version.
seev.009 questions
- What is the latest version of seev.009?
- The latest version in the ISO 20022 e-Repository release of 24 April 2025 is seev.009.001.02.
- What is the root element of seev.009?
- The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:seev.009.001.02, and its message element is AgtCANtfctnAdvc (AgentCANotificationAdvice).
- Is there an MT equivalent of seev.009?
- 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.