IssuerFinancials
RIXML 2.5 Element
Contains financial data items pertinent to an issuer organization, such as earnings, revenue, or market capitalization. The issuerFinancialsType attribute defines the specific type of financial metric being reported.
Usage
Optional child of Issuer element with zero-or-more cardinality. Requires issuerFinancialsType attribute from IssuerFinancialsTypeEnum list. Contains FinancialValue elements with the actual data.
Business Context
Provides company-level financial metrics essential for fundamental analysis and issuer evaluation. Supports research workflows by standardizing how key corporate financial data is communicated across different research platforms and systems.
Specification Guide
Overview
IssuerFinancials is a container element holding financial data and metrics that pertain to an issuing entity (a company or organisation) rather than to individual securities it has issued. It carries quantitative data such as revenue, earnings, market capitalisation and other fundamental metrics, classified by the required issuerFinancialsType attribute drawn from IssuerFinancialsTypeEnum. The element sits within the context package of a research Product, specifically inside Issuer under IssuerDetails, and provides the structured fundamental-analysis data that downstream systems use for valuation, screening and comparative analysis (sources: data-dictionary-2.5.1 p.52, user-guide-2.3.1 p.36, level-one-2.5 p.18).
Usage
IssuerFinancials is an optional child of Issuer with zero-or-more cardinality, allowing multiple instances per issuer so publishers can report several different financial metrics (e.g. one instance for Earnings, another for Revenue, another for MarketCap) (sources: level-one-2.3 p.18, level-one-2.4 p.18, level-one-2.5 p.18). Each instance must specify issuerFinancialsType to classify the financial metric being reported, and typically contains one or more FinancialValue child elements that hold the actual numerical data points (often one per period or scenario). Optional children include Currency and Source for data attribution [data-dictionary-2.5.1 p.52]. Optional attributes provide accounting and temporal context: gaapType (from FinancialStatementGAAPTypeEnum) identifies the accounting standard, restated flags restated figures, proForma flags hypothetical/adjusted figures, and year-type and prior-current attributes provide period context (sources: data-dictionary-2.4 p.49, user-guide-2.3.1 p.36). From v2.2 onwards, the displayName attribute allows publishers to present a value under an alternative label (e.g. "Turnover" rather than "Sales") while preserving the standardised underlying type [release-notes-2.2 p.3].
Rules
- MUSTWhen IssuerFinancials is present, issuerFinancialsType must be supplied with a value from IssuerFinancialsTypeEnum to classify the financial metric.[RIXML Level One Addendum v2.3.1 p.18] [RIXML Research Data Dictionary v2.4 p.49] [RIXML Research Data Dictionary v2.5.1 p.52] [RIXML Research Suite Data Dictionary v3.0 (DRAFT) p.53]↗
- SHOULDIssuerFinancials should contain at least one FinancialValue child carrying the actual numerical data point(s).[RIXML Research Data Dictionary v2.4 p.49] [RIXML Research Data Dictionary v2.5.1 p.52]
- SHOULDFinancial values reported under IssuerFinancials should specify their currency denomination using an ISO 4217 three-letter code via the Currency child or the currency attribute, so figures can be interpreted unambiguously in multi-currency contexts.[Morning Call Report (Advanced) Sample v2.4]↗ [Company Report (Advanced) Sample v2.4]↗ [RIXML Release Notes v2.2 p.3]
- SHOULDWhen reporting estimates, each FinancialValue inside IssuerFinancials should set estimateActual so consumers can distinguish estimated from actual data.[Company Report (Advanced) Sample v2.4]↗
- INFORMATIVEDilution concepts do not apply to issuer-level financial data; the dilution attribute and IssuerFinancialQualifierEnum were removed from IssuerFinancials in v2.1 in favour of separate gaapType, restated and proForma attributes.[RIXML Release Notes v2.1 p.3]
Relationships
- child-ofIssuer — IssuerFinancials is an optional, repeatable child of Issuer (within IssuerDetails) and provides the issuer-level financial metrics for that issuer.
- containsFinancialValue — IssuerFinancials aggregates one or more FinancialValue children that carry the actual numerical data points (e.g. across periods or scenarios).
- containsCurrency — IssuerFinancials may include a Currency child to denominate its financial values; from v2.2 the currency content is restricted to ISO 4217 codes.
- containsSource — IssuerFinancials may include a Source child providing data attribution for the financial values (e.g. consensus provider).
- classified-byIssuerFinancialsTypeEnum — The required issuerFinancialsType takes its value from IssuerFinancialsTypeEnum, identifying the specific metric (e.g. Earnings, Revenue, MarketCap).
- qualified-byFinancialStatementGAAPTypeEnum — The optional gaapType (added in v2.1) takes values from FinancialStatementGAAPTypeEnum to identify the accounting standard underlying the figures.
- parallel-toSecurityFinancials — IssuerFinancials is the issuer-level counterpart to SecurityFinancials; the two share most attribute conventions but IssuerFinancials omits dilution-related concepts that only apply at the security level.
Where It Fits
Canonical Path
Children
Definition
| Type | |
| Namespace | http://www.rixml.org/2017/9/RIXML |
| Min Occurs | 1 |
| Max Occurs | 1 |
Attributes
gaapTypeFinancialStatementGAAPTypeEnum |
Generally Accepted Accounting Principles. optionalSince 2.1 |
restatedYesNoEnum |
To state in a new form a company's financial statements, perhaps to reflect a current period item back through prior periods. optionalSince 2.1 |
proFormaYesNoEnum |
A hypothetical financial model based on a set of assumptions. optionalSince 2.1 |
publisherDefinedValuestring |
For specifying other IM systems. optionalSince 2.1 |
displayNamestring |
A descriptive name of the index suitable for display purposes. optionalSince 2.2 |
yearTypeYearTypeEnum |
Indicates whether the year specified is a fiscal year or calendar year optionalSince 2.1 |
priorCurrentPriorCurrentTypeEnum |
Used to indicate whether the rating is current or prior (current is the default). Prior is only used to give reference for a change from a prior rating. Prior is used to indicate what the prior figure was for the period specified in order to give context to the current figure, not to provide the figure for a prior time period. optionalSince 2.1 |
issuerFinancialsTypeIssuerFinancialsTypeEnum |
requiredSince 2.1 |
Children
CurrencyISO4217CurrencyType0..1 |
Indicates the currency of the issuer financials. Represented by the three letter alpha code defined by ISO 4217. optionalSince 2.1 |
Sourcestring0..1 |
Free-text tag to indicate the source of the numbers. Example: the name of the company that provides the consensus figures. optionalSince 2.1 |
FinancialValueFinancialValueType1..unbounded |
requiredSince 2.1 |
Example
<IssuerFinancials issuerFinancialsType="Yes">
<FinancialValue> ... </FinancialValue>
</IssuerFinancials>Version History
displayNamev2.1 — Significant restructuring: the legacy IssuerFinancialQualifierEnum and its issuerFinancialQualifier attribute were removed, and three independent attributes were introduced in their place: gaapType (using FinancialStatementGAAPTypeEnum), restated and proForma. This aligned the element with the parallel restructuring of SecurityFinancials, while omitting dilution concepts that are not meaningful at the issuer level [release-notes-2.1 p.3].
v2.2 — Currency content was tightened to ISO 4217 codes (via ISO4217CurrencyType), and a new optional displayName attribute was added to let publishers display alternative labels (e.g. "Turnover" for "Sales") without changing the underlying issuerFinancialsType classification [release-notes-2.2 p.3].
v2.3 – v2.5 — Structure stabilised. The element remained an optional, repeatable child of Issuer requiring issuerFinancialsType and supporting FinancialValue, Currency and Source children plus accounting and temporal attributes (sources: level-one-2.3 p.18, level-one-2.4 p.18, level-one-2.5 p.18, data-dictionary-2.5.1 p.52).
v3.0 (draft) — The element is repositioned inside a new IssuerFinancialsList container, with its content explicitly typed as FinancialsType (a shared base type for financial data). The issuerFinancialsType requirement is retained [data-dictionary-v3-draft p.53].
Semantic Relationships
Qualifies1 relationship
Display name attribute allows publishers to provide alternative names for both publisher-defined values and RIXML-defined values
RIXML Research Data Dictionary v2.5.1, p.52— Elements and Attributes