fxtr.034.001.01
Scope The ForeignExchangeTradeConfirmationRequest message is sent from a market participant to a Central matching utility (CMU) to request a foreign exchange(spot/forward/swap) trade confirmation.
Usage The confirmation request is sent by the market participants to the CMU after they receiving the capture reports. Note that a confirmation request could be cancelled or amended.
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
%% ForeignExchangeTradeConfirmationRequestV01 recursion level 0 with max 0
class ForeignExchangeTradeConfirmationRequestV01{
ConfirmationType ConfirmationRequest1Code
QueryStartNumber IsoMax35NumericText
QueryTradeStatus QueryTradeStatus1Code
}
ForeignExchangeTradeConfirmationRequestV01 *-- "1..1" Header23 : Header
ForeignExchangeTradeConfirmationRequestV01 *-- "1..1" MessageIdentification1 : RequestIdentification
ForeignExchangeTradeConfirmationRequestV01 *-- "1..1" Trade2 : TradeDetail
ForeignExchangeTradeConfirmationRequestV01 *-- "1..1" Period4 : QueryPeriod
ForeignExchangeTradeConfirmationRequestV01 *-- "0..1" SupplementaryData1 : SupplementaryData
Now, we will zero-in one-by-one on each of these building blocks.
Header building block
Message management information. Set of characteristics related to the transfer of transactions. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% Header23 recursion level 0 with max 1
class Header23{
FormatVersion IsoMax6Text
ExchangeIdentification IsoMax3NumericText
MessageSequenceNumber IsoNumber
CreationDateTime IsoISODateTime
}
Header23 *-- "1..1" GenericIdentification32 : InitiatingParty
Header23 *-- "0..1" GenericIdentification32 : RecipientParty
%% GenericIdentification32 recursion level 1 with max 1
class GenericIdentification32{
Identification IsoMax35Text
Type PartyType3Code
Issuer PartyType4Code
ShortName IsoMax35Text
}
%% GenericIdentification32 recursion level 1 with max 1
class GenericIdentification32{
Identification IsoMax35Text
Type PartyType3Code
Issuer PartyType4Code
ShortName IsoMax35Text
}
Header23 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| FormatVersion | Version of file format. | IsoMax6Text - Required 1..1 |
| ExchangeIdentification | Unique identification of an exchange occurrence. | IsoMax3NumericText - Required 1..1 |
| InitiatingParty | Unique identification of the partner that has initiated the exchange. | GenericIdentification32 - Required 1..1 |
| RecipientParty | Unique identification of the partner that is the recipient of the exchange. | GenericIdentification32 - Optional 0..1 |
| MessageSequenceNumber | Sequence of this message in a conversation in integer. | IsoNumber - Required 1..1 |
| CreationDateTime | Date and time at which the file or message was created. | IsoISODateTime - Required 1..1 |
RequestIdentification building block
Identifies the confirm request messge. Identifies a message by a unique identifier and the date and time when the message was created by the sender. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% MessageIdentification1 recursion level 0 with max 1
class MessageIdentification1{
Identification IsoMax35Text
CreationDateTime IsoISODateTime
}
MessageIdentification1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Identification of the message. | IsoMax35Text - Required 1..1 |
| CreationDateTime | Date of creation of the message. | IsoISODateTime - Required 1..1 |
TradeDetail building block
Details of the treasury trade confirmed. Details of the foreign exchange trade including spot\forward\NDF\swap that is confirmed. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% Trade2 recursion level 0 with max 1
class Trade2{
TradeIdentification IsoMax35Text
TradeDate IsoISODate
ForeignExchangeTradeProduct UnderlyingProductIdentifier1Code
TradingCurrency CurrencyCode
SettlementCurrency CurrencyCode
TradingMethod TradingMethodType1Code
TradingMode TradingModeType1Code
ClearingMethod ClearingMethod1Code
Symbol IsoMax35Text
PlaceOfConfirmation IsoAnyBICIdentifier
AssociatedTradeReference IsoMax70Text
}
Trade2 *-- "0..1" Trade3 : ForeignExchangeDetails
Trade2 *-- "0..0" InstrumentLeg6 : SwapLeg
Trade2 *-- "0..1" ISecurityIdentification22Choice : ProductIdentification
%% Trade3 recursion level 1 with max 1
class Trade3{
ExecutionPrice IsoActiveCurrencyAnd13DecimalAmount
LastQuantity IsoCurrencyAndAmount
SettlementType SettlementDateCode
SettlementDate IsoISODate
ForwardPoints IsoDecimalNumber
CalculatedCounterpartyCurrencyLastQuantity IsoCurrencyAndAmount
ValueDate IsoISODate
RiskAmount IsoActiveCurrencyAndAmount
FixingCurrency CurrencyCode
FixingDate IsoISODate
OptionIndicator IsoYesNoIndicator
DeltaIndicator IsoYesNoIndicator
AssociatedTradeReference IsoMax70Text
}
Trade3 *-- "1..1" AgreedRate3 : ValuationRate
Trade3 *-- "1..1" SecurityIdentification18 : SecurityIdentification
%% InstrumentLeg6 recursion level 1 with max 1
class InstrumentLeg6{
LegSide Side1Code
LegSettlementType SettlementDateCode
LegSettlementDate IsoISODateTime
LegLastPrice IsoActiveCurrencyAnd13DecimalAmount
LegSettlementCurrency CurrencyCode
LegOrderQuantity IsoCurrencyAndAmount
LegForwardPoints IsoDecimalNumber
LegCalculatedCounterpartyCurrencyLastQuantity IsoCurrencyAndAmount
LegRiskAmount IsoActiveCurrencyAndAmount
LegValueDate IsoISODate
LegCurrency CurrencyCode
LegSymbol IsoMax35Text
}
InstrumentLeg6 *-- "1..1" AgreedRate3 : LegValuationRate
InstrumentLeg6 *-- "1..1" SecurityIdentification18 : LegSecurityIdentification
%% ISecurityIdentification22Choice recursion level 1 with max 1
Trade2 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| TradeIdentification | Unique reference identification assigned to the trade by the instructing party. This reference will be used throughout the trade life cycle to identify the particular trade. | IsoMax35Text - Required 1..1 |
| TradeDate | Specifies the date on which the trade was executed. | IsoISODate - Required 1..1 |
| ForeignExchangeTradeProduct | Specifies the underlying product type. | UnderlyingProductIdentifier1Code - Required 1..1 |
| TradingCurrency | Specifies the ISO code of the trade currency. | CurrencyCode - Optional 0..1 |
| SettlementCurrency | Settlement currency of the trade, agreed by both sides of the trade. | CurrencyCode - Optional 0..1 |
| TradingMethod | Identifies the type of trading method. | TradingMethodType1Code - Optional 0..1 |
| TradingMode | Identifies the type of the trade mode. | TradingModeType1Code - Required 1..1 |
| ClearingMethod | Clearing method of the trade, agreed by both sides of the trade. | ClearingMethod1Code - Required 1..1 |
| Symbol | Symbol of the trade. | IsoMax35Text - Optional 0..1 |
| PlaceOfConfirmation | Infrastructure where the trade confirmation will take place. | IsoAnyBICIdentifier - Optional 0..1 |
| ForeignExchangeDetails | Provides details of the foreign exchange trade including Spot Forward and NDF. | Trade3 - Optional 0..1 |
| SwapLeg | Provides details about each leg of the multileg instrument (foreign exchange swap). | InstrumentLeg6 - Unknown 0..0 |
| ProductIdentification | Identification of the treasury trade product, as assigned under a formal or proprietary identification scheme. | ISecurityIdentification22Choice - Optional 0..1 |
| AssociatedTradeReference | Some associated trade reference needs to be specified. | IsoMax70Text - Unknown 0..0 |
ConfirmationType building block
Identifies the type of confirmation message being sent. Identifies the type of confirmation message being sent. For comparison, see the ISO20022 official specification This message is declared as ConfirmationRequest1Code in the ISO specification. In our implementation, it is represented in source code as ConfirmationRequest1Code. Due to global using directives, it is treated as a System.String by the compiler and runtime.
QueryPeriod building block
Period of the inquiry. Time span defined by a start date and time, and an end date and time. For comparison, see the ISO20022 official specification
classDiagram direction tb %% Period4 recursion level 0 with max 1 Period4 *-- "1..1" IDateFormat18Choice : StartDate Period4 *-- "1..1" IDateFormat18Choice : EndDate %% IDateFormat18Choice recursion level 1 with max 1 %% IDateFormat18Choice recursion level 1 with max 1
Period4 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| StartDate | Date and time at which the range starts. | IDateFormat18Choice - Required 1..1 |
| EndDate | Date and time at which the range ends. | IDateFormat18Choice - Required 1..1 |
QueryStartNumber building block
Start number in request result. Specifies a numeric string with a maximum length of 35 digits. For comparison, see the ISO20022 official specification This message is declared as Max35NumericText in the ISO specification. In our implementation, it is represented in source code as IsoMax35NumericText. Due to global using directives, it is treated as a System.String by the compiler and runtime.
QueryTradeStatus building block
Specifies the inquiry status of the trade. Specifies the inquiry status of the trade. For comparison, see the ISO20022 official specification This message is declared as QueryTradeStatus1Code in the ISO specification. In our implementation, it is represented in source code as QueryTradeStatus1Code. Due to global using directives, it is treated as a System.String by the compiler and runtime.
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
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| PlaceAndName | Unambiguous reference to the location where the supplementary data must be inserted in the message instance. In the case of XML, this is expressed by a valid XPath. | IsoMax350Text - Optional 0..1 |
| Envelope | Technical element wrapping the supplementary data. | IsoSupplementaryDataEnvelope1 - Required 1..1 |
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the ForeignExchangeTradeConfirmationRequestV01 implementation follows a specific implementaiton pattern. First of all, ForeignExchangeTradeConfirmationRequestV01 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, ForeignExchangeTradeConfirmationRequestV01Document implements IOuterDocument. Because ForeignExchangeTradeConfirmationRequestV01 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type ForeignExchangeTradeConfirmationRequestV01.
classDiagram
class IOuterRecord
ForeignExchangeTradeConfirmationRequestV01 --|> IOuterRecord : Implements
ForeignExchangeTradeConfirmationRequestV01Document --|> IOuterDocument~ForeignExchangeTradeConfirmationRequestV01~ : Implements
class IOuterDocument~ForeignExchangeTradeConfirmationRequestV01~ {
ForeignExchangeTradeConfirmationRequestV01 Message
}
Document wrapper for serialization
The only real purpose ForeignExchangeTradeConfirmationRequestV01Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:fxtr.034.001.01’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using ForeignExchangeTradeConfirmationRequestV01.ToDocument() method. The returned ForeignExchangeTradeConfirmationRequestV01Document value will serialize correctly according to ISO 20022 standards.
classDiagram
ForeignExchangeTradeConfirmationRequestV01Document *-- ForeignExchangeTradeConfirmationRequestV01 : 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.034.001.01">
<FXTradConfReq>
<Hdr>
<!-- Header inner content -->
</Hdr>
<ReqId>
<!-- RequestIdentification inner content -->
</ReqId>
<TradDtl>
<!-- TradeDetail inner content -->
</TradDtl>
<ConfTp>
<!-- ConfirmationType inner content -->
</ConfTp>
<QryPrd>
<!-- QueryPeriod inner content -->
</QryPrd>
<QryStartNb>
<!-- QueryStartNumber inner content -->
</QryStartNb>
<QryTradSts>
<!-- QueryTradeStatus inner content -->
</QryTradSts>
<SplmtryData>
<!-- SupplementaryData inner content -->
</SplmtryData>
</FXTradConfReq>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_2qmO4ESCEeStEe_B2dcrqg"
name="ForeignExchangeTradeConfirmationRequestV01"
definition="Scope
 The ForeignExchangeTradeConfirmationRequest message is sent from a market participant to a Central matching utility (CMU) to request a foreign exchange(spot/forward/swap) trade confirmation.

Usage
The confirmation request is sent by the market participants to the CMU after they receiving the capture reports.
Note that a confirmation request could be cancelled or amended."
registrationStatus="Registered"
messageSet="_JAbpUQRHEeWRS-48_sRZxQ"
xmlTag="FXTradConfReq"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<messageBuildingBlock
xmi:id="_7SxT4ESCEeStEe_B2dcrqg"
name="Header"
definition="Message management information."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="Hdr"
complexType="_d7nnwAJXEeS2H9l84F_isg" />
<messageBuildingBlock
xmi:id="_FSjWwESDEeStEe_B2dcrqg"
name="RequestIdentification"
definition="Identifies the confirm request messge."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="ReqId"
complexType="_Q7pG5Np-Ed-ak6NoX_4Aeg_-967008570" />
<messageBuildingBlock
xmi:id="_IqUj0ESDEeStEe_B2dcrqg"
name="TradeDetail"
definition="Details of the treasury trade confirmed."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="TradDtl"
complexType="_yDLnEA2IEeSwB74WgTbh4Q" />
<messageBuildingBlock
xmi:id="_x4TUcIsWEeS_1fMypAW06w"
name="ConfirmationType"
definition="Identifies the type of confirmation message being sent."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="ConfTp"
simpleType="_jIjf8H6IEeSAlrUr1Vow5g" />
<messageBuildingBlock
xmi:id="_11BnEESpEeSTS-T7FO4CUQ"
name="QueryPeriod"
definition="Period of the inquiry."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="QryPrd"
complexType="_Nt3jd-ENEd-qUMZtd_eZuQ" />
<messageBuildingBlock
xmi:id="_WDuD4KaZEeSR8qifggAitQ"
name="QueryStartNumber"
definition="Start number in request result."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="QryStartNb"
simpleType="_TQbTxgEcEeCQm6a_G2yO_w_1928353271" />
<messageBuildingBlock
xmi:id="_15tBMKadEeSR8qifggAitQ"
name="QueryTradeStatus"
definition="Specifies the inquiry status of the trade."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="QryTradSts"
simpleType="_tAngoKadEeSR8qifggAitQ" />
<messageBuildingBlock
xmi:id="_upa4YKHlEeS69KkQis5bYg"
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="034"
flavour="001"
version="01" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.