SAP Business One: KI-Integration über DI-API und Service-Layer

Was ist SAP Business One?

SAP Business One (kurz SAP B1) ist das KMU-ERP der SAP-Familie, weltweit verbreitet mit Stand Mai 2026 über 80.000 Kunden in 170 Ländern. Im Gegensatz zu SAP S/4HANA (Mittelstand bis Konzern) richtet sich B1 an Unternehmen mit 10 bis 1.000 Mitarbeitenden. Es läuft auf zwei Datenbank-Backends: SAP HANA (modern, In-Memory) und Microsoft SQL Server (klassisch, Bestands-Installationen).

Für Integrationen gibt es zwei Wege, die historisch parallel existieren. Die DI-API (Data Interface API) ist die ältere Schnittstelle und wird als COM-Komponente (Windows) oder Java-Library eingesetzt. Sie deckt das komplette B1-Datenmodell ab, ist aber auf einen lokalen Client angewiesen und nicht webfreundlich. Der Service-Layer ist die modernere REST/OData-Schnittstelle, basiert auf HANA und ist seit B1 Version 9.3 (2018) verfügbar. In aktuellen Installationen ab B1 10.0 ist der Service-Layer der empfohlene Weg.

Der Service-Layer arbeitet mit Session-basierter Authentifizierung. Sie loggen sich mit Company-Datenbank, Benutzername und Passwort ein und erhalten ein Session-Cookie, das in nachfolgenden Requests mitgeschickt wird. Die Endpunkte folgen OData v4 Konventionen: /b1s/v1/BusinessPartners, /b1s/v1/Items, /b1s/v1/Invoices, /b1s/v1/JournalEntries. Filter, Pagination und Field-Selection laufen über OData-Query-Parameter ($filter, $select, $top, $skip).

Warum es für CH-Treuhand wichtig ist

SAP Business One sitzt in der Schweiz vor allem in zwei Mandanten-Profilen: Mittelständische Produktion und Handel mit internationaler Lieferkette, sowie Tochtergesellschaften grösserer Auslands-Konzerne. Wenn Sie als Treuhand-Büros solche Mandate betreuen, ist die Integration in B1 fast unumgänglich, sobald KI-gestützte Auswertungen angeboten werden sollen.

Die KI-Use-Cases unterscheiden sich von Bexio/Abacus. Bei B1 geht es seltener um klassische Buchhaltung (das macht der interne Buchhalter), sondern mehr um Lieferketten-Daten: Lieferanten-Stammdaten anreichern (Beispiel: B1 hat eine Lieferanten-Nummer, das LLM zieht zusätzliche Daten aus öffentlichen Quellen und schreibt sie zurück), Beleg-OCR ans HANA-Backend (Lieferanten-Rechnungen werden über Service-Layer als Draft-Invoice angelegt), und Plausibilisierung der Marge (Verkaufspreis vs Einkaufspreis pro Artikel-Gruppe).

Das Hosting ist meist Kunden-eigen, entweder On-Prem in der Schweiz oder in einer privaten Cloud (Azure, AWS). Die KI-Schicht sitzt dann typischerweise im selben Netzwerk wie der B1-Server, was die Latenz reduziert und die Datenhoheit klar hält.

Wie es funktioniert

Der Einstieg erfolgt in vier Schritten: Service-Layer aktivieren, Login durchführen, Session-Cookie speichern, Endpunkte abfragen.

Der Service-Layer ist in B1 10.0 standardmässig aktiv, läuft aber auf einem dedizierten Port (typisch 50000 für HANA, 50001 für SSL). In SQL-Server-basierten Installationen ist der Service-Layer separat zu installieren. Die Konfiguration im B1 Administration Console legt fest, welche Company-Datenbank über den Service-Layer erreichbar ist und welche Benutzer Zugriff haben.

Ein Beispiel-Login und eine Folge-Abfrage:

```bash # Login (gibt Session-Cookie zurück) curl -X POST "https://b1.kunde.ch:50000/b1s/v1/Login" \ -H "Content-Type: application/json" \ -d '{"CompanyDB":"SBODEMOCH","UserName":"manager","Password":"********"}' \ -c cookies.txt

# Alle offenen Verkaufs-Rechnungen abfragen curl -X GET "https://b1.kunde.ch:50000/b1s/v1/Invoices?\$filter=DocumentStatus eq 'bost_Open'&\$top=50" \ -b cookies.txt ```

Die Antwort kommt als OData-Envelope mit value-Array und odata.nextLink für Pagination. Für KI-Workflows lesen wir die Daten typischerweise in Batches (500 bis 5.000 Records pro Lauf), indexieren sie in einer Vektor-DB und nutzen den Service-Layer für schreibende Operationen (Draft-Invoice anlegen, BusinessPartner-Notiz erweitern). Schreiben läuft über POST, aktualisieren über PATCH.

Eine wichtige Eigenheit: Der Service-Layer hält die Session am Leben, solange Requests kommen. Bei mehr als 30 Minuten Inaktivität wird die Session ungültig; Sie müssen sich neu anmelden. Für KI-Pipelines, die nightly laufen, ist ein robustes Session-Management mit Re-Login bei 401 unbedingt zu implementieren.

SAP B1-Integration in 5 Schritten

1. 01B1-Version prüfen (>=10.0 für Service-Layer empfohlen), Datenbank-Backend klären (HANA oder SQL Server).
2. 02Service-Layer aktivieren und einen technischen API-User mit minimal nötigen Berechtigungen anlegen.
3. 03Lese-Pipeline aufsetzen: OData-Endpunkte (BusinessPartners, Items, Invoices) im definierten Takt abfragen, Pagination über $skip korrekt umsetzen.
4. 04Session-Management implementieren: Re-Login bei 401, Heartbeat-Request alle 20 Minuten zum Vermeiden von Session-Verfall.
5. 05Schreibende Operationen nur über Drafts: DraftInvoice oder DraftJournalEntry anlegen, finale Freigabe über B1-UI durch einen Menschen.

Wann einsetzen

Die B1-Integration lohnt sich vor allem bei drei Profilen. Erstens: Produktion und Handel mit grossem Lieferanten-Stamm. Hier hilft KI bei der Anreicherung (Bonitäts-Auskunft, Zahlungs-Verhalten, Compliance-Check). Zweitens: Mandate mit hohem Beleg-Volumen. Lieferanten-Rechnungen werden via OCR-Pipeline gelesen, durch KI vor-kontiert und als Draft-Invoice in B1 angelegt; der Buchhalter prüfte nur noch und gibt frei. Drittens: Konzern-Tochtergesellschaften mit Berichtspflicht ans Mutterhaus. Die KI generiert Monats-Reports in der vom Mutterhaus gewünschten Struktur, basierend auf B1-Daten.

Der ROI ist hoch, aber projektbezogen. Eine B1-KI-Integration ist selten ein 2-Wochen-Sprint; rechnen Sie mit 6 bis 16 Wochen für eine produktive Pipeline. Der Aufwand zahlt sich aus, wenn das Volumen passt: ab etwa 500 Lieferanten-Rechnungen pro Monat lohnt sich die Investition typischerweise.

Wann NICHT

Bei Mandaten mit weniger als 200 Buchungen oder 100 Lieferanten-Rechnungen pro Monat ist der Aufwand für eine eigene B1-Integration kaum zu rechtfertigen. Hier reicht die manuelle Erfassung mit gelegentlicher KI-Unterstützung in Excel oder Outlook.

Wenn das Mandat noch auf B1 9.2 oder älter sitzt, fehlt der Service-Layer und die Integration läuft über die DI-API. Das ist machbar, aber spürbar aufwändiger: COM-Komponenten auf einem Windows-Server, kein Web-Zugriff, höherer Wartungsaufwand. Empfehlung: Ein B1-Update auf 10.0 oder später als Vorbedingung der Integration einplanen.

Schreibende Operationen ins Hauptbuch sind heikel und sollten nur über Drafts laufen. Direkter JournalEntry-Insert via Service-Layer ist zwar möglich, aber wir empfehlen, immer über DraftJournalEntries zu gehen und die finale Freigabe einem Menschen zu überlassen.

Vor- und Nachteile

Häufige Fragen

Verwandte Themen

Quellen

1. SAP Help Portal: Business One Service Layer Reference · 2026-05
2. SAP B1 10.0 FP 2502: Release Notes · 2026-04
3. Gartner: SAP B1 Customer Base Survey 2026 · 2026-03
4. OData v4 Specification (OASIS) · 2026-05