Draftworx Wiki

Appearance

XBRL Overview ​

XBRL (eXtensible Business Reporting Language) is a freely available, open, global framework for exchanging business information. It is an XML-based markup language that tags each data point in a business report with metadata describing its meaning and context.

What Does XBRL Do? ​

XBRL converts business reports (financial statements, regulatory filings, tax returns) into a computer-readable format by tagging each data point. Think of each tag as a barcode -- it allows software to automatically recognise, extract, and analyse information.

For example, "Revenue of R5,000,000 for FY2024" in a PDF is just text. In XBRL, that same fact is tagged with:

  • What it is (Revenue -- the concept)
  • Who reported it (the entity -- part of the context)
  • When it applies (FY2024 -- the period, also in the context)
  • What unit (ZAR -- the unit)

The Two Core Components ​

  1. 04 XBRL Taxonomies -- Define the vocabulary (what can be reported). Think of these as specialised dictionaries.
  2. 09 XBRL Instance Documents -- Contain the actual reported data (what is being reported). These are the filled-in reports.

Key Benefits ​

StakeholderBenefit
InvestorsEasier, cheaper, faster, more accurate information discovery and comparison
RegulatorsEnhanced data collection, improved risk assessment, more efficient oversight
CompaniesExpanded access to capital, performance monitoring beyond compliance
AnalystsAutomated extraction and comparison across companies, countries, and languages

Current Scale ​

  • Used in 65+ countries
  • Nearly 220 reporting implementations worldwide
  • Millions of reports published annually
  • Supports multiple languages and international comparisons

Learning Path ​

  1. 02 XBRL History -- How XBRL came to be
  2. 03 XBRL Specifications -- The technical standards
  3. 04 XBRL Taxonomies -- The dictionaries
  4. 05 XBRL Schemas -- How concepts are defined in .xsd files
  5. 06 XBRL Concepts -- What a concept is and how it becomes a fact
  6. 07 XBRL Linkbases -- The 5 relationship types (label, presentation, calculation, definition, reference)
  7. 08 XBRL Contexts and Units -- Who, when, and in what unit
  8. 09 XBRL Instance Documents -- The actual reports containing facts
  9. 10 XBRL Dimensions -- Multi-dimensional reporting (hypercubes)
  10. 11 Entry Points and DTS -- How taxonomies are discovered
  11. 12 Taxonomy Packages -- How taxonomies are distributed as ZIP files
  12. 13 Inline XBRL -- Embedding XBRL in HTML
  13. 14 XBRL Formula -- Validation rules using XPath
  14. 15 Open Information Model -- The future: JSON, CSV, and beyond
  15. 16 XBRL Organizations and Jurisdictions -- Who governs XBRL
  16. 17 XBRL Global Adoption -- Real-world usage (SEC, ESEF, CIPC)
  17. 18 XBRL Tools and Software -- Working with XBRL
  18. 19 LEI Taxonomy Example -- Analysing the simple LEI sample taxonomy
  19. 20 CIPC Taxonomy Example -- Analysing the South African CIPC taxonomy