omadiaomadia.ai
registry
integrationodoo

Odoo Connector

@omadia/integration-odoo

Gemeinsamer Odoo-JSON-RPC-Layer (read-only) für alle Odoo-Konsumenten + Handelsregister-Enrichment (OpenRegister / NorthData). Publishes kernel-Services 'odoo.client' (OdooClient), 'odoo.cache' (OdooResponseCache), 'odoo.enrich' (CompanyEnrichmentProvider) + per-Scope Agent-Toolkits 'odoo.agentToolkit.{accounting,hr}' (query_graph + odoo_execute); contributes den native `odoo_version`-Tool und — optional via odoo_generic_read_enabled — die generischen Read-Tools `odoo_query` / `odoo_describe` sowie `enrich_company` via ctx.tools.register.

latest
v0.2.1
license
MIT
versions
5
author
byte5 GmbH

install

In your omadia instance, open Admin → Registries and add this registry, then install Odoo Connector from Admin → Plugins → Store.

registryhttps://hub.omadia.ai

setup guide

Set up the Odoo connection

The integration talks to Odoo's External API (JSON-RPC, read-only) with an API key instead of a password. You need four values:

  1. Odoo URL: your instance, e.g. https://erp.example.com or https://yourco.odoo.com (no trailing slash needed).
  2. Database: the Odoo database name (for SaaS instances usually the subdomain part).
  3. API Login: the email of a technical user account used for JSON-RPC.
  4. API Key: in Odoo → Profile → Account Security → New API Key → copy → field API key.

Recommended: a dedicated technical user with exactly the required module read rights, not an admin account.

Optional: the company-enrichment providers (OpenRegister / NorthData) are off by default — enable and key them only if you need commercial-register lookups.

versions

v0.2.1
>=1.0 <2.0128.6 KB2026-08-24
.zipe613bba3ea2e…
v0.2.0
>=1.0 <2.0126.0 KB2026-06-08
.zipe6d05e46dc41…
v0.1.6
>=1.0 <2.0112.2 KB2026-06-03
.zipf58c165d5d16…
v0.1.5
>=1.0 <2.0112.0 KB2026-06-03
.zipae7226fffed7…
v0.1.4
>=1.0 <2.0111.3 KB2026-06-02
.zip19579a683cfb…

setup fields

Values the operator fills in at install-time.

odoo_urlstring
Odoo URLBase-URL der Odoo-Instanz, z.B. https://erp.example.com oder https://meinefirma.odoo.com. Kein trailing slash nötig.
required
odoo_dbstring
Datenbank-NameName der Odoo-Datenbank — bei SaaS-Instanzen der Subdomain-Teil.
required
odoo_loginstring
API-LoginE-Mail-Adresse des Technical-User-Accounts für JSON-RPC.
required
odoo_api_keysecret
API-KeyRotierbar in Odoo → Profil → Accountsicherheit → New API Key.
required
odoo_proxy_max_bytesstring
Max Response-Size (Bytes)Kappt Odoo-Antworten über diesem Limit, um Memory-Blow-Ups bei großen search_reads zu verhindern. Default 500000.
optional
odoo_insecure_tlsstring
TLS-Verifizierung deaktivierenNur für lokalen Dev mit privatem CA-Cert: 'true' schaltet TLS-Verify für Odoo-Requests aus. Produktion MUSS leer oder 'false' bleiben.
optional
odoo_generic_read_enabledstring
Generische Odoo-Read-Tools aktivieren'true' registriert die orchestrator-weiten Tools `odoo_query` (search_read) und `odoo_describe` (Schema). Sie lesen über die HR-/Accounting-Scope-Grenze hinweg (model-auto-routing), bleiben aber strikt read-only und behalten die HR-Red-Line-Sperren (Gehälter, Bank-/Privatdaten). Default 'false' — ohne Aktivierung läuft Odoo-Zugriff nur über die Sub-Agents. Das `odoo_version`-Tool ist unabhängig davon immer aktiv.
optional
odoo_entity_sync_enabledstring
Entity-Sync aktivieren'true' registriert einen Background-Job, der res.partner / hr.employee / hr.department / account.journal periodisch in den Knowledge-Graph spiegelt.
optional
odoo_entity_sync_interval_hoursstring
Entity-Sync Intervall (Stunden)Zwischen 1 und 168. Default 6h.
optional
odoo_entity_sync_page_sizestring
Entity-Sync Page-SizeOdoo search_read batch-Größe pro Call. Default 100.
optional
odoo_entity_sync_max_per_modelstring
Entity-Sync Max pro ModellHard-cap für Records pro Modell-Durchlauf, z.B. 5000 = max 5k Records pro res.partner-Sync. Default 5000.
optional
openregister_enabledstring
OpenRegister aktivieren'true' aktiviert den OpenRegister-Provider für das enrich_company-Tool. Gewinnt vor NorthData, wenn beide aktiv sind.
optional
openregister_api_keysecret
OpenRegister API-KeyBearer-Token aus https://docs.openregister.de/authentication.
optional
openregister_base_urlstring
OpenRegister Base-URLDefault https://api.openregister.de.
optional
openregister_rate_limit_rpsstring
OpenRegister Rate-Limit (rps)
optional
openregister_cache_ttl_daysstring
OpenRegister Cache-TTL (Tage)
optional
openregister_max_bytesstring
OpenRegister Max Response-Size
optional
openregister_fetch_levelstring
OpenRegister Fetch-Level'minimal' (1 credit), 'standard' (3 credits, Default) oder 'full'.
optional
northdata_enabledstring
NorthData aktivieren'true' aktiviert den NorthData-Provider (Plan-B, nur wenn openregister_enabled=false).
optional
northdata_api_keysecret
NorthData API-KeyX-Api-Key aus https://www.northdata.com/doc (Premium-Plan).
optional
northdata_base_urlstring
NorthData Base-URL
optional
northdata_rate_limit_rpsstring
NorthData Rate-Limit (rps)
optional
northdata_cache_ttl_daysstring
NorthData Cache-TTL (Tage)
optional
northdata_max_bytesstring
NorthData Max Response-Size
optional

permissions

memory

reads: [0] · writes: [0]

graph

reads: [0] · writes: [0]

network

outbound: [0]

filesystem

scratch: false