DTCCCAINSD1V01

supl.008.001.01

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
%% DTCCCAINSD1V01 recursion level 0 with max 0
DTCCCAINSD1V01 *-- "0..1" OptionalDividendAccountQuantitySD1 : OptionalDividend
DTCCCAINSD1V01 *-- "0..1" TaxExemptQuantitySD1 : TaxExempt
DTCCCAINSD1V01 *-- "0..1" WireInstructionSD1 : WireInstruction
DTCCCAINSD1V01 *-- "0..1" DTCTaxReliefSD2 : DTCTaxRelief
DTCCCAINSD1V01 *-- "0..1" USTaxWithholdingSD1 : USTaxWithholding
DTCCCAINSD1V01 *-- "0..1" CashInLieuSD1 : CashInLieu

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
%% OptionalDividendAccountQuantitySD1 recursion level 0 with max 1
class OptionalDividendAccountQuantitySD1{
    PlaceAndName IsoMax350Text
    SafekeepingAccount IsoRestrictedFINXMax35Text
}
OptionalDividendAccountQuantitySD1 *-- "1..1" IFinancialInstrumentQuantity15Choice : BeneficialOwnerQuantity
%% IFinancialInstrumentQuantity15Choice recursion level 1 with max 1

OptionalDividendAccountQuantitySD1 members

Member name	Description	Data Type / Multiplicity
PlaceAndName	xPath to the element that is being extended.	IsoMax350Text - Required 1..1
SafekeepingAccount	Account where financial instruments are maintained.	IsoRestrictedFINXMax35Text - Required 1..1
BeneficialOwnerQuantity	Beneficial owner quantity to be paid.	IFinancialInstrumentQuantity15Choice - Required 1..1

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

Member name	Description	Data Type / Multiplicity
PlaceAndName	xPath to the element that is being extended.	IsoMax350Text - Required 1..1
ControlIdentification	Tax control ID.	IsoMax6Text - Required 1..1
Quantity	Elected quantity.	IFinancialInstrumentQuantity15Choice - Required 1..1

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
%% WireInstructionSD1 recursion level 0 with max 1
class WireInstructionSD1{
    PlaceAndName IsoMax350Text
    BankName IsoMax105Text
    BankAddress IsoMax140Text
    BankCity IsoMax70Text
    BankCountry CountryCode
    BankAttentionTo IsoMax105Text
    BankComments IsoMax140Text
    BeneficiaryAccount IsoMax70Text
    BeneficiaryAccountIdentification IsoRestrictedFINMax35Text
    BeneficiaryAccountComments IsoMax140Text
}
WireInstructionSD1 *-- "1..1" IFinancialInstrumentQuantity15Choice : WireQuantity
%% IFinancialInstrumentQuantity15Choice recursion level 1 with max 1

WireInstructionSD1 members

Member name	Description	Data Type / Multiplicity
PlaceAndName	xPath to the element that is being extended.	IsoMax350Text - Required 1..1
WireQuantity	Quantity of securities concerned in this wire.	IFinancialInstrumentQuantity15Choice - Required 1..1
BankName	Name of the recipient bank for the wire.	IsoMax105Text - Required 1..1
BankAddress	Street address of the recipient bank for the wire.	IsoMax140Text - Required 1..1
BankCity	City of the recipient bank for the wire.	IsoMax70Text - Required 1..1
BankCountry	Country of the recipient bank for the wire.	CountryCode - Required 1..1
BankAttentionTo	Responsible person in the recipient back for the wire.	IsoMax105Text - Required 1..1
BankComments	Notes or comments for the recipient bank for the wire.	IsoMax140Text - Required 1..1
BeneficiaryAccount	Account type at the recipient bank for the wire.	IsoMax70Text - Required 1..1
BeneficiaryAccountIdentification	Account identification at the recipient bank for the wire.	IsoRestrictedFINMax35Text - Required 1..1
BeneficiaryAccountComments	Notes or comments for the beneficiary account at the recipient bank for the wire.	IsoMax140Text - Required 1..1

DTCTaxRelief building block

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

classDiagram
   direction tb
%% DTCTaxReliefSD2 recursion level 0 with max 1
class DTCTaxReliefSD2{
    PlaceAndName IsoMax350Text
}
DTCTaxReliefSD2 *-- "1..1" DTCTaxReliefSD1 : DTCTaxReliefCategory
DTCTaxReliefSD2 *-- "1..1" IFinancialInstrumentQuantity15Choice : InstructionQuantity
%% DTCTaxReliefSD1 recursion level 1 with max 1
class DTCTaxReliefSD1{
    CategoryIdentification IsoExact3NumericText
    CategoryDescription IsoMax35Text
}
%% IFinancialInstrumentQuantity15Choice recursion level 1 with max 1

DTCTaxReliefSD2 members

Member name	Description	Data Type / Multiplicity
PlaceAndName	xPath to the element that is being extended.	IsoMax350Text - Required 1..1
DTCTaxReliefCategory	Provides information about the defined tax relief categories used by DTC (The Depository Trust Corporation).	DTCTaxReliefSD1 - Required 1..1
InstructionQuantity	Instructed quantity for DTC Tax Relief service elections.	IFinancialInstrumentQuantity15Choice - Required 1..1

USTaxWithholding building block

U.S. Tax Withholding elections. US tax withholding election details. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% USTaxWithholdingSD1 recursion level 0 with max 1
class USTaxWithholdingSD1{
    PlaceAndName IsoMax350Text
    NRATaxCode NRATax1Code
}
USTaxWithholdingSD1 *-- "0..1" IRateFormat6Choice : WithholdingTaxRate
USTaxWithholdingSD1 *-- "1..1" IFinancialInstrumentQuantity15Choice : Quantity
%% IRateFormat6Choice recursion level 1 with max 1
%% IFinancialInstrumentQuantity15Choice recursion level 1 with max 1

USTaxWithholdingSD1 members

Member name	Description	Data Type / Multiplicity
PlaceAndName	xPath to the element that is being extended.	IsoMax350Text - Required 1..1
NRATaxCode	Non resident alien (NRA) tax code. Each U.S. tax withholding eligible distribution must have a determination of the tax liability. This code is relevant to tax withholding and U.S. IRS reporting. Foreign securities also have an applicable tax code, but all foreign issues have one standard code.	NRATax1Code - Required 1..1
WithholdingTaxRate	Percentage of a cash distribution that will be withheld by a tax authority.	IRateFormat6Choice - Optional 0..1
Quantity	Elected quantity per NRA tax code.	IFinancialInstrumentQuantity15Choice - Required 1..1

CashInLieu building block

DTC (The Depository Trust Corporation) Cash In Lieu service election. Cash in lieu election details. For comparison, see the ISO20022 official specification

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

CashInLieuSD1 members

Member name	Description	Data Type / Multiplicity
PlaceAndName	xPath to the element that is being extended.	IsoMax350Text - Required 1..1
Quantity	Quantity elected.	IFinancialInstrumentQuantity15Choice - Required 1..1

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    DTCCCAINSD1V01 --|> IOuterRecord : Implements
    DTCCCAINSD1V01Document --|> IOuterDocument~DTCCCAINSD1V01~ : Implements
    class IOuterDocument~DTCCCAINSD1V01~ {
        DTCCCAINSD1V01 Message
     }

Document wrapper for serialization

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

classDiagram
    DTCCCAINSD1V01Document *-- DTCCCAINSD1V01 : 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.01">
    <DTCCCAINSD1>
        <OptnlDvdd>
            <!-- OptionalDividend inner content -->
        </OptnlDvdd>
        <TaxXmpt>
            <!-- TaxExempt inner content -->
        </TaxXmpt>
        <WireInstr>
            <!-- WireInstruction inner content -->
        </WireInstr>
        <DTCTaxRlf>
            <!-- DTCTaxRelief inner content -->
        </DTCTaxRlf>
        <USTaxWhldg>
            <!-- USTaxWithholding inner content -->
        </USTaxWhldg>
        <CshInLieu>
            <!-- CashInLieu inner content -->
        </CshInLieu>
    </DTCCCAINSD1>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_1Mz5EDL3EeKU9IrkkToqcw_1438480682"
  nextVersions="_gCY7YUlAEeK8UrXTVVBVxw"
  name="DTCCCAINSD1V01"
  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="_1Mz5ETL3EeKU9IrkkToqcw_-868730910"
    name="OptionalDividend"
    definition="DTC (The Depository Trust Corporation) Optional Dividend service election."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="OptnlDvdd"
    complexType="_1a-Q4jL3EeKU9IrkkToqcw_2124863558">
    <semanticMarkup
      xmi:id="_c1sO_Q5lEeO42pgjaJ50lw"
      type="Synonym">
      <elements
        xmi:id="_c1sO_g5lEeO42pgjaJ50lw"
        name="context"
        value="DTCC" />
      <elements
        xmi:id="_c1sO_w5lEeO42pgjaJ50lw"
        name="value"
        value="Optional Dividend" />
    </semanticMarkup>
  </messageBuildingBlock>
  <messageBuildingBlock
    xmi:id="_1Mz5EjL3EeKU9IrkkToqcw_1039926111"
    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="_c1sPDg5lEeO42pgjaJ50lw"
      type="Synonym">
      <elements
        xmi:id="_c1sPDw5lEeO42pgjaJ50lw"
        name="context"
        value="DTCC" />
      <elements
        xmi:id="_c1sPEA5lEeO42pgjaJ50lw"
        name="value"
        value="Tax Exempt" />
    </semanticMarkup>
  </messageBuildingBlock>
  <messageBuildingBlock
    xmi:id="_1Mz5EzL3EeKU9IrkkToqcw_-2087888194"
    name="WireInstruction"
    definition="DTC (The Depository Trust Corporation) Foreign Currency Payment service wire payment instruction."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="WireInstr"
    complexType="_1bkGwTL3EeKU9IrkkToqcw_-370608437">
    <semanticMarkup
      xmi:id="_c11_zQ5lEeO42pgjaJ50lw"
      type="Synonym">
      <elements
        xmi:id="_c11_zg5lEeO42pgjaJ50lw"
        name="context"
        value="DTCC" />
      <elements
        xmi:id="_c11_zw5lEeO42pgjaJ50lw"
        name="value"
        value="Wire Instruction" />
    </semanticMarkup>
  </messageBuildingBlock>
  <messageBuildingBlock
    xmi:id="_1Mz5FDL3EeKU9IrkkToqcw_-1885590787"
    name="DTCTaxRelief"
    definition="DTC (The Depository Trust Corporation) Tax Relief service election."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="DTCTaxRlf"
    complexType="_1b3BsjL3EeKU9IrkkToqcw_-1727266611">
    <semanticMarkup
      xmi:id="_c12AAQ5lEeO42pgjaJ50lw"
      type="Synonym">
      <elements
        xmi:id="_c12AAg5lEeO42pgjaJ50lw"
        name="context"
        value="DTCC" />
      <elements
        xmi:id="_c12AAw5lEeO42pgjaJ50lw"
        name="value"
        value="Tax Relief" />
    </semanticMarkup>
  </messageBuildingBlock>
  <messageBuildingBlock
    xmi:id="_1Mz5FTL3EeKU9IrkkToqcw_-63987189"
    name="USTaxWithholding"
    definition="U.S. Tax Withholding elections."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="USTaxWhldg"
    complexType="_1QsThTL3EeKU9IrkkToqcw_-215226807">
    <semanticMarkup
      xmi:id="_c1_wzQ5lEeO42pgjaJ50lw"
      type="Synonym">
      <elements
        xmi:id="_c1_wzg5lEeO42pgjaJ50lw"
        name="context"
        value="DTCC" />
      <elements
        xmi:id="_c1_wzw5lEeO42pgjaJ50lw"
        name="value"
        value="US Tax Withholding" />
    </semanticMarkup>
  </messageBuildingBlock>
  <messageBuildingBlock
    xmi:id="_1Mz5FjL3EeKU9IrkkToqcw_1321235420"
    name="CashInLieu"
    definition="DTC (The Depository Trust Corporation) Cash In Lieu service election."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="CshInLieu"
    complexType="_1cTtpTL3EeKU9IrkkToqcw_-1781577744">
    <semanticMarkup
      xmi:id="_c2SrxQ5lEeO42pgjaJ50lw"
      type="Synonym">
      <elements
        xmi:id="_c2Srxg5lEeO42pgjaJ50lw"
        name="context"
        value="DTCC" />
      <elements
        xmi:id="_c2Srxw5lEeO42pgjaJ50lw"
        name="value"
        value="Cash In Lieu" />
    </semanticMarkup>
  </messageBuildingBlock>
  <messageDefinitionIdentifier
    businessArea="supl"
    messageFunctionality="008"
    flavour="001"
    version="01" />
</messageDefinition>

ISO Building Blocks

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