Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.numeral.com/llms.txt

Use this file to discover all available pages before exploring further.

This guide explains how to install the Numeral Tax addon on your Odoo.sh project.

​
Prerequisites

  • An active Odoo.sh project
  • Admin access to your Odoo.sh project
  • A Numeral account with API credentials (numeralhq.com)

​
Step 1: Deploy from the Odoo App Store

  1. Visit the Numeral Tax listing on the Odoo App Store for your Odoo version:
    Odoo VersionApp Store Link
    Odoo 17apps.odoo.com/apps/modules/17.0/numeral_tax_addon
    Odoo 18apps.odoo.com/apps/modules/18.0/numeral_tax_addon
    Odoo 19apps.odoo.com/apps/modules/19.0/numeral_tax_addon
  2. Click the Deploy on Odoo.sh button.
  3. Select your existing Odoo.sh project from the list.
  4. Wait for the build to complete — you can monitor progress in the build logs.
The deployment may take a few minutes.

​
Step 2: Install the Module

Once deployed:
  1. Log in to your Odoo instance.
  2. Go to Apps.
  3. Click Update Apps List (in the menu).
  4. Search for “Numeral Tax”.
  5. Click Install.

​
Step 3: Configure Numeral API

After installation:
  1. Go to Settings → General Settings.
  2. Scroll to the Numeral Tax section.
  3. Enter your API credentials:
    • API Token: Your Numeral API key (starts with sk_live_ or sk_test_)
  4. Click Test Connection to verify.
  5. Click Save.

​
Multi-Company Setup

If you have multiple companies:
  • Switch to each company using the company selector.
  • Configure Numeral settings for each company separately.
Branch companies can check Inherit from parent to use the parent company’s API credentials.

​
Updating the Module

When a new version is released:
  1. Visit the Numeral Tax listing on the Odoo App Store.
  2. Click Deploy on Odoo.sh again to deploy the latest version.
  3. Wait for the build to complete.
  4. Go to Apps → find Numeral Tax → click Upgrade.

​
Troubleshooting

  • Verify the deployment completed successfully in the Odoo.sh build logs.
  • Try clicking Update Apps List again.
  • Ensure you deployed the correct version for your Odoo instance.
  • Verify your API token is correct.
  • Ensure there are no extra spaces in the token field.
  • Check if your Numeral account is active.
  • Try with a test token (sk_test_...) first.
  • Ensure products have the Numeral Tax checkbox enabled.
  • Check that products have a valid category.
  • Review the sync status in Settings → Numeral Tax.