CancelNonDeliverableForwardValuationV02

trea.006.001.02

Scope The CancelNonDeliverableForwardValuation message is sent by a participant to a central system or to a counterparty to notify the cancellation of the valuation of a non deliverable trade previously confirmed by the sender. Usage The message will contain a Related Reference to link it to the previously sent notification. It may contain a reason for cancellation.

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
%% CancelNonDeliverableForwardValuationV02 recursion level 0 with max 0
CancelNonDeliverableForwardValuationV02 *-- "1..1" TradeAgreement2 : TradeInformation
CancelNonDeliverableForwardValuationV02 *-- "0..1" TradePartyIdentification3 : TradingSideIdentification
CancelNonDeliverableForwardValuationV02 *-- "0..1" TradePartyIdentification3 : CounterpartySideIdentification
CancelNonDeliverableForwardValuationV02 *-- "0..1" AmountsAndValueDate1 : TradeAmounts
CancelNonDeliverableForwardValuationV02 *-- "0..1" AgreedRate1 : ValuationRate
CancelNonDeliverableForwardValuationV02 *-- "0..1" ValuationData2 : ValuationInformation
  

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

TradeInformation building block

Provides references and date of the valuation of the non deliverable trade which is cancelled. 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
%% TradeAgreement2 recursion level 0 with max 1
class TradeAgreement2{
    TradeDate IsoISODate
    NotificationIdentification IsoMax35Text
    CommonReference IsoMax35Text
    AmendOrCancelReason IsoMax35Text
    RelatedReference IsoMax35Text
}
  

TradeAgreement2 members

Member name Description Data Type / Multiplicity
TradeDate Date at which the trading parties have agreed to amend or cancel 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
AmendOrCancelReason Describes the reason for the cancellation or the amendment. IsoMax35Text - Optional 0..1
RelatedReference Refers to the identification of a previous event in the life of a trade which is amended or cancelled. IsoMax35Text - Required 1..1

TradingSideIdentification building block

Specifies the trading side of the non deliverable trade which is cancelled. 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 cancelled. 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 valuation of the non deliverable trade which is cancelled. 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

ValuationRate building block

Specifies the valuation rate of the valuation of the non deliverable trade which is cancelled. 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

ValuationInformation building block

Specifies the valuation information of the valuation of the non deliverable trade which is cancelled. Set of data which contains the link to the opening of the non deliverable trade and supplementary information on its valuation. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ValuationData2 recursion level 0 with max 1
class ValuationData2{
    ValuationReference IsoMax35Text
    SettlementCurrency ActiveOrHistoricCurrencyCode
    AdditionalValuationInformation IsoMax140Text
}
ValuationData2 *-- "0..1" IPartyIdentification8Choice : SettlementParty
%% IPartyIdentification8Choice recursion level 1 with max 1
  

ValuationData2 members

Member name Description Data Type / Multiplicity
ValuationReference Reference to the latest trade identification of the NDF opening trade. IsoMax35Text - Required 1..1
SettlementCurrency Specifies the currency in which the non deliverable trade has to be settled ie the deliverable currency. ActiveOrHistoricCurrencyCode - Optional 0..1
AdditionalValuationInformation Free format text that may contain information on the valuation such as the currency, 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 CancelNonDeliverableForwardValuationV02 implementation follows a specific implementaiton pattern. First of all, CancelNonDeliverableForwardValuationV02 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, CancelNonDeliverableForwardValuationV02Document implements IOuterDocument. Because CancelNonDeliverableForwardValuationV02 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type CancelNonDeliverableForwardValuationV02.

classDiagram
    class IOuterRecord
    CancelNonDeliverableForwardValuationV02 --|> IOuterRecord : Implements
    CancelNonDeliverableForwardValuationV02Document --|> IOuterDocument~CancelNonDeliverableForwardValuationV02~ : Implements
    class IOuterDocument~CancelNonDeliverableForwardValuationV02~ {
        CancelNonDeliverableForwardValuationV02 Message
     }
  

Document wrapper for serialization

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

classDiagram
    CancelNonDeliverableForwardValuationV02Document *-- CancelNonDeliverableForwardValuationV02 : 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.006.001.02">
    <CclNDFValtnV02>
        <TradInf>
            <!-- TradeInformation inner content -->
        </TradInf>
        <TradgSdId>
            <!-- TradingSideIdentification inner content -->
        </TradgSdId>
        <CtrPtySdId>
            <!-- CounterpartySideIdentification inner content -->
        </CtrPtySdId>
        <TradAmts>
            <!-- TradeAmounts inner content -->
        </TradAmts>
        <ValtnRate>
            <!-- ValuationRate inner content -->
        </ValtnRate>
        <ValtnInf>
            <!-- ValuationInformation inner content -->
        </ValtnInf>
    </CclNDFValtnV02>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_MYoUotE8Ed-BzquC8wXy7w_-340131062"
  name="CancelNonDeliverableForwardValuationV02"
  definition="Scope&#xD;&#xA;The CancelNonDeliverableForwardValuation message is sent by a participant to a central system or to a counterparty to notify the cancellation of the valuation of a non deliverable trade previously confirmed by the sender.&#xD;&#xA;Usage&#xD;&#xA;The message will contain a Related Reference to link it to the previously sent notification. It may contain a reason for cancellation."
  registrationStatus="Registered"
  messageSet="_wRx2x02rEeG_I4xRYCA_7g"
  xmlTag="CclNDFValtnV02"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_MYoUo9E8Ed-BzquC8wXy7w_-745317673"
    name="TradeInformation"
    definition="Provides references and date of the valuation of the non deliverable trade which is cancelled."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="TradInf"
    complexType="_TJ8xhdp-Ed-ak6NoX_4Aeg_-401775147" />
  <messageBuildingBlock
    xmi:id="_MYoUpNE8Ed-BzquC8wXy7w_200370128"
    name="TradingSideIdentification"
    definition="Specifies the trading side of the non deliverable trade which is cancelled."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="TradgSdId"
    complexType="_PdKWsdp-Ed-ak6NoX_4Aeg_-1580495666" />
  <messageBuildingBlock
    xmi:id="_MYoUpdE8Ed-BzquC8wXy7w_67383181"
    name="CounterpartySideIdentification"
    definition="Specifies the counterparty of the non deliverable trade which is cancelled."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="CtrPtySdId"
    complexType="_PdKWsdp-Ed-ak6NoX_4Aeg_-1580495666" />
  <messageBuildingBlock
    xmi:id="_MYoUptE8Ed-BzquC8wXy7w_-761938752"
    name="TradeAmounts"
    definition="Specifies the amounts of the valuation of the non deliverable trade which is cancelled."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="TradAmts"
    complexType="_TITy0tp-Ed-ak6NoX_4Aeg_290674075" />
  <messageBuildingBlock
    xmi:id="_MYoUp9E8Ed-BzquC8wXy7w_-748089195"
    name="ValuationRate"
    definition="Specifies the valuation rate of the valuation of the non deliverable trade which is cancelled."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="ValtnRate"
    complexType="_QLW5ctp-Ed-ak6NoX_4Aeg_290674057" />
  <messageBuildingBlock
    xmi:id="_MYoUqNE8Ed-BzquC8wXy7w_-750859823"
    name="ValuationInformation"
    definition="Specifies the valuation information of the valuation of the non deliverable trade which is cancelled."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="ValtnInf"
    complexType="_TIKBxNp-Ed-ak6NoX_4Aeg_-1153647347" />
  <messageDefinitionIdentifier
    businessArea="trea"
    messageFunctionality="006"
    flavour="001"
    version="02" />
</messageDefinition>

ISO Building Blocks

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