bexio an Ihre Werkzeuge anschliessen, was seine Schnittstelle wirklich dokumentiert

Die REST-Schnittstelle 2.0 von bexio, gelesen bevor sie angeschlossen wird

Die Schnittstelle wird von einer einzigen Wurzel aus aufgerufen, https://api.bexio.com/2.0/, und tauscht JSON aus. Die Authentifizierung folgt OAuth 2.0 mit OpenID Connect, auf der Autorisierungsdomäne https://auth.bexio.com/realms/bexio, im Ablauf Authorization Code und dann Refresh Token, wenn eine Anwendung im Namen eines Benutzers handelt. Für eine Brücke, die allein auf einem Server läuft, beschreibt die am 23. August 2026 gelesene Dokumentation des Anbieters ebenfalls persönliche Zugriffstoken. Die beiden Wege öffnen nicht denselben Pfad, und die Wahl fällt vor der ersten Codezeile.

Diese Wahl hat greifbare Folgen. Ein persönliches Token ist an einen Benutzer des bexio-Kontos gebunden und eignet sich für eine Server-zu-Server-Verbindung, die nur ein einziges Unternehmen betrifft. Der Ablauf Authorization Code eignet sich für eine Anwendung, die mehreren bexio-Konten dienen soll, wobei jedes seine Zustimmung selbst gibt. Die öffentliche Dokumentation beschreibt beide sowie die Mechanik der Token-Erneuerung, was erlaubt, die Arbeit vor der Bindung abzuschätzen.

Eine auf Dauer wichtige Einzelheit: Die Versionsnummer steht in der Wurzel der Schnittstelle selbst. Eine Brücke wird also gegen eine benannte Version geschrieben und nicht gegen eine anonyme Adresse, die sich ohne Vorwarnung bewegen würde. Das ist die Art von Punkt, die man beim Entwurf notiert und drei Jahre später wieder liest, wenn sich im Unternehmen niemand mehr erinnert, wer was gebaut hat.

Die Bereiche beschreiben, Objekt für Objekt, was die Brücke sehen darf

bexio zerlegt die Rechte einer Anwendung in feine Bereiche, einen je Objekt und je Handlungsstufe. Die Dokumentation nennt zum Beispiel contact_show für das Lesen der Kontakte, kb_invoice_edit für das Schreiben auf den Rechnungen, project_show für die Projekte. Eine gut entworfene Brücke verlangt nur, was sie braucht, und dieses Verlangen liest sich später im Klartext wieder, an dem Tag, an dem eine Frage aufkommt, was ein Automat im Dossier verändert haben kann.

Es ist auch die erste Abwägung eines Integrationsvorhabens. Eine nur lesende Verbindung zu einem Dashboard verlangt nicht dieselben Bereiche wie ein Automat, der aus einem Onlineshop Rechnungen erstellt. Den Umfang später zu erweitern berührt die Autorisierung selbst, also die Freigabe durch die Person, die das Konto hält. Da stellt man die Liste besser gleich beim Rahmen auf, mit dem Daseinsgrund jeder Zeile.

Fünfhundert Elemente je Anfrage, und eine zu messende Durchsatzbegrenzung

Die Dokumentation kündigt eine Paginierung an mit einer Obergrenze von 500 Elemente pro Abfrage und eine auf die Aufrufe angewandte Durchsatzbegrenzung. Die erste Zahl bemisst jede Datenübernahme. Eine Basis mit mehreren Tausend Kontakten, Artikeln oder Rechnungen wird in Abschnitten gelesen, mit einem auf der Seite des Integrators geführten Zeiger, und diese Zerlegung findet sich in jeder späteren Neusynchronisation wieder, nicht nur am Tag der Inbetriebnahme.

Die zweite Zahl steht in den am 23. August 2026 gelesenen Seiten nirgends als Schwelle. Sie stellt sich unter wirklichen Bedingungen auf dem betroffenen Konto fest, indem man das Verhalten der Aufrufe beobachtet, wenn der Takt steigt. Eine ernsthafte Baustelle beginnt also mit einer Messung statt mit einer Annahme, und der gewählte Takt wird in die Abnahme geschrieben, mit dem Verhalten für den Fall, dass die Schnittstelle einen Aufruf zurückweist.

Ohne dokumentierten Webhook wird die Frische der Daten zu einer Einstellung

Die am 23. August 2026 gelesene öffentliche Dokumentation enthält keinen Abschnitt zu Webhooks und keinen zu einem Ereignismechanismus. Jede Synchronisation mit einem anderen Werkzeug wird also als periodische Abfrage gebaut. Der heikle Punkt ist nicht der Reichtum der Schnittstelle, sondern der Takt, in, dem man beschliesst, sie zu befragen.

Dieser Zwang lässt sich behandeln. Man hält auf der Seite des Integrators die Spur dessen, was bereits gesehen wurde, man spielt die Aufrufe ohne Doppel nach, wenn eine Ausführung auf halbem Weg abbricht, und man wählt je nach Objekt eine andere Frequenz. Ein Artikelkatalog bewegt sich nicht im selben Rhythmus wie ein Rechnungsjournal. Der Entwurf dieser Mechanik macht einen wirklichen Teil der Arbeit aus, und er verdient es, vor der Bestellung schwarz auf weiss beschrieben zu werden.

Es gibt eine für die Benutzer sichtbare Folge. Eine im Shop erstellte Rechnung erscheint in bexio nicht in derselben Sekunde, sie erscheint im nächsten Zyklus. Diese Verzögerung wird gewählt, dokumentiert und den betroffenen Personen gezeigt, statt an einem Montagmorgen von der Buchhalterin entdeckt zu werden, die einen Beleg sucht. Es ist ebenso eine Führungsentscheidung wie ein technischer Parameter.

Nicht alles läuft über die Schnittstelle, und manche Abläufe haben ihren eigenen Kanal

Für die anfängliche Übernahme dokumentiert bexio Importe über Excel- oder CSV-Dateien für die Kontakte, die Produkte und den Kontenplan, beschrieben in den Hilfeartikeln 000001781 und 000001598. Eine Grenze von 15'000 Zeilen wird für den Produktimport gemeldet. Dieser Kanal bleibt oft der kürzeste, um einen Bestand zu laden, wobei die Schnittstelle danach für das tägliche Leben der Daten übernimmt.

Auf der Bankseite läuft die Übernahme der Konto- und Transaktionsdaten über bLink, die Plattform von SIX. Die Zahlungen aus bexio gehören zu bexio Pay, verrechnet mit CHF 14.00 pro Monat und im Paket Ultimate inbegriffen. Die Löhne gehen über Swissdec an die Versicherungen und die Behörden hinaus, wobei das Produkt bexio Lohnbuchhaltung im offiziellen Register in ELM 5.0, 5.1 und 5.3 unter dem Zertifikat Nr. 1142.24 figuriert. Die QR-Rechnung ihrerseits wird nativ erzeugt.

Zwei Abläufe verdienen eine vorgängige Prüfung. Der Versand von Rechnungen in das E-Banking des Empfängers über eBill läuft über eine Drittanwendung des Marketplace, eBill von iomarket AG, zusätzlich verrechnet. Und bexio figuriert nicht in der am 21. August 2026 aktualisierten OpenPeppol-Liste der Certified Service Providers. Ein Unternehmen, das einem Peppol verlangenden Auftraggeber fakturieren muss, schaut für genau diesen Kanal anderswo hin, und es weiss das vor der Unterschrift.

Der Marketplace deckt einen bekannten Fall ab, eine Brücke deckt Ihren ab

Der Marketplace von bexio kündigt über hundert Anwendungen an, vom Onlinehandel bis zur Dokumentenverwaltung. Wenn eine veröffentlichte Anwendung genau dem Bedarf entspricht, ist das der kürzeste Weg, und er wird vor jeder Entwicklung erprobt. Das Massgeschneiderte beginnt anderswo, dort wo Kundennummern zwischen zwei Systemen zusammengeführt, eine hauseigene Regel angewandt oder ein internes Fachwerkzeug angebunden werden muss, das niemand sonst benutzt.

Eine Brücke braucht einen Zugang zum Konto, und dieser Zugang zählt. Die am 23. August 2026 veröffentlichten Pakete schliessen eine feste Benutzerzahl ein, und der Preis eines zusätzlichen Zugangs ist für einen Teil von ihnen veröffentlicht. Die Abwägung stellt sich im Augenblick der Entscheidung, ob der Automat unter einem eigenen technischen Konto arbeitet, was die Spuren lesbar macht, oder unter dem Konto einer Person, was sie mit deren täglicher Arbeit vermischt.

Zwischen den beiden Optionen ist das nützliche Kriterium die Lebensdauer. Eine Anwendung des Marketplace ist ein Vertrag mit einem Dritten, mit seinem eigenen Rhythmus der Aktualisierungen und seinem eigenen Support. Eine für das Unternehmen geschriebene Brücke folgt den Bereichen und dem Takt, die man ihr gesetzt hat, und ihr Code gehört zum Dossier. Beides rechtfertigt sich, und die Wahl stellt sich Ablauf für Ablauf, nicht ein für alle Mal.

Der Ausgang der Daten bereitet sich an dem Tag vor, an, dem man eintritt

Die Hilfe des Anbieters dokumentiert Exporte in PDF und in Excel sowie eine Sicherungsfunktion. Kein vollständiger Export der Datenbank als einzelne Datei ist in den am 23. August 2026 gelesenen Seiten dokumentiert. In diesem Zusammenhang wird die Schnittstelle selbst zu einem Mittel des Wiederlesens, und die der Brücke gewährten Bereiche bestimmen, was sie tatsächlich zurückholen kann. Die Frage stellt sich zu Beginn eines Vorhabens, nicht an dem Tag, an, dem man gehen möchte.

Ein letzter nützlicher Anhaltspunkt. Das offizielle Partnerprogramm von bexio richtet sich an Treuhandstellen, wobei das öffentliche Verzeichnis über 1'000 Treuhandgesellschaften und Status von Silber bis Platin ankündigt. Für den technischen Teil stützt sich das Unternehmen auf die öffentliche Dokumentation und auf jene, die sie zu lesen wissen. Wir verkaufen keine Lizenzen.

• Die zu synchronisierenden Objekte, und die Laufrichtung jedes einzelnen
• Die strikt notwendigen Bereiche, Lesen und Schreiben getrennt
• Der gewählte Zugangsweg, persönliches Token oder vollständiger OAuth-Ablauf
• Der Abfragetakt, auf dem wirklichen Konto gemessen, bevor er festgelegt wird
• Das Konto, unter dem die Brücke arbeitet, und was es kostet
• Was eines Tages wieder heraus können muss, und über welchen Kanal

Woher diese Antworten stammen

Jede Tatsache dieser Seite lässt sich an der Quelle prüfen. Die Links öffnen direkt die Website des Anbieters oder der betreffenden Organisation.

• bexio, Pakete und PreiseNamen und Preise der vier Pakete, inbegriffene Benutzer und Preis eines zusätzlichen Zugangs, gelesen am 23.08.2026
• Dokumentation der bexio-SchnittstelleWurzel api.bexio.com/2.0, OAuth 2.0 und OpenID Connect, persönliche Zugriffstoken, Bereiche, Paginierung bei 500, Durchsatzbegrenzung, kein Webhook-Abschnitt
• bexio, die QR-RechnungNative Erzeugung der Schweizer QR-Rechnung und Zuordnung der Zahlungen
• bexio, die elektronische RechnungeBill über die Drittanwendung iomarket AG des Marketplace, zusätzlich verrechnet
• Swissdec-Register der zertifizierten Programmebexio Lohnbuchhaltung zertifiziert ELM 5.0, 5.1 und 5.3, Zertifikat Nr. 1142.24
• OpenPeppol-Liste der Certified Service ProvidersAm 21.08.2026 aktualisierte Liste, ohne Eintrag bexio
• Datenschutzerklärung von bexioPersonendaten der Kunden ausschliesslich in der Schweiz gespeichert und bearbeitet, Server in der Schweiz gelegen
• Mitteilung von bexio vom 18. Februar 2026100'000 Kunden, zu 100 % Tochter der Mobiliar, neue Pakete ab März 2026
• inside-it, bexio kündigt 100'000 Kunden anEinordnung durch die Schweizer Informatikpresse, Swiss21 über 80'000 und KLARA 50'000
• Verzeichnis der Treuhandpartner von bexioDen Treuhandstellen vorbehaltenes Partnerprogramm, über 1'000 gelistete Gesellschaften, Status von Silber bis Platin
• inside-it, die Mobiliar übernimmt bexioAnkündigung des Kaufs am 05.07.2018, 100 % der Aktien

ERHEBUNG VOM 23.08.2026

Häufige Fragen