ForeignExchangeTradeInstructionV03

fxtr.014.001.03

Scope The ForeignExchangeTradeInstruction message is sent by a participant to a central settlement system to notify the creation of the foreign exchange trade agreed by both trading parties. Usage The ForeignExchangeTradeInstruction message is sent from a participant to a central settlement system to advise of the creation of a foreign exchange trade.

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
%% ForeignExchangeTradeInstructionV03 recursion level 0 with max 0
ForeignExchangeTradeInstructionV03 *-- "1..1" TradeAgreement10 : TradeInformation
ForeignExchangeTradeInstructionV03 *-- "1..1" TradePartyIdentification6 : TradingSideIdentification
ForeignExchangeTradeInstructionV03 *-- "1..1" TradePartyIdentification6 : CounterpartySideIdentification
ForeignExchangeTradeInstructionV03 *-- "1..1" AmountsAndValueDate1 : TradeAmounts
ForeignExchangeTradeInstructionV03 *-- "1..1" AgreedRate1 : AgreedRate
ForeignExchangeTradeInstructionV03 *-- "0..1" SettlementParties29 : TradingSideSettlementInstructions
ForeignExchangeTradeInstructionV03 *-- "0..1" SettlementParties29 : CounterpartySideSettlementInstructions
ForeignExchangeTradeInstructionV03 *-- "0..1" GeneralInformation4 : OptionalGeneralInformation
ForeignExchangeTradeInstructionV03 *-- "0..1" RegulatoryReporting4 : RegulatoryReporting
ForeignExchangeTradeInstructionV03 *-- "0..1" SupplementaryData1 : SupplementaryData
  

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

TradeInformation building block

General information related to the trade. Date and identification of a trade. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% TradeAgreement10 recursion level 0 with max 1
class TradeAgreement10{
    TradeDate IsoISODate
    OriginatorReference IsoMax35Text
    CommonReference IsoMax35Text
    OperationType IsoMax4Text
    OperationScope IsoMax4Text
    SettlementSessionIdentifier IsoExact4AlphaNumericText
    PaymentVersusPaymentIndicator IsoYesNoIndicator
}
  

TradeAgreement10 members

TradingSideIdentification building block

Party(ies) on the trading side of the trade. Entity involved in an activity. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% TradePartyIdentification6 recursion level 0 with max 1
TradePartyIdentification6 *-- "1..1" IPartyIdentification73Choice : SubmittingParty
TradePartyIdentification6 *-- "0..1" IPartyIdentification73Choice : TradeParty
TradePartyIdentification6 *-- "0..0" FundIdentification4 : FundIdentification
%% IPartyIdentification73Choice recursion level 1 with max 1
%% IPartyIdentification73Choice recursion level 1 with max 1
%% FundIdentification4 recursion level 1 with max 1
class FundIdentification4{
    AccountIdentificationWithCustodian IsoMax35Text
}
FundIdentification4 *-- "1..1" PartyIdentification60 : FundIdentification
FundIdentification4 *-- "0..1" IPartyIdentification73Choice : CustodianIdentification
  

TradePartyIdentification6 members

CounterpartySideIdentification building block

Party(ies) on the counterparty side of the trade. Entity involved in an activity. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% TradePartyIdentification6 recursion level 0 with max 1
TradePartyIdentification6 *-- "1..1" IPartyIdentification73Choice : SubmittingParty
TradePartyIdentification6 *-- "0..1" IPartyIdentification73Choice : TradeParty
TradePartyIdentification6 *-- "0..0" FundIdentification4 : FundIdentification
%% IPartyIdentification73Choice recursion level 1 with max 1
%% IPartyIdentification73Choice recursion level 1 with max 1
%% FundIdentification4 recursion level 1 with max 1
class FundIdentification4{
    AccountIdentificationWithCustodian IsoMax35Text
}
FundIdentification4 *-- "1..1" PartyIdentification60 : FundIdentification
FundIdentification4 *-- "0..1" IPartyIdentification73Choice : CustodianIdentification
  

TradePartyIdentification6 members

TradeAmounts building block

Amounts of the trade. Specifies the value date and the amounts traded in a foreign exchange transaction. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AmountsAndValueDate1 recursion level 0 with max 1
class AmountsAndValueDate1{
    TradingSideBuyAmount IsoActiveOrHistoricCurrencyAndAmount
    TradingSideSellAmount IsoActiveOrHistoricCurrencyAndAmount
    SettlementDate IsoISODate
}
  

AmountsAndValueDate1 members

AgreedRate building block

Exchange rate as agreed by the traders. Information needed to process a currency exchange or conversion. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AgreedRate1 recursion level 0 with max 1
class AgreedRate1{
    ExchangeRate IsoBaseOneRate
    UnitCurrency CurrencyCode
    QuotedCurrency CurrencyCode
}
  

AgreedRate1 members

TradingSideSettlementInstructions building block

Settlement instructions for the amounts received by the trading side. Identification of a settlement party by a choice between a BIC or a name and address or a party identification. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SettlementParties29 recursion level 0 with max 1
SettlementParties29 *-- "0..1" IPartyIdentification73Choice : DeliveryAgent
SettlementParties29 *-- "0..1" IPartyIdentification73Choice : Intermediary
SettlementParties29 *-- "1..1" IPartyIdentification73Choice : ReceivingAgent
SettlementParties29 *-- "0..1" IPartyIdentification73Choice : BeneficiaryInstitution
%% IPartyIdentification73Choice recursion level 1 with max 1
%% IPartyIdentification73Choice recursion level 1 with max 1
%% IPartyIdentification73Choice recursion level 1 with max 1
%% IPartyIdentification73Choice recursion level 1 with max 1
  

SettlementParties29 members

CounterpartySideSettlementInstructions building block

Settlement instructions for the amounts received by the counterparty. Identification of a settlement party by a choice between a BIC or a name and address or a party identification. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SettlementParties29 recursion level 0 with max 1
SettlementParties29 *-- "0..1" IPartyIdentification73Choice : DeliveryAgent
SettlementParties29 *-- "0..1" IPartyIdentification73Choice : Intermediary
SettlementParties29 *-- "1..1" IPartyIdentification73Choice : ReceivingAgent
SettlementParties29 *-- "0..1" IPartyIdentification73Choice : BeneficiaryInstitution
%% IPartyIdentification73Choice recursion level 1 with max 1
%% IPartyIdentification73Choice recursion level 1 with max 1
%% IPartyIdentification73Choice recursion level 1 with max 1
%% IPartyIdentification73Choice recursion level 1 with max 1
  

SettlementParties29 members

OptionalGeneralInformation building block

Specifies whether the trade is a block or an individual trade. It also contains supplementary information such as free format information, broker’s identification, dealing branches and references. Information concerning the negotiation process leading to a treasury trade. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% GeneralInformation4 recursion level 0 with max 1
class GeneralInformation4{
    BlockIndicator IsoYesNoIndicator
    RelatedTradeReference IsoMax35Text
    DealingMethod Trading1MethodCode
    CounterpartyReference IsoMax35Text
    BrokersCommission IsoActiveCurrencyAndAmount
    SenderToReceiverInformation IsoMax210Text
}
GeneralInformation4 *-- "0..1" IPartyIdentification73Choice : BrokerIdentification
GeneralInformation4 *-- "0..1" IPartyIdentification73Choice : DealingBranchTradingSide
GeneralInformation4 *-- "0..1" IPartyIdentification73Choice : DealingBranchCounterpartySide
GeneralInformation4 *-- "0..1" ContactInformation1 : ContactInformation
%% IPartyIdentification73Choice recursion level 1 with max 1
%% IPartyIdentification73Choice recursion level 1 with max 1
%% IPartyIdentification73Choice recursion level 1 with max 1
%% ContactInformation1 recursion level 1 with max 1
class ContactInformation1{
    Name IsoMax350Text
    FaxNumber IsoPhoneNumber
    TelephoneNumber IsoPhoneNumber
    EmailAddress IsoMax256Text
}
  

GeneralInformation4 members

RegulatoryReporting building block

Information that is to be provided to trade repositories in the context of the regulatory standards around over-the-counter (OTC) derivatives, central counterparties and trade repositories. Includes data elements that can be used for reporting to trade repositories, it is not to be used on regular trade confirmations. Although some fields, for example, unique transaction identifier and prior unique transaction identifier, might be used on regular trade confirmations. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% RegulatoryReporting4 recursion level 0 with max 1
class RegulatoryReporting4{
    ClearingThresholdIndicator IsoYesNoIndicator
    ClearedProductIdentification IsoMax35Text
    UnderlyingProductIdentifier UnderlyingProductIdentifier1Code
    AllocationIndicator AllocationIndicator1Code
    CollateralisationIndicator CollateralisationIndicator1Code
    ExecutionVenue IsoMax35Text
    NonStandardFlag IsoYesNoIndicator
    LinkSwapIdentification IsoExact42Text
    FinancialNatureOfTheCounterpartyIndicator IsoYesNoIndicator
    CollateralPortfolioIndicator IsoYesNoIndicator
    CollateralPortfolioCode IsoMax10Text
    PortfolioCompressionIndicator IsoYesNoIndicator
    CorporateSectorIndicator CorporateSectorIdentifier1Code
    TradeWithNonEEACounterpartyIndicator IsoYesNoIndicator
    IntragroupTradeIndicator IsoYesNoIndicator
    CommercialOrTreasuryFinancingIndicator IsoYesNoIndicator
    AdditionalReportingInformation IsoMax210Text
}
RegulatoryReporting4 *-- "0..0" TradingSideTransactionReporting1 : TradingSideTransactionReporting
RegulatoryReporting4 *-- "0..0" CounterpartySideTransactionReporting1 : CounterpartySideTransactionReporting
RegulatoryReporting4 *-- "0..1" IPartyIdentification73Choice : CentralCounterpartyClearingHouse
RegulatoryReporting4 *-- "0..1" IPartyIdentification73Choice : ClearingBroker
RegulatoryReporting4 *-- "0..1" IPartyIdentification73Choice : ClearingExceptionParty
RegulatoryReporting4 *-- "0..1" ClearingBrokerIdentification1 : ClearingBrokerIdentification
RegulatoryReporting4 *-- "0..1" IDateAndDateTimeChoice : ExecutionTimestamp
%% TradingSideTransactionReporting1 recursion level 1 with max 1
class TradingSideTransactionReporting1{
    ReportingJurisdiction IsoMax35Text
}
TradingSideTransactionReporting1 *-- "0..1" IPartyIdentification73Choice : ReportingParty
TradingSideTransactionReporting1 *-- "0..0" UniqueTransactionIdentifier2 : TradingSideUniqueTransactionIdentifier
%% CounterpartySideTransactionReporting1 recursion level 1 with max 1
class CounterpartySideTransactionReporting1{
    ReportingJurisdiction IsoMax35Text
}
CounterpartySideTransactionReporting1 *-- "0..1" IPartyIdentification73Choice : ReportingParty
CounterpartySideTransactionReporting1 *-- "0..0" UniqueTransactionIdentifier2 : CounterpartySideUniqueTransactionIdentifier
%% IPartyIdentification73Choice recursion level 1 with max 1
%% IPartyIdentification73Choice recursion level 1 with max 1
%% IPartyIdentification73Choice recursion level 1 with max 1
%% ClearingBrokerIdentification1 recursion level 1 with max 1
class ClearingBrokerIdentification1{
    SideIndicator SideIndicator1Code
    ClearingBrokerIdentification IsoMax35Text
}
%% IDateAndDateTimeChoice recursion level 1 with max 1
  

RegulatoryReporting4 members

SupplementaryData building block

Additional information that cannot be captured in the structured elements 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 ForeignExchangeTradeInstructionV03 implementation follows a specific implementaiton pattern. First of all, ForeignExchangeTradeInstructionV03 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, ForeignExchangeTradeInstructionV03Document implements IOuterDocument. Because ForeignExchangeTradeInstructionV03 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type ForeignExchangeTradeInstructionV03.

classDiagram
    class IOuterRecord
    ForeignExchangeTradeInstructionV03 --|> IOuterRecord : Implements
    ForeignExchangeTradeInstructionV03Document --|> IOuterDocument~ForeignExchangeTradeInstructionV03~ : Implements
    class IOuterDocument~ForeignExchangeTradeInstructionV03~ {
        ForeignExchangeTradeInstructionV03 Message
     }
  

Document wrapper for serialization

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

classDiagram
    ForeignExchangeTradeInstructionV03Document *-- ForeignExchangeTradeInstructionV03 : 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:fxtr.014.001.03">
    <FXTradInstr>
        <TradInf>
            <!-- TradeInformation inner content -->
        </TradInf>
        <TradgSdId>
            <!-- TradingSideIdentification inner content -->
        </TradgSdId>
        <CtrPtySdId>
            <!-- CounterpartySideIdentification inner content -->
        </CtrPtySdId>
        <TradAmts>
            <!-- TradeAmounts inner content -->
        </TradAmts>
        <AgrdRate>
            <!-- AgreedRate inner content -->
        </AgrdRate>
        <TradgSdSttlmInstrs>
            <!-- TradingSideSettlementInstructions inner content -->
        </TradgSdSttlmInstrs>
        <CtrPtySdSttlmInstrs>
            <!-- CounterpartySideSettlementInstructions inner content -->
        </CtrPtySdSttlmInstrs>
        <OptnlGnlInf>
            <!-- OptionalGeneralInformation inner content -->
        </OptnlGnlInf>
        <RgltryRptg>
            <!-- RegulatoryReporting inner content -->
        </RgltryRptg>
        <SplmtryData>
            <!-- SupplementaryData inner content -->
        </SplmtryData>
    </FXTradInstr>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_xXa2kTJ5EeOd1OidA-8_VQ"
  nextVersions="_lxHWUZRyEeak6e8_Fc5fQg"
  previousVersion="_qttxIRnWEeKKXqHkeUjBbw"
  name="ForeignExchangeTradeInstructionV03"
  definition="Scope&#xD;&#xD;&#xA;The ForeignExchangeTradeInstruction message is sent by a participant to a central settlement system to notify the creation of the foreign exchange trade agreed by both trading parties.&#xD;&#xD;&#xA;Usage&#xD;&#xD;&#xA;The ForeignExchangeTradeInstruction message is sent from a participant to a central settlement system to advise of the creation of a foreign exchange trade."
  registrationStatus="Registered"
  messageSet="_urpIICeJEeOCeO5e7islRQ"
  xmlTag="FXTradInstr"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_xXa2kzJ5EeOd1OidA-8_VQ"
    nextVersions="_lxHWU5RyEeak6e8_Fc5fQg"
    previousVersion="_qttxIxnWEeKKXqHkeUjBbw"
    name="TradeInformation"
    definition="General information related to the trade."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="TradInf"
    complexType="_wiD-kVN4EeOEi5J12GuNGQ" />
  <messageBuildingBlock
    xmi:id="_xXa2lTJ5EeOd1OidA-8_VQ"
    nextVersions="_lxHWVZRyEeak6e8_Fc5fQg"
    previousVersion="_qttxJxnWEeKKXqHkeUjBbw"
    name="TradingSideIdentification"
    definition="Party(ies) on the trading side of the trade."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="TradgSdId"
    complexType="_rbRD8SjaEeK1Sbo8NpBROA" />
  <messageBuildingBlock
    xmi:id="_xXa2lzJ5EeOd1OidA-8_VQ"
    nextVersions="_lxHWV5RyEeak6e8_Fc5fQg"
    previousVersion="_qttxKxnWEeKKXqHkeUjBbw"
    name="CounterpartySideIdentification"
    definition="Party(ies) on the counterparty side of the trade."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="CtrPtySdId"
    complexType="_rbRD8SjaEeK1Sbo8NpBROA" />
  <messageBuildingBlock
    xmi:id="_xXa2mTJ5EeOd1OidA-8_VQ"
    nextVersions="_lxHWWZRyEeak6e8_Fc5fQg"
    previousVersion="_qttxLxnWEeKKXqHkeUjBbw"
    name="TradeAmounts"
    definition="Amounts of the trade."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="TradAmts"
    complexType="_TITy0tp-Ed-ak6NoX_4Aeg_290674075" />
  <messageBuildingBlock
    xmi:id="_xXa2mzJ5EeOd1OidA-8_VQ"
    nextVersions="_lxHWW5RyEeak6e8_Fc5fQg"
    previousVersion="_qttxMxnWEeKKXqHkeUjBbw"
    name="AgreedRate"
    definition="Exchange rate as agreed by the traders."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="AgrdRate"
    complexType="_QLW5ctp-Ed-ak6NoX_4Aeg_290674057" />
  <messageBuildingBlock
    xmi:id="_xXa2nTJ5EeOd1OidA-8_VQ"
    nextVersions="_lxHWXZRyEeak6e8_Fc5fQg"
    previousVersion="_qttxNxnWEeKKXqHkeUjBbw"
    name="TradingSideSettlementInstructions"
    definition="Settlement instructions for the amounts received by the trading side."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="TradgSdSttlmInstrs"
    complexType="_4CRAsSjaEeK1Sbo8NpBROA" />
  <messageBuildingBlock
    xmi:id="_xXa2nzJ5EeOd1OidA-8_VQ"
    nextVersions="_lxHWX5RyEeak6e8_Fc5fQg"
    previousVersion="_qttxOxnWEeKKXqHkeUjBbw"
    name="CounterpartySideSettlementInstructions"
    definition="Settlement instructions for the amounts received by the counterparty."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="CtrPtySdSttlmInstrs"
    complexType="_4CRAsSjaEeK1Sbo8NpBROA" />
  <messageBuildingBlock
    xmi:id="_xXa2oTJ5EeOd1OidA-8_VQ"
    nextVersions="_lxHWYZRyEeak6e8_Fc5fQg"
    previousVersion="_qttxPxnWEeKKXqHkeUjBbw"
    name="OptionalGeneralInformation"
    definition="Specifies whether the trade is a block or an individual trade. It also contains supplementary information such as free format information, broker's identification, dealing branches and references."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="OptnlGnlInf"
    complexType="_y1bu0R9rEeKR8ap75esygQ" />
  <messageBuildingBlock
    xmi:id="_xXa2ozJ5EeOd1OidA-8_VQ"
    nextVersions="_lxHWY5RyEeak6e8_Fc5fQg"
    previousVersion="_2SkDCyjtEeK1Sbo8NpBROA"
    name="RegulatoryReporting"
    definition="Information that is to be provided to trade repositories in the context of the regulatory standards around over-the-counter (OTC) derivatives, central counterparties and trade repositories."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="RgltryRptg"
    complexType="_I6JesTS3EeOW7s4n9SUZ3A" />
  <messageBuildingBlock
    xmi:id="_xXa2pTJ5EeOd1OidA-8_VQ"
    nextVersions="_lxQgQZRyEeak6e8_Fc5fQg"
    previousVersion="_PUq3tSnBEeKqmMA7_Y42sg"
    name="SupplementaryData"
    definition="Additional information that cannot be captured in the structured elements and/or any other specific block."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="SplmtryData"
    complexType="_Qn0zC9p-Ed-ak6NoX_4Aeg_468227563" />
  <messageDefinitionIdentifier
    businessArea="fxtr"
    messageFunctionality="014"
    flavour="001"
    version="03" />
</messageDefinition>

ISO Building Blocks

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