seev.028.001.01
Scope This message is sent by an issuer (or its agent) to the CSD to instruct the deactivation of a corporate action event or to deactivate one or more specific options of the corporate action. As of the deactivation date, the CSD is allowed to reject any related election instruction received from clients. Usage Deactivation refers only to the empowerment of the CSD to reject further elections. To withdraw an event, the Agent Corporate Action Notification Advice message must be used. This message can be used to deactivate all the options of a corporate action event, in which case, no option should be mentioned in the message. This message can also be used to deactivate one or more specific corporate action options, in which case, the option type and option number must be present. This message can only be used when the deactivation date is after the market deadline. Before the market deadline, an updated notification advice message must be sent with option availability status: inactive or cancelled. An un-effected deactivation (pending deactivation date/time) can be cancelled with an Agent Corporate Action Deactivation Cancellation Request. The amendment of a deactivation is effected by cancel/replace mechanism.
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
%% AgentCADeactivationInstructionV01 recursion level 0 with max 0
AgentCADeactivationInstructionV01 *-- "1..1" DocumentIdentification8 : Identification
AgentCADeactivationInstructionV01 *-- "1..1" CorporateActionInformation1 : CorporateActionGeneralInformation
AgentCADeactivationInstructionV01 *-- "1..1" CorporateActionDeactivationInstruction1 : DeactivationDetails
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 instruction. 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. General information about the corporate action event. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% CorporateActionInformation1 recursion level 0 with max 1
class CorporateActionInformation1{
IssuerCorporateActionIdentification IsoMax35Text
CorporateActionProcessingIdentification IsoMax35Text
}
CorporateActionInformation1 *-- "1..1" IPartyIdentification2Choice : AgentIdentification
CorporateActionInformation1 *-- "1..1" ICorporateActionEventType2FormatChoice : EventType
CorporateActionInformation1 *-- "1..1" ICorporateActionMandatoryVoluntary1FormatChoice : MandatoryVoluntaryEventType
CorporateActionInformation1 *-- "0..1" ICorporateActionEventProcessingType1FormatChoice : EventProcessingType
CorporateActionInformation1 *-- "1..1" FinancialInstrumentDescription3 : UnderlyingSecurity
%% IPartyIdentification2Choice recursion level 1 with max 1
%% ICorporateActionEventType2FormatChoice recursion level 1 with max 1
%% ICorporateActionMandatoryVoluntary1FormatChoice recursion level 1 with max 1
%% ICorporateActionEventProcessingType1FormatChoice 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
CorporateActionInformation1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| AgentIdentification | Identification of the issuer agent. | IPartyIdentification2Choice - Required 1..1 |
| IssuerCorporateActionIdentification | Reference given to the event by the CA event issuer (agent). | IsoMax35Text - Optional 0..1 |
| CorporateActionProcessingIdentification | Reference assigned by the account servicer to unambiguously identify a corporate action event. | IsoMax35Text - Optional 0..1 |
| EventType | Type of corporate action event. | ICorporateActionEventType2FormatChoice - Required 1..1 |
| MandatoryVoluntaryEventType | Specifies whether the event is mandatory, mandatory with options or voluntary. | ICorporateActionMandatoryVoluntary1FormatChoice - Required 1..1 |
| EventProcessingType | Type of processing involved by a Corporate Action. | ICorporateActionEventProcessingType1FormatChoice - Optional 0..1 |
| UnderlyingSecurity | Identification of the underlying financial instrument, ie, the financial instrument affected by the corporate action event. | FinancialInstrumentDescription3 - Required 1..1 |
DeactivationDetails building block
Information related to the deactivation of a CA event. Provides information about the deactivation. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% CorporateActionDeactivationInstruction1 recursion level 0 with max 1
class CorporateActionDeactivationInstruction1{
DeactivationDateAndTime IsoISODateTime
}
CorporateActionDeactivationInstruction1 *-- "0..0" CorporateActionOption2 : OptionDetails
%% CorporateActionOption2 recursion level 1 with max 1
class CorporateActionOption2{
OptionNumber IsoExact3NumericText
}
CorporateActionOption2 *-- "1..1" ICorporateActionOption1FormatChoice : OptionType
CorporateActionDeactivationInstruction1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| DeactivationDateAndTime | Date and time at which the CSD must deactivate the corporate action event or the option. | IsoISODateTime - Required 1..1 |
| OptionDetails | Provides information about the option, when the deactivation instruction applies at the level of a corporate action option. | CorporateActionOption2 - Unknown 0..0 |
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the AgentCADeactivationInstructionV01 implementation follows a specific implementaiton pattern. First of all, AgentCADeactivationInstructionV01 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, AgentCADeactivationInstructionV01Document implements IOuterDocument. Because AgentCADeactivationInstructionV01 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type AgentCADeactivationInstructionV01.
classDiagram
class IOuterRecord
AgentCADeactivationInstructionV01 --|> IOuterRecord : Implements
AgentCADeactivationInstructionV01Document --|> IOuterDocument~AgentCADeactivationInstructionV01~ : Implements
class IOuterDocument~AgentCADeactivationInstructionV01~ {
AgentCADeactivationInstructionV01 Message
}
Document wrapper for serialization
The only real purpose AgentCADeactivationInstructionV01Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:seev.028.001.01’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using AgentCADeactivationInstructionV01.ToDocument() method. The returned AgentCADeactivationInstructionV01Document value will serialize correctly according to ISO 20022 standards.
classDiagram
AgentCADeactivationInstructionV01Document *-- AgentCADeactivationInstructionV01 : 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.028.001.01">
<AgtCADeactvtnInstr>
<Id>
<!-- Identification inner content -->
</Id>
<CorpActnGnlInf>
<!-- CorporateActionGeneralInformation inner content -->
</CorpActnGnlInf>
<DeactvtnDtls>
<!-- DeactivationDetails inner content -->
</DeactvtnDtls>
</AgtCADeactvtnInstr>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_TMHRHdEwEd-BzquC8wXy7w_1150162088"
name="AgentCADeactivationInstructionV01"
definition="Scope
This message is sent by an issuer (or its agent) to the CSD to instruct the deactivation of a corporate action event or to deactivate one or more specific options of the corporate action. As of the deactivation date, the CSD is allowed to reject any related election instruction received from clients.
Usage
Deactivation refers only to the empowerment of the CSD to reject further elections. To withdraw an event, the Agent Corporate Action Notification Advice message must be used.
This message can be used to deactivate all the options of a corporate action event, in which case, no option should be mentioned in the message.
This message can also be used to deactivate one or more specific corporate action options, in which case, the option type and option number must be present.
This message can only be used when the deactivation date is after the market deadline. Before the market deadline, an updated notification advice message must be sent with option availability status: inactive or cancelled.
An un-effected deactivation (pending deactivation date/time) can be cancelled with an Agent Corporate Action Deactivation Cancellation Request.
The amendment of a deactivation is effected by cancel/replace mechanism."
registrationStatus="Registered"
messageSet="_wRe70k2rEeG_I4xRYCA_7g"
xmlTag="AgtCADeactvtnInstr"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<messageBuildingBlock
xmi:id="_TMQbANEwEd-BzquC8wXy7w_-840620052"
name="Identification"
definition="Identification assigned by the Sender to unambiguously identify the instruction."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="Id"
complexType="_RXNBiNp-Ed-ak6NoX_4Aeg_-320016249" />
<messageBuildingBlock
xmi:id="_TMQbAdEwEd-BzquC8wXy7w_-1767832374"
name="CorporateActionGeneralInformation"
definition="General information about the corporate action event."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="CorpActnGnlInf"
complexType="_TdxFY9p-Ed-ak6NoX_4Aeg_1155832018" />
<messageBuildingBlock
xmi:id="_TMQbAtEwEd-BzquC8wXy7w_-1426185033"
name="DeactivationDetails"
definition="Information related to the deactivation of a CA event."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="DeactvtnDtls"
complexType="_UJuMddp-Ed-ak6NoX_4Aeg_-1685692105" />
<messageDefinitionIdentifier
businessArea="seev"
messageFunctionality="028"
flavour="001"
version="01" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.