# KI-Agent an SAP Business One anbinden

> Ein KI-Agent spricht SAP Business One über die Service Layer an, eine REST-Schnittstelle nach OData-Standard, die es für SAP HANA und Microsoft SQL Server gibt. Er meldet sich mit einem eigenen B1-Benutzer an, liest Belege, legt Entwürfe an und reagiert seit FP 2602 auf Webhooks.

Kanonische URL: https://www.ruebstudio.de/de/wissen/ki-agenten-anbinden/ki-agent-sap-business-one-anbinden  
Autor: Dr.-Ing. Marcus Rüb, CEO  
Veröffentlicht: 2026-11-08

SAP Business One ist ein ERP-System für kleine und mittlere Unternehmen: Aufträge, Lieferungen, Rechnungen, Lager und Geschäftspartner liegen in einer Datenbank, entweder auf SAP HANA oder auf Microsoft SQL Server. Wer einen KI-Agenten Angebote vorbereiten, Lieferstände beantworten oder Eingangsbelege vorerfassen lässt, braucht einen sauberen Weg in dieses System. Dieser Überblick zeigt, wie das mit der Service Layer funktioniert, wo sich die HANA- und die SQL-Server-Variante unterscheiden und welche Grenzen gelten. Stand: November 2026, Grundlage ist das SAP-Handbuch zur Service Layer in der Dokumentversion 1.29 vom 27.07.2026.

## Was bedeutet es, einen KI-Agenten an SAP Business One anzubinden?

Ein KI-Agent ist an SAP Business One angebunden, wenn er über eine offizielle Schnittstelle Daten lesen und Vorgänge anstoßen kann, statt auf Exporte angewiesen zu sein. Bei Business One ist diese Schnittstelle die Service Layer. Der Agent bekommt einen eigenen Benutzer, eine begrenzte Liste von Werkzeugen und arbeitet innerhalb der Berechtigungen, die Business One für diesen Benutzer vorsieht.

Typische Aufgaben, für die ein Agent einen Business-One-Zugang braucht:

- **Auskünfte:** „Ist der Auftrag 4711 schon geliefert?", „Welche offenen Posten hat dieser Kunde?", „Wie viel ist von Artikel X am Lager?"
- **Vorerfassung:** aus einer Kundenanfrage per E-Mail einen Angebotsentwurf mit Positionen anlegen, aus einer Lieferantenrechnung im PDF einen Belegentwurf.
- **Reaktion auf Ereignisse:** wenn ein Auftrag angelegt oder geändert wird, Liefertermine prüfen, Rückfragen vorbereiten oder Hinweise an den Vertrieb schicken.
- **Abgleich:** Stammdaten zwischen Business One und anderen Systemen vergleichen und Unstimmigkeiten melden.

Wie man Agenten grundsätzlich an Unternehmenssysteme anbindet, also Werkzeuge schneidet, Rechte begrenzt und Schreibzugriffe absichert, beschreibt der [Grundlagen-Leitfaden zur Anbindung von KI-Agenten](https://www.ruebstudio.de/de/wissen/ki-agenten-anbinden/ki-agenten-an-unternehmenssysteme-anbinden). Dieser Artikel konzentriert sich auf das, was bei Business One anders ist.

### Was ist anders als bei SAP S/4HANA?

Bei Business One gibt es keinen Katalog einzeln aktivierter OData-Services, sondern eine Service Layer, die alle Geschäftsobjekte unter einer Adresse bereitstellt. Statt Communication Arrangements und Cloud Connector reicht ein Business-One-Benutzer mit passenden Berechtigungen. Das macht den Einstieg schlanker, verlagert die Absicherung aber stärker auf Ihre eigene Konfiguration.

Bei [SAP S/4HANA](https://www.ruebstudio.de/de/wissen/ki-agenten-anbinden/ki-agent-sap-s4hana-anbinden) aktivieren Sie einzelne APIs, ordnen sie über Communication Arrangements technischen Benutzern zu und verbinden On-premise-Systeme meist über den Cloud Connector mit der SAP BTP. Bei Business One fallen diese Schichten weg. Der Agent spricht direkt mit der Service Layer des Business-One-Servers. Der typische Rahmen ist kleiner: ein Server oder ein gehostetes System beim SAP-Partner, eine überschaubare Zahl von Benutzern, oft kein eigenes SAP-Basis-Team. Wer bei S/4HANA eine Integrationsabteilung als Ansprechpartner hat, spricht bei Business One meist mit dem betreuenden Partner.

## Wie funktioniert die Service Layer?

Die Service Layer ist laut SAP eine Erweiterungs-API auf Basis von HTTP und OData, die vollständige Geschäftsobjekte über einen Webserver bereitstellt. Sie unterstützt OData Version 3 unter `/b1s/v1` und Version 4 unter `/b1s/v2`. Ein Client meldet sich an, erhält ein Sitzungs-Cookie und ruft danach Geschäftsobjekte wie `Orders`, `Items` oder `BusinessPartners` auf.

Das [SAP-Handbuch zur Service Layer](https://help.sap.com/doc/fc2f5477516c404c8bf9ad1315a17238/10.0/en-US/Working_with_SAP_Business_One_Service_Layer.pdf) beschreibt eine dreistufige Architektur: Clients sprechen per HTTP/OData mit einem Webserver auf Basis von Apache, der Webserver nutzt die Business-One-Datenbank. Standardmäßig ist die Service Layer als Cluster mit Load Balancer eingerichtet. Für einen Agenten sind fünf Bausteine wichtig.

### Anmeldung und Sitzung

Die Anmeldung läuft über einen POST auf `/Login` mit Firmendatenbank, Benutzername und Passwort. Die Antwort setzt das Cookie `B1SESSION`, das jede weitere Anfrage mitschicken muss, und optional `ROUTEID` für die Zuordnung zum selben Knoten.

```http
POST https://<server>:50000/b1s/v2/Login
Content-Type: application/json

{"CompanyDB": "<Firmendatenbank>", "UserName": "<agent-benutzer>", "Password": "<aus Secret Store>"}
```

Die Sitzung läuft laut Handbuch standardmäßig nach 30 Minuten Inaktivität ab; der Wert steht in `conf/b1s.conf`. Ein Agent sollte die Sitzung wiederverwenden, statt sich vor jeder Anfrage neu anzumelden: Das Handbuch nennt die Anmeldung ausdrücklich einen aufwendigen Vorgang. Seit SAP Business One 10.0 FP 2305 ist zusätzlich eine Anmeldung mit einem Windows-Domänenkonto möglich, wenn Active Directory angebunden ist.

### Geschäftsobjekte und Metadaten

Unter `$metadata` beschreibt die Service Layer alle Entitäten, Felder und Aktionen. Für einen Agenten ist das die Grundlage, um Werkzeuge zu definieren. Seit FP 2608 liefert die OData-V4-Metadatenabfrage laut Handbuch Annotationen wie `Common.Label` mit lesbaren Bezeichnungen und erlaubt gezielte Teilabfragen, weil die vollständigen Metadaten mit benutzerdefinierten Tabellen und Objekten sehr groß werden.

Für die Werkzeugdefinition heißt das: Lassen Sie den Agenten nicht frei durch die Metadaten navigieren. Wählen Sie die wenigen Objekte aus, die der Anwendungsfall braucht, etwa `Orders`, `DeliveryNotes`, `Items` und `BusinessPartners`, und beschreiben Sie dem Modell die Felder in eigenen Worten.

### Abfragen mit OData und SQL Queries

Für Lesezugriffe genügen meist OData-Abfragen mit `$filter`, `$select` und `$expand`. Seit FP 2011 gibt es zusätzlich die Entität `SQLQueries`: gespeicherte, parametrisierte SQL-Abfragen, die nur auf Tabellen einer Allowlist zugreifen dürfen. Normale Benutzer brauchen dafür eine eigene Berechtigung.

Die SQL Queries sind für Agenten interessant, weil sie Auswertungen über mehrere Tabellen erlauben, ohne der KI freien Datenbankzugriff zu geben. Die Allowlist steht in `conf/b1s_sqltable.conf`; Sie dürfen Tabellen daraus entfernen, das Hinzufügen weiterer Tabellen liegt laut Handbuch außerhalb des Supports. Zudem normalisiert die Service Layer die SQL-Syntax, sodass dieselbe gespeicherte Abfrage auf HANA und SQL Server laufen soll. Ergebnisse kommen seitenweise: Standard sind 20 Einträge pro Seite, steuerbar über den Header `Prefer: odata.maxpagesize`.

### Schreiben und Batch

Schreibzugriffe sind normale POST-, PATCH- und Aktionsaufrufe auf die Geschäftsobjekte. Mehrere Änderungen lassen sich in einem `$batch` bündeln; Transaktionen gelten laut Handbuch nur innerhalb einer Anfrage, auch innerhalb eines Batch, aber nie über mehrere Anfragen hinweg.

Für Agenten ist das eine wichtige Einschränkung: Eine Kette aus „Auftrag anlegen, dann Lieferung, dann Rechnung" in drei getrennten Aufrufen ist nicht atomar. Bricht der Agent nach dem zweiten Schritt ab, bleibt ein halber Vorgang im System. Deshalb gehören zusammenhängende Änderungen entweder in einen Batch oder in einen Ablauf, der Zwischenstände erkennt und sauber fortsetzt.

### Webhooks

Seit SAP Business One 10.0 FP 2602 unterstützt die Service Layer Webhooks. Ein Dienst namens Webhook Messenger Service liefert Benachrichtigungen, etwa wenn ein Auftrag angelegt, geändert oder storniert wird. Abonnements legen Sie über die Entität `EventSubscriptions` an.

Damit muss ein Agent nicht mehr regelmäßig abfragen, ob sich etwas geändert hat. Er wird angestoßen, holt sich die betroffenen Daten und arbeitet den Fall ab. Seit FP 2608 lassen sich laut Handbuch zusätzliche Felder in die Benachrichtigung aufnehmen (`BizObjProps`) und Ereignisse über Formeln filtern (`FilterExpr`). Vor FP 2602 bleibt nur das zeitgesteuerte Abfragen, etwa über das Änderungsdatum der Belege.

## Welche Varianten gibt es: HANA, SQL Server, Service Layer oder DI API?

Die wichtigste Unterscheidung bei Business One ist die Datenbank. Die Service Layer gibt es für die HANA-Version und laut Handbuch seit 10.0 PL01 auch für Microsoft SQL Server. Die Grundfunktionen sind gleich, einzelne Erweiterungen aber nicht. Daneben existiert mit der DI API eine ältere Schnittstelle, die für Agenten selten passt.

### SAP Business One, Version für SAP HANA

Auf HANA ist die Service Layer seit Langem der Standardweg. Zusätzlich stellt sie hier Semantic Layer Views unter `/b1s/v1/sml.svc` bereit: vorgefertigte Analysesichten aus dem HANA-Analysemodell, etwa zu Einkaufspreisen oder Bilanzdaten. Für Auskunfts-Agenten sind diese Sichten nützlich, weil Kennzahlen dort schon zusammengeführt sind. Normale Benutzer brauchen auch hier eine ausdrückliche Berechtigung pro Sicht. Die Service Layer läuft in dieser Variante typischerweise unter SUSE Linux Enterprise.

### SAP Business One, Version für Microsoft SQL Server

Auf SQL Server läuft die Service Layer typischerweise unter Microsoft Windows. Statt der Semantic Layer Views kann sie seit 10.0 PL02 eigene SQL Views in der Firmendatenbank automatisch erkennen und als OData bereitstellen; laut Handbuch gilt das nur für die SQL-Server-Version. Eine Besonderheit betrifft Anhänge: Der Anhangsordner ist meist eine Windows-Freigabe. Läuft die Service Layer unter Windows, greift sie direkt darauf zu; unter Linux muss die Freigabe laut Handbuch eigens eingebunden werden. Das ist wichtig für Agenten, die Dokumente an Belege hängen sollen.

Viele ältere SQL-Server-Installationen haben historisch mit der DI API gearbeitet. Prüfen Sie vor dem Projekt, ob die Service Layer bei Ihnen überhaupt installiert ist und mit welchem Feature Package. Webhooks setzen FP 2602 voraus, die Metadaten-Annotationen FP 2608.

### Service Layer oder DI API?

Laut SAP-FAQ basiert die DI API auf Microsoft COM und passt am besten in eine Windows-Umgebung, etwa für Add-ons im Business-One-Client. Für einen Agenten, der als Dienst auf einem anderen Server läuft, ist die Service Layer der passende Weg. Die DI API kann allerdings einiges, was der Service Layer fehlt.

Das Handbuch nennt diese Einschränkungen der Service Layer gegenüber der DI API:

| Funktion | DI API | Service Layer |
|---|---|---|
| Direktes SQL (RecordSet) | ja | nein, nur gespeicherte SQL Queries |
| Transaktion über mehrere Aufrufe | ja | nein, nur innerhalb einer Anfrage |
| Import/Export als XML | ja | nein |
| Neue UDF/UDT/UDO sofort nutzbar | ja | erst nach Neustart der Service Layer |

Für Agenten sind die fehlenden Transaktionen und das fehlende freie SQL eher Schutz als Nachteil: Beides sind Fähigkeiten, die man einer KI ohnehin nicht geben möchte.

### Gehostetes Business One beim Partner

Viele Unternehmen betreiben Business One nicht selbst, sondern beim SAP-Partner. Dann ist die Service Layer oft nicht aus dem Internet erreichbar, und die Adresse kann sich mit einem Update ändern. Klären Sie mit dem Partner, wie der Agent erreichbar ist, etwa über VPN oder einen Reverse Proxy, und wer bei Updates prüft, dass die Anbindung weiterläuft.

## Welche Voraussetzungen braucht es?

Technisch brauchen Sie eine erreichbare Service Layer mit bekanntem Feature Package, einen eigenen Business-One-Benutzer für den Agenten und gepflegte Stammdaten. Organisatorisch brauchen Sie eine Entscheidung, welche Vorgänge der Agent nur vorbereitet und welche er selbst ausführt, und eine Klärung mit dem SAP-Partner zu Lizenz und API-Nutzung.

**Systeme:**

- Service Layer installiert, per HTTPS erreichbar, mit gültigem Zertifikat.
- Feature Package bekannt; für Webhooks mindestens 10.0 FP 2602.
- Testmandant, am besten eine Kopie der echten Firmendatenbank, auf dem der Agent arbeiten darf, bevor er an das Produktivsystem geht.

**Benutzer und Rechte:**

- Ein eigener Benutzer für den Agenten, nie der `manager` oder ein persönliches Konto. Ob dafür eine eigene Lizenz nötig ist, klärt Ihr Partner anhand Ihres Vertrags.
- Berechtigungen im Business-One-Client (im englischen Menü: Administration › System Initialization › Authorizations) so eng wie möglich: Lesen, wo gelesen wird, Vollzugriff nur auf die Objekte, die der Agent anlegen soll.
- Für SQL Queries die Berechtigungen „Service Layer SQL Query" je Abfrage; das Anlegen neuer Abfragen bleibt Menschen vorbehalten.

**Daten:**

- Artikelstamm mit sauberen Bezeichnungen und Einheiten. Ein Agent, der Angebote vorbereitet, ist nur so gut wie die Artikeltexte.
- Geschäftspartner ohne Dubletten, mit gepflegten Ansprechpartnern.
- Benutzerdefinierte Felder dokumentiert: Was in `U_`-Feldern steht, weiß oft nur, wer sie angelegt hat.

## Wie geht man in Schritten vor?

Der bewährte Weg beginnt mit einem lesenden Agenten auf einem Testmandanten und einem einzigen, klar umrissenen Prozess. Schreibzugriffe kommen erst, wenn die Antworten stimmen, und dann zuerst als Entwürfe. Webhooks und mehrere Prozesse folgen, wenn der Betrieb stabil läuft.

1. **Prozess auswählen.** Ein Vorgang mit vielen Wiederholungen und klaren Regeln, etwa Lieferauskünfte oder die Vorerfassung von Angebotsanfragen.
2. **Objekte und Felder festlegen.** Welche Entitäten der Service Layer braucht der Agent, welche Felder davon? Alles andere bleibt außen vor.
3. **Werkzeuge bauen.** Jede Fähigkeit wird ein eigenes, eng beschriebenes Werkzeug, etwa „Lieferstatus zu Auftragsnummer", nicht „beliebige OData-Abfrage". Das Model Context Protocol (MCP) eignet sich, um diese Werkzeuge für verschiedene Agenten bereitzustellen.
4. **Sitzung verwalten.** Ein Werkzeug-Server meldet sich einmal an, hält `B1SESSION` und meldet sich nach Ablauf neu an. Zugangsdaten liegen in einem Secret Store, nie im Prompt.
5. **Lesend testen.** Echte Fragen aus dem Alltag auf dem Testmandanten stellen und die Antworten gegen den Business-One-Client prüfen.
6. **Entwürfe statt Buchungen.** Schreibende Werkzeuge legen zuerst Belegentwürfe an (Tabelle ODRF, in der Service Layer als `Drafts`), die ein Mensch im Client prüft und in echte Belege überführt.
7. **Ereignisse anbinden.** Ab FP 2602 Webhooks auf die relevanten Objekte abonnieren, damit der Agent bei neuen Aufträgen oder Änderungen angestoßen wird.
8. **Protokollieren und messen.** Jede Anfrage des Agenten mit Zeitpunkt, Werkzeug, Parametern und Ergebnis speichern. Das ist die Grundlage für Fehlersuche und für die Entscheidung, ob ein Vorgang irgendwann ohne Freigabe laufen darf.

Fertige Agenten für typische Abläufe, etwa die [Angebotserstellung](https://www.ruebstudio.de/de/ki-agenten/angebotserstellung) oder den [technischen Service](https://www.ruebstudio.de/de/ki-agenten/technischer-service), setzen auf genau diese Schritte auf. Eine Übersicht über solche Agenten finden Sie unter [KI-Agenten](https://www.ruebstudio.de/de/ki-agenten).

## Welche Grenzen und Risiken gibt es?

Die größten Risiken liegen nicht in der Technik der Service Layer, sondern in Rechten, halben Vorgängen und Vertragsfragen. Dazu kommt die SAP API Policy, die KI-Systeme, die API-Aufrufe planen oder ausführen, nur über von SAP vorgesehene Wege erlaubt. Wie sie auf Business One angewendet wird, sollten Sie vor dem Projekt klären.

**SAP API Policy.** Die [SAP API Policy v.4.2026a](https://help.sap.com/doc/sap-api-policy/latest/en-US/API_Policy_latest.pdf) erlaubt nur veröffentlichte APIs für dokumentierte Zwecke. Sie untersagt außerdem die Nutzung von APIs zur Interaktion mit (teil-)autonomen oder generativen KI-Systemen, die Abfolgen von API-Aufrufen planen, auswählen oder ausführen, außer über von SAP ausdrücklich vorgesehene Architekturen und Wege. Die Policy versteht sich als Teil der Dokumentation der jeweiligen SAP-Lösung, mit der sie bereitgestellt wird; im Text selbst ist Business One nicht gesondert genannt. Ob und wie sie für Ihre Business-One-Installation gilt, hängt von Ihrem Vertrag und der dazugehörigen Dokumentation ab. Klären Sie das mit Ihrem SAP-Partner und gegebenenfalls juristisch; dieser Abschnitt ist keine Rechtsberatung.

**Halbe Vorgänge.** Weil Transaktionen nicht über mehrere Anfragen reichen, kann ein Agent, der mitten in einer Kette abbricht, inkonsistente Zustände hinterlassen. Gegenmittel: Batch für zusammenhängende Änderungen, Entwürfe statt Buchungen, und ein Werkzeug-Server, der vor jedem Schreibschritt prüft, ob der Vorgang schon existiert.

**Zu weite Rechte.** Ein Agent mit Superuser-Rechten kann alles, was der Client kann. Ein Fehler im Prompt oder eine manipulierte E-Mail reicht dann für falsche Buchungen. Eigener Benutzer, enge Berechtigungen und eine kleine Werkzeugliste begrenzen den Schaden.

**Prompt Injection über Belegtexte.** Freitexte in Belegen, Notizen oder Anhängen landen im Kontext des Modells. Behandeln Sie sie als Daten, nicht als Anweisungen, und lassen Sie schreibende Werkzeuge nie allein auf Grundlage solcher Texte auslösen.

**Updates.** Mit jedem Feature Package können sich Metadaten ändern; neue benutzerdefinierte Felder sind laut Handbuch erst nach einem Neustart der Service Layer sichtbar. Planen Sie nach jedem Update einen kurzen Test der Agenten-Werkzeuge ein.

**Last.** Ein Agent, der in einer Schleife hängt, kann die Service Layer mit Anfragen fluten. Begrenzen Sie die Zahl der Aufrufe pro Vorgang im Werkzeug-Server und nutzen Sie Seitengrößen und `$select`, statt ganze Objekte zu laden.

**Wann der Ansatz nicht passt:** Wenn die Stammdaten in Business One unvollständig sind oder wichtige Informationen nur in Excel-Listen und Köpfen stehen, löst ein Agent das Problem nicht. Dann ist Datenpflege der erste Schritt.

## Wie fange ich an?

Beginnen Sie mit einer Bestandsaufnahme: Version und Feature Package, Datenbank, Erreichbarkeit der Service Layer, betreuender Partner. Dann ein lesender Agent für einen Prozess auf einem Testmandanten. Nach einigen Wochen im Alltag entscheiden Sie anhand der Protokolle, ob Entwürfe und weitere Prozesse folgen.

Eine kurze Checkliste für das erste Gespräch mit dem Partner:

- Welche Version und welches Feature Package läuft, und wann ist das nächste Update geplant?
- Ist die Service Layer installiert und wie ist sie erreichbar?
- Gibt es einen Testmandanten oder kann eine Kopie angelegt werden?
- Welche Lizenz braucht ein technischer Benutzer für den Agenten?
- Wie bewertet der Partner die SAP API Policy für Ihren Anwendungsfall?

Die allgemeinen Prinzipien, die für jedes System gelten, etwa Werkzeugschnitt, Freigaben und Protokollierung, finden Sie im [Grundlagen-Leitfaden zur Anbindung von KI-Agenten](https://www.ruebstudio.de/de/wissen/ki-agenten-anbinden/ki-agenten-an-unternehmenssysteme-anbinden). Wenn Sie zusätzlich oder später mit SAP S/4HANA arbeiten, zeigt der Artikel [KI-Agent an SAP S/4HANA anbinden](https://www.ruebstudio.de/de/wissen/ki-agenten-anbinden/ki-agent-sap-s4hana-anbinden), welche zusätzlichen Schichten dort hinzukommen.

## Häufige Fragen

### Brauche ich SAP BTP, um einen Agenten an SAP Business One anzubinden?

Technisch nicht: Die Service Layer läuft beim Business-One-Server selbst und ist per HTTPS erreichbar. Ob ein Agent ohne von SAP vorgesehenen Weg zulässig ist, hängt von der SAP API Policy und Ihrem Vertrag ab und sollte mit dem SAP-Partner geklärt werden.

### Funktioniert die Service Layer auch mit der SQL-Server-Version?

Ja. Laut SAP-Handbuch wird die Service Layer seit SAP Business One 10.0 PL01 auch auf Microsoft SQL Server unterstützt. Einzelne Funktionen unterscheiden sich, etwa Semantic Layer Views nur auf HANA und SQL Views nur auf SQL Server.

### Darf der Agent beliebiges SQL gegen die Datenbank schicken?

Nein. Die Service Layer kennt keinen direkten SQL-Zugriff wie das RecordSet-Objekt der DI API. Gespeicherte SQL Queries sind möglich, aber nur auf freigegebene Tabellen der Allowlist und nur mit entsprechender Berechtigung.

### Kann der Agent Belege direkt buchen?

Technisch ja, die Service Layer kann Aufträge, Rechnungen und andere Belege anlegen. Für den Einstieg ist es sicherer, wenn der Agent Belegentwürfe erzeugt und ein Mensch sie im Client prüft und bucht.

### Ist die DI API für Agenten noch sinnvoll?

Nur in Ausnahmefällen. Die DI API basiert auf Microsoft COM und passt zu Windows-Add-ons, nicht zu einem Agenten, der als Dienst auf einem anderen Server läuft.

## Quellen

- [SAP – Working with SAP Business One Service Layer, Dokumentversion 1.29 (27.07.2026)](https://help.sap.com/doc/fc2f5477516c404c8bf9ad1315a17238/10.0/en-US/Working_with_SAP_Business_One_Service_Layer.pdf)
- [SAP API Policy v.4.2026a (SAP Help Portal)](https://help.sap.com/doc/sap-api-policy/latest/en-US/API_Policy_latest.pdf)
- [SAP Learning – Leveraging the SAP Business One Service Layer: API Terms and Documentation](https://learning.sap.com/courses/leveraging-the-sap-business-one-service-layer/introducing-service-layer-api-terms-and-documentation)
