This article is for those who file with Companies and Intellectual Property Commission (CIPC) in South Africa.

CIPC Taxonomy Migration

When an updated version of your taxonomy is available, you can migrate your existing accounts that are tagged with XBRL to the new taxonomy version. Make sure you migrate each document separately. You can migrate from an older taxonomy to the latest and greatest, such as from 2014 to 2019.

If you have multiple documents using the same source links (which is common in statutory reporting), you need to migrate the taxonomy on each of those documents. Then, make any updates needed.

Checking for Common Source Links

Your statutory accounts are likely to have common source links from a master workbook, spreadsheet and or document. Before beginning a taxonomy migration, check your document for shared source links so you are familiar with how your accounts are structured.

To check for common source links:

1
Go to the Data menu and click Doc Links.
2
Review the list of links in the Location Finder panel on the left.

image alt text

Exporting Existing XBRL

After checking your document for common links and single-source values, you can export its current XBRL. The export includes the taxonomy for comparison with the new taxonomy.

To export the existing XBRL:

1
Open your document and make sure the correct taxonomy is selected.
2
Go to the XBRL menu and turn on XBRL.
3
Click Advanced , the select Taxonomy Migration and click Export XBRL (Active Doc + Taxonomy).
4
Review the following warning:
  • Your stat accounts will have shared source links, so the warning you see below can be ignored.
  • Click Proceed if you are ready to continue.

image alt text

5
Click OK when the export is complete, then choose a location and click Save.
6
You will be prompted again with a warning message. Click OK.

image alt text

Selecting the New Taxonomy

Select the new taxonomy to make it the active taxonomy for your document before importing the existing XBRL for migration.

To select the new taxonomy:

1
Open the document if it is not already open.
2
Go to the XBRL menu and turn off XBRL.
3
Click Select Taxonomy, then choose the new FRC taxonomy you want to use. If a taxonomy is already used within a document, a green checkmark will appear next to it.
4
Click the Taxonomy Name button to enable that taxonomy.

Previewing the Migration

Make sure you have completed all of the steps in the previous sections. Then, after selecting the new taxonomy, import the existing XBRL to migrate to it.

To migrate existing XBRL to the new taxonomy:

1
Open the document and go to the XBRL menu.
2
Click Advanced, then select Taxonomy Migration and choose Import/Migrate XBRL into Active Taxonomy.
3
Browse to and select the exported XBRL.
4
You have the option to preview the migration before migrating. Click Preview Migration to preview (recommended) or Migrate to continue with the migration without previewing it.

image alt text

5
Click OK to save the migration log.

image alt text

6
After migration preview is complete, a migration log is saved to your computer. You are notified when this is done. Click OK to continue

image alt text

7
Review the migration log for information about the changes and action items you need to resolve as part of the migration process. This can be done either by viewing the migration log in the XBRL notifications panel at the bottom of the screen or by opening the .csv file you downloaded in a spreadsheet application.

image alt text

Migrating to the New Taxonomy

Repeat steps one through five above, this time running the actual XBRL taxonomy migration instead of previewing it.

Make sure you have completed all of the steps in the previous sections. Then, after selecting the new taxonomy, import the existing XBRL to migrate to it.

To migrate existing XBRL to the new taxonomy:

1
Open the document and go to the XBRL menu.
2
Click Advanced, then select Taxonomy Migration and choose Import/Migrate XBRL into Active Taxonomy.
3
Browse to and select the exported XBRL.
4
You have the option to preview the migration before migrating. Click Preview Migration to preview (recommended) or Migrate to continue with the migration without previewing it.

image alt text

5
Click OK to save the migration log.

image alt text

Updating the Project and Generating XBRL

Make sure to update the project properties to the new taxonomy.

To update project properties:

1
Open the Projects panel on the right.
2
Click the Project Properties button.
3
Go to the XBRL Settings tab and select the new taxonomy in the XBRL Taxonomy dropdown.
4
Click Apply Changes.
5
Go to the XBRL tab and click Generate XBRL.

Your project is now updated to the new taxonomy.

image alt text

Updating Facts with Deleted Concepts

If you are using an XBRL concept from a previous taxonomy that has been deleted in the new taxonomy, a new concept will need to be added to the fact. Because deleted concepts do not provide a recommendation for replacement (known as a migration path), deleted concepts will need to be found in the document and then corrected by searching for a replacement concept from the new taxonomy.

Deleted concepts are shown in the taxonomy migration log under action items. To view the log, open the downloaded migration log .csv file in a spreadsheet application.

One way to find facts with deleted concepts is to open the Wdesk XBRL Viewer from the XBRL generation panel. Facts with deleted concepts will appear in purple in the viewer as potentially untagged facts. By comparing the Wdesk XBRL Viewer with the migration log you can identify the facts with missing concepts and replace them with new concepts as normal.

After adding replacements concepts to the facts, share XBRL for the document.