seev.011.001.01
Scope This message is sent by a CSD to an issuer (or its agent) to report the status, or change in status, of a notification advice or notification cancellation request. Usage When this message is used to report the status of a notification advice then the building block Agent Corporate Action Notification Advice Identification must be present. When this message is used to provide the status of a notification cancellation request then the building block Notification Cancellation Request Identification must be present.
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
%% AgentCANotificationStatusAdviceV01 recursion level 0 with max 0
AgentCANotificationStatusAdviceV01 *-- "1..1" DocumentIdentification8 : Identification
AgentCANotificationStatusAdviceV01 *-- "1..1" DocumentIdentification8 : AgentCANotificationAdviceIdentification
AgentCANotificationStatusAdviceV01 *-- "1..1" DocumentIdentification8 : AgentCANotificationCancellationRequestIdentification
AgentCANotificationStatusAdviceV01 *-- "1..1" CorporateActionInformation2 : CorporateActionGeneralInformation
AgentCANotificationStatusAdviceV01 *-- "1..1" INotificationCancellationRequestStatus1Choice : NotificationCancellationRequestStatus
AgentCANotificationStatusAdviceV01 *-- "1..1" INotificationAdviceStatus1Choice : NotificationAdviceStatus
Now, we will zero-in one-by-one on each of these building blocks.
Identification building block
Identification assigned by the Sender to unambiguously identify the status advice. Identifies the document by providing a unique identification and optionally the date/time of the creation of the document. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% DocumentIdentification8 recursion level 0 with max 1
class DocumentIdentification8{
Identification IsoMax35Text
CreationDateTime IsoISODateTime
}
DocumentIdentification8 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Unique identification of the document. | IsoMax35Text - Required 1..1 |
| CreationDateTime | Date/time of the creation of the document. | IsoISODateTime - Optional 0..1 |
AgentCANotificationAdviceIdentification building block
Identification of the linked Agent CA Notification Advice for which a status is given. Identifies the document by providing a unique identification and optionally the date/time of the creation of the document. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% DocumentIdentification8 recursion level 0 with max 1
class DocumentIdentification8{
Identification IsoMax35Text
CreationDateTime IsoISODateTime
}
DocumentIdentification8 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Unique identification of the document. | IsoMax35Text - Required 1..1 |
| CreationDateTime | Date/time of the creation of the document. | IsoISODateTime - Optional 0..1 |
AgentCANotificationCancellationRequestIdentification building block
Identification of the linked Agent CA Notification Cancellation Request for which a status is given. Identifies the document by providing a unique identification and optionally the date/time of the creation of the document. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% DocumentIdentification8 recursion level 0 with max 1
class DocumentIdentification8{
Identification IsoMax35Text
CreationDateTime IsoISODateTime
}
DocumentIdentification8 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Unique identification of the document. | IsoMax35Text - Required 1..1 |
| CreationDateTime | Date/time of the creation of the document. | IsoISODateTime - Optional 0..1 |
CorporateActionGeneralInformation building block
General information about the corporate action event. Provides information about the corporate action event. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% CorporateActionInformation2 recursion level 0 with max 1
class CorporateActionInformation2{
IssuerCorporateActionIdentification IsoMax35Text
CorporateActionProcessingIdentification IsoMax35Text
}
CorporateActionInformation2 *-- "1..1" IPartyIdentification2Choice : AgentIdentification
CorporateActionInformation2 *-- "1..1" ICorporateActionEventType2FormatChoice : EventType
CorporateActionInformation2 *-- "0..1" ICorporateActionEventProcessingType1FormatChoice : EventProcessingType
CorporateActionInformation2 *-- "1..1" ICorporateActionMandatoryVoluntary1FormatChoice : MandatoryVoluntaryEventType
CorporateActionInformation2 *-- "1..1" FinancialInstrumentDescription3 : UnderlyingSecurity
CorporateActionInformation2 *-- "0..0" FinancialInstrumentDescription3 : OtherUnderlyingSecurity
%% IPartyIdentification2Choice recursion level 1 with max 1
%% ICorporateActionEventType2FormatChoice recursion level 1 with max 1
%% ICorporateActionEventProcessingType1FormatChoice recursion level 1 with max 1
%% ICorporateActionMandatoryVoluntary1FormatChoice recursion level 1 with max 1
%% FinancialInstrumentDescription3 recursion level 1 with max 1
class FinancialInstrumentDescription3{
PlaceOfListing IsoMICIdentifier
}
FinancialInstrumentDescription3 *-- "1..1" SecurityIdentification7 : SecurityIdentification
FinancialInstrumentDescription3 *-- "0..1" IPartyIdentification2Choice : SafekeepingPlace
%% FinancialInstrumentDescription3 recursion level 1 with max 1
class FinancialInstrumentDescription3{
PlaceOfListing IsoMICIdentifier
}
FinancialInstrumentDescription3 *-- "1..1" SecurityIdentification7 : SecurityIdentification
FinancialInstrumentDescription3 *-- "0..1" IPartyIdentification2Choice : SafekeepingPlace
CorporateActionInformation2 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| AgentIdentification | Identification of the issuer’s agent or the issuer. | IPartyIdentification2Choice - Required 1..1 |
| IssuerCorporateActionIdentification | Reference given to the event by the CA event issuer (agent). | IsoMax35Text - Required 1..1 |
| CorporateActionProcessingIdentification | Reference assigned by the (I)CSD to unambiguously identify a corporate avent. | IsoMax35Text - Optional 0..1 |
| EventType | Speficies the type of corporate event. | ICorporateActionEventType2FormatChoice - Required 1..1 |
| EventProcessingType | Type of processing involved by a Corporate Action. | ICorporateActionEventProcessingType1FormatChoice - Optional 0..1 |
| MandatoryVoluntaryEventType | Specifies whether the event is mandatory, mandatory with options or voluntary. | ICorporateActionMandatoryVoluntary1FormatChoice - Required 1..1 |
| UnderlyingSecurity | Identification of the underlying financial instrument, ie, the financial instrument affected by the corporate action event. | FinancialInstrumentDescription3 - Required 1..1 |
| OtherUnderlyingSecurity | Identification of the secondary underlying financial instrument, ie, the non-principal financial instrument affected by the corporate action event. | FinancialInstrumentDescription3 - Unknown 0..0 |
NotificationCancellationRequestStatus building block
Status of the Notification Cancellation Request sent by the issuer (agent). Choice between various statuses. For comparison, see the ISO20022 official specification
classDiagram direction tb %% INotificationCancellationRequestStatus1Choice recursion level 0 with max 1
NotificationCancellationRequestStatus1Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
NotificationAdviceStatus building block
Status of the notification advice sent by the issuer (agent). Provides the status of a notification advice. For comparison, see the ISO20022 official specification
classDiagram direction tb %% INotificationAdviceStatus1Choice recursion level 0 with max 1
NotificationAdviceStatus1Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the AgentCANotificationStatusAdviceV01 implementation follows a specific implementaiton pattern. First of all, AgentCANotificationStatusAdviceV01 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, AgentCANotificationStatusAdviceV01Document implements IOuterDocument. Because AgentCANotificationStatusAdviceV01 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type AgentCANotificationStatusAdviceV01.
classDiagram
class IOuterRecord
AgentCANotificationStatusAdviceV01 --|> IOuterRecord : Implements
AgentCANotificationStatusAdviceV01Document --|> IOuterDocument~AgentCANotificationStatusAdviceV01~ : Implements
class IOuterDocument~AgentCANotificationStatusAdviceV01~ {
AgentCANotificationStatusAdviceV01 Message
}
Document wrapper for serialization
The only real purpose AgentCANotificationStatusAdviceV01Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:seev.011.001.01’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using AgentCANotificationStatusAdviceV01.ToDocument() method. The returned AgentCANotificationStatusAdviceV01Document value will serialize correctly according to ISO 20022 standards.
classDiagram
AgentCANotificationStatusAdviceV01Document *-- AgentCANotificationStatusAdviceV01 : 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.011.001.01">
<AgtCANtfctnStsAdvc>
<Id>
<!-- Identification inner content -->
</Id>
<AgtCANtfctnAdvcId>
<!-- AgentCANotificationAdviceIdentification inner content -->
</AgtCANtfctnAdvcId>
<AgtCANtfctnCxlReqId>
<!-- AgentCANotificationCancellationRequestIdentification inner content -->
</AgtCANtfctnCxlReqId>
<CorpActnGnlInf>
<!-- CorporateActionGeneralInformation inner content -->
</CorpActnGnlInf>
<NtfctnCxlReqSts>
<!-- NotificationCancellationRequestStatus inner content -->
</NtfctnCxlReqSts>
<NtfctnAdvcSts>
<!-- NotificationAdviceStatus inner content -->
</NtfctnAdvcSts>
</AgtCANtfctnStsAdvc>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_TReSOdEwEd-BzquC8wXy7w_-1525445298"
name="AgentCANotificationStatusAdviceV01"
definition="Scope
This message is sent by a CSD to an issuer (or its agent) to report the status, or change in status, of a notification advice or notification cancellation request.
Usage
When this message is used to report the status of a notification advice then the building block Agent Corporate Action Notification Advice Identification must be present.
When this message is used to provide the status of a notification cancellation request then the building block Notification Cancellation Request Identification must be present."
registrationStatus="Registered"
messageSet="_wRe70k2rEeG_I4xRYCA_7g"
xmlTag="AgtCANtfctnStsAdvc"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<constraint
xmi:id="_TRoDOdEwEd-BzquC8wXy7w_-1090401185"
name="NotificationAdviceStatusRule"
definition="If AgentCANotificationAdviceIdentification is present then NotificationAdviceStatus must be present."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_TRoDPNEwEd-BzquC8wXy7w_-963880620"
name="NotificationCancellationRequestStatusRule"
definition="If AgentCANotificationCancellationRequestIdentification is present then NotificationCancellationRequestStatus must be present."
registrationStatus="Provisionally Registered" />
<xors
xmi:id="_TRoDM9EwEd-BzquC8wXy7w_-640710749"
name="NotificationCancellationRequestStatusOrNotificationAdviceStatusRule"
definition="Either NotificationCancellationRequestStatus or NotificationAdviceStatus must be present but not both."
registrationStatus="Provisionally Registered"
impactedMessageBuildingBlocks="_TRoDMdEwEd-BzquC8wXy7w_-979644850 _TRoDMtEwEd-BzquC8wXy7w_-982413026" />
<xors
xmi:id="_TRoDNtEwEd-BzquC8wXy7w_54388851"
name="AgentCANotificationAdviceIDOrAgentCANotificationCancellationRequestIDRule"
definition="Either AgentCANotificationAdviceIdentification or AgentCANotificationCancellationRequestIdentification must be present, but not both."
registrationStatus="Provisionally Registered"
impactedMessageBuildingBlocks="_TReSO9EwEd-BzquC8wXy7w_-867070991 _TReSPNEwEd-BzquC8wXy7w_-853220988" />
<messageBuildingBlock
xmi:id="_TReSOtEwEd-BzquC8wXy7w_-885544808"
name="Identification"
definition="Identification assigned by the Sender to unambiguously identify the status advice."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="Id"
complexType="_RXNBiNp-Ed-ak6NoX_4Aeg_-320016249" />
<messageBuildingBlock
xmi:id="_TReSO9EwEd-BzquC8wXy7w_-867070991"
name="AgentCANotificationAdviceIdentification"
definition="Identification of the linked Agent CA Notification Advice for which a status is given."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="AgtCANtfctnAdvcId"
complexType="_RXNBiNp-Ed-ak6NoX_4Aeg_-320016249" />
<messageBuildingBlock
xmi:id="_TReSPNEwEd-BzquC8wXy7w_-853220988"
name="AgentCANotificationCancellationRequestIdentification"
definition="Identification of the linked Agent CA Notification Cancellation Request for which a status is given."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="AgtCANtfctnCxlReqId"
complexType="_RXNBiNp-Ed-ak6NoX_4Aeg_-320016249" />
<messageBuildingBlock
xmi:id="_TRoDMNEwEd-BzquC8wXy7w_-1070148838"
name="CorporateActionGeneralInformation"
definition="General information about the corporate action event."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="CorpActnGnlInf"
complexType="_Td6PVdp-Ed-ak6NoX_4Aeg_2005876121" />
<messageBuildingBlock
xmi:id="_TRoDMdEwEd-BzquC8wXy7w_-979644850"
name="NotificationCancellationRequestStatus"
definition="Status of the Notification Cancellation Request sent by the issuer (agent)."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="NtfctnCxlReqSts"
complexType="_RiYWw9p-Ed-ak6NoX_4Aeg_-987032957" />
<messageBuildingBlock
xmi:id="_TRoDMtEwEd-BzquC8wXy7w_-982413026"
name="NotificationAdviceStatus"
definition="Status of the notification advice sent by the issuer (agent)."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="NtfctnAdvcSts"
complexType="_Ri1Ctdp-Ed-ak6NoX_4Aeg_-997189670" />
<messageDefinitionIdentifier
businessArea="seev"
messageFunctionality="011"
flavour="001"
version="01" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.