Iso20022

NetReportV01

camt.088.001.01

The Net Report message is sent to a participant by a central system to provide details of the of the bi-lateral payment obligations, calculated by the central system per currency.

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
%% NetReportV01 recursion level 0 with max 0
NetReportV01 *-- "1..1" NetReportData1 : NetReportData
NetReportV01 *-- "1..1" IPartyIdentification73Choice : NetServiceParticipantIdentification
NetReportV01 *-- "0..1" IPartyIdentification73Choice : NetServiceCounterpartyIdentification
NetReportV01 *-- "1..1" NetObligation1 : NetObligation
NetReportV01 *-- "0..1" SupplementaryData1 : SupplementaryData

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

NetReportData building block

Specifies the meta data associated with the net report. Specifies the meta data associated with a net report. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% NetReportData1 recursion level 0 with max 1
class NetReportData1{
    MessageIdentification IsoMax35Text
    CreationDateTime IsoISODateTime
    NettingCutOffTime IsoISOTime
    ReportDate IsoISODate
    ValueDate IsoISODate
    ReportType IsoMax35Text
    NetServiceType IsoMax35Text
}
NetReportData1 *-- "0..1" IPartyIdentification73Choice : NetReportServicer
NetReportData1 *-- "0..1" Pagination : MessagePagination
%% IPartyIdentification73Choice recursion level 1 with max 1
%% Pagination recursion level 1 with max 1
class Pagination{
    PageNumber IsoMax5NumericText
    LastPageIndicator IsoYesNoIndicator
}

NetReportData1 members

Member name Description Data Type / Multiplicity
MessageIdentification Unique and unambiguous identifier for a message, as assigned by the Sender. This unique identifier can be used for cross-referencing purposes in subsequent messages. IsoMax35Text - Required 1..1
CreationDateTime Date and time at which the net report was generated. IsoISODateTime - Required 1..1
NettingCutOffTime Provides the cut off time that has been passed, resulting in the generation of the net report. IsoISOTime - Required 1..1
ReportDate Specifies the value date on which the net report was generated. IsoISODate - Required 1..1
ValueDate Specifies the value date for the trades used in the generation of the net report. IsoISODate - Required 1..1
ReportType Specifies the type of net report, indicating how the obligations have been calculated. IsoMax35Text - Optional 0..1
NetReportServicer Describes the central system responsible for generating the net report. IPartyIdentification73Choice - Optional 0..1
NetServiceType Describes the type of netting service supporting the net report. IsoMax35Text - Optional 0..1
MessagePagination Page number of the message (within the net report) and continuation indicator to indicate that the report is to continue or that the message is the last page of the report. Pagination - Optional 0..1

NetServiceParticipantIdentification building block

Describes the participant receiving the net report. Identification of a party by a choice between a BIC or a name and address or an LEI. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification73Choice recursion level 0 with max 1

PartyIdentification73Choice members

Member name Description Data Type / Multiplicity

NetServiceCounterpartyIdentification building block

Describes the counterparty participant involved in (all of) the obligations of the report. Identification of a party by a choice between a BIC or a name and address or an LEI. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification73Choice recursion level 0 with max 1

PartyIdentification73Choice members

Member name Description Data Type / Multiplicity

NetObligation building block

Provides the amount, direct parties or netting groups involved in the obligation. Describes the amount, direction and parties involved in a payment obligation between two participants (and their netting group or trading party) of a netting service. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% NetObligation1 recursion level 0 with max 1
class NetObligation1{
    ObligationIdentification IsoMax35Text
    Amount IsoActiveCurrencyAndAmount
    ObligationDirection PaymentReceipt1Code
    TransactionsNumber IsoMax10NumericText
}
NetObligation1 *-- "1..1" INettingIdentification1Choice : ParticipantNettingIdentification
NetObligation1 *-- "1..1" INettingIdentification1Choice : CounterpartyNettingIdentification
NetObligation1 *-- "0..1" IPartyIdentification73Choice : NetServiceCounterpartyIdentification
NetObligation1 *-- "0..1" SettlementParties29 : CounterpartySettlementInstructions
%% INettingIdentification1Choice recursion level 1 with max 1
%% INettingIdentification1Choice recursion level 1 with max 1
%% IPartyIdentification73Choice recursion level 1 with max 1
%% SettlementParties29 recursion level 1 with max 1
SettlementParties29 *-- "0..1" IPartyIdentification73Choice : DeliveryAgent
SettlementParties29 *-- "0..1" IPartyIdentification73Choice : Intermediary
SettlementParties29 *-- "1..1" IPartyIdentification73Choice : ReceivingAgent
SettlementParties29 *-- "0..1" IPartyIdentification73Choice : BeneficiaryInstitution

NetObligation1 members

Member name Description Data Type / Multiplicity
ObligationIdentification Unique identification for the obligation. IsoMax35Text - Required 1..1
Amount Amount and currency of the obligation. IsoActiveCurrencyAndAmount - Required 1..1
ParticipantNettingIdentification Describes the party or netting group (of the participant receiving the report) involved in the calculation of the obligation. INettingIdentification1Choice - Required 1..1
ObligationDirection Specifies the direction of the obligation. PaymentReceipt1Code - Required 1..1
CounterpartyNettingIdentification Describes the party or netting group (of the counterparty in the obligation) involved in the calculation of the obligation. INettingIdentification1Choice - Required 1..1
NetServiceCounterpartyIdentification Describes the counterparty participant involved in the obligation. IPartyIdentification73Choice - Optional 0..1
CounterpartySettlementInstructions Specifies the standard settlement instructions used to issue payment to the counterparty in order to settle the obligation. SettlementParties29 - Optional 0..1
TransactionsNumber Number of transactions used to calculate the obligation. This is used in reconciliation between the net report obligation and the previously provided transaction status updates. IsoMax10NumericText - Optional 0..1

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

classDiagram
    class IOuterRecord
    NetReportV01 --|> IOuterRecord : Implements
    NetReportV01Document --|> IOuterDocument~NetReportV01~ : Implements
    class IOuterDocument~NetReportV01~ {
        NetReportV01 Message
     }

Document wrapper for serialization

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

classDiagram
    NetReportV01Document *-- NetReportV01 : 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:camt.088.001.01">
    <NetRpt>
        <NetRptData>
            <!-- NetReportData inner content -->
        </NetRptData>
        <NetSvcPtcptId>
            <!-- NetServiceParticipantIdentification inner content -->
        </NetSvcPtcptId>
        <NetSvcCtrPtyId>
            <!-- NetServiceCounterpartyIdentification inner content -->
        </NetSvcCtrPtyId>
        <NetOblgtn>
            <!-- NetObligation inner content -->
        </NetOblgtn>
        <SplmtryData>
            <!-- SupplementaryData inner content -->
        </SplmtryData>
    </NetRpt>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_2YFYQJUlEeaYkf5FCqYMeA"
  nextVersions="_kBNA9QM-Ee2nqoJcXIhTdw"
  name="NetReportV01"
  definition="The Net Report message is sent to a participant by a central system to provide details of the of the bi-lateral payment obligations, calculated by the central system per currency."
  registrationStatus="Registered"
  messageSet="_nB3wITJaEeOX98kTVpuqCw"
  xmlTag="NetRpt"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <constraint
    xmi:id="_FPkMEJU1EeaYkf5FCqYMeA"
    nextVersions="_kBNA9wM-Ee2nqoJcXIhTdw"
    name="CounterpartyIdentificationRule"
    definition="NetServiceCounterpartyIdentification must only be used at this level if all of the underlying obligations are with a single counterparty."
    registrationStatus="Provisionally Registered" />
  <messageBuildingBlock
    xmi:id="_bs5gUJUrEeaYkf5FCqYMeA"
    nextVersions="_kBNA-QM-Ee2nqoJcXIhTdw"
    name="NetReportData"
    definition="Specifies the meta data associated with the net report."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="NetRptData"
    complexType="_e329QJUnEeaYkf5FCqYMeA" />
  <messageBuildingBlock
    xmi:id="_TX-x4JUtEeaYkf5FCqYMeA"
    nextVersions="_kBNA-wM-Ee2nqoJcXIhTdw"
    name="NetServiceParticipantIdentification"
    definition="Describes the participant receiving the net report."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="NetSvcPtcptId"
    complexType="_JJOcQSjIEeKnA5P_jl2DUw" />
  <messageBuildingBlock
    xmi:id="_98aukJU0EeaYkf5FCqYMeA"
    nextVersions="_kBNA_QM-Ee2nqoJcXIhTdw"
    name="NetServiceCounterpartyIdentification"
    definition="Describes the counterparty participant involved in (all of) the obligations of the report."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="NetSvcCtrPtyId"
    complexType="_JJOcQSjIEeKnA5P_jl2DUw" />
  <messageBuildingBlock
    xmi:id="_0OAIgJU0EeaYkf5FCqYMeA"
    nextVersions="_kBNA_wM-Ee2nqoJcXIhTdw"
    name="NetObligation"
    definition="Provides the amount, direct parties or netting groups involved in the obligation."
    registrationStatus="Provisionally Registered"
    minOccurs="1"
    xmlTag="NetOblgtn"
    complexType="_7NnNsJUuEeaYkf5FCqYMeA" />
  <messageBuildingBlock
    xmi:id="_RA5FEJU1EeaYkf5FCqYMeA"
    nextVersions="_kBNBAQM-Ee2nqoJcXIhTdw"
    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="camt"
    messageFunctionality="088"
    flavour="001"
    version="01" />
</messageDefinition>

ISO Building Blocks

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