PriceReportV04

reda.001.001.04

SCOPE

A report provider, for example, a transfer agent, fund accountant or market data provider, sends the PriceReport message to the report recipient, for example, a fund management company, transfer agent, market data provider, regulator or any other interested party to provide the net asset value and price information for financial instruments on specific trade dates and, optionally, to quote price variation information.

USAGE

The PriceReport message is sent by the report provider to the report recipient to:

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
%% PriceReportV04 recursion level 0 with max 0
class PriceReportV04{
    PriceReportIdentification IsoMax35Text
    Function PriceReportFunction1Code
    CancellationIdentification IsoMax35Text
}
PriceReportV04 *-- "1..1" MessageIdentification1 : MessageIdentification
PriceReportV04 *-- "0..1" AdditionalReference3 : PoolReference
PriceReportV04 *-- "0..1" AdditionalReference3 : PreviousReference
PriceReportV04 *-- "0..1" AdditionalReference3 : RelatedReference
PriceReportV04 *-- "1..1" Pagination : MessagePagination
PriceReportV04 *-- "1..1" PriceValuation4 : PriceValuationDetails
PriceReportV04 *-- "0..1" Extension1 : Extension
  

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

MessageIdentification building block

Reference that uniquely identifies a message from a business application standpoint. 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

PoolReference building block

Collective reference identifying a set of messages. References a related message or provides another reference, such as a pool reference, linking a set of messages. The party which issued the related reference may be the Sender of the referenced message or a party other than the Sender. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AdditionalReference3 recursion level 0 with max 1
class AdditionalReference3{
    Reference IsoMax35Text
    MessageName IsoMax35Text
}
AdditionalReference3 *-- "0..1" IPartyIdentification2Choice : ReferenceIssuer
%% IPartyIdentification2Choice recursion level 1 with max 1
  

AdditionalReference3 members

Member name Description Data Type / Multiplicity
Reference Business reference of a message assigned by the party issuing the message. This reference must be unique amongst all messages of the same name sent by the same party. IsoMax35Text - Required 1..1
ReferenceIssuer Issuer of the reference. IPartyIdentification2Choice - Optional 0..1
MessageName Name of a message. IsoMax35Text - Optional 0..1

PreviousReference building block

Reference to a linked message that was previously sent. References a related message or provides another reference, such as a pool reference, linking a set of messages. The party which issued the related reference may be the Sender of the referenced message or a party other than the Sender. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AdditionalReference3 recursion level 0 with max 1
class AdditionalReference3{
    Reference IsoMax35Text
    MessageName IsoMax35Text
}
AdditionalReference3 *-- "0..1" IPartyIdentification2Choice : ReferenceIssuer
%% IPartyIdentification2Choice recursion level 1 with max 1
  

AdditionalReference3 members

Member name Description Data Type / Multiplicity
Reference Business reference of a message assigned by the party issuing the message. This reference must be unique amongst all messages of the same name sent by the same party. IsoMax35Text - Required 1..1
ReferenceIssuer Issuer of the reference. IPartyIdentification2Choice - Optional 0..1
MessageName Name of a message. IsoMax35Text - Optional 0..1

RelatedReference building block

Reference to a linked message that was previously received. References a related message or provides another reference, such as a pool reference, linking a set of messages. The party which issued the related reference may be the Sender of the referenced message or a party other than the Sender. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AdditionalReference3 recursion level 0 with max 1
class AdditionalReference3{
    Reference IsoMax35Text
    MessageName IsoMax35Text
}
AdditionalReference3 *-- "0..1" IPartyIdentification2Choice : ReferenceIssuer
%% IPartyIdentification2Choice recursion level 1 with max 1
  

AdditionalReference3 members

Member name Description Data Type / Multiplicity
Reference Business reference of a message assigned by the party issuing the message. This reference must be unique amongst all messages of the same name sent by the same party. IsoMax35Text - Required 1..1
ReferenceIssuer Issuer of the reference. IPartyIdentification2Choice - Optional 0..1
MessageName Name of a message. IsoMax35Text - Optional 0..1

MessagePagination building block

Pagination of the message. Number used to sequence pages when it is not possible for data to be conveyed in a single message and the data has to be split across several pages (messages). For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Pagination recursion level 0 with max 1
class Pagination{
    PageNumber IsoMax5NumericText
    LastPageIndicator IsoYesNoIndicator
}
  

Pagination members

Member name Description Data Type / Multiplicity
PageNumber Page number. IsoMax5NumericText - Required 1..1
LastPageIndicator Indicates the last page. IsoYesNoIndicator - Required 1..1

PriceReportIdentification building block

Unique and unambiguous identifier for the price report, as assigned by the reporting party. Specifies a character string with a maximum length of 35 characters. For comparison, see the ISO20022 official specification This message is declared as Max35Text in the ISO specification. In our implementation, it is represented in source code as IsoMax35Text. Due to global using directives, it is treated as a System.String by the compiler and runtime.

Function building block

Function of the price report, that is, whether the price report is a new price report or a replacement of some kind. Specifies the function of the price report. For comparison, see the ISO20022 official specification This message is declared as PriceReportFunction1Code in the ISO specification. In our implementation, it is represented in source code as PriceReportFunction1Code. Due to global using directives, it is treated as a System.String by the compiler and runtime.

CancellationIdentification building block

Unique and unambiguous identifier for the cancellation of the previous price report, as assigned by the reporting party. Specifies a character string with a maximum length of 35 characters. For comparison, see the ISO20022 official specification This message is declared as Max35Text in the ISO specification. In our implementation, it is represented in source code as IsoMax35Text. Due to global using directives, it is treated as a System.String by the compiler and runtime.

PriceValuationDetails building block

Information related to the price valuation of a financial instrument. Calculation of the net asset value for an investment fund/fund class. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% PriceValuation4 recursion level 0 with max 1
class PriceValuation4{
    Identification IsoMax35Text
    TotalNAV IsoActiveOrHistoricCurrencyAndAmount
    ValuationType ValuationTiming1Code
    ValuationFrequency EventFrequency1Code
    OfficialValuationIndicator IsoYesNoIndicator
    SuspendedIndicator IsoYesNoIndicator
}
PriceValuation4 *-- "0..1" IDateAndDateTimeChoice : ValuationDateTime
PriceValuation4 *-- "1..1" IDateAndDateTimeChoice : NAVDateTime
PriceValuation4 *-- "1..1" FinancialInstrument8 : FinancialInstrumentDetails
PriceValuation4 *-- "0..1" IPartyIdentification2Choice : FundManagementCompany
PriceValuation4 *-- "0..1" FinancialInstrumentQuantity1 : TotalUnitsNumber
PriceValuation4 *-- "0..1" IDateAndDateTimeChoice : NextValuationDateTime
PriceValuation4 *-- "0..1" IDateAndDateTimeChoice : PreviousValuationDateTime
PriceValuation4 *-- "0..0" UnitPrice15 : PriceDetails
PriceValuation4 *-- "0..0" ValuationStatistics3 : ValuationStatistics
PriceValuation4 *-- "0..1" PerformanceFactors1 : PerformanceDetails
%% IDateAndDateTimeChoice recursion level 1 with max 1
%% IDateAndDateTimeChoice recursion level 1 with max 1
%% FinancialInstrument8 recursion level 1 with max 1
class FinancialInstrument8{
    Name IsoMax350Text
    SupplementaryIdentification IsoMax35Text
    DenominationCurrency ActiveOrHistoricCurrencyCode
    ClassType IsoMax35Text
    SecuritiesForm FormOfSecurity1Code
    DistributionPolicy DistributionPolicy1Code
    DualFundIndicator IsoYesNoIndicator
}
FinancialInstrument8 *-- "1..10" ISecurityIdentification3Choice : Identification
%% IPartyIdentification2Choice recursion level 1 with max 1
%% FinancialInstrumentQuantity1 recursion level 1 with max 1
class FinancialInstrumentQuantity1{
    Unit IsoDecimalNumber
}
%% IDateAndDateTimeChoice recursion level 1 with max 1
%% IDateAndDateTimeChoice recursion level 1 with max 1
%% UnitPrice15 recursion level 1 with max 1
class UnitPrice15{
    Type TypeOfPrice9Code
    ExtendedType IsoExtended350Code
    PriceMethod PriceMethod1Code
    ForExecutionIndicator IsoYesNoIndicator
    CumDividendIndicator IsoYesNoIndicator
    CalculationBasis IsoPercentageRate
    EstimatedPriceIndicator IsoYesNoIndicator
    NumberOfDaysAccrued IsoNumber
    TaxableIncomePerShare IsoActiveOrHistoricCurrencyAnd13DecimalAmount
    TaxableIncomePerShareCalculated TaxableIncomePerShareCalculated2Code
    ExtendedTaxableIncomePerShareCalculated IsoExtended350Code
    TaxableIncomePerDividend IsoActiveOrHistoricCurrencyAnd13DecimalAmount
    EUDividendStatus EUDividendStatus1Code
    ExtendedEUDividendStatus IsoExtended350Code
}
UnitPrice15 *-- "1..0" PriceValue1 : ValueInInvestmentCurrency
UnitPrice15 *-- "0..0" PriceValue1 : ValueInAlternativeCurrency
UnitPrice15 *-- "0..0" Charge15 : ChargeDetails
UnitPrice15 *-- "0..0" Tax17 : TaxLiabilityDetails
UnitPrice15 *-- "0..0" Tax17 : TaxRefundDetails
%% ValuationStatistics3 recursion level 1 with max 1
class ValuationStatistics3{
    Currency ActiveOrHistoricCurrencyCode
    Yield IsoPercentageRate
}
ValuationStatistics3 *-- "1..1" PriceType2 : PriceTypeChangeBasis
ValuationStatistics3 *-- "1..1" PriceValueChange1 : PriceChange
ValuationStatistics3 *-- "0..1" StatisticsByPredefinedTimePeriods2 : ByPredefinedTimePeriods
ValuationStatistics3 *-- "0..0" StatisticsByUserDefinedTimePeriod2 : ByUserDefinedTimePeriod
%% PerformanceFactors1 recursion level 1 with max 1
class PerformanceFactors1{
    CorporateActionFactor IsoDecimalNumber
    CumulativeCorporateActionFactor IsoDecimalNumber
    NormalPerformance IsoDecimalNumber
}
PerformanceFactors1 *-- "0..1" DatePeriodDetails : AccumulationPeriod
  

PriceValuation4 members

Member name Description Data Type / Multiplicity
Identification Unique technical identifier for an instance of a price valuation within a price report, as assigned by the issuer of the report. IsoMax35Text - Optional 0..1
ValuationDateTime Date and time of the price valuation for the investment fund/fund class. IDateAndDateTimeChoice - Optional 0..1
NAVDateTime Date and time at which a price is applied, according to the terms stated in the prospectus. The NAV date is also known as the trade date. The NAV date becomes the trade date in an order. IDateAndDateTimeChoice - Required 1..1
FinancialInstrumentDetails Investment fund class for which the net asset value is calculated. FinancialInstrument8 - Required 1..1
FundManagementCompany Issuer of the fund. IPartyIdentification2Choice - Optional 0..1
TotalNAV Value of all the holdings, less the fund’s liabilities, attributable to a specific investment fund class. IsoActiveOrHistoricCurrencyAndAmount - Unknown 0..0
TotalUnitsNumber Total number of investment fund class units that have been issued. FinancialInstrumentQuantity1 - Optional 0..1
NextValuationDateTime Date and time of the next price valuation for the investment fund/fund class. IDateAndDateTimeChoice - Optional 0..1
PreviousValuationDateTime Date and time of the previous price valuation for the investment fund/fund class. IDateAndDateTimeChoice - Optional 0..1
ValuationType Specifies how the valuation is done, based on the schedule stated in the prospectus. ValuationTiming1Code - Required 1..1
ValuationFrequency Frequency of the valuation. EventFrequency1Code - Optional 0..1
OfficialValuationIndicator Indicates whether the valuation is an official valuation. IsoYesNoIndicator - Required 1..1
SuspendedIndicator Indicates whether the valuation of the investment fund class is suspended. IsoYesNoIndicator - Required 1..1
PriceDetails Amount of money for which goods or services are offered, sold, or bought. UnitPrice15 - Unknown 0..0
ValuationStatistics Information related to the price variations of an investment fund class. ValuationStatistics3 - Unknown 0..0
PerformanceDetails Factors that give indications about the performance of a fund. PerformanceFactors1 - Optional 0..1

Extension 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
%% Extension1 recursion level 0 with max 1
class Extension1{
    PlaceAndName IsoMax350Text
    Text IsoMax350Text
}
  

Extension1 members

Member name Description Data Type / Multiplicity
PlaceAndName Name qualifying the information provided in the Text field, and place where this information should be inserted. IsoMax350Text - Required 1..1
Text Text of the extension. IsoMax350Text - Required 1..1

Extensibility and generalization considerations

To facilitate generalized design patterns in the system, the PriceReportV04 implementation follows a specific implementaiton pattern. First of all, PriceReportV04 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, PriceReportV04Document implements IOuterDocument. Because PriceReportV04 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type PriceReportV04.

classDiagram
    class IOuterRecord
    PriceReportV04 --|> IOuterRecord : Implements
    PriceReportV04Document --|> IOuterDocument~PriceReportV04~ : Implements
    class IOuterDocument~PriceReportV04~ {
        PriceReportV04 Message
     }
  

Document wrapper for serialization

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

classDiagram
    PriceReportV04Document *-- PriceReportV04 : 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:reda.001.001.04">
    <PricRpt>
        <MsgId>
            <!-- MessageIdentification inner content -->
        </MsgId>
        <PoolRef>
            <!-- PoolReference inner content -->
        </PoolRef>
        <PrvsRef>
            <!-- PreviousReference inner content -->
        </PrvsRef>
        <RltdRef>
            <!-- RelatedReference inner content -->
        </RltdRef>
        <MsgPgntn>
            <!-- MessagePagination inner content -->
        </MsgPgntn>
        <PricRptId>
            <!-- PriceReportIdentification inner content -->
        </PricRptId>
        <Fctn>
            <!-- Function inner content -->
        </Fctn>
        <CxlId>
            <!-- CancellationIdentification inner content -->
        </CxlId>
        <PricValtnDtls>
            <!-- PriceValuationDetails inner content -->
        </PricValtnDtls>
        <Xtnsn>
            <!-- Extension inner content -->
        </Xtnsn>
    </PricRpt>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_IOkQsRj3EeKxeog5DTmtgg"
  previousVersion="_ZtdTrNEvEd-BzquC8wXy7w_1235947940"
  name="PriceReportV04"
  definition="SCOPE&#xA;&#xA;A report provider, for example, a transfer agent, fund accountant or market data provider, sends the PriceReport message to the report recipient, for example, a fund management company, transfer agent, market data provider, regulator or any other interested party to provide the net asset value and price information for financial instruments on specific trade dates and, optionally, to quote price variation information.&#xA;&#xA;USAGE&#xA;&#xA;The PriceReport message is sent by the report provider to the report recipient to: &#xA;- report prices for one or several different financial instruments for one or several different trade dates,&#xA;- report statistical information about the valuation of a financial instrument,&#xA;- inform another party that the quotation of a financial instrument is suspended,&#xA;- report prices that are used for other purposes than the execution of investment funds orders.&#xA;."
  registrationStatus="Registered"
  messageSet="_wFQdsE2rEeG_I4xRYCA_7g _hijK0WiLEeOuqdLlpUIWBw _qCumkAFwEeu2__1EbNXzuA"
  xmlTag="PricRpt"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <constraint
    xmi:id="_JT1jWhl-EeKxsrht2duUcg"
    name="NewPriceReportRule"
    definition="If Function is &quot;NEWP&quot; then CancellationIdentification must not be present."
    registrationStatus="Provisionally Registered"
    expression="&lt;RuleDefinition&gt;&lt;ComplexRule xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xsi:type=&quot;ComplexRule&quot;&gt;&lt;mustBe&gt;&lt;connector&gt;AND&lt;/connector&gt;&lt;BooleanRule xsi:type=&quot;Absence&quot;&gt;&lt;leftOperand&gt;/CancellationIdentification&lt;/leftOperand&gt;&lt;/BooleanRule&gt;&lt;/mustBe&gt;&lt;onCondition&gt;&lt;connector&gt;AND&lt;/connector&gt;&lt;BooleanRule xsi:type=&quot;EqualToValue&quot;&gt;&lt;leftOperand&gt;/Function&lt;/leftOperand&gt;&lt;rightOperand&gt;NewPriceReport&lt;/rightOperand&gt;&lt;/BooleanRule&gt;&lt;/onCondition&gt;&lt;/ComplexRule&gt;&lt;/RuleDefinition&gt;" />
  <messageBuildingBlock
    xmi:id="_IOkQtxj3EeKxeog5DTmtgg"
    name="MessageIdentification"
    definition="Reference that uniquely identifies a message from a business application standpoint."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="MsgId"
    complexType="_Q7pG5Np-Ed-ak6NoX_4Aeg_-967008570" />
  <messageBuildingBlock
    xmi:id="_IOkQuxj3EeKxeog5DTmtgg"
    name="PoolReference"
    definition="Collective reference identifying a set of messages."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="PoolRef"
    complexType="_Q6vvAdp-Ed-ak6NoX_4Aeg_2101402955" />
  <messageBuildingBlock
    xmi:id="_IOkQvxj3EeKxeog5DTmtgg"
    name="PreviousReference"
    definition="Reference to a linked message that was previously sent."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="PrvsRef"
    complexType="_Q6vvAdp-Ed-ak6NoX_4Aeg_2101402955" />
  <messageBuildingBlock
    xmi:id="_IOkQwxj3EeKxeog5DTmtgg"
    name="RelatedReference"
    definition="Reference to a linked message that was previously received."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="RltdRef"
    complexType="_Q6vvAdp-Ed-ak6NoX_4Aeg_2101402955" />
  <messageBuildingBlock
    xmi:id="_IOkQxxj3EeKxeog5DTmtgg"
    name="MessagePagination"
    definition="Pagination of the message."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="MsgPgntn"
    complexType="_Q65gBdp-Ed-ak6NoX_4Aeg_-21330104" />
  <messageBuildingBlock
    xmi:id="__CwxkBl8EeKxsrht2duUcg"
    name="PriceReportIdentification"
    definition="Unique and unambiguous identifier for the price report, as assigned by the reporting party."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="PricRptId"
    simpleType="_YW1tKdp-Ed-ak6NoX_4Aeg_1913463446" />
  <messageBuildingBlock
    xmi:id="_TO56wBl9EeKxsrht2duUcg"
    name="Function"
    definition="Function of the price report, that is, whether the price report is a new price report or a replacement of some kind."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="Fctn"
    simpleType="_ABtQoBl-EeKxsrht2duUcg" />
  <messageBuildingBlock
    xmi:id="_CDo2sBl_EeKxsrht2duUcg"
    name="CancellationIdentification"
    definition="Unique and unambiguous identifier for the cancellation of the previous price report, as assigned by the reporting party."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="CxlId"
    simpleType="_YW1tKdp-Ed-ak6NoX_4Aeg_1913463446" />
  <messageBuildingBlock
    xmi:id="_IOkQyxj3EeKxeog5DTmtgg"
    name="PriceValuationDetails"
    definition="Information related to the price valuation of a financial instrument."
    registrationStatus="Provisionally Registered"
    minOccurs="1"
    xmlTag="PricValtnDtls"
    complexType="_et2_cRl_EeKxsrht2duUcg" />
  <messageBuildingBlock
    xmi:id="_IOkQzxj3EeKxeog5DTmtgg"
    name="Extension"
    definition="Additional information that cannot be captured in the structured elements and/or any other specific block."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="Xtnsn"
    complexType="_Q6vvCNp-Ed-ak6NoX_4Aeg_1503007069" />
  <messageDefinitionIdentifier
    businessArea="reda"
    messageFunctionality="001"
    flavour="001"
    version="04" />
</messageDefinition>

ISO Building Blocks

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