Troubleshooting guide for XBRL filing

Create and Open icons are present but not working, e.g. no response upon clicking

No

1. Enable Macros [PDF, 479 KB] (opens in new tab)

2. Repair MS Office [PDF , 687 KB] (opens in new tab)

3. Install Patch (opens in new tab)

Tool not working properly with no error message

No

Create and Open icons are present but not working, e.g. no response upon clicking

Yes (MS Office Document Customisation message is displayed)

1. Repair Primary Interop Assemblies [PDF , 588 KB] (opens in new tab)

2. Repair Visual Studio for Office Runtime [PDF , 684 KB] (opens in new tab)

3. Repair MS Office [PDF , 687 KB] (opens in new tab)

Tool not working properly with no error message

Yes (MS Office Document Customisation message is displayed)

Create and Open icons are NOT present

No

1. Run Visual Basic for Applications:

   • Office 2007 and higher [PDF , 761 KB] (opens in new tab)

   • Office 2003 [PDF , 527 KB] (opens in new tab)

2. Enable Macros [PDF , 479 KB] (opens in new tab)

Create and Open icons are NOT present

Yes (MS Office Document Customisation message is displayed)

1. Run Visual Basic for Applications:

   • Office 2007 and higher [PDF , 761 KB] (opens in new tab)

   • Office 2003 [PDF , 527 KB] (opens in new tab)

2. Enable Macros [PDF , 479 KB] (opens in new tab)

3. Repair Primary Interop Assemblies [PDF , 588 KB] (opens in new tab)

4. Repair Visual Studio for Office Runtime [PDF , 684 KB] (opens in new tab)

5. Repair MS Office [PDF , 687 KB] (opens in new tab)

.Net Framework installed but prompted with error message

Yes (.Net Framework not installed message is displayed)

1. Open the Control Panel and click Programs and Features

2. Right click on Microsoft .NET Framework 4.7.2 or above for preparation tool v3.2

3. Select Repair

4. Reinstall preparation tool

User tries to open the preparation tool, but finds that his last saved Excel file is opened

N.A.

1. Change the file extensions [PDF , 462 KB] (opens in new tab)

2. Repair MS Office [PDF , 684 KB) (opens in new tab)

Fix for “The Bizfinx preparation tool already running” error

Yes ("The Bizfinx preparation tool is already running. Please save and close the existing file and try again")

1. Check if BizFin^x preparation tool is already running. Each time, you can only have one set of templates opened by the preparation tool.

2. To make sure, you can go to Task Manager> Processes and kill all EXCEL.EXE processes. Reopen the preparation tool to check if the issue is resolved. If the problem remains, proceed to Step 3.

3. Check if you have full access (Read, Write and Execute) to the folder "C:\Acra Preparation Tool v3" or "C:\Acra Preparation Tool". To check this, create a new text document inside the above folder and then delete the same file. If you are unable to perform this action, it means that you do not have full access to the folder. Please contact your IT personnel to allow you to have full access to the folder.

4. Once full access is granted, repeat Step 3 to make sure you have full access to the folder. Reopen the preparation tool to check if the issue is resolved.

Fix for GEN-02 Error while filling up the Scoping Questions

Yes (Error message with GEN-02 header and says "Please contact technical support")

Please follow the steps below to resolve the GEN-02 error in the Preparation Tool

Step 1: Ensure System Prerequisites are met

1. Update Windows

• Go to Start Menu > Settings > Windows Update, then check for and install the latest updates.

2. Repair Microsoft Office

• Go to Start Menu > Control Panel > Programs > Programs and Features 

• Locate Microsoft Office, right-click it, and select Repair

• Complete the repair process

3. Install VSTO Runtime

• Download and install the VSTO runtime in this link (opens in new tab)

• After installation, try opening the Preparation Tool again

Step 2 : Replace Text Control Files 

If the issue persists:

1. Download the Text Control Zip file (opens in new tab)

2. Replace files in the Preparation Tool folder

• Extract the Zip file

• Copy all extracted files and paste them into this directory: C:\Acra Preparation Tool v3

• Replace existing files when prompted

3. Close all Excel files and relaunch the Preparation Tool to check if the issue is resolved. 

Step 3: Install Visual C++ 2013 Prerequisites

If the issue persist:

1. Download (opens in new tab) Visual C++ Redistributables, and select both vcredist_x86.exe and vcredist_x64.exe

2. Install both files, then restart your system

3. Open the Preparation Tool again to check if the issue is resolved.

Step 4: Apply Preparation Tool Patch 

If the issue persist:

1. Download the Preparation Tool 3.4.1 patch (opens in new tab)

2. Apply the patch

• Extract the Zip file

• Copy all files and paste/replace them in: C:\Acra Preparation Tool v3

• Ensure all Excel files are closed before reopening the Preparation Tool

Step 5: Additional Checks 

1. Try open the XBRL file directly from the C:\Acra Preparation Tool v3 folders.

2. If the issue pertains, please send us:

• A screenshot of the error message

• The log file located at : C:\Acra Preparation Tool v3\iFile\Conf\Log

• The source word document that is triggering the issue.

We will review the details and advise further.