SAP S/4HANA Schnittstelle und API-Integration
SAP S/4HANA läuft auf drei Arten: Public Cloud, Private Edition unter RISE und On-Premise, jede anders erreicht und anders abgesichert. Maesn deckt alle drei über eine REST API ab, über OData und SOAP, die SAP S/4HANA-Schnittstelle, mit der Ihr Produkt spricht, bleibt also die, die es schon hat.
Die ganze S/4HANA-Komplexität liegt bei Maesn
Eine SAP-Anbindung scheitert selten an dem Objekt, das Sie wollen. Sie scheitert am Betriebsmodell, das den Weg entscheidet, an der Authentifizierung, die sich mit ihm unterscheidet, und an den Release-Ständen, die sich unter Ihnen bewegen. Maesn fängt alle drei ab.
Ein Verfahren über alle drei
Die Public Cloud wird direkt erreicht, Private Edition und On-Premise über die SAP BTP des Kunden. Maesn leitet über OData oder SOAP, nichts davon verzweigt also in Ihrem Code.
Vereinheitlicht auf einen Account-Key
Communication User, X.509-Zertifikate, OAuth 2.0, Principal Propagation. Maesn klärt das Verfahren je angebundenem Kunden und übergibt Ihnen einen Account-Key.
Versionsunterschiede abgefangen
Die Public Cloud aktualisiert sich automatisch auf das neueste Release, älteren On-Premise-Ständen fehlen einige freigegebene APIs. Maesn löst die Verfügbarkeit je Release auf und weicht aus, wo es nötig ist.
Auf Ihrer Seite bleibt ein REST-Aufruf gegen ein Datenmodell, das Sie einmal umsetzen. Welches S/4HANA ein Kunde betreibt, ist dann kein Projekt mehr, sondern eine Einstellung.
Ein kurzes Gespräch genügt meist, um zu klären, ob Maesn zu Ihrem Anwendungsfall passt.
Eine API über jedem Betriebsmodell
Welches S/4HANA ein Kunde betreibt, ist die erste und wichtigste Unterscheidung: sie entscheidet, was technisch erreichbar ist und wie es erreicht wird. Maesn behandelt die drei als eigene Zielsysteme und legt eine Schnittstelle darüber.
| Betriebsmodell | Betrieb und Releases |
|---|---|
| Cloud, Public Edition | Von SAP gehostet, mandantenfähig, automatische Updates, immer auf dem neuesten Release (2408, 2502, 2508 und folgende) |
| Cloud, Private Edition (RISE) | Von SAP verwaltet, betrieben bei einem Hyperscaler (AWS, Azure, Google Cloud) oder von einem Hosting-Partner bereitgestellt. Dieselbe Codebasis und dieselben Release-Stände wie On-Premise |
| On-Premise | Vom Kunden oder Partner gehostet, Release-Takt alle zwei Jahre (2023, 2025, 2027), und der Kunde entscheidet über das Upgrade |
Maesn folgt den SAP Clean Core Integration Principles
Traditionelle und proprietäre Schnittstellen wie direkte RFCs, klassische BAPIs oder IDocs bleiben außen vor. Maesn baut ausschließlich auf den sauberen, versionierten Standard-APIs von SAP auf, OData und SOAP-Webservices, so wie SAP es empfiehlt. Diese saubere Verbindung läuft über die SAP Business Technology Platform, der ERP-Kern bleibt also unberührt.
Der Grund ist Portabilität genauso wie Hygiene. Ein BAPI oder ein IDoc bindet eine Anbindung an ein Betriebsmodell und greift in den Kern des Kunden, ein Wechsel desselben Kunden von On-Premise auf RISE hieße also Neubau. Freigegebene APIs verhalten sich über alle drei gleich. Fehlt einem älteren Release-Stand eine freigegebene API für ein Objekt, weicht Maesn auf eine CDS-View oder einen kleinen eigenen OData-Service aus und hält die Schnittstelle nach außen identisch, und das ist derselbe Ansatz, den Customisation Handling überall sonst im Katalog verfolgt: der systemspezifische Teil wird aufgefangen statt an Ihr Schema weitergereicht.
Zwei Standardprotokolle, OData und SOAP
Maesn arbeitet mit den APIs aus dem offiziellen SAP Business Accelerator Hub. OData trägt den Großteil von Lesen und Schreiben, SOAP deckt die Vorgänge der Finanzbuchhaltung ab, die OData nicht abdeckt. Beide tragen über Public, Private und On-Premise, die Schnittstelle, gegen die Sie bauen, bleibt also in jedem Betriebsmodell dieselbe.
Standardmäßiges Lesen und Schreiben
REST-Zugriff auf freigegebene APIs aus dem SAP Business Accelerator Hub, der Standard überall dort, wo es ihn gibt, über Public, Private und On-Premise.
Buchungen, die OData nicht abdeckt
Bestimmte Vorgänge der Finanzbuchhaltung und ältere Szenarien gibt es nur als Webservices. Maesn spricht nach innen beides und gibt nach außen eine REST- und JSON-Schnittstelle zurück.
| Protokoll | Was darüber läuft | Verfügbar in |
|---|---|---|
| OData (V2/V4) | Standardmäßiger REST-Zugriff auf freigegebene APIs, lesend und schreibend | Alle drei Betriebsmodelle |
| SOAP / Webservices | Vorgänge der Finanzbuchhaltung und ältere Szenarien, die OData nicht abdeckt, je Objekt manchmal die einzige Möglichkeit | Alle drei Betriebsmodelle |
Maesn nutzt ausschließlich OData und SOAP. Proprietäre Schnittstellen wie BAPI/RFC oder IDoc bleiben bewusst außerhalb der Anbindung: sie würden die Anbindung an ein Betriebsmodell binden und in den Kern des Kunden greifen. Fehlt für ein Objekt auf einem älteren Release eine freigegebene OData-API, löst Maesn das intern und hält nach außen dieselbe Schnittstelle, die Anbindung bleibt damit clean-core und portabel.
Nichts davon erreicht Ihren Client. OData ist ein REST-basiertes Protokoll mit eigenen Konventionen, von der Schreibweise der Abfragen bis zur Form des Antwortrahmens, und SOAP ist noch einmal eine eigene Welt. Maesn spricht nach innen beides und gibt nach außen schlichtes REST und JSON zurück, ob ein Objekt also über OData oder über SOAP kommt, klärt sich auf unserer Seite. Ihr Team schreibt hier denselben Anfragestil wie für jedes andere System, das es erreicht.
Direkt für die Public Cloud, über BTP für den Rest
Die Public Cloud wird direkt über OData erreicht. Private Edition und On-Premise werden über die SAP BTP des Kunden erreicht, mit dem SAP Cloud Connector für den Tunnel und API Management als Gateway. Ein direkt veröffentlichter mTLS-Endpunkt bleibt als Ausnahme verfügbar.
| Variante | Protokoll | Anbindungsweg | Authentifizierung |
|---|---|---|---|
| Public Cloud | Freigegebenes OData | Direkter HTTPS-Aufruf, ohne BTP | Communication Arrangement plus OAuth oder Zertifikat |
| Private Edition (RISE) | OData, dazu CDS oder Eigenentwicklung, wo nötig | SAP BTP des Kunden: Cloud Connector und API Management | Zertifikat oder OAuth |
| On-Premise | OData, dazu CDS oder Eigenentwicklung, wo nötig | SAP BTP des Kunden, als Ausnahme ein Reverse Proxy mit mTLS | Zertifikat oder OAuth |
API Management sitzt als reine Durchleitung vor den freigegebenen OData- und SOAP-APIs, ohne Umformung und ohne Orchestrierung auf der BTP. Diese Grenze ist Absicht: das Gateway ist eine Tür und kein Ort, an dem Logik wohnt, nichts von Ihnen hängt also davon ab, wie ein Kunde seine Plattform eingerichtet hat.
Was die BTP leistet und was optional bleibt
Für Private Edition und On-Premise läuft die Verbindung über die SAP BTP des Kunden, mit dem Cloud Connector für den Tunnel und API Management als schlankem Gateway. Die Public Cloud braucht nichts davon. Maesn erreicht die freigegebenen OData- und SOAP-APIs und betreibt keine Orchestrierung auf der BTP.
SAP BTP Subaccount
Nötig für Private Edition und On-Premise, dort endet der Tunnel des Cloud Connectors. Für die Public Cloud nicht im Einsatz.
BTP API Management
Das Gateway, das Maesn für Private Edition und On-Premise aufruft. Eine reine Durchleitung für die freigegebenen OData- und SOAP-APIs, ohne Umformung.
SAP Cloud Connector
Verbindet diese beiden mit der BTP des Kunden. Kostenlose Software, die mit einem BTP-Subaccount zusammenarbeitet.
Direkter Endpunkt als Ausnahme
Die Ausnahme für Kunden, die die BTP außen vor lassen: erreicht Private Edition und On-Premise ohne BTP.
Wenn die BTP noch nicht steht
Ein BTP-Subaccount, der darauf gerichtete Cloud Connector und die über API Management veröffentlichten freigegebenen APIs. RISE-Kunden haben die Berechtigung meist schon.
RISE-Kunden haben die BTP-Berechtigung meist schon. Wir gehen sie mit Ihrem Team durch, bevor Sie zu bauen anfangen.
Jedes SAP-Verfahren, ein Account-Key
Bei der Authentifizierung wird eine SAP-Anbindung konkret, und sie unterscheidet sich in jedem Betriebsmodell. Maesn bettet jedes Verfahren hinter einer vereinheitlichten Authentifizierung ein: Ihr Kunde verbindet sich einmal, und Sie bekommen einen Account-Key, ohne SAP-eigene Verzweigung in Ihrem Code.
| Ebene | Mechanismen |
|---|---|
| Public Cloud | Communication Arrangement plus Communication User. Basic, X.509-Clientzertifikat und zunehmend OAuth 2.0 (Client-Zugangsdaten oder SAML Bearer) |
| Private / On-Premise | Technischer Benutzer (Basic), X.509-Clientzertifikate (STRUST + CERTRULE), OAuth über das SAP Gateway und Principal Propagation über den Cloud Connector |
| BTP-Ebene | XSUAA / OAuth 2.0; Destinations verwalten die Zugangsdaten zentral |
In der Public Cloud registriert Maesn ein benanntes Communication Scenario, das im SAP des Kunden unter dem Namen von Maesn erscheint, der SAP-Standardweg ohne eigenes Protokoll.
Der Kunde verbindet sich
Sie schicken den Kunden in den Ablauf. Maesn öffnet den Verbindungsschritt für sein S/4HANA-Betriebsmodell. Welches der drei er betreibt, wird dort festgestellt und nicht bei Ihnen erfragt.
Verfahren und Tunnel geklärt
Communication User, Zertifikat, OAuth oder Cloud Connector: Maesn löst auf, was jeweils gilt, und speichert die Verbindung. Die SAP-Basis-Arbeit passiert einmal, auf unserer Seite.
Ein Account-Key zurück
Jede weitere Anfrage trägt Ihren API-Schlüssel plus diesen Account-Key, über den ganzen Katalog hinweg identisch. Ihr Code erfährt nicht, welches Betriebsmodell dahinter steht.
Der Teil, bei dem es sich lohnt, konkret zu werden, ist die Frage, wer was hält. Communication User, X.509-Zertifikate, OAuth-Clients und der Cloud Connector liegen alle auf der Kundenseite der Linie, und sie zu klären ist die Arbeit, für die sonst bei jedem einzelnen Onboarding ein SAP-Basis-Berater nötig ist. Maesn erledigt das einmal je angebundenem Kunden und gibt einen einzigen Wert zurück. Unified Authentication trägt hier einen Fall, den kein anderes System im Katalog hat: das Verfahren unterscheidet sich innerhalb eines Produkts, ein Wechsel desselben Kunden von On-Premise auf RISE ändert also, wie er erreicht wird, ohne dass sich ändert, was Sie halten. Der Account-Key überlebt diesen Wechsel.
Änderungen, sobald sie geschehen
Das meiste an einer SAP-Anbindung ist Lesen und Buchen auf Abruf. Für die Änderungen, die nicht warten können, trägt Maesn auch Events, Sie reagieren also, sobald sie geschehen, statt abzufragen.
Lesen und Buchen auf Abruf
OData und SOAP in allen drei Betriebsmodellen: Sie holen die Daten, die Sie brauchen, und erfassen Buchungen, wenn Ihr Ablauf es verlangt.
Nahezu in Echtzeit geschickt
Über SAP Event Mesh schickt das System Änderungen, sobald sie geschehen, eine Buchung oder eine Statusänderung erreicht Ihr Produkt also ohne Abfragen. In allen drei Betriebsmodellen, mit freigegebenen Events in der Public Cloud.
Events kommen auf derselben Grundlage an wie überall sonst im Katalog, über ein Event-Modell, der Handler, den Sie bereits geschrieben haben, ist also der Handler, der sie entgegennimmt. Was sich je System unterscheidet, ist das, was das System selbst veröffentlicht, und dieser Unterschied bleibt auf unserer Seite der Verbindung.
Lesen und Schreiben in einem Datenmodell
Lese- und Schreibzugriffe laufen über das Standard-Datenmodell von Maesn, dieselben Objekte, die Sie für die anderen Systeme im Katalog schon nutzen. Was SAP freigibt, hängt vom Betriebsmodell und vom freigegebenen Umfang ab.
Von SAP in Ihr Produkt
Von Ihrem Produkt nach SAP
Was Sie lesen, kommt im gemeinsamen Common Data Model zurück, ein Buchungssatz aus einer S/4HANA-Landschaft hat also dieselbe Form wie einer aus einem hundertmal kleineren System, und der Code, den Sie hier schreiben, ist der Code, den Sie für das nächste wiederverwenden.
Was nicht aus dem Datenmodell kommt, ist die Konfiguration: welches Konto, welcher Steuerschlüssel und, in einer Gruppe mit mehreren Gesellschaften, welcher Company Code. Diese Werte gehören dem Unternehmen, und Maesn liest die echten aus dem Live-System, damit Ihr Kunde die Konten zuordnet, die er kennt, statt einer generischen Liste. Wie diese Zuordnung entworfen wird und was sie kostet, wenn sich ein Kontenrahmen ändert, steht in unserem Leitfaden zur Abbildung der ERP-Konfiguration.
Bringen Sie die Objektliste mit, die Ihr Anwendungsfall braucht, und das Betriebsmodell, das Ihr Kunde betreibt, und wir gehen im Gespräch beides durch.
Zertifiziert, und wir tragen Sie dorthin
Technik und Zertifizierung sind zwei getrennte Entscheidungen. Die Anbindung läuft heute über freigegebene APIs. Wenn Sie den zertifizierten, gelisteten Weg wollen, trägt Maesn Sie hindurch, Ihr Produkt kommt also unter Ihrer eigenen Marke im SAP Store an und nicht unter unserer.
Maesn begleitet seine Kunden durch die Zertifizierung und den Eintrag, zusätzlich zur Anbindung über die freigegebenen APIs.
SAP PartnerEdge
Der Entwicklungszweig für Partner, die Anbindungen auf SAP ausliefern, und der Einstieg in den offiziellen Weg.
Zertifizierte Anbindung
„SAP Certified, Integration with SAP S/4HANA“ auf freigegebenen APIs und einem Clean-Core-Ansatz, genau worauf die Zertifizierung von SAP schaut und genau so, wie Maesn baut.
Eintrag im SAP Store
Unter Ihrer Marke, nicht unter der von Maesn. Der Eintrag ist die Vertrauensebene über der API, und er ist der Teil, nach dem ein Enterprise-Einkäufer sucht, bevor ein Beschaffungsgespräch beginnt.
Warum Maesn statt Eigenbau
Bei SAP hat die Frage nach Bauen oder Kaufen eine zusätzliche Dimension, denn es gibt nicht das eine Ding zu bauen. Ein Public-Cloud-Mandant, eine RISE-Landschaft und ein acht Jahre altes On-Premise-Release sind drei Zielsysteme unter einem Produktnamen, und ein Kunde kann zwischen ihnen wechseln, während Sie noch sein Anbieter sind.
Eine API über jede Variante
Public, Private und On-Premise antworten auf derselben Schnittstelle. Das Betriebsmodell, das Ihr Kunde betreibt, ist dann kein Projekt mehr, sondern eine Einstellung, ein Interessent auf RISE und ein Interessent auf einem acht Jahre alten On-Premise-Release erreichen Sie also über dasselbe Onboarding.
Anbindung und Authentifizierung bleiben bei uns
Cloud Connector, Zertifikate, Communication Arrangements und Principal Propagation: die Teile, für die es einen SAP-Basis-Berater braucht, bleiben auf der Seite von Maesn, je angebundenem Kunden. Ihre Entwickler öffnen nie einen Tunnel und verwahren nie ein Zertifikat.
Das nächste System kostet nichts
Sobald SAP über Maesn läuft, antwortet jedes andere ERP- und Buchhaltungssystem im Katalog auf der Schnittstelle, die Sie bereits gebaut haben. Nichts in diesem Katalog verlangt einer Anbindung mehr ab als SAP, ein Team, das sie geschafft hat, hat die schwerste zuerst geschafft.
Public Cloud, Private Edition und On-Premise auf einer REST API, mit Anbindung und Authentifizierung auf unserer Seite.