Was ist eine Schnittstelle (API)?

Glossar · ERP & Odoo

Auch bekannt als: API, Programmierschnittstelle, Application Programming Interface, Webservice, Integration

Kurz erklärt

Eine Schnittstelle (API, Application Programming Interface) ist ein festgelegter Zugang, über den Programme automatisch Daten austauschen oder Funktionen in einem anderen System auslösen – ohne dass jemand Daten abtippt oder Dateien hin- und herschiebt.

Wie eine API funktioniert

Eine API ist so etwas wie die Speisekarte eines Systems: Darauf steht, was man bestellen kann und in welcher Form die Antwort kommt. Ein Programm schickt eine Anfrage – «gib mir alle offenen Rechnungen» oder «lege diesen Auftrag an» –, das andere System prüft die Berechtigung und antwortet in einem vereinbarten Format, heute meist JSON.

Damit das klappt, braucht es drei Dinge: eine Adresse, unter der die Schnittstelle erreichbar ist, eine Anmeldung, etwa mit einem API-Schlüssel, und eine Dokumentation der verfügbaren Funktionen und Felder. Webdienste wickeln das über HTTPS ab, verbreitet ist der REST-Stil.

Typische Schnittstellen im KMU

Welche Verbindungen ihr braucht, hängt vom Geschäftsmodell ab: Ein Handelsbetrieb mit Webshop hat andere Prioritäten als ein Treuhandbüro oder eine Schreinerei. In Schweizer KMU tauchen aber immer wieder dieselben Kandidaten auf:

  • Bank: Kontoauszüge und Zahlungsaufträge im Format ISO 20022
  • Rechnungen: Versand und Empfang über eBill oder als PDF mit QR-Code
  • Webshop und Marktplätze: Bestellungen, Bestände und Preise
  • Branchensoftware, Maschinen und Kassen
  • Versanddienstleister, Zahlungsanbieter und Telefonie

Worauf ihr achten solltet

Legt zuerst fest, welches System für welche Daten führend ist. Wenn zwei Programme dieselbe Adresse ändern dürfen, gewinnt am Ende der Zufall. Klärt ausserdem, wer die Schnittstelle pflegt: Ändert eine Seite ihre API, muss die Verbindung nachgezogen werden.

Gute Schnittstellen melden Fehler, statt still zu scheitern, und erhalten nur die Rechte, die sie wirklich brauchen. Nicht jede Verbindung muss in Echtzeit laufen: Ein regelmässiger Dateiaustausch, etwa per CSV, ist auch eine Schnittstelle – einfacher, aber träger. Wer Programme gar nicht verbindet, landet bei Insellösungen.

Zwei weitere Punkte gehören vor jeden Entscheid: API-Schlüssel sind so heikel wie Passwörter – nicht per Mail verschicken, regelmässig erneuern und sperren, wenn jemand den Betrieb verlässt. Und manche Anbieter schalten ihre API nur in bestimmten Tarifen frei. Prüft das, bevor ihr ein Werkzeug fest einplant.

Schnittstellen in Odoo

Odoo bringt eine externe API mit, über die andere Programme auf fast alle Daten zugreifen können. Seit Version 19 heisst die aktuelle Variante JSON-2-API, angemeldet wird mit API-Schlüsseln. Die älteren Zugänge über XML-RPC und JSON-RPC sind abgekündigt; laut Odoo-Dokumentation sollen sie mit Odoo 22 im Herbst 2028 entfallen. Bestehende Anbindungen solltet ihr also rechtzeitig umstellen.

Auf Odoo Online ist die externe API nur im Custom-Tarif verfügbar. Für manches, etwa den Import von Kontoauszügen oder den Export von Zahlungsdateien, bringt Odoo eigene Funktionen mit; für alles andere entwickeln wir Anbindungen als eigene Module – mehr dazu bei den individuellen Anpassungen.

Häufige Fragen zu Schnittstelle

Deine Frage ist nicht dabei? Frag uns direkt – das Erstgespräch ist kostenlos und unverbindlich.

Was bedeutet API?

API steht für Application Programming Interface, auf Deutsch Programmierschnittstelle. Darüber tauschen Programme automatisch Daten aus.

Hat Odoo eine API?

Ja. Seit Odoo 19 gibt es die JSON-2-API mit Anmeldung über API-Schlüssel; die älteren XML-RPC- und JSON-RPC-Zugänge sind abgekündigt. Auf Odoo Online steht die externe API nur im Custom-Tarif zur Verfügung.

Was ist der Unterschied zwischen Schnittstelle und Import?

Ein Import überträgt Daten einmalig oder bei Bedarf von Hand, etwa beim Systemwechsel. Eine Schnittstelle tauscht Daten laufend und automatisch aus.

Bereit für den nächsten Schritt?

Lass uns gemeinsam herausfinden, wie Odoo euren Betrieb weiterbringt.