Odoo-Schnittstelle einrichten: API-Schlüssel anlegen und sicher verbinden

Wozu der API-Schlüssel dient

Die Anbindung spricht Ihre Odoo-Instanz über deren Schnittstelle an, das sogenannte JSON-RPC. Sie meldet sich dabei mit Ihrem Anmeldenamen und dem API-Schlüssel an, nicht mit Ihrem Passwort. Das hat zwei Vorteile: Sie müssen Ihr Passwort niemandem mitteilen, und Sie können den Zugang beenden, ohne das Passwort zu ändern oder andere Anwendungen zu stören.

Verwendet wird der Zugang ausschließlich lesend und nur für die Saldenliste. Die Software rechnet sie aus den gebuchten Buchungszeilen je Konto, mit Eröffnungswerten und Periodenbewegung getrennt; Entwürfe und stornierte Buchungen zählen nicht mit. Einzelne Buchungen werden nicht als Journal übernommen, und in Odoo wird nichts geschrieben. Die Zugangsdaten liegen verschlüsselt gespeichert.

Schritt für Schritt: den Schlüssel in Odoo anlegen

• Melden Sie sich in Odoo mit dem Benutzer an, unter dem die Verbindung laufen soll. Dieser Benutzer sollte die Buchhaltung der betreffenden Gesellschaft sehen dürfen.
• Klicken Sie oben rechts auf Ihren Namen und öffnen Sie „Mein Profil“.
• Wechseln Sie auf den Reiter „Kontosicherheit“ und wählen Sie „Neuer API-Schlüssel“.
• Geben Sie dem Schlüssel einen Namen, an dem Sie später erkennen, wofür er gedacht ist, zum Beispiel „Jahresabschluss“.
• Kopieren Sie den Schlüssel sofort. Odoo zeigt ihn nur dieses eine Mal; ist er verloren, legen Sie einfach einen neuen an.

Die Felder im Verbindungsdialog

Den Dialog öffnen Sie unter Gesellschaft → Integrationen → Odoo → „Odoo verbinden“.

Verbinden und prüfen

Nach dem Klick auf „Verbinden“ testet die Software die Verbindung. Steht sie, kann die Saldenliste direkt übernommen werden. Kommt keine Verbindung zustande, prüfen Sie zuerst die Felder auf typische Ursachen: eine Adresse ohne https, ein Tippfehler im Datenbanknamen, das Passwort an der Stelle des Schlüssels oder ein Anmeldename, der nicht zum Schlüssel passt.

Führt Ihre Datenbank mehrere Gesellschaften, achten Sie auf das letzte Feld. Ein leeres Feld bedeutet, dass alle Firmen gemeinsam gelesen werden; für den Abschluss einer einzelnen Gesellschaft tragen Sie deren ID ein. Wenn viele Gesellschaften angebunden werden sollen, ist der Mehrfirmen-Import unter Integrationen der kürzere Weg, weil er die Firmen selbst ausliest.

Technische Eckdaten für Ihre IT

Wenn Ihre IT-Abteilung oder Ihr Odoo-Partner die Freigabe prüft, helfen diese Angaben.

• Protokoll: Abfragen über die Odoo-Schnittstelle per JSON-RPC, ausschließlich über eine https-Adresse.
• Anmeldung: Anmeldename plus API-Schlüssel; ein Passwort wird weder abgefragt noch gespeichert.
• Umfang: Gelesen werden die gebuchten Buchungszeilen mit ihren Konten, um daraus die Saldenliste je Konto zu rechnen; beim Mehrfirmen-Import zusätzlich die Liste der Firmen der Datenbank.
• Schreibzugriffe: keine. Die Software legt in Odoo weder Buchungen noch Kontakte an und ändert keine Einstellungen.
• Speicherung: Die Zugangsdaten liegen verschlüsselt; die Daten der Software werden in der EU verarbeitet.
• Beendigung: Der Schlüssel lässt sich in Odoo jederzeit einzeln widerrufen, ohne Rückfrage bei uns.

Tarif, Sicherheit und Widerruf

Ob Ihre Odoo-Datenbank Abfragen von außen überhaupt annimmt, hängt vom Vertrag ab. Laut Odoo-Preisseite (Stand: 19. Oktober 2026) ist die externe API Bestandteil des Custom-Tarifs; prüfen Sie daher Ihren Tarif, bevor Sie einen Schlüssel anlegen. Ohne API-Zugang laden Sie die Saldenliste als Excel-Datei hoch, die Sie in Odoo unter Buchhaltung → Berichtswesen → Rohbilanz als XLSX exportieren.

Zur Sicherheit: Die Instanz-Adresse muss mit https beginnen, damit die Verbindung verschlüsselt ist. Der Schlüssel wird verschlüsselt gespeichert und nur zum Lesen verwendet. Widerrufen Sie ihn in Odoo, schlägt jeder weitere Abruf mit diesem Schlüssel fehl; Ihr Passwort und andere Schlüssel bleiben davon unberührt. Für einen späteren Abschluss legen Sie dann einen neuen Schlüssel an und tragen ihn im Dialog ein.

Häufige Fragen

Ist ein API-Schlüssel sicherer als das Passwort?

Er ist vor allem besser abgegrenzt. Sie geben Ihr Passwort nicht weiter, und der Schlüssel lässt sich einzeln zurückziehen, ohne dass Sie sich neu anmelden oder andere Verbindungen anpassen müssen. Hier wird er verschlüsselt gespeichert, nur über https verwendet und ausschließlich zum Lesen der Saldenliste eingesetzt.

Kann die Software über den Schlüssel etwas in Odoo ändern?

Die Software verwendet den Zugang nur lesend. Sie rechnet aus den gebuchten Buchungszeilen die Saldenliste und schreibt nichts zurück: keine Buchung, keinen Kontakt, keine Einstellung. Wer zusätzliche Sicherheit möchte, legt die Verbindung unter einem Benutzer an, dessen Rechte in Odoo auf das Nötige beschränkt sind.

Wo finde ich den Namen meiner Odoo-Datenbank?

Der Datenbankname erscheint beim Anmelden in Odoo. Bei Odoo Online ist es üblicherweise der Name Ihrer Instanz. Bei selbst gehosteten Installationen kennt ihn Ihr Administrator oder der Odoo-Partner, der die Instanz betreut. Achten Sie auf die genaue Schreibweise, denn die Verbindung kommt nur mit dem exakten Namen zustande.

Was passiert, wenn ich den Schlüssel widerrufe?

Die Verbindung bricht ab; neue Abrufe der Saldenliste sind nicht mehr möglich. Bereits übernommene Saldenlisten und daraus erstellte Abschlüsse bleiben hier erhalten. Wollen Sie später wieder Zahlen holen, erzeugen Sie in Odoo einen neuen Schlüssel und tragen ihn im Verbindungsdialog ein.

Kann ich für verschiedene Zwecke getrennte Schlüssel anlegen?

Ja, und das ist empfehlenswert. Legen Sie für jede angebundene Anwendung einen eigenen Schlüssel mit eigenem Namen an. Weil sich jeder Schlüssel in Odoo einzeln widerrufen lässt, können Sie eine Verbindung beenden, ohne die anderen zu berühren, und sehen am Namen, wofür ein Schlüssel gedacht war.

Brauche ich bei Odoo den Custom-Tarif?

Das hängt von Ihrem Vertrag ab. Auf der deutschen Preisseite führt Odoo die externe API beim Custom-Tarif auf (Stand: 19. Oktober 2026). Klären Sie im Zweifel mit Odoo oder Ihrem Odoo-Partner, ob Ihr Tarif Abfragen von außen erlaubt. Ohne diesen Zugang bleibt der Weg über die exportierte Rohbilanz als Excel-Datei.

Funktioniert die Anbindung auch mit einem eigenen Odoo-Server?

Ja. Neben Odoo Online lassen sich selbst gehostete Instanzen anbinden, solange sie über eine https-Adresse aus dem Internet erreichbar sind. Die Felder im Dialog sind dieselben: Adresse, Datenbank, Anmeldename, API-Schlüssel und bei Bedarf die ID der Gesellschaft. Steht der Server hinter einer Firewall, muss er für Anfragen über https von außen erreichbar sein.

Quellen und Rechtsstand

Primärquellen für die zentralen Aussagen dieser Seite. Öffnen Sie im Zweifel immer die aktuelle Fassung.

• Odoo-Preisseite Deutschland (Custom-Tarif: externe API) — abgerufen am 19.10.2026
• Odoo-Dokumentation 19.0 (deutsch): Kontenplan, Rohbilanz — abgerufen am 19.10.2026
• Odoo-Dokumentation 19.0: Berichte exportieren (PDF, XLSX) — abgerufen am 19.10.2026