ForeignExchangeTradeInstructionCancellationV03

fxtr.016.001.03

Scope The ForeignExchangeTradeInstructionCancellation message is sent by a participant to a central settlement system to notify the cancellation of the foreign exchange trade previously confirmed by the sender. Usage The ForeignExchangeTradeInstructionCancellation message is sent from a participant to a central settlement system to advise of the cancellation of a previously sent notification. The “Related Reference” must be used to link it to the previous notification.

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
%% ForeignExchangeTradeInstructionCancellationV03 recursion level 0 with max 0
ForeignExchangeTradeInstructionCancellationV03 *-- "1..1" TradeAgreement11 : TradeInformation
ForeignExchangeTradeInstructionCancellationV03 *-- "1..1" TradePartyIdentification6 : TradingSideIdentification
ForeignExchangeTradeInstructionCancellationV03 *-- "1..1" TradePartyIdentification6 : CounterpartySideIdentification
ForeignExchangeTradeInstructionCancellationV03 *-- "0..1" AgreedRate1 : AgreedRate
ForeignExchangeTradeInstructionCancellationV03 *-- "0..1" SettlementParties29 : TradingSideSettlementInstructions
ForeignExchangeTradeInstructionCancellationV03 *-- "0..1" SettlementParties29 : CounterpartySideSettlementInstructions
ForeignExchangeTradeInstructionCancellationV03 *-- "0..1" GeneralInformation4 : OptionalGeneralInformation
ForeignExchangeTradeInstructionCancellationV03 *-- "1..1" AmountsAndValueDate1 : TradeAmounts
ForeignExchangeTradeInstructionCancellationV03 *-- "0..1" RegulatoryReporting4 : RegulatoryReporting
ForeignExchangeTradeInstructionCancellationV03 *-- "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 together with references to previous events in its life. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% TradeAgreement11 recursion level 0 with max 1
class TradeAgreement11{
    TradeDate IsoISODate
    OriginatorReference IsoMax35Text
    CommonReference IsoMax35Text
    AmendOrCancelReason IsoMax35Text
    OperationType IsoMax4Text
    OperationScope IsoMax4Text
    SettlementSessionIdentifier IsoExact4AlphaNumericText
    PaymentVersusPaymentIndicator IsoYesNoIndicator
}
TradeAgreement11 *-- "1..1" IMatchingSystemReference1Choice : MatchingSystemReference
%% IMatchingSystemReference1Choice recursion level 1 with max 1
  

TradeAgreement11 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

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

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

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

classDiagram
    class IOuterRecord
    ForeignExchangeTradeInstructionCancellationV03 --|> IOuterRecord : Implements
    ForeignExchangeTradeInstructionCancellationV03Document --|> IOuterDocument~ForeignExchangeTradeInstructionCancellationV03~ : Implements
    class IOuterDocument~ForeignExchangeTradeInstructionCancellationV03~ {
        ForeignExchangeTradeInstructionCancellationV03 Message
     }
  

Document wrapper for serialization

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

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

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_zV7xsTJ5EeOd1OidA-8_VQ"
  nextVersions="_poi64ZRyEeak6e8_Fc5fQg"
  previousVersion="_56FNoRnWEeKKXqHkeUjBbw"
  name="ForeignExchangeTradeInstructionCancellationV03"
  definition="Scope&#xD;&#xD;&#xA;The ForeignExchangeTradeInstructionCancellation message is sent by a participant to a central settlement system to notify the cancellation of the foreign exchange trade previously confirmed by the sender.&#xD;&#xD;&#xA;Usage&#xD;&#xD;&#xA;The ForeignExchangeTradeInstructionCancellation message is sent from a participant to a central settlement system to advise of the cancellation of a previously sent notification. The &quot;Related Reference&quot; must be used to link it to the previous notification."
  registrationStatus="Registered"
  messageSet="_urpIICeJEeOCeO5e7islRQ"
  xmlTag="FXTradInstrCxl"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_zV7xszJ5EeOd1OidA-8_VQ"
    nextVersions="_poi645RyEeak6e8_Fc5fQg"
    previousVersion="_56FNoxnWEeKKXqHkeUjBbw"
    name="TradeInformation"
    definition="General information related to the trade."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="TradInf"
    complexType="_NoHuwVN5EeOEi5J12GuNGQ" />
  <messageBuildingBlock
    xmi:id="_zV7xtTJ5EeOd1OidA-8_VQ"
    nextVersions="_poi65ZRyEeak6e8_Fc5fQg"
    previousVersion="_56FNpxnWEeKKXqHkeUjBbw"
    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="_zV7xtzJ5EeOd1OidA-8_VQ"
    nextVersions="_poi655RyEeak6e8_Fc5fQg"
    previousVersion="_56FNqxnWEeKKXqHkeUjBbw"
    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="_zV7xuTJ5EeOd1OidA-8_VQ"
    nextVersions="_poi66ZRyEeak6e8_Fc5fQg"
    previousVersion="_56FNrxnWEeKKXqHkeUjBbw"
    name="AgreedRate"
    definition="Exchange rate as agreed by the traders."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="AgrdRate"
    complexType="_QLW5ctp-Ed-ak6NoX_4Aeg_290674057" />
  <messageBuildingBlock
    xmi:id="_zV7xuzJ5EeOd1OidA-8_VQ"
    nextVersions="_poi665RyEeak6e8_Fc5fQg"
    previousVersion="_56F0sxnWEeKKXqHkeUjBbw"
    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="_zV7xvTJ5EeOd1OidA-8_VQ"
    nextVersions="_poi67ZRyEeak6e8_Fc5fQg"
    previousVersion="_56F0txnWEeKKXqHkeUjBbw"
    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="_zV7xvzJ5EeOd1OidA-8_VQ"
    nextVersions="_poi675RyEeak6e8_Fc5fQg"
    previousVersion="_56F0uxnWEeKKXqHkeUjBbw"
    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="_zV7xwTJ5EeOd1OidA-8_VQ"
    nextVersions="_poi68ZRyEeak6e8_Fc5fQg"
    previousVersion="_56F0vxnWEeKKXqHkeUjBbw"
    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="_zV7xwzJ5EeOd1OidA-8_VQ"
    nextVersions="_poi685RyEeak6e8_Fc5fQg"
    previousVersion="_1fSzCSjtEeK1Sbo8NpBROA"
    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="_zV7xxTJ5EeOd1OidA-8_VQ"
    nextVersions="_poi69ZRyEeak6e8_Fc5fQg"
    previousVersion="_ahqUmSnBEeKqmMA7_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="016"
    flavour="001"
    version="03" />
</messageDefinition>

ISO Building Blocks

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