SAP-Schnittstelle anbinden: Wege, Ablauf und Sicherheit

Wenn Sie eine SAP-Schnittstelle anbinden, entscheiden Sie zuerst über den Schnittstellentyp und erst danach über Werkzeuge und Code. Für moderne Anwendungen ist eine freigegebene OData-API meist der beste Einstieg, für Massendaten und Belegaustausch das IDoc, für schnelle Funktionsaufrufe aus Bestandssystemen RFC/BAPI und für formale Service-Verträge SOAP. Danach folgen immer dieselben Bausteine: technischer Benutzer, Berechtigungen, Aktivierung des Dienstes, sichere Authentifizierung, Tests und ein Monitoring, das auch nach dem nächsten Release noch funktioniert. In diesem Leitfaden zeigen wir Ihnen, wie diese Schritte in SAP S/4HANA On-Premise und in der Cloud konkret aussehen.
Kurz gesagt
- Schnittstelle wählen: OData für Web- und App-Anbindungen, IDoc für asynchronen Belegaustausch, RFC/BAPI für direkte Funktionsaufrufe, SOAP für streng definierte Web Services.
- Nur freigegebene APIs nutzen: SAP empfiehlt bei RFC-Funktionsbausteinen ausdrücklich freigegebene Bausteine, damit die Schnittstelle stabil bleibt.
- On-Premise: SAP Gateway aktivieren, OData-Service registrieren, Berechtigungen für die nötigen Transaktionen vergeben.
- Cloud: Communication User, Communication System und Communication Arrangement anlegen, dann eine Destination in SAP BTP konfigurieren.
- Sicherheit und Betrieb: HTTPS mit TLS, OAuth 2.0 oder Zertifikate, rotierende Zugangsdaten und ein Monitoring, das nach jedem Update getestet wird.
Welche SAP-Schnittstelle passt zu Ihrem Vorhaben?
SAP bietet nicht die eine Schnittstelle, sondern mehrere Technologien, die für unterschiedliche Aufgaben gebaut wurden. Die richtige Wahl hängt davon ab, ob Sie Daten in Echtzeit abfragen, große Mengen übertragen oder Belege zwischen Systemen austauschen möchten. Wo Sie die passenden Schnittstellen finden, beschreibt SAP in der Dokumentation APIs for SAP S/4HANA: OData-APIs liegen im SAP API Business Hub im Paket für SAP S/4HANA, für SOA Web Services, BAPIs und IDocs ist der Business Object Repository Browser (Transaktion CLBOR) das zentrale Verzeichnis, und IDoc-Typen lassen sich zusätzlich in Transaktion WE30 ansehen.
| Schnittstelle | Funktionsweise | Typischer Einsatz | Worauf Sie achten sollten |
|---|---|---|---|
| OData-API | REST-basiert über HTTP, Daten meist als JSON | Web-Apps, mobile Apps, Shops, Portale, KI-Anwendungen | Freigegebene APIs bevorzugen, Gateway bzw. Communication Arrangement einrichten |
| RFC/BAPI | Direkter Aufruf von Funktionsbausteinen | Bestandssysteme, Middleware, schnelle synchrone Abfragen | Nur freigegebene Funktionsbausteine verwenden |
| IDoc | Asynchroner Austausch strukturierter Belege | Aufträge, Lieferungen, Rechnungen, Stammdatenverteilung | Partnervereinbarungen und Fehlerbehandlung planen |
| SOAP Web Service | XML-Nachrichten mit fest definiertem Vertrag | Formale B2B-Prozesse, Integrationsplattformen | Monitoring in SRT_MONI einplanen |
Ein paar Faustregeln aus unserer Projektpraxis helfen bei der Entscheidung:
- Braucht Ihre Anwendung Daten sofort, etwa einen Lagerbestand im Onlineshop oder einen Kundenstatus in der App? Dann ist eine OData-API in der Regel die erste Wahl.
- Geht es um Belege, die zuverlässig ankommen müssen, auch wenn ein System kurz nicht erreichbar ist? Dann spielt das IDoc seine Stärke als asynchrones Format aus.
- Soll ein vorhandenes System eine bestehende SAP-Funktion nutzen, ohne dass neue Services entwickelt werden? Dann ist ein freigegebener BAPI oft der kürzeste Weg.
- Verlangt Ihr Partner einen festen Service-Vertrag mit WSDL? Dann führt kaum ein Weg an SOAP vorbei.
Viele Projekte kombinieren mehrere Typen. Ein Shop liest Preise per OData und schreibt Aufträge als IDoc zurück. Wie das bei einem konkreten Shopsystem aussieht, zeigen wir in unserem Beitrag zur Shopify-SAP-Integration. Und wer neben SAP auch Vertriebswerkzeuge verknüpft, kennt das Muster aus anderen Bereichen: Bei der Kalenderintegration im Vertrieb entscheidet ebenfalls die Wahl der passenden Schnittstelle darüber, ob Daten zuverlässig und ohne Doppelpflege fließen.
Manchmal steht auch die Frage im Raum, ob eine Schnittstelle überhaupt nötig ist oder ob ein Bot die Oberfläche bedienen könnte. Unsere Gegenüberstellung RPA vs. API hilft bei dieser Abwägung.
Voraussetzungen, bevor Sie loslegen
Die meisten Verzögerungen in SAP-Projekten entstehen nicht beim Programmieren, sondern beim Warten auf Zugänge. Klären Sie deshalb früh, wer welche Rechte bekommt. Für eine OData-Anbindung an ein On-Premise-System nennt die Integrationsdokumentation von melibo folgende Voraussetzungen: administrativen Zugriff auf das SAP-System, ein installiertes SAP NetWeaver Gateway sowie Berechtigungen für die Transaktionen SEGW, SPRO und /IWFND/MAINT_SERVICE.
Aus unserer Erfahrung gehören außerdem diese Punkte auf die Checkliste:
- Ein technischer Benutzer für die Schnittstelle, getrennt von persönlichen Konten, mit genau den Rechten, die der Anwendungsfall braucht.
- Eine Testumgebung mit realistischen Daten, damit Sie nicht im Produktivsystem experimentieren.
- Ein fachliches Datenmodell: Welche Felder werden gelesen, welche geschrieben, welches System ist führend? Gerade bei Kunden-, Material- und Lieferantendaten lohnt sich der Blick in unseren Leitfaden zur Stammdaten-Integration.
- Netzwerkzugang: Firewall-Freigaben, Hostnamen, Ports und gegebenenfalls ein Cloud Connector, wenn eine Cloud-Anwendung auf ein lokales System zugreifen soll.
- Ansprechpartner auf beiden Seiten: jemand aus der SAP-Basis, jemand aus der Fachabteilung und jemand, der das angebundene System verantwortet.
Einen allgemeinen Überblick über Wege und Ablauf von ERP-Anbindungen, unabhängig von SAP, finden Sie in unserem Beitrag zur ERP-Schnittstellen-Integration.
OData-Service in SAP S/4HANA On-Premise bereitstellen
Läuft Ihr SAP-System im eigenen Rechenzentrum oder bei einem Hoster, führt der Weg für moderne Anwendungen meist über das SAP Gateway. Der Ablauf sieht in der Regel so aus:
- Gateway aktivieren: Im Customizing (Transaktion SPRO) wird das SAP Gateway eingeschaltet, sofern das noch nicht geschehen ist.
- Service auswählen oder modellieren: Gibt es bereits einen passenden Standard-Service, nutzen Sie ihn. Fehlt er, modelliert Ihr Entwicklungsteam einen eigenen Service im Service Builder (Transaktion SEGW).
- Logik ergänzen: In einem eigenen OData-Service steuern die Erweiterungsklassen das Verhalten. Die MPC_EXT-Klasse passt Metadaten und Annotationen an, die DPC_EXT-Klasse enthält die fachliche Logik für den Datenzugriff.
- Service registrieren: In Transaktion /IWFND/MAINT_SERVICE wird der Dienst aktiviert und damit von außen erreichbar, wie es auch die melibo-Anleitung zum SAP Gateway beschreibt.
- Berechtigungen zuordnen: Der technische Benutzer erhält eine Rolle, die genau diesen Service und die benötigten Geschäftsobjekte abdeckt.
- Anwendung verbinden: Ihre Web-App, Ihr Shop oder Ihre Middleware ruft die Service-URL per HTTPS auf und verarbeitet die Antworten.
Unser Tipp: Bevor Sie einen eigenen Service bauen, prüfen Sie im SAP API Business Hub, ob SAP bereits eine freigegebene API für Ihr Geschäftsobjekt anbietet. Das spart Entwicklungszeit und reduziert den Aufwand bei späteren Upgrades.
SAP S/4HANA Cloud über Communication Arrangements anbinden
In der Cloud-Edition von S/4HANA arbeiten Sie nicht mit SEGW und eigenen Gateway-Services, sondern mit freigegebenen APIs und einem klaren Konfigurationsmodell. Ein Beitrag in der SAP Community beschreibt die Schritte für eine Anbindung an eine Anwendung in SAP BTP:
- Freigegebene API auswählen, die zu Ihrem Anwendungsfall passt, etwa für Geschäftspartner oder Kundenaufträge.
- Communication User anlegen: ein technischer Benutzer, mit dem sich Ihre Anwendung anmeldet.
- Communication System anlegen: Es steht für das externe System, das auf S/4HANA zugreift.
- Communication Arrangement erstellen: Hier verknüpfen Sie Benutzer und System mit einem vordefinierten Kommunikationsszenario. Erst dadurch wird die API für Ihre Anwendung freigeschaltet.
- Destination in SAP BTP konfigurieren: Die Anwendung kennt dann URL, Authentifizierung und Zugangsdaten, ohne dass diese im Code stehen.
Der Vorteil dieses Modells: Was Ihre Anwendung darf, ist im Kommunikationsszenario sauber festgelegt. Das erleichtert Audits und macht spätere Anpassungen nachvollziehbar.
Authentifizierung und sichere Übertragung

Eine Schnittstelle zu SAP öffnet den Zugang zu Ihren wichtigsten Geschäftsdaten. Sicherheit ist deshalb kein Zusatz am Ende, sondern Teil des Designs. Die SAP-Lerneinheit Konnektivitätsoptionen verwenden nennt drei Verfahren zur Authentifizierung: Basic Authentication, OAuth 2.0 und zertifikatsbasierte Authentifizierung. HTTPS mit TLS verschlüsselt dabei die Kommunikation, und Zugangsdaten sollten regelmäßig rotiert werden.
So ordnen wir die Verfahren in der Praxis ein:
- Basic Authentication ist schnell eingerichtet und eignet sich für Prototypen und Tests. Für den produktiven Betrieb setzen wir sie nur mit TLS und rotierenden Passwörtern ein.
- OAuth 2.0 arbeitet mit zeitlich begrenzten Tokens statt dauerhafter Passwörter. In einem Beispiel aus den SAP-Samples auf GitHub umfasst die Einrichtung ein OAuth-Client-Profil, einen OAuth-Client in Transaktion OA2C_CONFIG und die Pflege der Token- und Autorisierungs-Endpunkte.
- Zertifikate sind die robusteste Variante für System-zu-System-Verbindungen, weil kein Passwort übertragen wird. Sie verlangen ein sauberes Zertifikatsmanagement mit Ablaufdaten im Blick.
Unabhängig vom Verfahren gilt: Der technische Benutzer bekommt nur die Rechte, die er wirklich braucht. Gibt eine Anwendung später mehr Daten frei als geplant, liegt das fast immer an zu großzügigen Rollen. Bei personenbezogenen Daten sprechen Sie Umfang und Zweck der Übertragung außerdem mit Ihrer oder Ihrem Datenschutzbeauftragten ab, bevor die Schnittstelle live geht.
Testen, überwachen und Fehler beheben
Eine Schnittstelle ist erst fertig, wenn Sie wissen, was passiert, sobald etwas schiefläuft. Wichtig ist dabei, dass SAP die einzelnen Technologien unterschiedlich protokolliert. Laut einer Übersicht zum Monitoring von OData- und SOAP-Nachrichten werden IDocs in Tabellen wie EDIDC und EDID4 gespeichert, ob erfolgreich oder fehlerhaft. Bei OData-Aufrufen protokolliert das Standardsystem nur Fehler, erfolgreiche Aufrufe werden nicht gespeichert. SOAP-Aufrufe finden Sie mit Erfolgs- und Fehlermeldungen in Transaktion SRT_MONI.
Für die Praxis heißt das:
- Bei OData braucht Ihre Anwendung ein eigenes Logging. Sonst lässt sich im Nachhinein kaum belegen, welcher Datensatz wann übertragen wurde.
- Bei IDocs richten Sie fest ein, wer fehlerhafte Belege prüft und erneut verarbeitet, damit kein Auftrag unbemerkt hängen bleibt.
- Bei RFC-Verbindungen prüfen Sie die Destination direkt im SAP-System. Meldungen wie unbekannter Host, nicht erreichbarer Partner oder fehlgeschlagene Anmeldung deuten meist auf falsche Verbindungsdaten, Firewall-Regeln oder fehlende Berechtigungen hin.
Testen Sie nicht nur den Normalfall. Gute Testfälle decken auch leere Felder, Sonderzeichen, doppelte Übertragungen, Zeitüberschreitungen und abgelaufene Tokens ab. Je früher diese Fälle auftauchen, desto ruhiger wird der Go-live.
Aufwand, Kosten und Wartung realistisch planen
Wie viel eine SAP-Anbindung kostet, hängt weniger von der Technologie ab als vom Umfang. Diese Faktoren bestimmen den Aufwand am stärksten:
- Anzahl und Komplexität der Geschäftsobjekte: Ein lesender Zugriff auf Materialstammdaten ist etwas anderes als ein bidirektionaler Auftragsfluss mit Preisfindung.
- Standard oder Eigenentwicklung: Eine freigegebene API spart Zeit gegenüber einem eigenen OData-Service oder Funktionsbaustein.
- Datenqualität: Uneinheitliche Stammdaten erzeugen Mapping-Regeln und Sonderfälle.
- Zwei Systeme, zwei Seiten: Jede Schnittstelle verbindet zwei Anwendungen, deren Verantwortliche eingebunden werden müssen.
- Sicherheits- und Compliance-Anforderungen: Zertifikate, OAuth, Freigabeprozesse und Dokumentation kosten Zeit, zahlen sich aber aus.
Den größten Fehler sehen wir bei der Planung der Zeit nach dem Go-live. Mit jedem SAP-Release und jedem Update des angebundenen Systems kann sich das Verhalten einer Schnittstelle ändern. Planen Sie deshalb nach jedem Update eine Testphase ein, in der Sie prüfen, ob der Datenaustausch noch einwandfrei läuft. Saubere Versionierung auf Seiten Ihrer eigenen APIs hilft enorm, wie wir in unserem Beitrag zur API-Versionierung zeigen. Was zu einer verlässlichen Betreuung gehört, fassen wir in den Best Practices zur Softwarewartung zusammen. Für eine belastbare Budgetplanung lohnt sich zudem eine strukturierte Aufwandsschätzung vor dem Projektstart.
Läuft bei Ihnen noch ein älteres Eigensystem, das per Dateiexport oder alten Funktionsbausteinen mit SAP spricht, kann die Anbindung der passende Moment sein, es grundlegend zu erneuern. Dabei unterstützt unsere Softwaremodernisierung.
Unsere Sicht auf SAP-Anbindungen
Wir erleben immer wieder, dass SAP-Schnittstellen als reines Technikthema gestartet werden: Welche API, welches Protokoll, welches Tool? Diese Fragen sind wichtig, aber sie kommen an zweiter Stelle. Zuerst steht der Prozess. Welche Abteilung arbeitet mit welchen Daten, wo entstehen heute Medienbrüche, wer pflegt was doppelt?
Genau hier setzen wir an. Weil wir Software maßgeschneidert entwickeln, richten wir die Anbindung an Ihren tatsächlichen Arbeitsabläufen aus und nicht an dem, was ein Standardkonnektor zufällig mitbringt. Technologieoffen heißt für uns: Wir wählen zwischen OData, IDoc, RFC/BAPI und SOAP nach Ihrem Anwendungsfall und kombinieren sie, wenn das Ihr Prozess verlangt.
Und wir denken über den Go-live hinaus. Eine SAP-Schnittstelle ist ein lebendiges System, das mit jedem Release und jeder neuen Anforderung mitwächst. Deshalb verstehen wir uns als langfristiger technischer Partner, der Ihre Lösung kontinuierlich weiterentwickelt, damit sie zukunftssicher bleibt.
Mintellity
SAP-Anbindung mit Mintellity umsetzen
Sie möchten Ihren Onlineshop, Ihre App, ein Kundenportal oder eine KI-Lösung mit SAP verbinden? Wir entwickeln die passende Schnittstelle als Teil Ihrer individuellen Softwarelösung: von der Prozessanalyse über die Auswahl der API bis zu Tests und Monitoring.

Nach dem Go-live bleiben wir an Ihrer Seite. Mit unserem Angebot für Wartung und Support prüfen wir Ihre Schnittstellen nach Updates und entwickeln sie weiter. Wie unsere Zusammenarbeit konkret abläuft, lesen Sie auf der Seite So arbeiten wir.
Häufige Fragen zur SAP-Schnittstellenanbindung
Was ist der Unterschied zwischen einer SAP-API und einer SAP-Schnittstelle?
„Schnittstelle“ ist der Oberbegriff für jeden Weg, auf dem Daten mit SAP ausgetauscht werden, also auch IDocs oder RFC-Verbindungen. Mit „SAP-API“ sind meist moderne, über HTTP erreichbare Dienste wie OData- oder SOAP-Services gemeint. In der Praxis werden beide Begriffe oft gleich verwendet.
Welche Schnittstelle ist für einen Onlineshop am besten geeignet?
Für aktuelle Daten wie Preise, Verfügbarkeiten oder Kundenstatus eignet sich in der Regel eine OData-API. Aufträge und Rechnungen werden häufig zusätzlich als IDoc übertragen, weil das Format auf zuverlässigen, asynchronen Belegaustausch ausgelegt ist. Welche Kombination passt, hängt von Ihrem Auftragsvolumen und Ihren Prozessen ab.
Brauche ich für die Anbindung SAP BTP?
Nicht zwingend. Ein On-Premise-System lässt sich über das SAP Gateway auch direkt anbinden. SAP BTP ist besonders dann sinnvoll, wenn Sie Erweiterungen in der Cloud betreiben oder S/4HANA Cloud mit eigenen Anwendungen verbinden möchten.
Wie lange dauert es, eine SAP-Schnittstelle anzubinden?
Das hängt vor allem vom Umfang ab: Eine lesende Anbindung an eine freigegebene API ist deutlich schneller umgesetzt als ein bidirektionaler Prozess mit eigener Logik. Häufig bestimmen die Bereitstellung von Zugängen, Berechtigungen und Testdaten den Zeitplan stärker als die Entwicklung selbst. Eine verlässliche Aussage liefert eine Aufwandsschätzung auf Basis Ihres konkreten Prozesses.
Was passiert mit der Schnittstelle bei einem SAP-Update?
Updates können Spezifikationen und Verhalten einer Schnittstelle verändern. Wer freigegebene APIs und Funktionsbausteine nutzt, reduziert dieses Risiko deutlich. Trotzdem sollte nach jedem Release eine Testphase fest eingeplant sein.
Quellen
- SAP: APIs for SAP S/4HANA
- melibo: SAP (SAP Gateway)
- SAP Community: Integrating SAP S/4HANA Cloud Public APIs into SAP Business Application
- SAP Learning: Konnektivitätsoptionen verwenden
- SAP-Samples auf GitHub: Push Data to S/4HANA System
- SAP Integration Hub: OData/SOAP API Message Monitoring and Reprocessing