supl.030.001.02
The DTCCCAISSD1 message extends ISO Corporate Action Instruction Status Advice 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 %% DTCCCAISSD1V02 recursion level 0 with max 0 DTCCCAISSD1V02 *-- "0..12" ReorganisationInstructionDetailsSD2 : ReorganisationInstructionDetails
Now, we will zero-in one-by-one on each of these building blocks.
ReorganisationInstructionDetails building block
Supplementary data extending corporate action reorganisation instruction status message with corporate action 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 %% ReorganisationInstructionDetailsSD2 recursion level 0 with max 1 class ReorganisationInstructionDetailsSD2{ PlaceAndName IsoMax350Text TransactionType ReorganisationTransactionType1Code TransactionIdentification IsoMax15Text TransactionSequenceNumber IsoMax3NumericText CustomerSequenceNumber IsoMax9NumericText TransactionIdentificationStatus DTCInstructionStatus2Code ProtectTransactionStatus DTCProtectInstructionStatus1Code RejectionReason InstructionRejectionReason1Code ProtectIdentification IsoMax15Text ProtectSafekeepingAccount IsoRestrictedFINMax35Text ProtectDate IsoISODate WarrantSubscriptionChargeAmount IsoRestrictedFINActiveCurrencyAndAmount TenderOddLotIndicator IsoYesNoIndicator CustomerReferenceIdentification IsoMax30Text UserReferenceNumber IsoMax6Text TransactionRecordNumber IsoMax10NumericText } ReorganisationInstructionDetailsSD2 *-- "0..1" SecuritiesQuantityDetailsSD4 : SecuritiesQuantityDetails ReorganisationInstructionDetailsSD2 *-- "0..1" CorporateActionCertificateSD1 : Certificate ReorganisationInstructionDetailsSD2 *-- "0..1" ContactIdentification5 : ContactPerson ReorganisationInstructionDetailsSD2 *-- "0..1" CorporateActionAcknowledgementSD1 : AcknowledgementDetails ReorganisationInstructionDetailsSD2 *-- "0..1" DeceasedStatusSD1 : DeceasedBeneficialOwnerDetails %% SecuritiesQuantityDetailsSD4 recursion level 1 with max 1 SecuritiesQuantityDetailsSD4 *-- "0..1" FinancialInstrumentQuantity4 : OversubscriptionQuantity SecuritiesQuantityDetailsSD4 *-- "0..1" FinancialInstrumentQuantity4 : TotalOversubscriptionQuantity SecuritiesQuantityDetailsSD4 *-- "0..1" IFinancialInstrumentQuantity31Choice : InstructionQuantity SecuritiesQuantityDetailsSD4 *-- "0..1" IFinancialInstrumentQuantity31Choice : OpenUncoveredQuantity SecuritiesQuantityDetailsSD4 *-- "0..1" IFinancialInstrumentQuantity31Choice : InterimCoveredQuantity %% CorporateActionCertificateSD1 recursion level 1 with max 1 class CorporateActionCertificateSD1{ CertificateNumber IsoMax15AlphaNumericText CertificateSequenceNumber IsoMax15AlphaNumericText CertificateRegistrationName IsoMax30Text } %% ContactIdentification5 recursion level 1 with max 1 class ContactIdentification5{ Name IsoMax35Text PhoneNumber IsoPhoneNumber } %% CorporateActionAcknowledgementSD1 recursion level 1 with max 1 class CorporateActionAcknowledgementSD1{ TermsAcknowledgementIndicator IsoYesNoIndicator Condition1Indicator IsoYesNoIndicator Condition2Indicator IsoYesNoIndicator Condition3Indicator IsoYesNoIndicator Condition4Indicator IsoYesNoIndicator Condition5Indicator IsoYesNoIndicator Condition6Indicator IsoYesNoIndicator AdjudicationOfIncompetencyAcknowledgementIndicator IsoYesNoIndicator LegalDocumentationThirtyMonthsRetentionAcknowledgementIndicator IsoYesNoIndicator InstructionDeletionAcknowledgementIndicator IsoYesNoIndicator PotentialLossAcknowledgementIndicator IsoYesNoIndicator } %% DeceasedStatusSD1 recursion level 1 with max 1 class DeceasedStatusSD1{ BeneficialOwnerName IsoMax35Text DeathDate IsoISODate DeathCertificateSerialNumber IsoMax30Text IssuingJurisdiction IsoMax35Text }
ReorganisationInstructionDetailsSD2 members
Member name | Description | Data Type / Multiplicity |
---|---|---|
PlaceAndName | Xpath to the element that is being extended. | IsoMax350Text - Optional 0..1 |
TransactionType | Identifies the reorganisation transaction type. | ReorganisationTransactionType1Code - 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 |
CustomerSequenceNumber | Unique identifier for each customer in a transaction. | IsoMax9NumericText - Optional 0..1 |
TransactionIdentificationStatus | Status of the instruction. | DTCInstructionStatus2Code - Optional 0..1 |
ProtectTransactionStatus | Status of the Protect Instruction. | DTCProtectInstructionStatus1Code - Optional 0..1 |
RejectionReason | Reason for which an inbound instruction message or a cancellation instruction message is rejected. | InstructionRejectionReason1Code - Collection 0..6 |
ProtectIdentification | Identifies the protect itself or of that is being covered. It is required for the function types cover protect (COVR), cover protect directly to agent (COVA) and cover on behalf of another participant (COVP). | IsoMax15Text - Required 1..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 |
ProtectDate | Date on which the protect was created. It is required for transaction types cover protect transaction (COVR), cover protect directly to agent transaction (COVA) and cover protect on behalf of another participant transaction (COVP). | IsoISODate - Required 1..1 |
SecuritiesQuantityDetails | Provides information about securities quantity linked to a corporate action option. | SecuritiesQuantityDetailsSD4 - Optional 0..1 |
WarrantSubscriptionChargeAmount | Warrant subscription amount entered by client when instructing on a warrant exercise instruction. | IsoRestrictedFINActiveCurrencyAndAmount - Optional 0..1 |
TenderOddLotIndicator | Indicates whether the tender offer accepts odd lots. Yes: tender offer accepts odd lots. No: tender offer does not accept odd lots. | IsoYesNoIndicator - Optional 0..1 |
Certificate | Certificate information for a given instruction. | CorporateActionCertificateSD1 - Optional 0..1 |
CustomerReferenceIdentification | Customer identification entered by client upon instruction submission. | IsoMax30Text - Optional 0..1 |
UserReferenceNumber | Unique identification of the transaction used by the transmitting party. | IsoMax6Text - Optional 0..1 |
ContactPerson | Party contact information for the given instruction; required for voluntary offer instruction transaction (VOIT), protect transaction (PROT) and protect on behalf of another participant transaction (PROP); not required for cover protect instructions like cover protect transaction (COVR), cover protect directly to agent transaction (COVA) and cover protect on behalf of another participant transaction (COVP). | ContactIdentification5 - Optional 0..1 |
AcknowledgementDetails | Acknowledgement information relative to corporate action reorganisation instructions. | CorporateActionAcknowledgementSD1 - Optional 0..1 |
DeceasedBeneficialOwnerDetails | Beneficial owner information related to CD early redemption instructions. | DeceasedStatusSD1 - Optional 0..1 |
TransactionRecordNumber | Transaction record number for ATAM or ART system which may be causing pending status. Corresponds to ATP RBN number. | IsoMax10NumericText - Optional 0..1 |
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the DTCCCAISSD1V02 implementation follows a specific implementaiton pattern. First of all, DTCCCAISSD1V02 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, DTCCCAISSD1V02Document implements IOuterDocument. Because DTCCCAISSD1V02 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type DTCCCAISSD1V02.
classDiagram class IOuterRecord DTCCCAISSD1V02 --|> IOuterRecord : Implements DTCCCAISSD1V02Document --|> IOuterDocument~DTCCCAISSD1V02~ : Implements class IOuterDocument~DTCCCAISSD1V02~ { DTCCCAISSD1V02 Message }
Document wrapper for serialization
The only real purpose DTCCCAISSD1V02Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:supl.030.001.02’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using DTCCCAISSD1V02.ToDocument() method. The returned DTCCCAISSD1V02Document value will serialize correctly according to ISO 20022 standards.
classDiagram DTCCCAISSD1V02Document *-- DTCCCAISSD1V02 : 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.030.001.02">
<DTCCCAISSD1>
<ReorgInstrDtls>
<!-- ReorganisationInstructionDetails inner content -->
</ReorgInstrDtls>
</DTCCCAISSD1>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_LAGyp75MEeexmbB7KsjCwA"
nextVersions="_b_h_X-aHEei5aPS232E3Mw"
previousVersion="_O4RgAJCFEeaSk9d1hvTrHg"
name="DTCCCAISSD1V02"
definition="The DTCCCAISSD1 message extends ISO Corporate Action Instruction Status Advice message with DTCC corporate action elements not covered in the standard message."
registrationStatus="Registered"
xmlTag="DTCCCAISSD1"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<messageBuildingBlock
xmi:id="_KAyL4cYAEeexPc-mfUU5zQ"
nextVersions="_b_h_YeaHEei5aPS232E3Mw"
name="ReorganisationInstructionDetails"
definition="Supplementary data extending corporate action reorganisation instruction status message with corporate action elements not covered in the standard message."
registrationStatus="Provisionally Registered"
maxOccurs="12"
minOccurs="0"
xmlTag="ReorgInstrDtls"
complexType="_QNHyY8YAEeexPc-mfUU5zQ" />
<messageDefinitionIdentifier
businessArea="supl"
messageFunctionality="030"
flavour="001"
version="02" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.