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.0
license
MIT
versions
4
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.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_urlstringOdoo URLrequired
odoo_dbstringDatenbank-Namerequired
odoo_loginstringAPI-Loginrequired
odoo_api_keysecretAPI-Keyrequired
odoo_proxy_max_bytesstringMax Response-Size (Bytes)optional
odoo_insecure_tlsstringTLS-Verifizierung deaktivierenoptional
odoo_generic_read_enabledstringGenerische Odoo-Read-Tools aktivierenoptional
odoo_entity_sync_enabledstringEntity-Sync aktivierenoptional
odoo_entity_sync_interval_hoursstringEntity-Sync Intervall (Stunden)optional
odoo_entity_sync_page_sizestringEntity-Sync Page-Sizeoptional
odoo_entity_sync_max_per_modelstringEntity-Sync Max pro Modelloptional
openregister_enabledstringOpenRegister aktivierenoptional
openregister_api_keysecretOpenRegister API-Keyoptional
openregister_base_urlstringOpenRegister Base-URLoptional
openregister_rate_limit_rpsstringOpenRegister Rate-Limit (rps)optional
openregister_cache_ttl_daysstringOpenRegister Cache-TTL (Tage)optional
openregister_max_bytesstringOpenRegister Max Response-Sizeoptional
openregister_fetch_levelstringOpenRegister Fetch-Leveloptional
northdata_enabledstringNorthData aktivierenoptional
northdata_api_keysecretNorthData API-Keyoptional
northdata_base_urlstringNorthData Base-URLoptional
northdata_rate_limit_rpsstringNorthData Rate-Limit (rps)optional
northdata_cache_ttl_daysstringNorthData Cache-TTL (Tage)optional
northdata_max_bytesstringNorthData Max Response-Sizeoptional

permissions

memory

reads: [0] · writes: [0]

graph

reads: [0] · writes: [0]

network

outbound: [0]

filesystem

scratch: false