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:
- report prices for one or several different financial instruments for one or several different trade dates,
- report statistical information about the valuation of a financial instrument,
- inform another party that the quotation of a financial instrument is suspended,
- report prices that are used for other purposes than the execution of investment funds orders. .
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

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: 
- report prices for one or several different financial instruments for one or several different trade dates,
- report statistical information about the valuation of a financial instrument,
- inform another party that the quotation of a financial instrument is suspended,
- report prices that are used for other purposes than the execution of investment funds orders.
."
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 "NEWP" then CancellationIdentification must not be present."
registrationStatus="Provisionally Registered"
expression="<RuleDefinition><ComplexRule xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ComplexRule"><mustBe><connector>AND</connector><BooleanRule xsi:type="Absence"><leftOperand>/CancellationIdentification</leftOperand></BooleanRule></mustBe><onCondition><connector>AND</connector><BooleanRule xsi:type="EqualToValue"><leftOperand>/Function</leftOperand><rightOperand>NewPriceReport</rightOperand></BooleanRule></onCondition></ComplexRule></RuleDefinition>" />
<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.