DTCCCAISSD1V02

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.