Die bexio-Schnittstelle: was damit möglich ist

Die Schnittstelle von bexio, kurz API, erlaubt es anderen Programmen, Daten in Ihrem bexio zu lesen, anzulegen und zu ändern, etwa Kontakte, Artikel, Offerten, Rechnungen, Projekte und Zeiten. Sie arbeitet mit HTTPS und JSON, der Zugang läuft über OAuth 2.0. Ihr Betrieb muss dafür nicht selbst programmieren, denn Apps und Plattformen nutzen die Schnittstelle im Hintergrund.

Was die Schnittstelle abdeckt

Die Dokumentation von bexio gliedert die Schnittstelle in diese Bereiche:

Nicht jeder Ablauf steht als Endpunkt zur Verfügung. bexio hält in der Dokumentation selbst fest, dass noch nicht jeder Anwendungsfall über die Schnittstelle unterstützt wird. Prüfen Sie deshalb vor jedem Vorhaben, ob der benötigte Endpunkt existiert. Webhooks, also eine Benachrichtigung durch bexio bei Änderungen, beschreibt die Dokumentation nicht. Plattformen wie Zapier fragen regelmässig nach neuen Daten, laut Zapier im kostenlosen Plan alle 15 Minuten.

Beispiel: eine Offerte über die Schnittstelle

Die Schnittstelle bildet den Weg ab, den Sie aus der Oberfläche kennen. Für Offerten bietet sie unter anderem diese Aktionen:

• Offerten anlegen, ändern und suchen, mit Positionen jeder Art, etwa Artikel-, Text-, Rabatt- und Zwischentotalpositionen.
• Eine Offerte stellen, also vom Status «Entwurf» auf «Offen» setzen, sie als versendet markieren, per E-Mail versenden oder als PDF abrufen.
• Eine Offerte annehmen oder ablehnen, kopieren und daraus einen Auftrag oder eine Rechnung erstellen.

Anlegen und Stellen sind getrennte Aktionen («Create quote» und «Issue a quote»). Wer eine Anbindung baut, kann also einen Entwurf anlegen und das Stellen einer Person überlassen. Das ist eine sinnvolle Aufteilung zwischen Automatik und Verantwortung.

So erhält eine Anwendung Zugang

Es gibt zwei Wege. Beide setzen eine Anmeldung mit bexio-Zugangsdaten voraus.

Bei OAuth prüft bexio zwei Ebenen: die Scopes, die der Anwendung erteilt wurden, und die Benutzerrechte der Person, die die Verbindung eingerichtet hat. Beide müssen passen, sonst verweigert bexio den Zugriff. Wie Sie Rechte und Schlüssel sauber vergeben, erklärt der Beitrag Schnittstellen sicher betreiben.

Grenzen und Spielregeln

• Anfragelimit: Eine konkrete Zahl nennt die Dokumentation nicht. Sie beschreibt Kopfzeilen, an denen eine Anwendung das aktuelle Limit, die verbleibenden Anfragen und die Zeit bis zum Zurücksetzen erkennt.
• Löschen: Löschaktionen entfernen Daten laut Dokumentation endgültig, etwa bei Offerten und Artikeln. Kontakte werden nur als gelöscht markiert und bleiben über einen Filter abrufbar.
• Änderungen: Die Schnittstelle entwickelt sich weiter. Seit Juni 2025 gibt es für Adressen die Felder Strassenname, Hausnummer und Adresszusatz, das frühere Feld «address» ist in Anfragen als veraltet markiert. Für Neuigkeiten verweist bexio auf eine Statusseite und einen Entwickler-Newsletter.
• Support: bexio liefert die Schnittstelle, wie sie dokumentiert ist, ohne begleitete Umsetzung oder Hilfe beim Programmieren. Bei Störungen in einer Anbindung eines Drittanbieters wenden Sie sich an diesen Anbieter.
• Bedingungen: Nach den Marketplace-AGB kann bexio den Zugriff aus wichtigem Grund einschränken, etwa bei zu hoher Last. Wer auf der Schnittstelle ein eigenes Geschäftsmodell mit mindestens fünf verbundenen bexio-Konten betreibt, muss das melden. Das betrifft vor allem Dienstleister, die für viele Kunden Anbindungen betreiben.
• Testen: Für die Entwicklung nennt bexio einen Sandbox-Account, der speziell für Entwicklungszwecke gedacht ist.

Drei Wege, die Schnittstelle zu nutzen

1. Fertige App: Der Marketplace bietet Anbindungen für viele Aufgaben. Wie Sie eine passende auswählen, zeigt der Beitrag Apps im bexio-Marketplace sinnvoll auswählen.
2. Plattform ohne Programmierung: Dienste wie Zapier und Make verbinden bexio mit anderen Programmen. Die Details stehen im Beitrag Zapier und Make mit bexio verbinden.
3. Eigene Anbindung: Laut bexio kann jeder eine Integration entwickeln. Dafür brauchen Sie Entwicklerwissen oder einen Dienstleister, denn bexio selbst bietet keine Auftragsentwicklung an.

Auf welchem Weg auch immer: Die Schnittstelle schreibt, was man ihr gibt. Fehler in Kontakten und Artikeln werden mitgeschrieben und vervielfacht. Klären Sie deshalb zuerst die Datenqualität.

Häufige Fragen

Brauche ich die Schnittstelle selbst?

Nur, wenn weder bexio noch eine App oder Plattform Ihre Aufgabe abdeckt. Beginnen Sie am besten mit einer fertigen Lösung und gehen Sie erst bei Sonderfällen zu einer eigenen Anbindung über.

Kostet die Schnittstelle etwas?

Laut bexio-Hilfe steht für die Nutzung der API mit OAuth eine kostenfreie Zugriffsmöglichkeit zur Verfügung. Kosten entstehen durch Apps, Plattformen oder Entwicklungsarbeit. Prüfen Sie die Konditionen beim jeweiligen Anbieter.

Wie sehe ich, welche Anwendungen auf mein bexio zugreifen?

Verbundene Apps listet bexio unter «Alle Einstellungen» → «Apps & API» → «Apps». Dort können Sie eine Verbindung auch entfernen, wie es die bexio-Hilfe am Beispiel von Zapier zeigt. Personal Access Tokens verwalten Sie dagegen im Entwicklerportal.

Kann eine Anbindung Daten ändern, ohne dass ich es merke?

Mit Schreibrechten kann sie Daten anlegen, ändern und löschen. Vergeben Sie deshalb nur die nötigen Rechte, lassen Sie Dokumente als Entwurf anlegen und testen Sie zuerst mit Musterdaten wie «Muster Haustechnik AG».

Fazit

Die bexio-Schnittstelle deckt die wichtigsten Bereiche des Alltags ab: Kontakte, Verkauf, Artikel, Projekte und Zeiten. Der Zugang läuft über OAuth oder, für den persönlichen Gebrauch, über Personal Access Tokens. Bei OAuth müssen Scope und Benutzerrecht passen. Starten Sie mit einer fertigen Lösung, achten Sie auf Rechte und Anfragelimit und halten Sie Ihre Stammdaten sauber.