Abacus Schnittstelle: REST API, AbaConnect und Drittsysteme

Wer ein Drittsystem mit Abacus verbinden will, stösst schnell auf mehrere Begriffe: REST API, AbaConnect, ODBC, XML-Import. Welche Schnittstelle passt, hängt von der Abacus-Version, dem Hosting und der Aufgabe ab. Die Entscheidung falsch zu treffen, kostet später Umbauten.

Dieser Beitrag ordnet die Optionen, nennt typische Anbindungen, erklärt die Rolle von Abacus-Partnern und unabhängigen Entwicklern und zeigt, was den Aufwand bestimmt.

Hinweis: Hedinger-Digital ist nicht mit Abacus Research AG verbunden. Abacus und AbaWeb sind Marken der Abacus Research AG. Dieser Beitrag ist ein unabhängiger Ratgeber und keine offizielle Dokumentation. Verbindlich ist der Abacus API Hub.

Die Schnittstellen von Abacus im Überblick

Zentrale Anlaufstelle ist der Abacus API Hub. Er bündelt die Informationen zu den Schnittstellen der Abacus Business Software. Es gibt im Wesentlichen drei Wege.

REST API. Sie wurde mit Version 2023 offiziell eingeführt und wird weiterentwickelt. Die Authentifizierung läuft über OAuth mit einem Service-Benutzer (Client-ID und Client-Secret). Abacus veröffentlicht jedes Jahr eine neue Hauptversion, und Umfang und unterstützte Objekte unterscheiden sich je nach Version. Die Übersicht dazu steht im API Hub.

AbaConnect. Die ältere Schnittstelle basiert auf SOAP-Webservices und bietet zusätzlich XML-Import und -Export über AbaMenu. Sie war lange die von Abacus empfohlene Schnittstelle und ist bei bestehenden Anbindungen weiterhin im Einsatz. Bei neuen Projekten ist zuerst zu klären, ob die REST API die benötigten Objekte abdeckt.

Dateibasierter Austausch und Datenbankzugriff. Bestellungen lassen sich unter anderem im AbaDoc-XML-Format über einen E-Mail-Zugang in einen E-Business-Eingang übergeben. Für Auswertungen gibt es zusätzlich Zugriff über ODBC/JDBC. Das eignet sich für Berichte und einfache Übergaben, weniger für interaktive Anbindungen.

Welche Schnittstelle wofür

Die Tabelle ist eine Faustregel. Abgesichert wird sie durch einen Blick in die Objektübersicht der eingesetzten Version.

Voraussetzungen: Version, Lizenz, Zugang

Eine Anbindung setzt nach Angaben von Integrationspartnern eine ausreichend aktuelle Abacus-Version mit aktivierter REST-Schnittstelle, die passenden Lizenzen und einen von aussen erreichbaren, abgesicherten Zugang voraus. Zusätzlich braucht es Berechtigungen und einen technischen Benutzer. Dieser wird üblicherweise gemeinsam mit dem Abacus-Betreuer des Unternehmens eingerichtet.

Bei jedem Betrieb sind drei Angaben individuell:

• Basis-URL des Servers, abhängig von Hosting und Anbieter
• Abacus-Version, denn sie bestimmt die verfügbaren Endpunkte
• Mandant, also welche Gesellschaft angesprochen wird

Das klingt nach Detail, führt in der Praxis aber zu den meisten Verzögerungen: Ohne diese Angaben und den Zugang lässt sich keine Anbindung testen.

Typische Anbindungen an Drittsysteme

Online-Shop. Shopware, WooCommerce oder eine Eigenentwicklung gleichen Artikel, Kunden, Preise, Lagerbestände und Bestellungen mit Abacus ab. Die REST API löst dabei Abashop ab.

Zeiterfassung und Projektsoftware. Erfasste Stunden fliessen nach Abacus und bilden die Grundlage für Fakturierung und Nachkalkulation.

CRM. Kundenstamm und Aufträge werden zwischen CRM und Abacus abgeglichen, damit Vertrieb und Buchhaltung mit denselben Daten arbeiten.

Branchensoftware und Kassensysteme. Gastronomie, Handel, Handwerk und andere Branchen betreiben oft eigene Fachsysteme. Umsätze, Debitoren und Belege werden in Abacus übernommen.

Dokumentenverwaltung und Belegfluss. Rechnungen und Belege werden aus Ablagen oder E-Mail-Eingängen an die Buchhaltung übergeben. Wie dies mit KI-Unterstützung aussehen kann, zeigt der Beitrag zu KI in der Buchhaltung mit bexio und Abacus. Für Treuhandbüros und deren Mandanten gibt es eine eigene Seite zu Digitalisierung im Treuhandwesen.

Wer bexio einsetzt, findet das Gegenstück im Beitrag bexio Schnittstelle: API, Apps und Automatisierung.

Abacus-Partner oder unabhängiger Entwickler

Es gibt keine einheitliche Antwort. Drei Konstellationen kommen vor.

Ihr Abacus-Partner. Er kennt Installation, Version und Lizenzen, richtet Benutzer ein und liefert oft fertige Lösungen. Sinnvoll, wenn die Anbindung nahe am Standard liegt oder Abacus-Anpassungen nötig sind.

Ein unabhängiger Entwickler. Er baut die Verbindung auf Ihrer Seite, etwa zwischen Abacus und einer Eigenentwicklung oder einem Workflow-Tool. Das ist möglich, sobald die Abacus-Seite (Version, Lizenz, technischer Benutzer) mit dem Abacus-Betreuer geklärt ist. Vorteil: freie Wahl von Technik und Preis, Flexibilität bei Sonderfällen.

Ein Marketplace-Produkt. Der Abacus Marketplace führt geprüfte Partnerlösungen auf REST-Basis, etwa für Dokumentenverwaltung, CRM und E-Commerce. Wer eine solche Lösung anbieten will, durchläuft ein Aufnahmeverfahren mit Prüfung durch Abacus. Für einen einzelnen Betrieb ist das meist nicht nötig, für ein Produkt mit vielen Kunden schon.

Bei der Wahl zählt, wer im Störungsfall Verantwortung trägt. Halten Sie schriftlich fest, wer die Abacus-Seite und wer die Integrationsseite betreut.

Was Aufwand und Kosten bestimmt

Preise hängen von Umfang und Lizenzen ab und lassen sich ohne Anforderungen nicht seriös nennen. Diese Faktoren treiben den Aufwand:

• Anzahl und Art der Objekte: Ein Artikelstamm ist einfacher als Bestellungen mit Rabatten, Gebinden und Teillieferungen.
• Richtung des Datenflusses: Nur lesen ist einfacher als in beide Richtungen abgleichen.
• Abacus-Version und Hosting: Nicht jede Version bietet alle Objekte, und der Zugang von aussen muss abgesichert sein.
• Änderungserkennung: Nach Angaben unabhängiger Integrationsanbieter gibt es keine Webhooks. Änderungen werden über abonnierte Änderungsthemen abgeholt, das braucht eine geplante Abfrage.
• Fehlerbehandlung: Was passiert, wenn ein Artikel fehlt, der Server nicht antwortet oder die Zahlen nicht stimmen?
• Ratenbegrenzung: Pro Benutzer gelten Limits pro Minute, Stunde und Tag, die je nach Version variieren. Grosse Erstimporte brauchen Drosselung.
• Tests und Wartung: Jede jährliche Hauptversion kann Anpassungen nach sich ziehen.

Für ein belastbares Angebot genügt ein kurzer Anforderungskatalog: welche Systeme, welche Objekte, welche Richtung, welches Volumen, welche Version.

Grenzen und wann sich eine Schnittstelle nicht lohnt

• Versionsabhängigkeit. Was in der einen Version geht, fehlt in einer älteren. Vor dem Projekt gehört die Objektübersicht zur Version geprüft.
• Keine Webhooks. Echtzeit-Reaktionen sind nicht ohne Weiteres möglich, Änderungen kommen mit Verzögerung.
• Erreichbarkeit. Bei Installationen im eigenen Netz braucht es einen gesicherten Zugang von aussen. Das ist eine Sicherheitsfrage, nicht nur eine technische.
• Lizenzen und Rechte. Ohne passende Lizenz und Berechtigungen bleiben Endpunkte gesperrt.
• Verantwortung. Automatisierte Buchungen ersetzen die Prüfung nicht. Die Verantwortung für die Buchführung bleibt beim Unternehmen (OR, GeBüV).
• Datenschutz. Sobald Abacus-Daten an Workflow-Plattformen oder KI-Dienste weitergegeben werden, gelten Auftragsbearbeitung und revDSG für den gesamten Datenfluss. Der Beitrag zu Datenschutz bei KI-Tools fasst die Punkte zusammen.

Nicht lohnen sich Schnittstellen bei wenigen Datensätzen pro Monat: Dann ist ein CSV- oder XML-Import oft ausreichend und günstiger. Ebenso, wenn der Prozess selbst noch nicht geklärt ist. Erst den Ablauf festlegen, dann automatisieren. Zur Wahl des Werkzeugs: Make vs n8n.

Nächster Schritt

Notieren Sie, welche Systeme mit Abacus sprechen sollen, welche Daten in welche Richtung fliessen und welche Abacus-Version im Einsatz ist. Damit lässt sich klären, ob REST API, AbaConnect oder ein Dateiimport der richtige Weg ist.

Hedinger-Digital baut Anbindungen zwischen Abacus und Drittsystemen und stimmt sich dabei mit Ihrem Abacus-Betreuer ab. Mehr unter Prozessautomatisierung oder direkt über die Kontaktseite.