ERP Integrations

Odoo

Connect Odoo so Atlas can read customers, quotes, sales orders, purchase orders, inventory, and manufacturing context.

Prerequisites

Odoo URL	Production or staging Odoo base URL
Database	Odoo database name
Credentials	Integration user login and API key

Connect in Atlas

Atlas -> Connectors -> Native Integrations -> Odoo

Click the Odoo card to open the native setup form.

Test & Save

Display Name: Example: Odoo Production or Odoo Staging.
URL: Example: https://acme.odoo.com. Use the base URL you sign into, without a model path.
Database: Example: acme-prod. In Odoo Online this may differ from the visible company name.
Email: Example: atlas-service@acme.com. This must be the login for the dedicated Odoo integration user.
API Key: Example source: Preferences -> Account Security -> New API Key while signed in as atlas-service.

1
Open the connector card
In Atlas, go to Connectors, find Odoo under Native Integrations, and click the card. The modal should say Set up integration.
2
Expand Setup instructions
The Odoo form includes a six-step setup panel. Follow it in order before entering credentials.
3
Paste the credentials
Enter the Odoo URL, database, atlas-service email, API key, and display name.
4
Click Test & Save
Atlas authenticates with Odoo, checks the integration user, saves the connection, and starts schema catalog ingestion.
5
Set active if prompted
If the workspace has more than one ERP connector, set the correct Odoo connection as the active ERP before enabling workflows.

Business objects

Customers, contacts, and commercial terms
Quotes, sales orders, and invoices
Purchase orders, vendors, and receipts
Products, bills of materials, inventory, and manufacturing orders

ODOO_URL=https://example.odoo.com
ODOO_DB=company-prod
ODOO_LOGIN=atlas.integration@example.com

Authentication

Atlas connects to Odoo through the Odoo external API using the database name, login, and an API key for the integration user. Treat the API key like a password and avoid using a personal employee account.

1
Create an integration user
In Odoo, go to Settings -> Users & Companies -> Users -> New. Create a user named atlas-service, set the login email, and make it an Internal User.
2
Assign least-privilege groups
Grant only the Odoo app groups Atlas needs, such as Sales, Purchase, Accounting/Invoicing, Inventory, or Manufacturing. Do not grant Technical or Administration for normal operation.
3
Generate an API key
Set a temporary password if needed, sign in as atlas-service, open Preferences -> Account Security, and create a new API key.
4
Confirm database name
Odoo authentication requires the database name as well as the URL and login. A valid URL with the wrong database will still fail authentication.

Verify the connection

1
Authenticate
Use Test & Save in the Atlas Odoo modal. If it fails, correct URL, database, login, or API key before moving on.
2
Read partner data
Verify Atlas can read res.partner records for customers and contacts.
3
Read workflow entities
Read a quote, sales order, purchase order, product, and inventory record used by the target workflow.
4
Run schema discovery
Let Atlas index Odoo models and fields so later tool calls use tenant-specific names rather than assumptions.

Version differences

Odoo installations vary by version, installed modules, and Studio customization. Verify model names and field names against your tenant before enabling writes.

Odoo setup references

Odoo external API and API keys
Use this to confirm how Odoo authenticates external API calls with a database, login, and API key.

Common errors

Access denied: the integration user lacks a group or record rule for the model Atlas is reading.
Authentication failed: URL, database name, login, or API key is wrong.
Missing field: the tenant uses a custom module or Studio field that differs from the default mapping.
Write blocked: Atlas policy requires approval or the Odoo user lacks write permission.