Konnektoren
Schemaobjekte
Die SQL- und Dateibrücke
Das OAuth 2.0 Verfahren
Gesperrte Datensätze

Odoo ERP Konnektors

Der Odoo ERP Konnektor stellt die Schnittstelle zwischen Odoo ERP und Syncler dar.
Die Verbindung erfolgt über die XML-RPC-Schnittstelle von Odoo und ermöglicht das Lesen und Schreiben von Datenobjekten wie Geschäftspartnern, Artikeln, Aufträgen und Rechnungen.
Damit lassen sich Odoo-Instanzen direkt mit anderen Systemen und Prozessen in Syncler integrieren.

Voraussetzungen

Für die Einrichtung des Konnektors werden die folgenden Angaben benötigt:

Einstellung Beschreibung
Server URL URL der Odoo-Instanz, z. B. https://meinefirma.odoo.com
Datenbank Name der verwendeten Odoo-Datenbank
Benutzername Odoo-Benutzer mit ausreichenden Berechtigungen für API-Zugriffe
Passwort Passwort des Benutzers

Hinweis:
Der Benutzer muss Zugriff auf alle relevanten Module (z. B. Verkauf, Buchhaltung, Kontakte) haben.
Ohne ausreichende Berechtigungen werden bestimmte Objekte im Schema nicht angezeigt.

Einrichtung

  1. Öffnen Sie in Syncler den Bereich Systeme und wählen Sie „Neues System anlegen“.

  2. Wählen Sie als Systemtyp „Odoo ERP“ aus.

  3. Tragen Sie die zuvor ermittelten Werte in die entsprechenden Felder ein:

    Feld Beispielwert
    Server URL https://meinefirma.odoo.com
    Datenbank odoo_prod
    Benutzername integration@syncler.io
    Passwort ********

  4. Speichern Sie das System.
    Beim Speichern führt Syncler automatisch einen Verbindungstest durch und prüft die Erreichbarkeit der API sowie die Gültigkeit der Anmeldeinformationen.

  5. Nach erfolgreichem Test lädt Syncler automatisch das verfügbare Datenschema der Odoo-Instanz.
    Dieses enthält alle unterstützten Objekte und deren Felder.

Objekte

Der Odoo ERP Konnektor stellt eine Reihe von Standardobjekten bereit, die über Syncs gelesen und geschrieben werden können.
Abhängig von der Konfiguration Ihrer Odoo-Instanz und den installierten Modulen kann der tatsächliche Umfang variieren.

Unterstützte Standardobjekte

Objektname Beschreibung
res_partner Geschäftspartner (Kunden, Lieferanten, Kontakte)
sale_order Verkaufsaufträge inkl. Positionen
sale_order_line Auftragspositionen
product_product Artikel und Produktvarianten
account_move Rechnungen inkl. Positionen
account_move_line Rechnungspositionen
res_country Länderdefinitionen

Hinweis:
Bei Bedarf kann die Schema-Aktualisierung manuell durchgeführt werden, um Änderungen in der Odoo-Instanz zu übernehmen.

Lesen von Daten

Das Lesen erfolgt über die XML-RPC-Schnittstelle von Odoo mit "search_read" für Listen und "read" für einzelne Datensätze.
Standardmäßig werden alle Felder eines Objekts geladen, sofern der Benutzer über ausreichende Berechtigungen verfügt.

Filterung und Abfragen

  • Abfragen können über Filter (Domain) definiert werden, z. B.: 
    (active:=:true),(customer_rank:>:0)
  • Diese Filter lassen sich in Syncs konfigurieren, um gezielte Teilmengen von Datensätzen abzurufen.
  • Firmen können gezielt mit (is_company:=:true) abgerufen werden.

Besonderheiten und Hinweise

  • Der Konnektor verwendet die XML-RPC-API (Port 8069, sofern nicht anders konfiguriert).
  • HTTPS-Verbindungen werden unterstützt und sind für Cloud-Instanzen standardmäßig aktiviert.
  • Für On-Premises-Installationen kann eine Freischaltung der API im Odoo-Server erforderlich sein.
  • Das Schema kann über die Aktion „Schema aktualisieren“ jederzeit neu eingelesen werden.
  • Benutzerdefinierte Felder (x_-Felder) werden automatisch erkannt und ins Schema aufgenommen.