SAP Business One und SAP S/4HANA mit Magento 2 verbinden

1. Warum manuelle Auftragsübertragung zwischen Magento und SAP nicht skaliert

Solange ein Shop nur wenige Bestellungen am Tag verarbeitet, lässt sich eine manuelle Übertragung ins ERP noch mit vertretbarem Aufwand stemmen. Sobald das Bestellvolumen wächst oder mehrere Vertriebskanäle gleichzeitig bedient werden, wird die manuelle Erfassung zum Flaschenhals: Mitarbeiter übertragen Positionen, Mengen und Adressen von Hand, was bei wachsendem Volumen unweigerlich zu Tippfehlern, doppelt erfassten Aufträgen und verzögerter Lieferung führt.

Eine automatisierte SAP-Anbindung beseitigt genau diesen Engpass, verlangt aber eine saubere technische Grundlage: Die Integration muss Bestellungen zuverlässig genau einmal übertragen, auch bei Netzwerkfehlern oder kurzzeitigen Ausfällen der SAP-Schnittstelle, und dabei alle für die Buchhaltung relevanten Felder korrekt und vollständig mitgeben. Wird diese Grundlage sauber gelegt, sinkt nicht nur die Fehlerquote spürbar, sondern auch die Zeit zwischen Zahlungseingang im Shop und Verfügbarkeit des Auftrags im ERP für Versand und Fakturierung.

2. SAP Business One und SAP S/4HANA technisch einordnen

SAP Business One richtet sich an kleine und mittlere Unternehmen und bietet mit der Service Layer API eine moderne, REST-basierte Schnittstelle, die Standardobjekte wie Aufträge, Artikel und Geschäftspartner direkt über HTTP-Aufrufe mit JSON-Payloads bereitstellt. Die Service Layer API ist vergleichsweise einfach zu integrieren, weil sie den Datenmodellen der SAP-Business-One-Oberfläche sehr nahekommt und gut dokumentiert ist.

SAP S/4HANA adressiert dagegen größere Organisationen und bietet OData-Services sowie, je nach Ausbaustufe, eine Anbindung über SAP Cloud Integration oder die SAP Integration Suite als Middleware-Schicht. Die Datenmodelle in S/4HANA sind deutlich komplexer als bei SAP Business One, weshalb eine direkte Punkt-zu-Punkt-Anbindung ohne Middleware bei S/4HANA seltener sinnvoll ist als bei Business One.

3. Die Service Layer API von SAP Business One anbinden

Die Service Layer API von SAP Business One authentifiziert sich über einen Login-Endpunkt, der eine Session-ID zurückliefert, die anschließend als Cookie bei jedem weiteren Aufruf mitgeschickt werden muss. Diese Session hat eine begrenzte Gültigkeit, weshalb die Integration ein automatisches Re-Login bei abgelaufener Session einbauen muss, statt bei jedem fehlgeschlagenen Aufruf sofort einen Fehler an den Magento-Checkout zurückzugeben.

Für das Anlegen eines Auftrags sendet die Integration einen POST-Aufruf an den Orders-Endpunkt mit Geschäftspartner-Code, Positionen samt Artikelnummer und Menge sowie der gewünschten Lieferadresse. Die Service Layer API validiert dabei serverseitig unter anderem Kreditlimits und Lagerverfügbarkeit, sodass ein abgelehnter Auftrag mit einer aussagekräftigen Fehlermeldung zurückkommt, die die Integration auswerten und dem Shop-Team verständlich zurückmelden muss.

<?php
declare(strict_types=1);

namespace Mironsoft\SapSync\Model\Client;

/**
 * Legt einen Auftrag in SAP Business One ueber die Service Layer API an.
 */
final class ServiceLayerOrderClient
{
    public function __construct(
        private readonly ServiceLayerSession $session,
        private readonly \GuzzleHttp\ClientInterface $httpClient,
    ) {
    }

    /**
     * Erstellt einen Auftrag fuer eine abgeschlossene Magento-Bestellung.
     *
     * @param array $orderPayload
     * @return array
     */
    public function createOrder(array $orderPayload): array
    {
        $response = $this->httpClient->request('POST', 'Orders', [
            'headers' => ['Cookie' => 'B1SESSION=' . $this->session->getSessionId()],
            'json' => $orderPayload,
        ]);

        return json_decode((string) $response->getBody(), true);
    }
}

4. Bestellungen und Aufträge automatisch aus Magento importieren

Der Auftrags-Import sollte immer erst dann ausgelöst werden, wenn eine Magento-Bestellung tatsächlich vollständig bezahlt oder zumindest verbindlich autorisiert ist, statt bereits bei einem noch abbrechbaren Warenkorb einen SAP-Auftrag anzulegen. Ein Beobachter-Muster auf dem Order-Status-Wechsel eignet sich dafür besser als ein reiner Cron-Job, weil die Übertragung dann nahezu in Echtzeit erfolgt.

Wichtig ist außerdem eine eindeutige Referenz zwischen der Magento-Bestellnummer und dem angelegten SAP-Auftrag, die in beiden Systemen sichtbar gespeichert wird. Diese Referenz erleichtert nicht nur den Kundenservice bei Rückfragen erheblich, sondern verhindert auch, dass bei einem Wiederholungsversuch nach einem fehlgeschlagenen Aufruf versehentlich ein doppelter Auftrag in SAP entsteht.

5. Stammdaten-Synchronisation: Artikel, Preislisten und Lagerorte

Artikelstammdaten wie Artikelnummer, Bezeichnung, Gewicht und Steuercode sollten aus SAP als führendem System nach Magento übertragen werden, da diese Daten für Buchhaltung und Lagerwirtschaft ohnehin dort gepflegt werden müssen. Preislisten in SAP Business One lassen sich über eigene Preislisten-Objekte abbilden, die sich auf Magento-Kundengruppen mappen lassen, sofern die Preisdifferenzierung in beiden Systemen nach vergleichbarer Logik erfolgt.

Bei mehreren Lagerorten muss die Integration zusätzlich festlegen, welcher SAP-Lagerort für die im Shop angezeigte Verfügbarkeit maßgeblich ist, insbesondere wenn ein Unternehmen über mehrere Standorte unterschiedliche Warenbestände führt. Eine aggregierte Verfügbarkeitslogik über mehrere Lagerorte hinweg ist technisch möglich, sollte aber bewusst und nicht als Nebeneffekt einer zu einfachen Abfrage entstehen.

6. SAP S/4HANA anbinden: OData-Services und SAP Cloud Integration

SAP S/4HANA stellt seine Geschäftsobjekte über standardisierte OData-Services bereit, etwa für Verkaufsaufträge oder Geschäftspartner, die sich grundsätzlich direkt aus Magento aufrufen lassen. In der Praxis läuft die Anbindung bei S/4HANA aber häufiger über die SAP Integration Suite oder eine vergleichbare Middleware, weil Unternehmen mit S/4HANA meist bereits weitere Umsysteme integriert haben und eine zentrale Integrationsschicht Transformationsregeln wiederverwendbar macht.

Diese Middleware übernimmt dann die Umwandlung des Magento-Bestellformats in die von S/4HANA erwartete OData-Struktur, inklusive komplexerer Feldzuordnungen für Kostenstellen, Vertriebsorganisationen und Werke, die in SAP Business One in dieser Form meist nicht existieren. Wer bereits eine Middleware für andere Systeme betreibt, sollte die S/4HANA-Anbindung dort ergänzen, statt eine isolierte Punkt-zu-Punkt-Verbindung ausschließlich für Magento aufzubauen.

7. Fehlerbehandlung bei abgelehnten Aufträgen und Kreditlimit-Sperren

Lehnt SAP einen Auftrag wegen eines überschrittenen Kreditlimits des Kunden ab, darf die Magento-Bestellung nicht einfach als erfolgreich abgeschlossen im Shop stehen bleiben, sondern muss klar als in Prüfung markiert werden. Die Integration sollte dem Kunden eine verständliche Statusmeldung anzeigen und dem Vertriebsinnendienst eine Benachrichtigung zukommen lassen, damit die Kreditlimit-Situation manuell geklärt werden kann, statt dass der Auftrag stillschweigend in einer Fehlerwarteschlange verschwindet.

Ähnliches gilt für Lagerverfügbarkeitskonflikte, etwa wenn ein Artikel zwischen Bestelleingang im Shop und Verarbeitung in SAP anderweitig reserviert wurde. Ein klar definierter, für das Vertriebsteam nachvollziehbarer Eskalationsprozess ist hier wichtiger als der Versuch, jeden denkbaren Konfliktfall vollautomatisch aufzulösen, zumal viele dieser Randfälle eine fachliche Entscheidung erfordern, die sich in Code kaum vollständig und dauerhaft korrekt abbilden lässt.

8. Sicherheits- und Berechtigungskonzept für die Schnittstelle

Der für die Integration verwendete SAP-Servicebenutzer sollte ausschließlich die tatsächlich benötigten Berechtigungen erhalten, etwa Lese- und Schreibrechte auf Aufträge und Lesezugriff auf Stammdaten, statt mit einem vollständigen Administrator-Zugang zu arbeiten. Diese Einschränkung begrenzt den möglichen Schaden erheblich, falls die Zugangsdaten der Integration jemals kompromittiert werden sollten.

Zusätzlich empfiehlt sich ein Rate-Limiting auf Seiten der Magento-Integration, das verhindert, dass ein fehlerhafter Wiederholungsmechanismus die SAP-Schnittstelle mit übermäßig vielen Anfragen belastet und dadurch andere, ebenfalls auf SAP angewiesene Systeme im Unternehmen beeinträchtigt.

9. SAP-Integrationsansätze im Überblick

Die folgende Tabelle vergleicht die wichtigsten Integrationsansätze für SAP Business One und SAP S/4HANA mit dem jeweils typischen Aufwand und der empfohlenen Vorgehensweise.

10. Zusammenfassung

11. FAQ: SAP-Integration: Das Wichtigste auf einen Blick