supl.033.001.02
The DTCCCACSSD1 message extends ISO corporate action Instruction Cancellation Request Status Advice (CACS) message with DTCC corporate action elements not covered in the standard message.
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 %% DTCCCACSSD1V02 recursion level 0 with max 0 DTCCCACSSD1V02 *-- "0..1" ReorganisationInstructionSD8 : ReorganisationInstructionCancellationDetails
Now, we will zero-in one-by-one on each of these building blocks.
ReorganisationInstructionCancellationDetails building block
Supplementary data extending corporate action instruction cancellation request status advice message with corporate action reorganisation elements not covered in the standard message. Provides additional information regarding corporate action reorganisation instruction details. For comparison, see the ISO20022 official specification
classDiagram direction tb %% ReorganisationInstructionSD8 recursion level 0 with max 1 class ReorganisationInstructionSD8{ PlaceAndName IsoMax350Text WithdrawalTransactionType ReorganisationWithdrawalTransactionType2Code TransactionIdentification IsoMax15Text TransactionSequenceNumber IsoMax3NumericText TransactionIdentificationStatus DTCInstructionStatus2Code RejectionReason InstructionRejectionReason1Code CustomerReferenceIdentification IsoMax30Text UserReferenceNumber IsoMax6Text ProtectSafekeepingAccount IsoRestrictedFINMax35Text ProtectTransactionStatus DTCProtectInstructionStatus1Code } ReorganisationInstructionSD8 *-- "0..1" SecuritiesQuantitySD6 : SecuritiesQuantityDetails ReorganisationInstructionSD8 *-- "0..1" ContactIdentification5 : ContactPerson %% SecuritiesQuantitySD6 recursion level 1 with max 1 SecuritiesQuantitySD6 *-- "0..1" IFinancialInstrumentQuantity31Choice : OpenUncoveredQuantity SecuritiesQuantitySD6 *-- "0..1" IFinancialInstrumentQuantity31Choice : InterimCoveredQuantity %% ContactIdentification5 recursion level 1 with max 1 class ContactIdentification5{ Name IsoMax35Text PhoneNumber IsoPhoneNumber }
ReorganisationInstructionSD8 members
Member name | Description | Data Type / Multiplicity |
---|---|---|
PlaceAndName | Xpath to the element that is being extended. | IsoMax350Text - Optional 0..1 |
WithdrawalTransactionType | Identifies the reorganisation withdrawal transaction type. | ReorganisationWithdrawalTransactionType2Code - Optional 0..1 |
TransactionIdentification | Unique number assigned by the depository. Transaction identification will be either the DTC instruction reference number for reorganisation instructions (VOI) or the DAM reference number for custody / reorganisation deposits. | IsoMax15Text - Optional 0..1 |
TransactionSequenceNumber | Number which further identifies DTC instruction reference number. Not applicable to reorganisation / custody deposits. | IsoMax3NumericText - Optional 0..1 |
TransactionIdentificationStatus | Status of the instruction. | DTCInstructionStatus2Code - Optional 0..1 |
SecuritiesQuantityDetails | Provides information about securities quantity linked to a corporate action option. | SecuritiesQuantitySD6 - Optional 0..1 |
RejectionReason | Reason for which an inbound instruction message or a cancellation instruction message is rejected. | InstructionRejectionReason1Code - Collection 0..6 |
CustomerReferenceIdentification | Customer identification entered by client upon instruction submission. | IsoMax30Text - Optional 0..1 |
ContactPerson | Party contact information for the given instruction. | ContactIdentification5 - Optional 0..1 |
UserReferenceNumber | Unique identification of the transaction used by the transmitting party. | IsoMax6Text - Optional 0..1 |
ProtectSafekeepingAccount | For cover protect instructions whereby one safekeeping account is covering on behalf of another safekeeping account. The protect safekeeping account will be the account which submitted the original protect instruction. | IsoRestrictedFINMax35Text - Optional 0..1 |
ProtectTransactionStatus | Status of the protect instruction. | DTCProtectInstructionStatus1Code - Optional 0..1 |
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the DTCCCACSSD1V02 implementation follows a specific implementaiton pattern. First of all, DTCCCACSSD1V02 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, DTCCCACSSD1V02Document implements IOuterDocument. Because DTCCCACSSD1V02 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type DTCCCACSSD1V02.
classDiagram class IOuterRecord DTCCCACSSD1V02 --|> IOuterRecord : Implements DTCCCACSSD1V02Document --|> IOuterDocument~DTCCCACSSD1V02~ : Implements class IOuterDocument~DTCCCACSSD1V02~ { DTCCCACSSD1V02 Message }
Document wrapper for serialization
The only real purpose DTCCCACSSD1V02Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:supl.033.001.02’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using DTCCCACSSD1V02.ToDocument() method. The returned DTCCCACSSD1V02Document value will serialize correctly according to ISO 20022 standards.
classDiagram DTCCCACSSD1V02Document *-- DTCCCACSSD1V02 : 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:supl.033.001.02">
<DTCCCACSSD1>
<ReorgInstrCxlDtls>
<!-- ReorganisationInstructionCancellationDetails inner content -->
</ReorgInstrCxlDtls>
</DTCCCACSSD1>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_b_h_ceaHEei5aPS232E3Mw"
nextVersions="_myaAh1B5Ee2KGNXAcFL5RA"
previousVersion="_8-GvcL5OEeexmbB7KsjCwA"
name="DTCCCACSSD1V02"
definition="The DTCCCACSSD1 message extends ISO corporate action Instruction Cancellation Request Status Advice (CACS) message with DTCC corporate action elements not covered in the standard message."
registrationStatus="Registered"
messageSet="_f180QGxSEeKtkPXDQKdgxQ"
xmlTag="DTCCCACSSD1"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<messageBuildingBlock
xmi:id="_b_h_c-aHEei5aPS232E3Mw"
nextVersions="_myaAiVB5Ee2KGNXAcFL5RA"
previousVersion="_xPi3UcY1EeesocHIuVGr7g"
name="ReorganisationInstructionCancellationDetails"
definition="Supplementary data extending corporate action instruction cancellation request status advice message with corporate action reorganisation elements not covered in the standard message."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="ReorgInstrCxlDtls"
complexType="_Iqu6Aef6Eei5aPS232E3Mw" />
<messageDefinitionIdentifier
businessArea="supl"
messageFunctionality="033"
flavour="001"
version="02" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.