xBRL-CSV and XBRL-XML¶
An EBA report can be written in two serializations of the same XBRL model: xBRL-CSV, the format of the EBA's current frameworks, and XBRL-XML, the older form, still found in earlier submissions and archives.
xBRL-CSV report packages¶
A report package is a ZIP with one top-level folder:
SYNTHETICDPMXL000002.CON_FR_COREP030300_COREPLE_2025-12-31_20260115093000000/
META-INF/reportPackage.json the package type
reports/report.json documentInfo: extends the taxonomy entry point
reports/parameters.csv entityID, refPeriod, baseCurrency, decimals*
reports/FilingIndicators.csv templateID, reported
reports/c_26.00.csv one CSV file per table
reports/c_27.00.csv
Each table file has one row per fact (EBA's convention: datapoint,
factValue, then key columns for open tables). The meaning of each
datapoint, its concept and dimensions, lives in the taxonomy's metadata
that report.json extends; see
EBA convention and resolved metadata. The format is defined
by the xBRL-CSV 1.0 and Report Packages 1.0
specifications.
dpm-xbrl streams table rows with the csv module (utf-8-sig), straight
from the ZIP, so a package is never unpacked to disk. The exact package
rules are in data formats.
XBRL-XML instances¶
An instance is one XML document under the XBRL 2.1
specification: a link:schemaRef to the entry point, filing indicators,
contexts (entity, period and dimensions), units, and one element per fact
that refers to a context and a unit.
dpm-xbrl scans the prolog, rejects any DOCTYPE, then streams the document
with iterparse, clearing each top-level element once it is processed. The
exact rules are in data formats.
The same fact in both¶
A fact in an xBRL-CSV table is identified by its template, datapoint and key values; in XML, by its concept, dimensions and unit. The taxonomy maps one to the other. Without it, a CSV fact has no concept and an XML fact has no datapoint, which is why conversion between the formats needs resolved metadata.
| xBRL-CSV | XBRL-XML | |
|---|---|---|
| Identifies a fact by | template, datapoint, key columns | concept, dimensions, unit |
| Decimals | report parameters per data type (decimalsMonetary) |
decimals attribute on each fact |
| Filing indicators | FilingIndicators.csv |
find:fIndicators |
| Size | compact; millions of facts per table | verbose; a context per dimension combination |
Fact.location |
reports/c_27.00.csv:3 |
instance.xbrl#f12 |
| Reads without the taxonomy | yes, in the EBA convention | yes |