Connecting Odoo Accounting

Odoo Accounting is connected using an API key you generate inside your Odoo instance. Once connected, invoices posted to your chosen sales journal are automatically synced and fiscalized.

Odoo does not use OAuth for this flow — you create an API key manually, paste it into FiscoBridge, and FiscoBridge uses it to talk to Odoo's JSON-RPC API on your behalf.

Before You Begin

Odoo plan requirement: Odoo's External API requires the Custom plan on Odoo Online. The One App Free and Standard plans do not expose the External API and cannot be connected. If you're on one of those plans, upgrade inside Odoo before starting — self-hosted Odoo has no plan restriction.

You will need:

• Admin (or equivalent) access to the Odoo user the integration will run as

• The database name of your Odoo instance (only required for self-hosted — on Odoo Online it is derived from your URL automatically)

• Your FiscoBridge account with an active integration license and a valid PFX certificate

Step 1 — Generate an API Key in Odoo

Log in to Odoo as the user the integration will run as. Invoices posted in Odoo will appear in FiscoBridge under that user's permissions, so use an account that can read the sales journal you want to fiscalize.

1. Click your avatar in the top-right and choose My Preferences (on some versions labelled Preferences)

2. Open the Account Security tab

3. Click New API Key

4. Give the key a description (e.g. "FiscoBridge") and choose a duration

5. Click Generate Key and copy the key — Odoo shows it only once

Duration matters. Pick the longest duration your Odoo policy allows — 1 year is recommended where available. When the key expires, sync stops until you generate a new one and update the integration in FiscoBridge, so set a calendar reminder a week before expiry.

Step 2 — Create the Integration in FiscoBridge

1. Go to Integrations → Integrations in the sidebar and click Create Integration

2. On the New Integration page, select the Odoo Accounting card

3. Pick the tier and subscription to bill the connection against (if you have more than one)

4. Upload your PFX certificate when prompted

5. The Odoo configuration dialog opens — choose how your Odoo instance is hosted:

   • Odoo Online — hosted on odoo.com or odoo.sh

   • Self-hosted — running on your own infrastructure

6. Fill in the connection details:

7. Click Test & continue. FiscoBridge makes a test call to your Odoo instance to verify the credentials and fetch the list of companies and sales journals.

Step 3 — Select Company and Sales Journal

After the test succeeds, you'll be asked to choose:

• Company — for multi-company Odoo setups, the company this integration covers. Create one FiscoBridge integration per company.

• Sales Journal — the specific journal whose invoices will be fiscalized. Invoices posted to other journals are ignored.

Click Save integration. The connection appears in your integrations list with status Active.

What Gets Synced

• Every invoice posted to the selected sales journal (types out_invoice and out_refund) is pulled into FiscoBridge automatically

• Each invoice is fiscalized — signed and reported to the tax authority

• The fiscal PDF is attached back to the Odoo move, and a chatter note links to the verification URL

• If your Odoo has the VSDC custom fields (x_vsdc_fiscal_number, x_vsdc_verification_url, x_vsdc_signature, x_vsdc_fiscalized_at), they're populated too; otherwise only the attachment and chatter note are written

New invoices are picked up every minute.

Updating the Configuration

If you need to change the API key (because the old one expired), switch to a different journal, or update any other field:

1. Go to Integrations → Integrations

2. Find the Odoo row and click Configure

3. The dialog opens with your existing settings pre-filled

4. Change what you need, click Test & continue, then Save changes

The integration keeps its ID, its subscription, and its history of fiscalized invoices. Only the stored configuration is replaced.

Common Errors

"Your Odoo plan does not include External API access. Upgrade to Custom." Your Odoo Online subscription doesn't expose the External API. Upgrade the Odoo subscription to the Custom plan, then retry.

"API key or database name is wrong." Re-paste the API key and confirm it belongs to the user whose email you entered in the Login field. On self-hosted, also double-check the Database value matches the database the user lives in. On Odoo Online there is no database field — the name is taken from your URL, so verify the URL points to the correct tenant.

"Could not reach your Odoo URL." The Instance URL is wrong, your Odoo instance is down, or your self-hosted deployment is not reachable from the public internet. FiscoBridge needs outbound HTTPS access to your Odoo instance.

Invoices stop syncing after a few weeks. Almost always the API key expired. Generate a new one in Odoo (Step 1), then update the integration (see "Updating the Configuration" above).

Removing the Integration

1. Go to Integrations → Integrations

2. Click the Remove button next to the Odoo integration

3. Confirm the removal

Removing the integration stops the sync. Previously fiscalized invoices are not affected. The API key inside Odoo stays active — delete it manually in Odoo if you no longer need it.

Next Steps

• Manage integrations — View all your active connections

• Integrations Overview — Learn about other supported platforms