Odoo-Schnittstelle und API-Integration

Odoo ist eine Open-Source-ERP-Plattform, die in ganz Europa und weltweit für Buchhaltung, Rechnungsstellung, Lagerhaltung und CRM eingesetzt wird. Es gibt sie in zwei Editionen, Community und Enterprise, und sie läuft entweder in der Cloud auf Odoo.sh oder selbst gehostet auf der eigenen Infrastruktur eines Kunden. Für ein Softwareteam heißt das, dass jeder Kunde seine eigene Basis-URL, seinen eigenen Datenbanknamen und möglicherweise eine andere Odoo-Version mitbringt.

Nein. Odoo stellt XML-RPC und JSON-RPC über einen einzigen Endpunkt bereit, der Modellnamen, Methodenaufrufe und Zugangsdaten im Rumpf der Anfrage erwartet. Maesn spricht JSON-RPC mit Odoo und antwortet Ihnen als REST, auf Ihrer Seite ist also kein RPC-Aufbau nötig.

Das sind die zwei Protokolle für entfernte Prozeduraufrufe, die Odoo anstelle einer REST-API bereitstellt. Beide laufen über einen einzigen Endpunkt, der einen Modellnamen. Einen Methodenaufruf und Zugangsdaten im Rumpf der Anfrage erwartet, Sie sprechen also die internen Modelle von Odoo direkt an statt benannter Ressourcen. Das ist ein anderes Denkmodell als bei jeder REST-Integration, die Ihr Team bisher geschrieben hat, und genau diesen Teil übernimmt Maesn: Ihre Anfragen kommen hier als REST an, wir sprechen das Protokoll, das das Odoo des Kunden will, und zurück kommt dasselbe gemeinsame Datenmodell wie bei jedem anderen System auf der Plattform.

Zwei Antworten, denn es hat zwei Seiten. Auf der Seite von Odoo gibt es kein eigenes Preisschild, aber eine Hürde: Die eigene Entwicklerdokumentation von Odoo schreibt, dass der Zugriff auf Daten über die externe API nur in den Custom-Tarifen von Odoo verfügbar ist und nicht in One App Free oder Standard. Das ist ein Vertrag zwischen Ihrem Kunden und Odoo, und keine Integrationsschicht ändert daran etwas, und deshalb gehört die Tariffrage in die Qualifizierung und nicht in den Sprint. Auf der Seite von Maesn gibt es überhaupt keine zweite Rechnung: Der Zugang zu jeder Integration ist enthalten, und abgerechnet wird eine Pauschale je angebundenem Kunden statt je API-Aufruf, Odoo zu erreichen kostet Sie also nicht mehr als jedes andere System auf der Plattform. Was Sie nicht mehr bezahlen, ist die Arbeit hinter der Hürde: die RPC-Schicht, die Instanz-URL und die Datenbank, die sich je Kunde unterscheiden, und die Versionsunterschiede von einem Kunden zum nächsten.

Ihr Kunde liefert vier Werte: die Instanz-URL, den Datenbanknamen, seine Login-E-Mail-Adresse und ein Zugangsmerkmal, idealerweise einen API-Schlüssel, erzeugt unter Einstellungen, Benutzer, Sicherheit, statt des Kontopassworts. Odoo authentifiziert dann je Sitzung, und Maesn hält diese Sitzung, einschließlich der erneuten Authentifizierung, wenn sie abläuft.

Basis-URL und Datenbankname werden je angebundenem Kunden verwahrt und an jede Anfrage gehängt. Ob ein Kunde Odoo.sh oder den eigenen Server betreibt, macht für Ihren Integrationscode keinen Unterschied.

Kein Odoo-Objekt trägt ein natives Event. Die Änderungserkennung ist hier also ein Lesezugriff, den Sie einplanen, und kein Abonnement, das Sie registrieren. Über Maesn ist dieser Lesezugriff derselbe Delta-Aufruf, den Sie gegen jedes andere angebundene System schon fahren, es ist also eine Schleife und nicht eine je System.

Odoo veröffentlicht keine öffentliche Sandbox. Der übliche Weg ist deshalb ein eigenes kostenloses Odoo-Testkonto, gegen das Sie bauen. Wo das nicht geht, richten wir Ihnen eines ein, die erste Integration zeigt damit nie auf das Produktivsystem eines Kunden.

Konten, Kontakte, Rechnungen, Journale, Buchungssätze und Zahlungen sind heute freigeschaltet, wobei Konten, Kontakte und Buchungssätze auch schreibbar sind. Odoo führt außerdem die meisten Objekte auf Anfrage von allen Systemen im Katalog. Die Abdeckung ist also ein Anfang und keine Obergrenze.

Ja. Der Eintrag läuft in Selbstbedienung über ein GitHub-Repository, das mit Ihrem Odoo-Konto verbunden ist, und App-Seiten werden nach der Qualität der Beschreibung, nach Screenshots und nach Vollständigkeit bewertet. Maesn unterstützt die technische Vorbereitung und die Einhaltung der Richtlinien.

Weil die Arbeit bei Odoo nicht aufhört. Direkt heißt, die RPC-Schicht zu tragen, eine Basis-URL und eine Datenbank je Kunde, eine Sitzung, die ohne Vorwarnung abläuft, ein Verhalten, das sich zwischen den jährlichen Hauptversionen verschiebt, und eine Änderungserkennung ohne Events, auf denen sie aufbauen könnte. Über Maesn bauen Sie einmal gegen ein Datenmodell, und jedes andere unterstützte Buchhaltungs- und ERP-System ist danach auf derselben Schnittstelle erreichbar.