seev.029.001.01
Scope This message is sent by an issuer (or its agent) to the CSD to request the cancellation of a previously sent corporate action deactivation instruction. Usage This message is used to request the cancellation of a pending deactivation instruction. The cancellation must apply to exactly the same level as the original instruction, ie to the entire CA event or to an option as per the original instruction. This message must be sent before the deactivation execution date. In case a corporate action or option is already deactivated, this message can not be used to reactivate the corporate action entire event or option; the notification advice message must be used to reactivate a corporate action or option.
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
%% AgentCADeactivationCancellationRequestV01 recursion level 0 with max 0
AgentCADeactivationCancellationRequestV01 *-- "1..1" DocumentIdentification8 : Identification
AgentCADeactivationCancellationRequestV01 *-- "1..1" DocumentIdentification8 : AgentCADeactivationInstructionIdentification
AgentCADeactivationCancellationRequestV01 *-- "1..1" CorporateActionInformation1 : CorporateActionGeneralInformation
AgentCADeactivationCancellationRequestV01 *-- "0..1" CorporateActionDeactivationInstruction1 : DeactivationInstructionDetails
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 cancellation request. 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 |
AgentCADeactivationInstructionIdentification building block
Identification of the Agent CA Deactivation Instruction to be cancelled. 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 |
DeactivationInstructionDetails building block
Details of the deactivation instruction to be cancelled. 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 AgentCADeactivationCancellationRequestV01 implementation follows a specific implementaiton pattern. First of all, AgentCADeactivationCancellationRequestV01 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, AgentCADeactivationCancellationRequestV01Document implements IOuterDocument. Because AgentCADeactivationCancellationRequestV01 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type AgentCADeactivationCancellationRequestV01.
classDiagram
class IOuterRecord
AgentCADeactivationCancellationRequestV01 --|> IOuterRecord : Implements
AgentCADeactivationCancellationRequestV01Document --|> IOuterDocument~AgentCADeactivationCancellationRequestV01~ : Implements
class IOuterDocument~AgentCADeactivationCancellationRequestV01~ {
AgentCADeactivationCancellationRequestV01 Message
}
Document wrapper for serialization
The only real purpose AgentCADeactivationCancellationRequestV01Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:seev.029.001.01’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using AgentCADeactivationCancellationRequestV01.ToDocument() method. The returned AgentCADeactivationCancellationRequestV01Document value will serialize correctly according to ISO 20022 standards.
classDiagram
AgentCADeactivationCancellationRequestV01Document *-- AgentCADeactivationCancellationRequestV01 : 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.029.001.01">
<AgtCADeactvtnCxlReq>
<Id>
<!-- Identification inner content -->
</Id>
<AgtCADeactvtnInstrId>
<!-- AgentCADeactivationInstructionIdentification inner content -->
</AgtCADeactvtnInstrId>
<CorpActnGnlInf>
<!-- CorporateActionGeneralInformation inner content -->
</CorpActnGnlInf>
<DeactvtnInstrDtls>
<!-- DeactivationInstructionDetails inner content -->
</DeactvtnInstrDtls>
</AgtCADeactvtnCxlReq>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_TL9gGdEwEd-BzquC8wXy7w_1830397138"
name="AgentCADeactivationCancellationRequestV01"
definition="Scope
This message is sent by an issuer (or its agent) to the CSD to request the cancellation of a previously sent corporate action deactivation instruction.
Usage
This message is used to request the cancellation of a pending deactivation instruction. The cancellation must apply to exactly the same level as the original instruction, ie to the entire CA event or to an option as per the original instruction.
This message must be sent before the deactivation execution date.
In case a corporate action or option is already deactivated, this message can not be used to reactivate the corporate action entire event or option; the notification advice message must be used to reactivate a corporate action or option."
registrationStatus="Registered"
messageSet="_wRe70k2rEeG_I4xRYCA_7g"
xmlTag="AgtCADeactvtnCxlReq"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<messageBuildingBlock
xmi:id="_TMHRENEwEd-BzquC8wXy7w_118262265"
name="Identification"
definition="Identification assigned by the Sender to unambiguously identify the cancellation request."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="Id"
complexType="_RXNBiNp-Ed-ak6NoX_4Aeg_-320016249" />
<messageBuildingBlock
xmi:id="_TMHREdEwEd-BzquC8wXy7w_-1093662480"
name="AgentCADeactivationInstructionIdentification"
definition="Identification of the Agent CA Deactivation Instruction to be cancelled."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="AgtCADeactvtnInstrId"
complexType="_RXNBiNp-Ed-ak6NoX_4Aeg_-320016249" />
<messageBuildingBlock
xmi:id="_TMHREtEwEd-BzquC8wXy7w_-541518720"
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="_TMHRE9EwEd-BzquC8wXy7w_-1594611016"
name="DeactivationInstructionDetails"
definition="Details of the deactivation instruction to be cancelled."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="DeactvtnInstrDtls"
complexType="_UJuMddp-Ed-ak6NoX_4Aeg_-1685692105" />
<messageDefinitionIdentifier
businessArea="seev"
messageFunctionality="029"
flavour="001"
version="01" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.