Odoo anbinden: Zwei Protokolle mit Frist, eine Tabelle für jeden Kontakt

Odoo antwortet auf Remote Procedure Calls statt auf REST, und bis vor Kurzem war die einzige Frage, welches der beiden Sie wählten. Seine eigene Referenz hat beiden inzwischen einen Abkündigungstermin gegeben, und sie nennt zwei verschiedene Termine.

Der Hinweis steht in einem mit Danger markierten Kasten oben in der RPC-Referenz: „Sowohl die XML-RPC- als auch die JSON-RPC-API an den Endpunkten /xmlrpc, /xmlrpc/2 und /jsonrpc sind zur Entfernung in Odoo 22 (Herbst 2028) und Online 21.1 (Winter 2027) vorgesehen.“ Der External-JSON-2-Endpunkt wird als Ersatz genannt.

Was Ihren Code erreicht, ist REST, auf derselben Schnittstelle wie jedes andere System im Katalog, beschrieben auf der Seite zur Odoo-Schnittstelle. Welcher der zwei Termine für einen bestimmten Kunden gilt, folgt aus seinem Hosting und seiner Version.

Odoo liefert seit elf Jahren eine Hauptversion pro Jahr und betreibt jede davon isoliert, mit eigener Codebasis und eigenem Datenbankschema. Niemand wird automatisch aktualisiert, ein Versionswechsel ist also ein Projekt, das jemand einplant.

Das ist gewöhnliches Release-Management, bis zu dem Moment, in dem Sie es neben die zwei Termine legen. Welche Schnittstelle ein Mandant aufrufen kann, ist eine Eigenschaft seiner Version, und inzwischen gilt das auch dafür, wie lange er sie noch aufrufen kann.

Die Release-Liste erklärt die Asymmetrie. Online 21.1 ist eine Nebenversion, und Nebenversionen kommen seit Januar 2026 alle paar Monate, während Hauptversion 22 dem Jahresrhythmus folgt. Einen gehosteten Mandanten verschiebt Odoo, nach Odoos Zeitplan; einen selbst gehosteten verschiebt sein Betreiber, wenn er sich dafür entscheidet, was den späteren Termin nur dem Anschein nach zum weicheren macht.

Vier Werte, einmalig: die Basis-URL der Instanz ohne jeden Pfad, der Datenbankname dahinter, eine Login-E-Mail-Adresse und entweder ein Passwort oder ein Schlüssel. Auf den RPC-Endpunkten reisen alle vier bei jedem Aufruf mit, und genau dort suchen Anbindungen gern nach einer Sitzung.

Es gibt keine. „Beide Funktionen sind zustandslos. Das bedeutet, dass Datenbank, Benutzer-ID und Benutzerpasswort bei jedem Aufruf mitgegeben werden müssen.“ Nichts wird ausgetauscht, nichts wird erneuert, nichts läuft mitten im Lauf ab.

Der Nachfolger arbeitet andersherum. Eine JSON-2-Anfrage trägt Authorization: bearer und, wo ein Server mehrere Datenbanken beherbergt, einen Header X-Odoo-Database. Weder die Benutzer-ID noch das Passwort taucht darin auf.

Eine Voraussetzung gilt nur für gehostete Instanzen: Odoo Online legt Benutzer ohne lokales Passwort an, ein Administrator setzt also eines, bevor der RPC-Zugriff überhaupt funktioniert. Diese Art von Vielfalt von Ihrer Seite fernzuhalten, ist das Thema von Unified Authentication.

Zwei Felder trennen eine Firma von einer Person: is_company, ein Boolean, und parent_id, das eine Person auf die Firma verweist, zu der sie gehört. Ein Listenaufruf gibt beide Arten zusammen zurück, in keiner brauchbaren Reihenfolge.

Ein Fehler folgt daraus, und zwar aus der Struktur selbst. Behandeln Sie jeden Datensatz als eigenständig, und eine Firma mit vier Kontakten kommt als vier Firmen an, weil jede Person ihre Mutter als Attribut trägt statt als Verweis. Die Beziehung geht nicht unterwegs verloren, sie wurde nie gelesen.

Hier ist das der einzige Weg hinein. Unsere Abdeckung markiert Customers und Suppliers in jeder Spalte als nicht verfügbar, und der Filter in der Anfrage oben ist der, den Odoo in seinem eigenen Beispiel verwendet.

Für Ändern und Löschen ist nichts freigeschaltet, Korrekturen werden also als neue Belege gebucht, und genau so erwartet es die Buchhaltungspraxis ohnehin.

Weitere 133 der 185 Kombinationen aus Objekt und Operation sind als auf Anfrage verfügbar markiert. Das ist die ERP-Fläche und keine Roadmap: die Objekte existieren, sie sind nicht standardmäßig freigeschaltet, und welche davon wir freischalten, ist ein Gespräch über Ihren Use Case.

Zwei Grenzen liegen außerhalb dieses Gesprächs. Odoo stellt nur bereit, was die angebundene Instanz installiert hat, bei einem Kunden ohne die Accounting-App gibt es also keine Rechnungen zu lesen, was auch immer die Tabelle sagt. Und der Zugang zur externen Schnittstelle ist „nur in den Custom-Preisplänen von Odoo verfügbar“, was in die Qualifizierung gehört und nicht in einen Sprint.

Was wir von der Liste nehmen:

• Das Protokoll. Der Aufruf, seine Form und die Modellnamen bleiben hinter unserer Schnittstelle, kein RPC-Konstrukt erreicht also Ihren Code.
• Die vier Werte, je Kunde. Basis-URL, Datenbank, Login und Zugangsdaten werden einmal erhoben und an jede Anfrage gehängt, ob gehostet oder selbst gehostet.
• Die Trennung in res.partner. Firmen und Personen werden getrennt und verknüpft, bevor sie bei Ihnen ankommen, und das ist der Unterschied zwischen einer Kontaktliste und einem Dublettengenerator.

Drei Dinge bleiben bei Ihnen, und zwei davon sind Entscheidungen, bevor sie Arbeit sind:

• Der Plan und die Version, auf der Ihr Kunde ist. Die Hürde des Custom-Plans liegt zwischen ihm und Odoo, und keine Integrationsschicht verschiebt sie. Dasselbe gilt für die Version, die er betreibt, und sie entscheidet, wann die zwei Termine oben ihn erreichen.
• Wie frisch Ihr Produkt sein muss. Ein geplanter Lesezugriff hat ein Intervall, und es zu wählen ist eine Produktentscheidung. Paginieren und Filtern lesen sich hier wie überall sonst, und das ist das Thema von Unified Pagination & Filtering.
• Welche Objekte Sie freigeschaltet brauchen. Sechs sind es heute, und diese Menge ist der Anfang des Gesprächs und nicht sein Ende.