Odoo Integration

Odoo Integration

Instructions for Fiscal Harmony API Integration with Odoo

Please follow the steps below after installation has been completed in the database.

STEP 1

Collect API Details from the Client’s Fiscal Harmony Portal

• Log in to the client’s Fiscal Harmony Portal using the provided link.

• Navigate to the API section and collect the following details:

  • API Key

  • API Secret
    Note: Two-Factor Authentication (2FA) may be required. It is recommended to use Google Authenticator for this process.
    
    

STEP 2

Apply API Keys in Odoo

• Log in to the Odoo Accounting System.

• Go to Apps > Fiscal Harmony > Fiscal Harmony API Settings.

• Fill in the following details:

  • Configuration Name: (Use the Company Name)

  • Company Name

  • API Key

  • API Secret

• Click Test Connection. A User ID will be assigned to the device and displayed at the top right corner (as shown in the image below, if available).
  
  

• Copy this User ID and paste it into the Fiscal Harmony User ID field.

STEP 3

Tax Mappings

• Click Sync Device Taxes.

  • Taxes available in the Odoo system will be fetched automatically.

• Under the Odoo Tax column, map each tax correctly according to the tax type (e.g., 15%, 0%).

• Save each tax mapping individually.

STEP 4

 Currency Mappings

• Map each currency in ZIMRA with the corresponding currency in Odoo.

• Click Save for each currency.