Version 17 - April 2025 (template release)
Template release pack
This South Africa template is a major release that includes important legislative updates and IFRS-alignment changes, along with new features and corrections.
Key legislative updates in this version are effective for annual periods beginning on or after January 1, 2024.
These updates include:
- Legislative iXBRL tagging updates:
- brought all hidden XBRL tags to the face of the report
- added new mandatory tags to the annual report
- changed “enumerated tags” to show their coded value for filing and the human readable value for members
- ISO3 country codes were replaced with ISO2 (for different address- and nationality for directors data).
- Updated the iXBRL tags for every tagged item:
- reports need to be filed with data tagged as either Parent (non-consolidated) or Consolidated (default).
- Updated primary report table Balance Sheet OL and Statement of comprehensive income tables.
- Consistency updates: all disclosure grids were updated to have the Section and Row Ref. Columns.
- Legislative content updates for the financial period 2024/25:
- added new disclosures and report tables.
- Updated category structure:
- moved categories and created new categories to create a more intuitive structure.
This version V17 release has been made available on platform 6.32.9713.
Additionally, the South Africa Template Content Version V17 includes an XBRL release with various fixes and improvements. This relies on a new version of the taxonomy.
Release notes
- Period Ended: December 31, 2024
- Update Type: Major (Legislative, XBRL, Features, and Corrections)
Legislative
Accounting Reference Number | Details |
|---|---|
Accounting policies updates | New and amended IFRS Accounting Standards that are effective for the current year: *Amendments to IAS 7 Statement of Cash Flows and IFRS 7 Financial Instruments: Disclosures - Supplier Finance Arrangement, *Amendments to IAS 1 - Classification of Liabilities as Current or Non-current, *Amendments to IAS 1 - Presentation of Financial Statements — Non-current Liabilities with Covenants, *Amendment to IFRS 16 Leases - Lease Liability in a Sale and Leaseback |
Accounting policies updates | New and revised IFRS Accounting Standards in issue but not yet effective. New sections: *Amendments to IAS 21 The Effects of Changes in Foreign Exchange Rates titled Lack of Exchangeability, *IFRS 18 Presentation and Disclosures in Financial Statements, *IFRS 19 Subsidiaries without Public Accountability: Disclosures |
South Africa Corporate Report – Annual>Annual financial report>Financial statements>Statement of comprehensive income - net of tax> Statement of comprehensive income - net of tax | Added new report element that pulls data from newly added disclosure grids. Report rows and columns are XBRL tagged. |
South Africa Corporate Report – Annual>Annual financial report>Financial statements>Statement of comprehensive income - before tax>Statement of comprehensive income - before tax | Added new report element that pulls data from newly added disclosure grids. Report rows and columns are XBRL tagged. |
South Africa Corporate Report – Annual>Annual financial report>Financial Statements>Notes to financial statements> Adoption of new and revised International Financial Reporting Standards (IFRSs)>Change in accounting policy, Prior period errors>Table (1st, 2nd ) | Current period and Prior period columns are set to always show for both entities. Please remember to set general display condition to true for column 1,2,3,4,5,6 for required columns on Table Columns in Report Table Settings on Entity Summary tab. |
Corrections
Item ID | Title | Details and limitations |
|---|---|---|
1 | Notes to the cash flow statement > Cash and cash equivalents > Cash and short term deposits Table | Replaced Dimension 'Consolidated and separate member [axis] = XBRLDimensionsSeparateMemberValue' with 'Consolidated and separate member [axis] = Separate [member]' for Parent entity XBRL tags. |
2 | Period Configuration > Categories > PRIMARY – Primary > PL - Profit/(loss) > PL.EXP - Operational expenses - detailed in EXPENSESBYNATURE / EXPENSESBYFUNCTION categories | Renamed category from Expense to this new name. Also moved PL.IMPAIRLOSS, PL.IMPAIRREVERSAL, PL.RESEARCHDEV categories out of this folder into PL - Profit/(loss) where they belong. Extended the category name for the subfolder PL.EXP.GENEXP - general expenses with - not in use because we expect users to allocate their expenses to this folder in bulk and assign them to relevant categories in the dedicated by Nature and by Expenses category folders. |
3 | Period Configuration > Categories PRIMARY – Primary > PL - Profit/(loss) > Transport costs - not in use - see it in EXPENSESBYNATURE / EXPENSESBYFUNCTION categories | Renamed category as this does not belong here. They are operational expenses. |
4 | Period Configuration > Categories > PRIMARY – Primary > PL - Profit/(loss) > Advertising costs - not in use - see it in EXPENSESBYNATURE / EXPENSESBYFUNCTION categories | Renamed category as this does not belong here. They are operational expenses. |
5 | Period Configuration > Categories > PRIMARY – Primary > PL - Profit/(loss) > PL.INV.INTINC - Interest income > PL.INTREVENUE | Moved category under PL.INVINTINC because it is either the same or a subcategory of it. |
6 | Period Configuration > Categories > EXPENSESBYNATURE > NATURE.CONSULTING- Consulting expense - not in use Use NATURE.OTHER.PRO.CONSULTING instead | Renamed category and created new category as indicated in name of this category. This category should be part of professional fees and in its original format could cause reports to be out of balance. At the same time the original category has been replaced in the only report it appears. |
7 | Period Configuration > Categories > EXPENSESBYNATURE > NATURE.OTHER > NATURE.PROP | Moved property tax expense into Other expenses. There was no reason to keep it as a first level expense, especially when rent, repairs and maintenance, other property related expenses, were part of the Other group. |
8 (1917899) | South Africa Corporate Report – Annual>Annual financial report>Financial statements>Notes to financial statements>Leases (Group as a lessee)>Right of use assets>Parent>Current, Prior | Updated both reports. Total column references Parent dimension as a string and not through a variable. Best way to test is to set Entity settings to Consolidated and Parent (both entity types enabled in Entity Summary>Report settings>Entity settings then open report in Edit XBRL mode and hover over the Total column. It should read as Separate member. |
9 | South Africa Corporate Report – Annual>Annual financial report>Financial Statements>Statement of changes in equity>Statement of changes in equity>Consolidated>Non-Standard Table - Consolidated Prior, Consolidated Current | Changed XBRL Dimension set from Separate member to Consolidated. It has been incorrectly tagged. This is the consolidated report. |
10 (1934005) | South Africa Corporate Report – Annual>Annual financial report>Financial statements>Notes to the financial statements>Material income and expense>Other material income and expense>Parent columns | XBRL tagging dimension is changed from linking to a variable (ConsolidatedAndSeparateFinancialStatementsAxis=XBRLDimensionsSeparateMemberValue) it is now refers to a static value: Parent (member). |
11 (1934005) | South Africa Corporate Report – Annual>Annual financial report>Financial statements>Notes to the financial statements>Material income and expense>Gains (losses) on disposal on non-current assets>Parent columns | XBRL tagging dimension is changed from linking to a variable (ConsolidatedAndSeparateFinancialStatementsAxis=XBRLDimensionsSeparateMemberValue) it is now refers to a static value: Parent (member). |
12 (1934005) | South Africa Corporate Report – Annual>Annual financial report>Financial statements>Notes to the financial statements>Material income and expense>Gains (losses) on disposal of property, plant and equipment>Parent columns | XBRL tagging dimension is changed from linking to a variable (ConsolidatedAndSeparateFinancialStatementsAxis=XBRLDimensionsSeparateMemberValue) it is now refers to a static value: Parent (member). |
13 (1934005) | South Africa Corporate Report – Annual>Annual financial report>Financial statements>Notes to the financial statements>Material income and expense>Gains (losses) on disposal of investments>Parent columns | XBRL tagging dimension is changed from linking to a variable (ConsolidatedAndSeparateFinancialStatementsAxis=XBRLDimensionsSeparateMemberValue) it is now refers to a static value: Parent (member). |
14 (1934005) | South Africa Corporate Report – Annual>Annual financial report>Financial statements>Notes to the financial statements>Trade and other receivables> Trade and other receivables Table - used with Balance Sheet in order of liquidity | Added Separate (member) dimension to parent columns XBRL tagging. |
15 (1940253) | Period configuration > Categories > Primary > Balance Sheet > Equity > Retained earnings | Added a brought forward subcategory (BS.EQ.OPENINGRE.BROUGHTFWD) to the original retained earnings category (BS.EQ.OPENINGRE) in Equities and moved the original Movements category (MOVEMENTSRE) under Retained earnings in Equity. |
16 | Different styling and minor content issues | Replace CU (currency unit) in paragraph with the variable ColumnHeading that in the default case (units in ‘000) will show R’000. Also, updated the paragraph style to Commentary for some paragraph where they appeared as normal paragraph although they were all commentary in reality. |
17 | South Africa Corporate Report – Annua l> Annual financial report>Financial statements > Notes to financial statements > Notes to the statement of cash flows > Cash and cash equivalents | Table was reworked. |
18 | Disclosure > Liabilities > Liabilities arising from financing activities > Liabilities arising from financing activities | Added new disclosure and all 4 linked report tables were reworked. They are pulling data from newly added disclosure. Before this change the data in here, which is liability type were sitting in an asset disclosure and because a new subtype, Supplier finance arrangements, came in it was unsustainable to keep them among Assets. |
Features
ITEM ID | TITLE | Details and limitations |
|---|---|---|
1 (1919817) | Row ref and Section columns which had the false condition removed for all grids, columns have been re-seized | Row ref and Section columns which had the false condition removed for all grids, columns have been re-seized |
2 | South Africa Corporate Report – Annual>Annual financial report>Corporate information>Details of the company>Preparer information>Preparer | Renamed element to 'Preparer name'. Preparer detail did not express properly what this is about. Added the extra dimension of XBRL-dimensions="ifrs-full:ConsolidatedAndSeparateFinancialStatementsAxis=XBRLDimensionsSeparateMemberValue" to tag. |
3 | South Africa Corporate Report – Annual>Annual financial report>Corporate information>Details of the company>Preparer information>Preparer Designation | Renamed element to 'Professional body full name' because it was a hybrid of designation and full name. Hidden tag (which is now exposed see previous item) was for designation and actual tag showed full name. They look rectified now. Added the extra dimension of XBRL-dimensions="ifrs-full:ConsolidatedAndSeparateFinancialStatementsAxis=XBRLDimensionsSeparateMemberValue" to tag. |
4 | South Africa Corporate Report – Annual>Annual financial report> Directors' report>Directors>Directors Information>Table (Executive Directors ,Non-Executive Directors)>Nationality | Added the ISO2 code after nationality name as this, ISO2, is going to be reported as part of the enumerated value. This will create the link between reported value and human readable value for instance The Holy See is VA for Vatican City. |
5 | Entity summary>Document information – XBRL>Entity Information>Public interest score | Added Prior Period to tab values. Line items now have both periods. Public interest score (PIS) calculation is based on the values above. When PIS was incorrectly calculated filing will throw a warning. By adding in prior period and provided PIS was correct then users will have a little helping hint to do the correct calculation for current period. |
6 | South Africa Corporate Report – Annual>Annual financial report>Financial statements>Notes to the financial statements>General expenses - By Function> General expenses Table | XBRL tagged table. |
7 | South Africa Corporate Report – Annual>Annual financial report>Financial statements>Notes to the financial statements> Related party disclosures>Remuneration of key management personnel>Table | Tagged table rows inclusive Total. |
8 | South Africa Corporate Report – Annual>Annual financial report>Financial statements>Statement of profit and loss>Income Statement by Nature | Rebuilt report by adding the different type of line items into different sections. Incomes and expenses are now grouped by sections so we could apply the correct credit/debit dimensions to them. |
9 | South Africa Corporate Report – Annual>Annual financial report>root>Variables> ShowEnumXBRLTags | New variable that sets to true if reporting.queries.client.lookupaccountingperioddata("EntitySummary|EntityDetails|General|GeneralDetails|FilingOptions|Current Period")[0].Value='CIPC' otherwise it is false. |
10 | South Africa Corporate Report – Annual>Annual financial report>Directors report>Directors>Directors Information>Directors' nationality - XBRL enumerated | New report element. |
11 | Disclosures>Financial Statements>Other Comprehensive Income XBRL>Components of other comprehensive income that will not be reclassified to profit and loss>Components of other comprehensive income that will not be reclassified to profit and loss, before tax and net of tax | Newly added control grids. Before they were not separated therefore we only had a set that could either be interpreted as before or net of tax. Now we have them split and the template caters for both cases. Linked tables were updated to pull data from newly added disclosures. |
12 | Disclosures>Other notes>Information relating to subsidiaries>Information about composition of Group, Composition of the Group, Details of non-wholly owned subsidiaries that have material non-controlling interest | Added back Parent entity columns to all grids. Country of incorporation is now a drop down list. It was free text before. |
13 | South Africa Corporate Report – Annual>Annual financial report>Financial statements>Notes to the financial statements>Subsidiaries | Moved consolidated tables in a new folder. Added new parent tables and related folders. They are using recreated subsidiary disclosure data. |
14 | South Africa Corporate Report – Annual>Annual financial report>Financial statements>Statement of cash flows>Footnotes - Statement of cash flows | New footnotes folders. Moved over cash flow related footnotes from Statement of financial positions and reworked them according to new standards. |
15 | South Africa Corporate Report – Annual>Annual financial report>Financial statements>XXX>Footnotes - | All footnotes are now updated. They run the same xml code except for the taxonomy tag, which can’t be placed in Variables. Everything else is moved to variables. This simplifies the way we can deal with footnotes. The appearance and behaviour of Footnotes raised questions earlier. Because all variable data is arranged evaluated in variables it is easier to read for support. Error messages are centralized to folder level. |
16 | Entity Summary>Entity details>General Details>Reporting to: | New tab control. Radio buttons to select between two options: CIPC or Members. The selection will make enumerated values disappear from Annual report. |
17 | South Africa Corporate Report – Annual>Annual financial report>Financial Statements>Statement of financial position> Balance Sheet OL | Updated the report. Added section totals and heading to sections where there was only one section between a header and a total. Also, updated XBRL tagging for report as before it used cell level tagging which is substandard to row and column level what we have now. |
18 | Resized grids for better readability | Resized grids so when new rows were added to resized controls grids do not require scrolling. |
19 | Replaced text with variables | Some text appeared as in our sample content like 2024, ‘hard coded’. Now they are replaced with variables e.g. CurrentYear for 2024. |
XBRL changes
note
If you are not hosted by Thomson Reuters, please contact the Support desk to obtain the new taxonomy package or in case any assistance is required to map the new taxonomy.
Item ID | Title | Details and limitations |
|---|---|---|
1933929 | Filed data must be tagged as either Separate or Consolidated | Inline XBRL data Separate/Consolidated dimensions were added to every inline XBRL items. Tables were unaffected by this change as their columns are assigned to Separate or Consolidated categories and therefore, they don’t need to change according to user selection i.e. the report is for a consolidated or a separate entity. |
1933929 | Hidden XBRL tags must be revealed | Every tag must be visible on the face of report. Enumerated tags must be presented with their actual value. We have introduced a switch so clients could select their presentation format between Cipc and Members. The switch is General details on Entity Summary page. Enumerated values will disappear for Members only reports. |
1933929 | Addition of New Report Elements | Several new elements have been added to reveal previously hidden XBRL tags, particularly in the areas of financial statements, corporate information, and document information. These includes elements like 'TypeOfAssurance', 'Preparer name', and various public interest score factors. Please check its values so they will not hinder your filing operations. |
1933929 | Enumerated Values | Several elements now display enumerated values as required by CIPC, ensuring that the values reported are those actually selected and not just those on the disclosure tab. |
note
To download the XBRL taxonomy, visit the official government website, where you will find the latest versions available for download. The following taxonomy references can be loaded into the application via Manage XBRL Taxonomies on the OneSource Accounts Production Platform.
Known issues
Refer to the following table for any potential impact on existing clients.
Item ID | Details and limitations |
|---|---|
1 | Disclosures>Other Notes>Information relating to subsidiaries>Composition of the Group>Wholly-owned subsidiaries and Non-wholly owned subsidiaries. Type of column has changed from percentage to number. Please make sure before the version update (from v16 to v17) that column values before the update don’t contain decimal values. It is likely that values from the columns will disappear and users have to add back prior period values. |
2 | Disclosures>Other Notes>Information relating to subsidiaries>Composition of the Group>Wholly-owned subsidiaries and Non-wholly owned subsidiaries. Country of incorporation has changed to a set list. Before it was free text. If customer used a non-standard (standard meaning ISO) naming for countries that will not match one of our list item it will disappear and has to be readded using the drop down list. |
3 | Disclosures>Liabilities>Borrowings>Borrowings by currency. Section and Row Ref. values were added in new version and they might not go over in the update in which case they manually be added. All sections have the value of ‘1-ANALYSIS BY CURRENCY’ and rows are Row1, Row2, Row3 etc. You can see the desired end result in the template itself. |
4 | Disclosures>Liabilities>Liabilities arising from financing activities>Liabilities from financing activities>Prior period. Values need to be readded from prior period as this grid control was recreated from scratch. The prior period values should be checked and a note taken of them before updating to v17 because the tab and grid control will be rendered hidden after the update. Alternatively, Support could change the visibility of the original grid control in its original location, which is Disclosures>Assets>Cash and cash equivalents>Cash and non-cash changes in liabilities |
5 | After exporting the file to XHTML with embedded iXBRL (desktop) or Inline Xbrl (web), please manually amend the file extension to .xhtml before filing with the CIPC |
Additional Information
ITEM ID | DETAILS AND LIMITATIONS |
|---|---|
1 | Desktop users should perform the following steps before they will be able to update their taxonomy files:
|
Impact on Existing Clients
Item ID | Details and limitations |
|---|---|
1 | View the known issues section for details. |
Deviations from Standard Configuration
There are no deviations identified for this release.
Appendix
There are no appendix items for this release.
Related Content
-
South Africa
Format:
Article