trea.001.001.02
Scope The CreateNonDeliverableForwardOpening message is sent by a participant to a central system or to a counterparty to notify the opening of a non deliverable trade. Usage The trading parties will send similar messages to the central settlement system and the central settlement system will send notifications to both parties.
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
%% CreateNonDeliverableForwardOpeningV02 recursion level 0 with max 0
CreateNonDeliverableForwardOpeningV02 *-- "1..1" TradeAgreement1 : TradeInformation
CreateNonDeliverableForwardOpeningV02 *-- "1..1" TradePartyIdentification3 : TradingSideIdentification
CreateNonDeliverableForwardOpeningV02 *-- "1..1" TradePartyIdentification3 : CounterpartySideIdentification
CreateNonDeliverableForwardOpeningV02 *-- "1..1" AmountsAndValueDate1 : TradeAmounts
CreateNonDeliverableForwardOpeningV02 *-- "1..1" AgreedRate1 : AgreedRate
CreateNonDeliverableForwardOpeningV02 *-- "1..1" NonDeliverableForwardValuationConditions2 : ValuationConditions
Now, we will zero-in one-by-one on each of these building blocks.
TradeInformation building block
Provides identification and date of the non deliverable trade which is created. Date and identification of a trade. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% TradeAgreement1 recursion level 0 with max 1
class TradeAgreement1{
TradeDate IsoISODate
NotificationIdentification IsoMax35Text
CommonReference IsoMax35Text
}
TradeAgreement1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| TradeDate | Date at which the trading parties agree on a treasury trade. | IsoISODate - Required 1..1 |
| NotificationIdentification | Identification of a notification.This identification must be unique amongst all notifications of same type confirmed by the same party. | IsoMax35Text - Required 1..1 |
| CommonReference | Reference common to the parties of a trade. | IsoMax35Text - Optional 0..1 |
TradingSideIdentification building block
Specifies the trading side of the non deliverable trade which is created. Entity involved in an activity. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% TradePartyIdentification3 recursion level 0 with max 1
TradePartyIdentification3 *-- "0..1" FundIdentification2 : FundInformation
TradePartyIdentification3 *-- "1..1" IPartyIdentification8Choice : SubmittingParty
TradePartyIdentification3 *-- "1..1" IPartyIdentification8Choice : TradeParty
%% FundIdentification2 recursion level 1 with max 1
class FundIdentification2{
FundIdentification IsoMax35Text
AccountIdentificationWithCustodian IsoMax35Text
}
FundIdentification2 *-- "0..1" IPartyIdentification8Choice : CustodianIdentification
%% IPartyIdentification8Choice recursion level 1 with max 1
%% IPartyIdentification8Choice recursion level 1 with max 1
TradePartyIdentification3 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| FundInformation | Identifies the fund which is one of the parties in a treasury trade. | FundIdentification2 - Optional 0..1 |
| SubmittingParty | Specifies the party which submits a treasury trade to a matching system or to a settlement system or to a counterparty. | IPartyIdentification8Choice - Required 1..1 |
| TradeParty | Specifies the party which originated a treasury trade. This party may be the same as the submitting party. | IPartyIdentification8Choice - Required 1..1 |
CounterpartySideIdentification building block
Specifies the counterparty of the non deliverable trade which is created. Entity involved in an activity. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% TradePartyIdentification3 recursion level 0 with max 1
TradePartyIdentification3 *-- "0..1" FundIdentification2 : FundInformation
TradePartyIdentification3 *-- "1..1" IPartyIdentification8Choice : SubmittingParty
TradePartyIdentification3 *-- "1..1" IPartyIdentification8Choice : TradeParty
%% FundIdentification2 recursion level 1 with max 1
class FundIdentification2{
FundIdentification IsoMax35Text
AccountIdentificationWithCustodian IsoMax35Text
}
FundIdentification2 *-- "0..1" IPartyIdentification8Choice : CustodianIdentification
%% IPartyIdentification8Choice recursion level 1 with max 1
%% IPartyIdentification8Choice recursion level 1 with max 1
TradePartyIdentification3 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| FundInformation | Identifies the fund which is one of the parties in a treasury trade. | FundIdentification2 - Optional 0..1 |
| SubmittingParty | Specifies the party which submits a treasury trade to a matching system or to a settlement system or to a counterparty. | IPartyIdentification8Choice - Required 1..1 |
| TradeParty | Specifies the party which originated a treasury trade. This party may be the same as the submitting party. | IPartyIdentification8Choice - Required 1..1 |
TradeAmounts building block
Specifies the amounts of the non deliverable trade which is created. 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
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| TradingSideBuyAmount | Currency and amount bought in a foreign exchange trade. | IsoActiveOrHistoricCurrencyAndAmount - Required 1..1 |
| TradingSideSellAmount | Currency and amount sold in a foreign exchange trade. | IsoActiveOrHistoricCurrencyAndAmount - Required 1..1 |
| SettlementDate | Date on which the trade is settled, ie, the amounts are due. | IsoISODate - Required 1..1 |
AgreedRate building block
Specifies the rate agreed at the opening of a non deliverable trade. 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
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| ExchangeRate | The value of one currency expressed in relation to another currency. ExchangeRate expresses the ratio between UnitCurrency and QuotedCurrency (ExchangeRate = UnitCurrency/QuotedCurrency). | IsoBaseOneRate - Required 1..1 |
| UnitCurrency | Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP. | CurrencyCode - Optional 0..1 |
| QuotedCurrency | Currency into which the base currency is converted, in a currency exchange. | CurrencyCode - Optional 0..1 |
ValuationConditions building block
Specifies the valuation conditions of the non deliverable trade which is created. Set of parameters used to calculate the fixing rate to be applied to a non-deliverable agreement. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% NonDeliverableForwardValuationConditions2 recursion level 0 with max 1
class NonDeliverableForwardValuationConditions2{
SettlementCurrency ActiveOrHistoricCurrencyCode
ValuationDate IsoISODate
AdditionalValuationInformation IsoMax140Text
}
NonDeliverableForwardValuationConditions2 *-- "0..1" IPartyIdentification8Choice : SettlementParty
%% IPartyIdentification8Choice recursion level 1 with max 1
NonDeliverableForwardValuationConditions2 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| SettlementCurrency | Specifies the currency in which the non deliverable trade has to be settled ie the deliverable currency. | ActiveOrHistoricCurrencyCode - Required 1..1 |
| ValuationDate | Date at which the rate used for calculating the net amount to be settled is observed. | IsoISODate - Required 1..1 |
| AdditionalValuationInformation | Free format text that may contain valuation information such as the place, the time or the source of the rate. | IsoMax140Text - Optional 0..1 |
| SettlementParty | Party through which the settlement will take place. It may contain the BIC of a central settlement system eg CLSBUS33. | IPartyIdentification8Choice - Optional 0..1 |
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the CreateNonDeliverableForwardOpeningV02 implementation follows a specific implementaiton pattern. First of all, CreateNonDeliverableForwardOpeningV02 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, CreateNonDeliverableForwardOpeningV02Document implements IOuterDocument. Because CreateNonDeliverableForwardOpeningV02 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type CreateNonDeliverableForwardOpeningV02.
classDiagram
class IOuterRecord
CreateNonDeliverableForwardOpeningV02 --|> IOuterRecord : Implements
CreateNonDeliverableForwardOpeningV02Document --|> IOuterDocument~CreateNonDeliverableForwardOpeningV02~ : Implements
class IOuterDocument~CreateNonDeliverableForwardOpeningV02~ {
CreateNonDeliverableForwardOpeningV02 Message
}
Document wrapper for serialization
The only real purpose CreateNonDeliverableForwardOpeningV02Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:trea.001.001.02’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using CreateNonDeliverableForwardOpeningV02.ToDocument() method. The returned CreateNonDeliverableForwardOpeningV02Document value will serialize correctly according to ISO 20022 standards.
classDiagram
CreateNonDeliverableForwardOpeningV02Document *-- CreateNonDeliverableForwardOpeningV02 : 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:trea.001.001.02">
<CretNDFOpngV02>
<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>
<ValtnConds>
<!-- ValuationConditions inner content -->
</ValtnConds>
</CretNDFOpngV02>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_OzAFVdE8Ed-BzquC8wXy7w_421836002"
name="CreateNonDeliverableForwardOpeningV02"
definition="Scope
The CreateNonDeliverableForwardOpening message is sent by a participant to a central system or to a counterparty to notify the opening of a non deliverable trade.
Usage
The trading parties will send similar messages to the central settlement system and the central settlement system will send notifications to both parties."
registrationStatus="Registered"
messageSet="_wRx2x02rEeG_I4xRYCA_7g"
xmlTag="CretNDFOpngV02"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<messageBuildingBlock
xmi:id="_OzAFVtE8Ed-BzquC8wXy7w_579998049"
name="TradeInformation"
definition="Provides identification and date of the non deliverable trade which is created."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="TradInf"
complexType="_TJ8xgdp-Ed-ak6NoX_4Aeg_290674431" />
<messageBuildingBlock
xmi:id="_OzAFV9E8Ed-BzquC8wXy7w_1458268305"
name="TradingSideIdentification"
definition="Specifies the trading side of the non deliverable trade which is created."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="TradgSdId"
complexType="_PdKWsdp-Ed-ak6NoX_4Aeg_-1580495666" />
<messageBuildingBlock
xmi:id="_OzAFWNE8Ed-BzquC8wXy7w_1612496357"
name="CounterpartySideIdentification"
definition="Specifies the counterparty of the non deliverable trade which is created."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="CtrPtySdId"
complexType="_PdKWsdp-Ed-ak6NoX_4Aeg_-1580495666" />
<messageBuildingBlock
xmi:id="_OzAFWdE8Ed-BzquC8wXy7w_-659367564"
name="TradeAmounts"
definition="Specifies the amounts of the non deliverable trade which is created."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="TradAmts"
complexType="_TITy0tp-Ed-ak6NoX_4Aeg_290674075" />
<messageBuildingBlock
xmi:id="_OzAFWtE8Ed-BzquC8wXy7w_497805144"
name="AgreedRate"
definition="Specifies the rate agreed at the opening of a non deliverable trade."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="AgrdRate"
complexType="_QLW5ctp-Ed-ak6NoX_4Aeg_290674057" />
<messageBuildingBlock
xmi:id="_OzJ2UNE8Ed-BzquC8wXy7w_1979703277"
name="ValuationConditions"
definition="Specifies the valuation conditions of the non deliverable trade which is created."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="ValtnConds"
complexType="_TIAQw9p-Ed-ak6NoX_4Aeg_1813124879" />
<messageDefinitionIdentifier
businessArea="trea"
messageFunctionality="001"
flavour="001"
version="02" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.