TradeLegNotificationV03

secl.001.001.03

Scope The TradeLegNotification message is sent by the central counterparty (CCP) to a clearing member to report the trade that has been executed by the trading platform.

The message definition is intended for use with the ISO20022 Business Application Header.

Usage The CCP reports both sides of the trade from the clearing member perspective. The CCP sends a message to the global clearing member of the seller and a message to the global clearing member of the buyer. Note: An individual clearing member only clear its own trades.

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
%% TradeLegNotificationV03 recursion level 0 with max 0
TradeLegNotificationV03 *-- "1..1" IPartyIdentification35Choice : ClearingMember
TradeLegNotificationV03 *-- "1..1" SecuritiesAccount18 : ClearingAccount
TradeLegNotificationV03 *-- "0..1" SecuritiesAccount19 : DeliveryAccount
TradeLegNotificationV03 *-- "0..1" PartyIdentificationAndAccount31 : NonClearingMember
TradeLegNotificationV03 *-- "0..1" Clearing4 : ClearingDetails
TradeLegNotificationV03 *-- "1..1" TradeLeg8 : TradeLegDetails
TradeLegNotificationV03 *-- "1..1" Settlement1 : SettlementDetails
TradeLegNotificationV03 *-- "0..1" SupplementaryData1 : SupplementaryData
  

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

ClearingMember building block

Provides the identification of the clearing member (individual clearing member or general clearing member). Choice of identification of a party. The party can be identified by giving a BIC or a proprietary code. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification35Choice recursion level 0 with max 1
  

PartyIdentification35Choice members

ClearingAccount building block

Identifies the clearing member account at the CCP through which the trade must be cleared (sometimes called position account). Account to or from which a securities entry is made. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SecuritiesAccount18 recursion level 0 with max 1
class SecuritiesAccount18{
    Identification IsoMax35Text
    Type ClearingAccountType1Code
    Name IsoMax70Text
}
  

SecuritiesAccount18 members

DeliveryAccount building block

An account opened by the central counterparty in the name of the clearing member or its settlement agent within the account structure, for settlement purposes (gives information about the clearing member/its settlement agent account at the central securities depository). Account to or from which a securities entry is made. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SecuritiesAccount19 recursion level 0 with max 1
class SecuritiesAccount19{
    Identification IsoMax35Text
    Name IsoMax70Text
}
SecuritiesAccount19 *-- "0..1" GenericIdentification30 : Type
%% GenericIdentification30 recursion level 1 with max 1
class GenericIdentification30{
    Identification IsoExact4AlphaNumericText
    Issuer IsoMax35Text
    SchemeName IsoMax35Text
}
  

SecuritiesAccount19 members

NonClearingMember building block

Provides details about the non clearing member identification and account. Party and account details. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% PartyIdentificationAndAccount31 recursion level 0 with max 1
PartyIdentificationAndAccount31 *-- "1..1" IPartyIdentification33Choice : Identification
PartyIdentificationAndAccount31 *-- "0..1" AlternatePartyIdentification4 : AlternateIdentification
PartyIdentificationAndAccount31 *-- "0..1" PartyTextInformation1 : AdditionalInformation
PartyIdentificationAndAccount31 *-- "0..1" SecuritiesAccount18 : ClearingAccount
%% IPartyIdentification33Choice recursion level 1 with max 1
%% AlternatePartyIdentification4 recursion level 1 with max 1
class AlternatePartyIdentification4{
    Country CountryCode
    AlternateIdentification IsoMax35Text
}
AlternatePartyIdentification4 *-- "1..1" IIdentificationType6Choice : IdentificationType
%% PartyTextInformation1 recursion level 1 with max 1
class PartyTextInformation1{
    DeclarationDetails IsoMax350Text
    PartyContactDetails IsoMax140Text
    RegistrationDetails IsoMax350Text
}
%% SecuritiesAccount18 recursion level 1 with max 1
class SecuritiesAccount18{
    Identification IsoMax35Text
    Type ClearingAccountType1Code
    Name IsoMax70Text
}
  

PartyIdentificationAndAccount31 members

ClearingDetails building block

Provides clearing details such as the settlement netting (or not) eligibility code or the clearing segment. Provides the clearing details. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Clearing4 recursion level 0 with max 1
class Clearing4{
    SettlementNettingEligibleCode NettingEligible1Code
    GuaranteedTrade IsoYesNoIndicator
}
Clearing4 *-- "0..1" IPartyIdentification35Choice : ClearingSegment
Clearing4 *-- "0..1" NonGuaranteedTrade3 : NonGuaranteedTrade
%% IPartyIdentification35Choice recursion level 1 with max 1
%% NonGuaranteedTrade3 recursion level 1 with max 1
NonGuaranteedTrade3 *-- "1..1" IPartyIdentification35Choice : TradeCounterpartyMemberIdentification
NonGuaranteedTrade3 *-- "1..1" IPartyIdentification35Choice : TradeCounterpartyClearingMemberIdentification
NonGuaranteedTrade3 *-- "0..1" DeliveringPartiesAndAccount11 : DeliveringParties
NonGuaranteedTrade3 *-- "0..1" ReceivingPartiesAndAccount11 : ReceivingParties
  

Clearing4 members

TradeLegDetails building block

Provides details about the trade leg such as the trade date, the settlement date or the trading currency. Provides the trade leg details. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% TradeLeg8 recursion level 0 with max 1
class TradeLeg8{
    TradeLegIdentification IsoMax35Text
    TradeIdentification IsoMax35Text
    TradeExecutionIdentification IsoMax35Text
    OrderIdentification IsoMax35Text
    AllocationIdentification IsoMax35Text
    Status Status5Code
    TradeDate IsoISODateTime
    TransactionDateTime IsoISODateTime
    TradingCurrency CurrencyCode
    BuySellIndicator Side1Code
    TradeType TradeType1Code
    DerivativeRelatedTrade IsoYesNoIndicator
    TradeRegistrationOrigin IsoMax35Text
    TradingCapacity TradingCapacity5Code
    TradePostingCode TradePosting1Code
}
TradeLeg8 *-- "0..1" IDateFormat15Choice : SettlementDate
TradeLeg8 *-- "1..1" SecurityIdentification14 : FinancialInstrumentIdentification
TradeLeg8 *-- "1..1" IFinancialInstrumentQuantity1Choice : TradeQuantity
TradeLeg8 *-- "1..1" Price4 : DealPrice
TradeLeg8 *-- "0..1" AmountAndDirection21 : GrossAmount
TradeLeg8 *-- "0..1" AmountAndDirection21 : AccruedInterestAmount
TradeLeg8 *-- "1..1" MarketIdentification84 : PlaceOfTrade
TradeLeg8 *-- "0..1" MarketIdentification85 : PlaceOfListing
TradeLeg8 *-- "0..1" PartyIdentificationAndAccount100 : Broker
TradeLeg8 *-- "1..1" IPartyIdentification35Choice : TradingParty
TradeLeg8 *-- "0..1" SecuritiesAccount19 : TradingPartyAccount
TradeLeg8 *-- "0..1" ISafekeepingPlaceFormat7Choice : SafekeepingPlace
TradeLeg8 *-- "0..1" SecuritiesAccount19 : SafekeepingAccount
%% IDateFormat15Choice recursion level 1 with max 1
%% SecurityIdentification14 recursion level 1 with max 1
class SecurityIdentification14{
    ISIN IsoISINIdentifier
    Description IsoMax140Text
}
SecurityIdentification14 *-- "0..0" OtherIdentification1 : OtherIdentification
%% IFinancialInstrumentQuantity1Choice recursion level 1 with max 1
%% Price4 recursion level 1 with max 1
class Price4{
    Type PriceValueType7Code
}
Price4 *-- "1..1" IPriceRateOrAmountChoice : Value
%% AmountAndDirection21 recursion level 1 with max 1
class AmountAndDirection21{
    Amount IsoActiveOrHistoricCurrencyAndAmount
    CreditDebitIndicator CreditDebitCode
}
%% AmountAndDirection21 recursion level 1 with max 1
class AmountAndDirection21{
    Amount IsoActiveOrHistoricCurrencyAndAmount
    CreditDebitIndicator CreditDebitCode
}
%% MarketIdentification84 recursion level 1 with max 1
MarketIdentification84 *-- "0..1" IMarketIdentification1Choice : Identification
MarketIdentification84 *-- "1..1" IMarketType8Choice : Type
%% MarketIdentification85 recursion level 1 with max 1
MarketIdentification85 *-- "0..1" IMarketIdentification1Choice : Identification
MarketIdentification85 *-- "1..1" IMarketType9Choice : Type
%% PartyIdentificationAndAccount100 recursion level 1 with max 1
class PartyIdentificationAndAccount100{
    SafekeepingAccount IsoMax35Text
    ProcessingIdentification IsoMax35Text
}
PartyIdentificationAndAccount100 *-- "1..1" IPartyIdentification83Choice : Identification
PartyIdentificationAndAccount100 *-- "0..1" AlternatePartyIdentification5 : AlternateIdentification
PartyIdentificationAndAccount100 *-- "0..1" PartyTextInformation1 : AdditionalInformation
%% IPartyIdentification35Choice recursion level 1 with max 1
%% SecuritiesAccount19 recursion level 1 with max 1
class SecuritiesAccount19{
    Identification IsoMax35Text
    Name IsoMax70Text
}
SecuritiesAccount19 *-- "0..1" GenericIdentification30 : Type
%% ISafekeepingPlaceFormat7Choice recursion level 1 with max 1
%% SecuritiesAccount19 recursion level 1 with max 1
class SecuritiesAccount19{
    Identification IsoMax35Text
    Name IsoMax70Text
}
SecuritiesAccount19 *-- "0..1" GenericIdentification30 : Type
  

TradeLeg8 members

SettlementDetails building block

Provides details about the settlement details of the trade leg such the settlement amount or the place of settlement. Provides the settlement details. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Settlement1 recursion level 0 with max 1
Settlement1 *-- "1..1" AmountAndDirection27 : SettlementAmount
Settlement1 *-- "0..1" IPartyIdentification34Choice : Depository
%% AmountAndDirection27 recursion level 1 with max 1
class AmountAndDirection27{
    Amount IsoActiveCurrencyAndAmount
    CreditDebitIndicator CreditDebitCode
    OriginalCurrencyAndOrderedAmount IsoActiveOrHistoricCurrencyAndAmount
}
AmountAndDirection27 *-- "0..1" ForeignExchangeTerms17 : ForeignExchangeDetails
%% IPartyIdentification34Choice recursion level 1 with max 1
  

Settlement1 members

SupplementaryData building block

Additional information that can not be captured in the structured fields and/or any other specific block. Additional information that can not be captured in the structured fields and/or any other specific block. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SupplementaryData1 recursion level 0 with max 1
class SupplementaryData1{
    PlaceAndName IsoMax350Text
}
SupplementaryData1 *-- "1..1" IsoSupplementaryDataEnvelope1 : Envelope
%% IsoSupplementaryDataEnvelope1 recursion level 1 with max 1
  

SupplementaryData1 members

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    TradeLegNotificationV03 --|> IOuterRecord : Implements
    TradeLegNotificationV03Document --|> IOuterDocument~TradeLegNotificationV03~ : Implements
    class IOuterDocument~TradeLegNotificationV03~ {
        TradeLegNotificationV03 Message
     }
  

Document wrapper for serialization

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

classDiagram
    TradeLegNotificationV03Document *-- TradeLegNotificationV03 : 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:secl.001.001.03">
    <TradLegNtfctn>
        <ClrMmb>
            <!-- ClearingMember inner content -->
        </ClrMmb>
        <ClrAcct>
            <!-- ClearingAccount inner content -->
        </ClrAcct>
        <DlvryAcct>
            <!-- DeliveryAccount inner content -->
        </DlvryAcct>
        <NonClrMmb>
            <!-- NonClearingMember inner content -->
        </NonClrMmb>
        <ClrDtls>
            <!-- ClearingDetails inner content -->
        </ClrDtls>
        <TradLegDtls>
            <!-- TradeLegDetails inner content -->
        </TradLegDtls>
        <SttlmDtls>
            <!-- SettlementDetails inner content -->
        </SttlmDtls>
        <SplmtryData>
            <!-- SupplementaryData inner content -->
        </SplmtryData>
    </TradLegNtfctn>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_BjjyQS0mEeSRe9rElPHBfg"
  name="TradeLegNotificationV03"
  definition="Scope&#xD;&#xA;The TradeLegNotification message is sent by the central counterparty (CCP) to a clearing member to report the trade that has been executed by the trading platform.&#xD;&#xA;&#xD;&#xA;The message definition is intended for use with the ISO20022 Business Application Header.&#xD;&#xA;&#xD;&#xA;Usage&#xD;&#xA;The CCP reports both sides of the trade from the clearing member perspective. The CCP sends a message to the global clearing member of the seller and a message to the global clearing member of the buyer. Note: An individual clearing member only clear its own trades."
  registrationStatus="Registered"
  messageSet="_vZbScWwCEeSvG_1tXIrsqQ"
  xmlTag="TradLegNtfctn"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <constraint
    xmi:id="_BjjyQy0mEeSRe9rElPHBfg"
    name="DepositoryOrPlaceOfListingPresenceRule"
    definition="Depository or PlaceOfListing must be present."
    registrationStatus="Provisionally Registered"
    expression="&lt;RuleDefinition&gt;&lt;SimpleRule xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xsi:type=&quot;SimpleRule&quot;&gt;&lt;mustBe&gt;&lt;connector&gt;OR&lt;/connector&gt;&lt;BooleanRule xsi:type=&quot;Presence&quot;&gt;&lt;leftOperand&gt;/SettlementDetails/Depository&lt;/leftOperand&gt;&lt;/BooleanRule&gt;&lt;BooleanRule xsi:type=&quot;Presence&quot;&gt;&lt;leftOperand&gt;/TradeLegDetails/PlaceOfListing&lt;/leftOperand&gt;&lt;/BooleanRule&gt;&lt;/mustBe&gt;&lt;/SimpleRule&gt;&lt;/RuleDefinition&gt;" />
  <messageBuildingBlock
    xmi:id="_BjjyRS0mEeSRe9rElPHBfg"
    name="ClearingMember"
    definition="Provides the identification of the clearing member (individual clearing member or general clearing member)."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="ClrMmb"
    complexType="_QPYd4dp-Ed-ak6NoX_4Aeg_-1523931735" />
  <messageBuildingBlock
    xmi:id="_BjjyRy0mEeSRe9rElPHBfg"
    name="ClearingAccount"
    definition="Identifies the clearing member account at the CCP through which the trade must be cleared (sometimes called position account)."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="ClrAcct"
    complexType="_T_SeENp-Ed-ak6NoX_4Aeg_924781717" />
  <messageBuildingBlock
    xmi:id="_BjjySS0mEeSRe9rElPHBfg"
    name="DeliveryAccount"
    definition="An account opened by the central counterparty in the name of the clearing member or its settlement agent within the account structure, for settlement purposes (gives information about the clearing member/its settlement agent account at the central securities depository)."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="DlvryAcct"
    complexType="_T_JUKtp-Ed-ak6NoX_4Aeg_1976638301" />
  <messageBuildingBlock
    xmi:id="_BjjySy0mEeSRe9rElPHBfg"
    name="NonClearingMember"
    definition="Provides details about the non clearing member identification and account."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="NonClrMmb"
    complexType="_PWdRx9p-Ed-ak6NoX_4Aeg_1767078833" />
  <messageBuildingBlock
    xmi:id="_BjjyTS0mEeSRe9rElPHBfg"
    name="ClearingDetails"
    definition="Provides clearing details such as the settlement netting (or not) eligibility code or the clearing segment."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="ClrDtls"
    complexType="_tv6MUWpUEeSgo9vJrfSF_Q" />
  <messageBuildingBlock
    xmi:id="_BjjyTy0mEeSRe9rElPHBfg"
    name="TradeLegDetails"
    definition="Provides details about the trade leg such as the trade date, the settlement date or the trading currency."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="TradLegDtls"
    complexType="_0eGloS0qEeSRe9rElPHBfg" />
  <messageBuildingBlock
    xmi:id="_BjjyUS0mEeSRe9rElPHBfg"
    name="SettlementDetails"
    definition="Provides details about the settlement details of the trade leg such the settlement amount or the place of settlement."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="SttlmDtls"
    complexType="_-dwqJaMOEeCojJW5vEuTEQ_-717706352" />
  <messageBuildingBlock
    xmi:id="_BjjyUy0mEeSRe9rElPHBfg"
    name="SupplementaryData"
    definition="Additional information that can not be captured in the structured fields and/or any other specific block."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="SplmtryData"
    complexType="_Qn0zC9p-Ed-ak6NoX_4Aeg_468227563" />
  <messageDefinitionIdentifier
    businessArea="secl"
    messageFunctionality="001"
    flavour="001"
    version="03" />
</messageDefinition>

ISO Building Blocks

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