DTCCCAINSD1V03

supl.008.001.03

The DTCCCAINSD1 message extends ISO corporate action instruction 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
%% DTCCCAINSD1V03 recursion level 0 with max 0
DTCCCAINSD1V03 *-- "0..1" OptionalDividendAccountQuantitySD2 : OptionalDividend
DTCCCAINSD1V03 *-- "0..1" TaxExemptQuantitySD1 : TaxExempt
DTCCCAINSD1V03 *-- "0..1" WireInstructionSD2 : WireInstruction
DTCCCAINSD1V03 *-- "0..1" SecuritiesQuantityDetailsSD1 : SecuritiesQuantityDetails
  

Now, we will zero-in one-by-one on each of these building blocks.

OptionalDividend building block

DTC (The Depository Trust Corporation) Optional Dividend service election. Provides additional information regarding optional dividend election details. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% OptionalDividendAccountQuantitySD2 recursion level 0 with max 1
class OptionalDividendAccountQuantitySD2{
    PlaceAndName IsoMax350Text
    NumberOfAccounts IsoMax15NumericText
}
OptionalDividendAccountQuantitySD2 *-- "1..1" IFinancialInstrumentQuantity15Choice : BeneficialOwnerQuantity
%% IFinancialInstrumentQuantity15Choice recursion level 1 with max 1
  

OptionalDividendAccountQuantitySD2 members

TaxExempt building block

DTC (The Depository Trust Corporation) Tax Exempt service election. Tax exempt election details. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% TaxExemptQuantitySD1 recursion level 0 with max 1
class TaxExemptQuantitySD1{
    PlaceAndName IsoMax350Text
    ControlIdentification IsoMax6Text
}
TaxExemptQuantitySD1 *-- "1..1" IFinancialInstrumentQuantity15Choice : Quantity
%% IFinancialInstrumentQuantity15Choice recursion level 1 with max 1
  

TaxExemptQuantitySD1 members

WireInstruction building block

DTC (The Depository Trust Corporation) Foreign Currency Payment service wire payment instruction. Payment wire instruction details. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% WireInstructionSD2 recursion level 0 with max 1
class WireInstructionSD2{
    PlaceAndName IsoMax350Text
    BankName IsoMax30Text
    BankAddress IsoMax30Text
    BankCity IsoMax30Text
    BankCountry CountryCode
    BankAttentionTo IsoMax30Text
    BankComments IsoMax60Text
    BeneficiaryAccount IsoMax30Text
    BeneficiaryAccountIdentification IsoMax30Text
    BeneficiaryAccountComments IsoMax30Text
}
WireInstructionSD2 *-- "1..1" IFinancialInstrumentQuantity15Choice : WireQuantity
%% IFinancialInstrumentQuantity15Choice recursion level 1 with max 1
  

WireInstructionSD2 members

SecuritiesQuantityDetails building block

Information to be extended as supplementary data to security quantity details. Provides information about securities quantity linked to a corporate action option. Provides information about securities quantity linked to a corporate action option. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SecuritiesQuantityDetailsSD1 recursion level 0 with max 1
class SecuritiesQuantityDetailsSD1{
    PlaceAndName IsoMax350Text
}
SecuritiesQuantityDetailsSD1 *-- "0..1" IQuantity40Choice : OversubscriptionQuantity
%% IQuantity40Choice recursion level 1 with max 1
  

SecuritiesQuantityDetailsSD1 members

Extensibility and generalization considerations

To facilitate generalized design patterns in the system, the DTCCCAINSD1V03 implementation follows a specific implementaiton pattern. First of all, DTCCCAINSD1V03 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, DTCCCAINSD1V03Document implements IOuterDocument. Because DTCCCAINSD1V03 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type DTCCCAINSD1V03.

classDiagram
    class IOuterRecord
    DTCCCAINSD1V03 --|> IOuterRecord : Implements
    DTCCCAINSD1V03Document --|> IOuterDocument~DTCCCAINSD1V03~ : Implements
    class IOuterDocument~DTCCCAINSD1V03~ {
        DTCCCAINSD1V03 Message
     }
  

Document wrapper for serialization

The only real purpose DTCCCAINSD1V03Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:supl.008.001.03’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using DTCCCAINSD1V03.ToDocument() method. The returned DTCCCAINSD1V03Document value will serialize correctly according to ISO 20022 standards.

classDiagram
    DTCCCAINSD1V03Document *-- DTCCCAINSD1V03 : 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.008.001.03">
    <DTCCCAINSD1>
        <OptnlDvdd>
            <!-- OptionalDividend inner content -->
        </OptnlDvdd>
        <TaxXmpt>
            <!-- TaxExempt inner content -->
        </TaxXmpt>
        <WireInstr>
            <!-- WireInstruction inner content -->
        </WireInstr>
        <SctiesQtyDtls>
            <!-- SecuritiesQuantityDetails inner content -->
        </SctiesQtyDtls>
    </DTCCCAINSD1>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_I7uei5CEEeaSk9d1hvTrHg"
  nextVersions="_LAGyL75MEeexmbB7KsjCwA"
  previousVersion="_gCY7YUlAEeK8UrXTVVBVxw"
  name="DTCCCAINSD1V03"
  definition="The DTCCCAINSD1 message extends ISO corporate action instruction message with DTCC corporate action elements not covered in the standard message."
  registrationStatus="Provisionally Registered"
  xmlTag="DTCCCAINSD1"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_I7uejZCEEeaSk9d1hvTrHg"
    nextVersions="_LAGyMb5MEeexmbB7KsjCwA"
    previousVersion="_gCY7ZUlAEeK8UrXTVVBVxw"
    name="OptionalDividend"
    definition="DTC (The Depository Trust Corporation) Optional Dividend service election."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="OptnlDvdd"
    complexType="_DfVYUUlFEeK8UrXTVVBVxw">
    <semanticMarkup
      xmi:id="_I7uej5CEEeaSk9d1hvTrHg"
      type="Synonym">
      <elements
        xmi:id="_I7uekZCEEeaSk9d1hvTrHg"
        name="context"
        value="DTCC" />
      <elements
        xmi:id="_I7uek5CEEeaSk9d1hvTrHg"
        name="value"
        value="Optional Dividend" />
    </semanticMarkup>
  </messageBuildingBlock>
  <messageBuildingBlock
    xmi:id="_I7uelZCEEeaSk9d1hvTrHg"
    nextVersions="_LAGyOb5MEeexmbB7KsjCwA"
    previousVersion="_gCY7b0lAEeK8UrXTVVBVxw"
    name="TaxExempt"
    definition="DTC (The Depository Trust Corporation) Tax Exempt service election."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="TaxXmpt"
    complexType="_1a-Q5jL3EeKU9IrkkToqcw_-1857619080">
    <semanticMarkup
      xmi:id="_I7uel5CEEeaSk9d1hvTrHg"
      type="Synonym">
      <elements
        xmi:id="_I7uemZCEEeaSk9d1hvTrHg"
        name="context"
        value="DTCC" />
      <elements
        xmi:id="_I7uem5CEEeaSk9d1hvTrHg"
        name="value"
        value="Tax Exempt" />
    </semanticMarkup>
  </messageBuildingBlock>
  <messageBuildingBlock
    xmi:id="_I7uenZCEEeaSk9d1hvTrHg"
    nextVersions="_LAGyQb5MEeexmbB7KsjCwA"
    previousVersion="_gCY7eUlAEeK8UrXTVVBVxw"
    name="WireInstruction"
    definition="DTC (The Depository Trust Corporation) Foreign Currency Payment service wire payment instruction."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="WireInstr"
    complexType="_xOUmcUlBEeK8UrXTVVBVxw">
    <semanticMarkup
      xmi:id="_I7uen5CEEeaSk9d1hvTrHg"
      type="Synonym">
      <elements
        xmi:id="_I7vFkZCEEeaSk9d1hvTrHg"
        name="context"
        value="DTCC" />
      <elements
        xmi:id="_I7vFk5CEEeaSk9d1hvTrHg"
        name="value"
        value="Wire Instruction" />
    </semanticMarkup>
  </messageBuildingBlock>
  <messageBuildingBlock
    xmi:id="_tHrSEJYQEeaME6y1kTGR7Q"
    name="SecuritiesQuantityDetails"
    definition="Information to be extended as supplementary data to security quantity details. Provides information about securities quantity linked to a corporate action option."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="SctiesQtyDtls"
    complexType="_wDuzgJYQEeaME6y1kTGR7Q" />
  <messageDefinitionIdentifier
    businessArea="supl"
    messageFunctionality="008"
    flavour="001"
    version="03" />
</messageDefinition>

ISO Building Blocks

The following items are used as building blocks to construct this message.