bexio-API: Änderungen und alte Schnittstelle

Die bexio-API ändert sich laufend, und zwei Änderungen treffen Anbindungen besonders oft: Adressen bestehen seit 2025 aus Strasse, Hausnummer und Adresszusatz, und die alte «legacy» API ist abgelöst. Wer Zapier, Make, n8n, ein Add-on oder ein eigenes Skript mit bexio verbunden hat, sollte beides prüfen. Dieser Beitrag zeigt, was bexio dokumentiert hat, was Ihre Anbindung ändern muss und wo die offiziellen Angaben enden.

Wo Sie Änderungen nachlesen

Die Dokumentation unter docs.bexio.com führt einen Änderungsverlauf («Changelog») mit Datum. Dort finden Sie jede Anpassung an Feldern, Berechtigungen und Endpunkten. Zusätzlich verweist die Dokumentation auf eine Statusseite für kurzfristige Störungen und auf einen Newsletter für Entwickler. Wer eine eigene Anbindung betreibt, abonniert beides.

Die bexio-Hilfe ergänzt das aus Kundensicht: Sie beschreibt zum Beispiel, wie Sie in Zapier auf die neuen Adressfelder umstellen. Support für Partner-Anbindungen leistet bexio nicht.

Die wichtigsten Änderungen im Überblick

Die Tabelle fasst zusammen, was der Änderungsverlauf und die Hilfe nennen.

Strukturierte Adressen: was Ihre Anbindung ändern muss

Seit Juli 2025 speichert bexio Adressen von Kontakten in getrennten Feldern. Ist die Adresse eines Kontakts nicht strukturiert, bleibt die Angabe unter «Zahlbar durch» im QR-Code der Rechnung unter Umständen leer. Der Kunde kann trotzdem bezahlen, muss die Adresse aber selbst erfassen. Genau deshalb lohnt sich die Umstellung auch für Daten, die über eine Anbindung entstehen.

So gehen Sie vor:

1. Felder zuordnen: Schreiben Sie Strasse nach street_name, Hausnummer nach house_number und Zusätze nach address_addition. Die Dokumentation verlangt street_name, sobald Hausnummer oder Adresszusatz gefüllt sind.
2. Antworten anpassen: Lesen Sie in Antworten die neuen Felder. Das alte Feld address liefert bexio laut Changelog nur noch aus Gründen der Rückwärtskompatibilität mit. Ein Datum für das Ende nennt der Änderungsverlauf nicht.
3. Zapier aktualisieren: Die bexio-Integration in Zapier trennt die Adresse seit Version 4.0.8 in «Street Name», «House Number» und «Address Addition». Das frühere Adressfeld ist entfernt, bestehende Zaps müssen Sie deshalb neu zuordnen. Die Schritte beschreibt Zapier-Verbindung zu bexio erneuern.
4. Bestehende Kontakte bereinigen: Für den Altbestand bietet bexio in der Kontaktliste die Massenmutation «Adressen aufteilen» an. Pro Durchgang verarbeitet sie höchstens 500 Kontakte. Das Vorgehen und die Fallstricke stehen in Strukturierte Adressen in bexio: Fehler vermeiden.
5. Testen: Legen Sie einen Testkontakt über die Anbindung an und prüfen Sie in bexio, ob Strasse, Hausnummer und Zusatz in den richtigen Feldern stehen.

Die alte «legacy» API: was belegt ist

Belegt ist, dass bexio die alte Schnittstelle ablöst. Der Änderungsverlauf nennt den 30. November 2023 als angekündigtes Abschaltdatum und vermerkt im Februar 2024, dass die Dokumentation entfernt wurde. Die bexio-Hilfe hat zudem einen eigenen Beitrag für den Fall «Meine Anbindung an die bexio legacy API funktioniert nicht mehr».

Die Antwort der Hilfe ist knapp:

• Als Kunde einer Anbindung wenden Sie sich an den Anbieter der Anwendung. bexio bietet keinen Support für Partner-Anbindungen.
• Als Entwickler einer Anbindung konsultieren Sie die Dokumentation auf docs.bexio.com.

Nicht belegt ist, woran Sie eine Anbindung auf der alten Schnittstelle erkennen und wie genau jede einzelne Anbindung abgeschaltet wurde. Die offiziellen Seiten sagen dazu nichts. Fragen Sie beim Anbieter oder Entwickler nach, welche API-Version die Anbindung nutzt. Gibt es keine Antwort, lohnt ein Blick in den bexio Marketplace, auf den die Hilfe für fertige Anbindungen verweist.

Wer selbst entwickelt, findet den Einstieg in bexio-API: erste Schritte für Entwickler. Laut Hilfe steht der Zugang über docs.bexio.com kostenfrei zur Verfügung. Auftragsentwicklung oder Hilfe bei der Umsetzung bietet bexio nicht an. Für die kommerzielle Nutzung verweist die Dokumentation auf besondere Regeln in den Nutzungsbedingungen.

Checkliste für Ihre eigene Anbindung

1. Bestandsaufnahme: Notieren Sie jede Anbindung, die auf bexio zugreift, samt Anbieter oder Verantwortlichem.
2. Anmeldung: Prüfen Sie, dass Ihre Anbindung die Anmeldung über auth.bexio.com nutzt und keine alten Adressen des früheren Dienstes.
3. Token: Ein persönliches Zugriffstoken läuft nach 60 Tagen ab, gewährt vollen Zugriff auf die Daten Ihres Unternehmens und ist nur für den persönlichen Gebrauch gedacht. Terminieren Sie die Erneuerung. Einzelheiten zu Zugängen und Berechtigungen stehen in bexio-API: Zugang und Token einrichten.
4. Berechtigungen: Vergleichen Sie bei Einkaufsfunktionen die angeforderten Berechtigungen mit der Dokumentation, die im Juni 2026 angepasst wurde.
5. Tolerant lesen: Ihre Anbindung sollte unbekannte zusätzliche Felder ignorieren, statt abzubrechen.
6. Gefahrlos testen: Zum Entwickeln nennt bexio auf seiner API-Seite einen eigenen Sandbox-Account. Löschaufrufe sind laut Dokumentation endgültig und lassen sich nicht rückgängig machen, testen Sie sie nie mit Echtdaten.

Häufige Fragen

Mein Zap ist plötzlich ausgefallen. Liegt es an den Adressen?

Das ist möglich, wenn der Zap Adressen schreibt oder liest. Öffnen Sie den Zap, prüfen Sie, ob bei der bexio-Aktion ein Update-Hinweis erscheint, und ordnen Sie die neuen Felder zu. Hilft das nicht, erneuern Sie die Verbindung.

Muss ich als normaler bexio-Kunde etwas an der API tun?

Nein, die Schnittstelle sprechen nur Anbindungen an. Betreuen Sie keine eigene, kümmert sich der Anbieter. Sinnvoll bleibt, Ihre Kontakte strukturiert zu halten, damit QR-Rechnungen vollständig sind.

Wird das Feld address irgendwann entfernt?

Der Änderungsverlauf führt es als veraltet und nennt kein Datum. Planen Sie die Umstellung trotzdem jetzt, damit sie nicht unter Zeitdruck passiert.

Wo erfahre ich von neuen Änderungen?

Im Änderungsverlauf auf docs.bexio.com sowie über die dort verlinkte Statusseite und den Entwickler-Newsletter.

Fazit

Die zwei grossen Änderungen sind erklärt: strukturierte Adressen in der API und die Ablösung der alten Schnittstelle. Prüfen Sie Ihre Anbindungen auf die neuen Adressfelder, die Anmeldung und die Laufzeit von Token, und testen Sie Änderungen ausserhalb Ihrer echten Daten. Wo die offizielle Dokumentation schweigt, etwa bei der Erkennung der alten Schnittstelle, hilft die Rückfrage beim Anbieter.