Overview

Step 1. Downloading the Plugins (Fiscalisation Software's)

1. Click the link below to open the drive where you can download the Palladium Fiscal Harmony Plugin on the link here.
   
2. Download the latest version of the plugin on the drive.

Step 2. Installing the Plugin

1. Run the downloaded plugin installer by double-clicking it and follow all the steps to successfully install the app.
   
2. After the installation, run the plugin as an administrator.
   

1. Once the plugin is open, click "Connection Settings", and the system will show a page like the one below.
   
2. On this page, proceed to do the following:
   
1. Enter the company name.
   
2. Enter the API key and the API Secret, which you can get from the Fiscal Harmony app on https://app.fiscalharmony.co.zw/api-keys/. Make sure to login and select the device you want to get the API Keys for.
   
1. If you haven't made an API Key, create API Key and enter your 2FA code.
   
2. If you have an API Key already, you would need to click Refresh secret to get a new API Secret.
3. Click the "Test Fiscal Harmony Connection" button.
   
1. If the system successfully tests the connection, proceed to the next step
   
2. However, if it fails, kindly check your internet connection, and you may also restart the computer.
   
4. Enter all the required database connection credentials. Make sure to provide the correct credentials; otherwise, the system will fail to test the database connection.
   
5. Click the button with the title "Test Database Connection".
   
6. Click the button titled "Save Organisation" The saved company will now appear on the Data grid if successfully saved.
   

NB. If you want to add more than one company, please repeat the same procedure as above.

Step 3. Setting up the Global Settings

1. Click the button "Global Settings"
   
2. A page will pop up, and you check the checkbox with the label "Automatically Open PDF Folder on Successful fiscalisation" if you want the folder with fiscalised invoices to open every time you run an invoice.
   
3. Use the textbox to change the default location to save your fiscalised invoices.
   
4. Click the "Save" button to save your changes.
   

Step 4. Setting up the Currency and Tax Mappings

1. Click the button "Currency Mappings"
   
2. Select the Currency in Palladium and map it to the corresponding Currency in ZIMRA.
   
3. Click the button "Save Changes"
   

NB: Please map all the currencies that you will be using to fiscalise.

1. Click the button with title "Tax Mappings"
   
2. Select the Tax name in Sage and map it to the corresponding tax in ZIMRA.
   
3. Click Button "Save Changes" to save your taxes
   

NB: Please map all the taxes that you will be using to fiscalise.

Step 5. TIN and VAT Setup

1. Navigate to customers and click "Edit" Button.
   
2. Enter the Tin number in the "Reg No:" field
   
3. Enter the Vat Number in the "VAT Reg:" field
   
4. Click  button "Ok" to save your settings.
   

Please be advised that your app must always be running in background for you to be able to fiscalise

You must always run the Plugin as administrator for you to be able to fiscalise.