FinancialValue
RIXML 2.5 Element
Stores individual financial data points for issuers or securities with extensive temporal and methodological context. Contains the actual financial figure along with attributes for estimate/actual designation, period specification, duration, exact datetime, and estimate action tracking.
Usage
Required within IssuerFinancials and SecurityFinancials elements, with multiples allowed for different time periods or metric variations. Must specify estimateActual attribute to indicate data source type. Can use period/periodYear/periodEnd combination or specific dateTime for temporal context.
Business Context
Core element for financial analysis and investment research, storing the fundamental data points that drive valuation models, earnings estimates, and financial forecasting. Essential for comparative analysis, trend identification, and quantitative research methodologies.
Where It Fits
Canonical Path
Definition
| Type | FinancialValueType |
| Namespace | http://www.rixml.org/2017/9/RIXML |
| Min Occurs | 1 |
| Max Occurs | 1 |
| Content Model | Text content (string) |
Attributes
estimateActualEstimateActualEnum |
Indicates whether a financial figure is actual or estimated. requiredSince 2.1 |
periodPeriodEnum |
Used together with periodYear and periodEnd to indicate the applicable period for a financial value. Example: Q4 2000 ending 31 December. optionalSince 2.1 |
periodEnddateTime |
Used together with period and periodYear to indicate the applicable period for a financial value. Example: Q4 2000 ending 31 December. optionalSince 2.1 |
periodYearinteger |
The four-digit year used together with period and periodEnd to indicate the applicable period for a financial value. Example: Q4 2000 ending 31 December. optionalSince 2.1 |
durationduration |
Time duration that is being addressed. optionalSince 2.1 |
dateTimedateTime |
Exact date and time applicable to a financial data item, expressed using ISO 8601 (as refined by the World Wide Web Consortium's note http://www.w3.org/TR/NOTE-datetime). In addition, RIXML requires the use of Zulu time or Z-time (GMT +/- n hours:minute:seconds). All times are absolute and easier to compute, rather than using a relative (i.e. 08:30 +5) time. Generally dateTime is used instead of period, periodYear and periodEnd when a specific date can be assigned to a financial data item, for example, Total Assets as of 31 January 2000. optionalSince 2.1 |
estimateActionEstimateEnum |
If this financial value is an estimate, the estimateAction attribute can be used to indicate an action, such as reiterate or upgrade, that applies to this estimate. Intended to provide support for the case where an author is including more than one estimate action in the same report -- for example, reiterating his current fiscal year estimate and upgrading his next fiscal year estimate. optionalSince 2.1 |
Children
Contains text content (type: string)
This element's value is its text content. Attributes provide additional context.
Example
<FinancialValue estimateActual="Value">ABC-123</FinancialValue>Version History
Unchanged since introduction in RIXML 2.1
Business Rules
The dateTime attribute should be used instead of the period, periodYear and periodEnd combination when a specific date can be assigned to a financial data item
When a financial value has estimateActual set to estimate, the estimateAction attribute may be included to specify actions like reiterate or upgrade that apply to that particular estimate
Design Decisions
The estimateActual attribute was designated as required to ensure consumers can distinguish between actual reported figures and estimated values
Financial data consumers need to clearly understand whether a figure represents actual reported data or an estimate, as this impacts investment decision-making and risk assessment
RIXML Research Data Dictionary v2.5.1, p.61
The dateTime attribute was configured to use ISO 8601 format with mandatory Zulu time representation instead of relative time zones
Absolute time representation is easier to compute and process than relative time formats, reducing complexity for data consumers and ensuring consistent temporal interpretation across systems
RIXML Research Data Dictionary v2.5.1, p.62
Semantic Relationships
Requires3 relationships
The period attribute must be used together with periodYear and periodEnd to specify the complete financial reporting period
RIXML Research Data Dictionary v2.5.1, p.61— Elements and Attributes
The period attribute must be used together with periodYear and periodEnd to specify the complete financial reporting period
RIXML Research Data Dictionary v2.5.1, p.61— Elements and Attributes
The estimateAction attribute can only be used when the financial value is an estimate
RIXML Research Data Dictionary v2.5.1, p.62— Elements and Attributes
Replaces1 relationship
The dateTime attribute is used instead of period, periodYear and periodEnd when a specific date can be assigned to a financial data item
RIXML Research Data Dictionary v2.5.1, p.62— Elements and Attributes