Die architektonische Basis: Warum die offizielle SelectLine OEM-Anbindung den Unterschied macht

Im Entwickler-Alltag erleben wir oft den Versuch, ERP-Systeme über generische Middleware-Lösungen oder rudimentäre CSV-Importe an Shopsysteme zu koppeln. Bei komplexen B2B-Anforderungen führt dies unweigerlich zu asynchronen Datenbeständen, Timeouts bei großen Katalogaktualisierungen und letztlich zu verärgerten Kunden, die falsche Preise im Shop sehen. Die offizielle SelectLine OEM-Anbindung für Shopware geht hier einen fundamental anderen, tiefer integrierten Weg.

Als offizielle Lösung kommuniziert die Schnittstelle nativ mit den API-Endpoints von Shopware 6. Das bedeutet für Sie in der Praxis: Die Datenhoheit verbleibt kompromisslos in der SelectLine. Artikelstammdaten, kundenspezifische Preisfindungen, Lagerbestände und Belegflüsse werden über einen bidirektionalen, fehlertoleranten Kanal synchronisiert. Wenn Sie in der Warenwirtschaft eine neue Kundengruppe anlegen oder einen Staffelpreis für ein spezifisches Debitorenkonto hinterlegen, sorgt die OEM-Schnittstelle dafür, dass exakt dieser Datensatz als validierter Payload in der Shopware-Datenbank landet – ohne Umwege über fehleranfällige Drittanbieter-Tools. Für einen tieferen Einblick in die genauen Synchronisationsintervalle empfehlen wir einen Blick auf unsere detaillierte Funktionsübersicht der Schnittstelle.

Die Erweiterung für den Profi-B2B-Bereich: Shopware 6 trifft auf bronner-b2b.de

Während Shopware 6 von Haus aus eine exzellente Basisarchitektur (Rule Builder, Flow Builder) mitbringt, erfordert der harte B2B-Alltag spezialisierte Workflows am Frontend. Hier entfalten die Shopware-Module von bronner-b2b.de ihr volles Potenzial, indem sie die im ERP definierten Datenstrukturen nahtlos in ein benutzerfreundliches Kundenerlebnis übersetzen.

Die Vernetzung der SelectLine OEM-Anbindung mit den Modulen von bronner-b2b.de löst konkret folgende klassische B2B-Herausforderungen:

• Unternehmensstrukturen und Ansprechpartner: Im ERP pflegen Sie einen Hauptdebitor mit diversen abweichenden Lieferanschriften und spezifischen Einkäufern. Die Schnittstelle überträgt diese Hierarchie in Shopware. Das bronner-b2b.de Modul nutzt diese Struktur, um im Frontend ein Rollen- und Rechtemanagement abzubilden. Ein Einkaufsassistent darf beispielsweise nur Warenkörbe befüllen, während der Einkaufsleiter diese per Klick freigibt.

• Schnellerfassung und CSV-Upload: B2B-Kunden stöbern selten; sie bestellen nach Stücklisten. Die Artikelnummern, die aus der SelectLine in den Shopware-Katalog synchronisiert wurden, lassen sich über die Schnellbestellformulare von bronner-b2b.de direkt in den Warenkorb legen. Auch der Upload einer CSV-Datei mit hunderten Positionen wird durch das Modul geparst und gegen die aus dem ERP stammenden Stammdaten validiert.

• Budgetverwaltung und Kontingente: Wenn Sie in der Warenwirtschaft Kreditlimits für bestimmte Firmenkunden definiert haben, lassen sich diese Budgets über die API an Shopware übergeben. Das B2B-Modul visualisiert dem Kunden seinen verbleibenden Verfügungsrahmen und blockiert den Checkout-Prozess präventiv, sobald das ERP-Limit überschritten wird.

Deep Dive: Kundenspezifische Preisfindung ohne Performance-Verlust

Das komplexeste Thema in jedem B2B-Projekt ist das Pricing. Die SelectLine verfügt über eine extrem mächtige Preisfindungs-Engine (Rabattgruppen, Preisgruppen, Aktionspreise, kundenindividuelle Sonderpreise). Wenn ein Kunde sich im Shopware-Frontend anmeldet, erwartet er in Echtzeit seinen exakten Nettopreis.

Ein Live-Call an das ERP-System bei jedem Seitenaufruf ist aus Performance-Sicht (TTFB – Time to First Byte) ein absolutes Anti-Pattern. Die offizielle OEM-Anbindung löst dieses Problem durch eine intelligente Vorausberechnung (Pre-Calculation) und effizientes Data-Mapping. Die Preise werden als erweiterte Preisregeln in die Datenbank von Shopware 6 gepusht. Die Module von bronner-b2b.de greifen beim Rendern der Kategorieseiten und Produktdetailseiten auf diese nativen Shopware-Tabellen zu. Das Resultat: Millisekunden-schnelle Ladezeiten trotz hochkomplexer, aus dem ERP stammender Preislogik.

Abweichende Topologien: Der Einsatz der Sage 100 für alternative Systeme und Logistik-Fokus

Während die beschriebene Architektur für Shopware-basierte Projekte hervorragende Ergebnisse liefert, erfordern manche IT-Landschaften eine gänzlich andere Herangehensweise. Wenn Sie in Ihrer Digitalisierungsstrategie beispielsweise auf das Ökosystem von Shopify setzen oder Ihr Fokus auf einer extrem tiefgehenden, automatisierten Versandabwicklung liegt, ändert sich die Systemauswahl gravierend. In solchen Szenarien greifen wir konsequent auf die Sage 100 zurück.

Die Sage 100 Warenwirtschaft ist architektonisch ideal darauf vorbereitet, komplexe Shopify-Umgebungen anzubinden. Darüber hinaus spielt die Sage 100 ihre überragenden Stärken aus, wenn es um das Thema Versand und Logistik geht. Benötigen Sie eine nahtlose Carrier-Integration (DHL, UPS, DPD) direkt aus der ERP-Oberfläche? Sollen Versandetiketten vollautomatisch beim Erstellen des Lieferscheins am Packplatz gedruckt und die Trackingnummern zeitgleich an das Shopsystem gemeldet werden? Für diese dedizierten Fulfillment- und Versand-Prozesse sowie für die native Kommunikation mit Shopify-APIs konfigurieren wir ausschließlich die Sage 100 als zentralen Dreh- und Angelpunkt Ihrer E-Commerce-Logistik.

Best Practices für die Datensynchronisation im B2B-Umfeld

Kehren wir zurück zur Verbindung zwischen der SelectLine und Shopware 6. Damit das Zusammenspiel mit den Modulen von bronner-b2b.de reibungslos funktioniert, müssen Sie bei der Einrichtung der Schnittstelle auf technischer Ebene einige Best Practices beachten.

Delta-Abgleich statt Full-Sync

Ein typischer B2B-Katalog umfasst oft zehntausende Artikel mit hunderten Eigenschaften (Länge, Material, Normung), die im ERP detailliert gepflegt sind. Konfigurieren Sie die OEM-Schnittstelle zwingend so, dass sie einen Delta-Abgleich durchführt. Es werden nur die Datensätze (Payloads) an die Shopware 6 Message Queue gesendet, bei denen sich der Hash-Wert in der Wawi seit dem letzten Sync geändert hat. Dies entlastet sowohl die Datenbank des ERP-Systems als auch die API des Shops enorm.

Asynchrone Verarbeitung durch den Message Broker

Shopware 6 nutzt das Symfony Messenger-Konzept. Stellen Sie sicher, dass Ihr Server-Setup (idealerweise Redis oder RabbitMQ) auf den asynchronen Konsum der Nachrichten ausgelegt ist. Wenn die SelectLine Tausende von Preisaktualisierungen an Shopware übermittelt, landen diese zunächst im Message Broker. Ihre CLI-Worker (Command Line Interface) arbeiten diese Queue dann im Hintergrund ab. Dadurch bleibt das Frontend für den Kunden und die Module von bronner-b2b.de jederzeit reaktionsschnell, selbst wenn im Hintergrund ein massiver Import von Kundendaten oder Belegen läuft.

Mapping der B2B-Belege

Geschäftskunden benötigen Zugriff auf ihre Historie. Rechnungen, Lieferscheine und offene Posten sind essenziell für die Buchhaltung Ihrer Kunden. Die offizielle OEM-Anbindung ermöglicht es, PDF-Dokumente und Belegdaten aus dem ERP in den Shopware-Kundenbereich zu spiegeln. Überprüfen Sie hierbei sorgfältig das Mapping der Status-IDs. Ein Auftrag, der im ERP von „in Bearbeitung“ auf „abgeschlossen“ springt, muss in Shopware exakt den Flow Builder triggern, um den Kunden per E-Mail zu informieren. Transparenz ist im B2B-Sektor das wichtigste Gut zur Vermeidung von Support-Tickets.

Fazit: Eine B2B-Architektur, die dauerhaft skaliert

Die Digitalisierung des B2B-Vertriebs verzeiht keine halben Sachen. Wer versucht, Endkunden-Shops mit kosmetischen Anpassungen für Firmenkunden nutzbar zu machen, wird langfristig an der Wartbarkeit scheitern. Die konsequente Nutzung der offiziellen SelectLine OEM-Anbindung als Brücke zu Shopware 6 ist der einzige Weg, um eine saubere, trennscharfe Systemarchitektur aufzubauen.

Die Warenwirtschaft bleibt das unangefochtene Backend für Logik, Preise und Stammdaten. Shopware 6 übernimmt das leistungsstarke, headless-fähige Frontend. Und durch die gezielte Implementierung der B2B-Module von bronner-b2b.de schließen Sie die Lücke in der User Experience, indem Sie hochkomplexe Beschaffungsprozesse intuitiv bedienbar machen. Wenn Sie diese Komponenten technisch sauber verheiraten, auf asynchrone Datenverarbeitung setzen und die Datenhoheit strikt im ERP belassen, schaffen Sie eine B2B-Plattform, die nicht nur aktuellen Anforderungen gerecht wird, sondern auch massives künftiges Wachstum problemlos verkraftet.

Die Systemarchitektur: Kundengruppen-Mapping zwischen Sage 100 und Shopware 6

Ein Blended Store lebt von der personalisierten Auslieferung von Inhalten, Preisen und Checkout-Regeln. In Shopware 6 übernimmt der „Rule Builder“ diese Aufgabe. Doch die Bedingungen für diese Regeln (z. B. „Kunde ist im B2B-Segment“, „Kunde hat Status Großhändler A“) müssen aus dem ERP-System gepusht werden. Wenn wir eine Schnittstelle konfigurieren, mappen wir die Kundengruppen und individuellen Debitoren-Eigenschaften aus der Sage 100 direkt in die Customer Data von Shopware.

Sobald sich ein B2B-Kunde im Shop einloggt, gleicht das System im Hintergrund die aus der Sage 100 übergebenen Flags ab. Das Frontend schaltet in Millisekunden von der B2C-Brutto-Ansicht (D2C) auf die B2B-Netto-Ansicht um. Dieser Vorgang erfordert eine saubere Anlage der Kundenstämme in der Warenwirtschaft. Das bedeutet konkret: Neuanmeldungen im B2B-Bereich des Shops werden als Leads in die Sage 100 geschrieben, dort vom Vertrieb geprüft, freigegeben und anschließend pusht die Schnittstelle für die Sage 100 das Freigabe-Flag via API-Call zurück an Shopware.

Preismatrizen: Kundenindividuelle Konditionen aus dem ERP orchestrieren

Die Preisberechnung ist bei hybriden Geschäftsmodellen der kritischste Faktor. D2C-Kunden sehen Standard-Bruttopreise, eventuell flankiert von temporären Streichpreisen. Im B2B-Sektor hingegen greifen in der Sage 100 hochkomplexe Regelwerke: Rabattgruppen, kundenindividuelle Sonderpreise, abweichende Währungen oder detaillierte Staffelpreise.

Es ist ein klassischer Architekturfehler, diese Logik im Shop-System nachbauen zu wollen. Stattdessen nutzen wir das „Advanced Pricing“ von Shopware 6 als reines Empfangsgefäß für die Payload aus der Sage 100. Der Prozess sieht wie folgt aus:

• Basispreislisten: Die Sage 100 übergibt die reguläre B2C-Preisliste als Standard-Pricing an den Shop.
• Erweiterte Preismatrizen: Über Delta-Sync-Mechanismen werden kunden- oder kundengruppenspezifische Rabattmatrizen aus der Sage 100 extrahiert. Die Schnittstelle transformiert diese in das JSON-Format, das die Shopware 6 Sync-API für Advanced Pricing erwartet.
• Staffelpreise: Abnahmemengen und die dazugehörigen Stückpreise werden artikelgenau aus dem ERP synchronisiert, sodass der B2B-Einkäufer im Shop sofort seine individuellen Margen sieht.

Da wir hier von enormen Datenmengen sprechen – stellen Sie sich 50.000 Artikel mit jeweils 5 kundenindividuellen Preisstaffeln vor –, muss der Datensync als asynchroner Queue-Prozess laufen, der primär auf Datenbank-Triggern (Delta-Sync) basiert. Nur geänderte Preiskonditionen lösen einen API-Call aus, um die Serverlast auf ein Minimum zu reduzieren.

Echtzeit-Lagerbestände und intelligente Verfügbarkeitsanzeigen

Die Anforderungen an die Logistikkommunikation sind im D2C- und B2B-Bereich völlig konträr. Ein Endkunde bestellt ein einzelnes Produkt und erwartet eine sofortige Verfügbarkeit. Ein Großhändler bestellt Europaletten-Weise, rechnet aber mit branchenüblichen Lieferzeiten. Wenn beide Zielgruppen auf dasselbe physische oder logische Lager in der Sage 100 zugreifen, droht Over-Selling.

Die Sage 100 berechnet den „frei verfügbaren Bestand“ unter Berücksichtigung von Reservierungen und offenen Aufträgen. Die Schnittstelle überträgt diesen Wert an Shopware 6. Um den Blended Store abzusichern, implementieren wir oft Pufferbestände: Das ERP meldet dem Shop beispielsweise ab einem realen Lagerbestand von 5 Stück im D2C-Kanal „ausverkauft“, um Retouren-Umtausch oder spontane B2B-Großaufträge abzusichern. B2B-Kunden wiederum können in Shopware 6 durch ERP-gesteuerte Flags autorisiert werden, auch Artikel mit negativem Bestand (Backorders) in den Warenkorb zu legen, da die Sage 100 im Hintergrund automatisch den Beschaffungsprozess beim Lieferanten anstößt.

Offizielle OEM-Anbindung: Der architektonische Exkurs zur SelectLine

Ein kurzer Blick über den Tellerrand für Systemlandschaften mit anderen ERP-Präferenzen: Sollten Sie in Ihrer Infrastruktur auf die SelectLine setzen, realisieren wir exakt dieses komplexe Zusammenspiel über unsere offizielle OEM-Anbindung für Shopware. Die SelectLine agiert hierbei in Kombination mit Shopware als hochgradig synchronisiertes Gespann. Sämtliche Artikelstrukturen, Kundengruppen und mehrschichtigen Preismatrizen werden nativ aus der SelectLine in den Shopware-Store gepusht. Da es sich um die offizielle OEM-Anbindung handelt, garantieren wir eine tiefe Update-Sicherheit und eine verlustfreie Datendurchlässigkeit, die für den stabilen Betrieb eines solchen Blended Stores zwingend erforderlich ist.

Steuerungslogik für das Fulfillment und Versandanbindungen in der Sage 100

Sobald der Bestell-Button im Shop gedrückt wird, verlagert sich die Intelligenz vollständig in die Warenwirtschaft. Wenn wir über komplexe Versandanbindungen und Fulfillment-Prozesse sprechen, ist die Sage 100 das absolute Kraftzentrum Ihrer Logistik. Ein Blended Store erzeugt völlig unterschiedliche Pick-, Pack- und Versand-Workflows.

Eine D2C-Bestellung muss auf Geschwindigkeit optimiert sein. Die Schnittstelle importiert den Webshop-Auftrag in die Sage 100, das System generiert per Auto-Workflow direkt den Lieferschein und triggert die Versandanbindung. Das Versandlabel (z. B. DHL oder DPD) wird gedruckt, und die Tracking-Nummer wandert sofort per API-Request zurück in den Shopware Store.

Eine B2B-Bestellung hingegen erfordert oft Teillieferungen, Speditionsversand oder die Zusammenführung mehrerer Bestellungen (Sammellieferscheine). Die Sage 100 erkennt anhand des Kundengruppen-Flags der importierten Bestellung sofort, dass es sich um einen Großhandelsauftrag handelt. Hier greifen andere Versandanbindungen – beispielsweise die Übermittlung der Frachtdaten an eine Speditionssoftware.

Sollten Sie Ihre Endkunden-Strategie übrigens noch granularer aufstellen und beispielsweise Shopify als dedizierten, reinen D2C-Kanal neben dem Blended Store betreiben, lässt sich auch dies zentral orchestrieren. Die Sage 100 zieht dann die Bestellungen aus beiden Plattformen an. Sämtliche Versandanbindungen, Label-Drucke und Retouren-Prozesse für Shopify- und Shopware-Aufträge werden einheitlich über das ERP abgewickelt, ohne dass die Logistik-Mitarbeiter jemals die Oberfläche wechseln müssen.

B2B-Features durch ERP-Daten befeuern: Kreditlimits und Schnellbestellungen

Ein herausragender Blended Store zeichnet sich dadurch aus, dass B2B-Kunden Funktionen nutzen können, die für D2C-Kunden unsichtbar bleiben. Diese Features benötigen jedoch belastbare Daten aus der Sage 100.

1. Bonitätsprüfung und dynamische Zahlungsarten

Im Großhandel ist der „Kauf auf Rechnung“ Standard, birgt aber Risiken. Die Sage 100 führt für jeden Debitor ein individuelles Kreditlimit. Über die Schnittstelle synchronisieren wir dieses Limit als Zusatzfeld (Custom Field) in den Shopware 6 Kundenstamm. Zudem übertragen wir den kumulierten Wert der offenen Posten. Der Rule Builder im Shop berechnet die Differenz. Übersteigt der Wert des aktuellen Warenkorbs das noch verfügbare Kreditlimit des Kunden, wird die Zahlungsart „Rechnung“ im Checkout dynamisch ausgeblendet und durch „Vorkasse“ ersetzt. Dies ist ein perfektes Beispiel dafür, wie tiefgreifend ERP-Daten die Frontend-Logik steuern können.

2. Kundenindividuelle Artikelnummern

B2B-Einkäufer suchen oft nicht nach Ihren internen SKU-Nummern, sondern nach ihren eigenen Materialnummern. Die Sage 100 kann pro Debitor und Artikel abweichende Kundenartikelnummern speichern. Übertragen wir dieses Mapping in die ElasticSearch- oder Standard-Suche von Shopware 6, kann der Großhändler im Blended Store seine eigenen Nummern in das Suchfeld eingeben und landet exakt beim richtigen Produkt. Für den D2C-Kunden bleibt dieses Datenfeld irrelevant und unsichtbar.

3. Belegwesen und Historie

Der D2C-Kunde möchte lediglich sehen, ob sein Paket versendet wurde. Der B2B-Kunde benötigt PDF-Rechnungen für die Buchhaltung, Lieferscheinkopien und den Status von Teillieferungen. Auch hier fungiert die Sage 100 als Master. Statt Belege im Shop zu generieren (was buchhalterisch bei B2B oft problematisch ist), generiert die Sage 100 die rechtskonforme Rechnung. Die Schnittstelle pusht das PDF-Dokument – oder zumindest einen sicheren Download-Link – direkt in das Kundenkonto des Shopware-Frontends. Der B2B-Kunde bedient sich im Self-Service, was Ihren Innendienst massiv entlastet.

Fazit: Architektur ohne Kompromisse

Der Betrieb eines Blended Stores mit D2C- und B2B-Segmenten in einem einzigen Shopware 6 Frontend ist technisch hochgradig effizient, sofern die Architektur strikt top-down aufgebaut ist. Die Sage 100 muss die unangefochtene Hoheit über Stammdaten, Preismatrizen, Bestände und komplexe Versandanbindungen behalten. Wenn Sie versuchen, ERP-Logik im Webshop nachzuprogrammieren, enden Sie unweigerlich im Wartungs-Chaos und riskieren fatale Inkonsistenzen bei Preis- und Steuerberechnungen.

Setzen Sie auf eine robuste, API-gestützte Schnittstellenarchitektur, die Delta-Updates nutzt, um Shopware als schnelles, dynamisches Auslieferungs-Frontend zu bespielen. Durch dieses Setup skalieren Sie Ihre Vertriebskanäle ressourcenschonend und bieten sowohl dem spontanen Endkunden als auch dem strukturierten Großhändler eine exzellente, fehlerfreie Customer Experience.

Als Entwickler, der sich tagtäglich mit der Datenintegrität zwischen E-Commerce-Plattformen und ERP-Backends befasst, betrachte ich die Schnittstelle als das zentrale Nervensystem dieser Infrastruktur. Die offizielle OEM-Anbindung für SelectLine ist exakt für solche Belastungsspitzen und Logik-Verschachtelungen konzipiert. Sie übernimmt die Aufgabe, das asynchrone JSON-Payload eines komplexen Shopware-Auftrags bitgenau und fehlerfrei in die strikte relationale Datenbanklogik der SelectLine Warenwirtschaft zu übersetzen.

Schnellbestellungen per CSV: Wenn Datenmassen auf die ERP-Logik treffen

Die Implementierung einer Schnellbestellfunktion via CSV-Upload in Shopware 6 optimiert die User Experience für den B2B-Einkäufer enorm. Anstatt sich durch Kategoriestrukturen zu navigieren, lädt das System eine rohe Liste mit oft hunderten product_number– und quantity-Werten in den Speicher. Das Shopware-Frontend validiert diese Eingaben gegen den aktuellen Index, berechnet individuelle B2B-Rabatte und erzeugt ein massives Checkout-Payload.

Die Herausforderung für die Schnittstelle beginnt exakt in der Sekunde des Kaufabschlusses. Ein Auftrag mit 350 Positionen darf das ERP-System bei der synchronen Übergabe nicht blockieren. Die offizielle OEM-Schnittstelle nutzt hierfür intelligente Warteschlangen (Message Queues) und verarbeitet die Aufträge asynchron. Dies bedeutet für Ihre Architektur:

• Transaktionssicherheit: Der gesamte Auftrag wird als eine atomare Transaktion an SelectLine übergeben. Bricht die Verbindung bei Position 349 ab, wird der gesamte Beleg in der SelectLine verworfen (Rollback) und der Übertragungsversuch nach einem definierten Intervall neu gestartet. Es entstehen keine „Halb-Aufträge“ in der Warenwirtschaft.
• Performance-Erhalt: Durch die Pufferung der Datenmassen bleibt sowohl Shopware 6 als auch die SelectLine performant. Die API-Limits werden respektiert, während Hintergrund-Worker die Datensätze kontinuierlich abarbeiten.
• Validierung der Artikelnummern: Oftmals weichen SKU-Formate in CSV-Dateien (z.B. durch vorangestellte Nullen) leicht von der Datenbank ab. Die Schnittstelle mappt die Shopware-SKU präzise auf die korrespondierende Artikelnummer in SelectLine, ohne dass es zu Fehlzuordnungen kommt.

Freigabeprozesse: Der feine Unterschied zwischen Entwurf und rechtsgültigem Auftrag

In B2B-Szenarien, insbesondere bei der Nutzung der Shopware B2B Suite oder der B2B Components, löst der Klick auf „Kaufen“ oft noch keinen echten Auftrag aus. Wenn der bestellende Mitarbeiter sein monatliches Budget überschreitet oder bestimmte Warengruppen bestellt, geht der Warenkorb in einen Status „Wartet auf Freigabe“ (Pending Approval) über. Ein Vorgesetzter muss diesen Vorgang zunächst autorisieren.

Aus Schnittstellen-Perspektive erfordert dies eine präzise Überwachung der State Machine in Shopware. Ein fataler Fehler unsauber programmierter Middleware ist es, jeden erzeugten Checkout blind an das ERP zu senden. Die Folge: In der SelectLine entstehen Aufträge, die rechtlich noch gar nicht bindend sind, blockieren physische Lagerbestände und verfälschen die Disposition.

Die offizielle OEM-Anbindung löst dieses Problem durch ein striktes Status-Mapping (siehe auch unsere Funktionsübersicht zur Auftragssynchronisation). Der Prozesszyklus sieht dabei wie folgt aus:

1. Der Mitarbeiter schließt die CSV-Schnellbestellung ab. Der Auftrag erhält in Shopware den internen Status in_progress oder ein äquivalentes B2B-Flag.
2. Die Schnittstelle registriert den Auftrag, ignoriert ihn jedoch bewusst für den Import in die SelectLine, da die Mapping-Regel vorschreibt: Importiere nur Aufträge mit dem Status open oder approved.
3. Der Abteilungsleiter loggt sich in Shopware ein und erteilt die Freigabe. Die State Machine von Shopware ändert den Auftragsstatus.
4. Ein Webhook oder der nächste Cronjob-Zyklus der Schnittstelle erfasst diese Statusänderung. Jetzt erst wird das Payload generiert und der Auftrag als gültiger Beleg (z.B. „Auftrag“ oder „Internetauftrag“) in der SelectLine angelegt.

Das technische Mapping: Shopware-Datenstrukturen in SelectLine-Belege übersetzen

Die Übersetzung eines komplexen B2B-Auftrags ist kein simples Kopieren von Textfeldern. Die SelectLine Warenwirtschaft verlangt nach einer strukturierten Anlage von Belegköpfen und Belegpositionen unter strenger Einhaltung kaufmännischer Logik. Die OEM-Schnittstelle greift tief in diese Architektur ein.

Kunden- und Debitor-Zuordnung

B2B-Kunden in Shopware verfügen oft über abweichende Rechnungs- und Lieferadressen, die als Unternehmenskonten geführt werden. Die Schnittstelle prüft beim Import zunächst, ob die übermittelte customer_number bereits als Debitor in SelectLine existiert. Ist dies der Fall, wird der Auftrag exakt diesem Mandanten zugeordnet. Existiert eine neue Lieferadresse, wird diese nicht als freier Text in den Beleg geschrieben, sondern sauber als neue, verknüpfte Lieferadresse im Kundenstamm der SelectLine angelegt.

Preise, Steuern und Rundungsdifferenzen

Ein berüchtigtes Problem bei der Übertragung langer Stücklisten sind Rundungsdifferenzen. Shopware berechnet den Gesamtpreis (oft netto im B2B) auf Basis eigener Algorithmen. Wenn das ERP-System nun versucht, den Auftrag anhand der übermittelten Mengen und der ERP-internen Preislisten neu zu berechnen, kommt es bei 350 Positionen fast zwangsläufig zu Abweichungen im Cent-Bereich.

Um dies zu verhindern, agiert die Schnittstelle hochgradig defensiv: Sie zwingt die SelectLine nicht zur Neuberechnung, sondern übergibt die in Shopware kalkulierten Netto-Einzelpreise als fixe Werte (Fremdpreise) in die Belegpositionen. Die Steuerklassen (Voll, Ermäßigt, Steuerfrei bei innergemeinschaftlichen Lieferungen) werden anhand der Shopware-Steuer-IDs auf die entsprechenden Steuerschlüssel der SelectLine gemappt. Das Ergebnis ist ein Buchungsbeleg, dessen Gesamtsumme auf den Cent genau dem Checkout in Shopware entspricht.

Verpackungseinheiten (VPE) und Staffelpreise

B2B-Bestellungen via CSV enthalten oft Mengen, die an bestimmte Verpackungseinheiten gebunden sind (z.B. „Gebinde à 50 Stück“). Die Schnittstelle muss die quantity des Shopware-Payloads korrekt interpretieren. Bestellt der Kunde 5 Gebinde, erfasst Shopware möglicherweise „5“, während SelectLine eine Basisstückzahl von „250“ abbuchen muss, je nachdem, wie der Artikelstamm konfiguriert ist. Die OEM-Anbindung gleicht die Umrechnungsfaktoren aus den Artikelstammdaten ab und sorgt dafür, dass die korrekte Basismengeneinheit im Beleg landet, um eine fehlerfreie Lagerabbuchung zu gewährleisten.

Fehlerbehandlung: Wenn Rohdaten korrupt sind

Trotz aller Vorab-Validierungen im Shopware-Frontend kann es vorkommen, dass unsaubere Daten die Schnittstelle erreichen. Ein B2B-Kunde lädt eine veraltete CSV-Datei hoch, die einen Artikel enthält, der in der SelectLine bereits archiviert oder gesperrt ist. Wie reagiert eine sauber konstruierte Middleware?

Anstatt abzustürzen oder den Auftrag komplett verschwinden zu lassen, greift ein mehrstufiges Error-Handling:

1. Validierungsphase: Bevor der Beleg in SelectLine geschrieben wird, simuliert die Schnittstelle den Import (Dry-Run).
2. Fehlererkennung: Das System erkennt, dass Position 112 (SKU: 9988-X) in der SelectLine nicht existiert oder für den Verkauf gesperrt ist.
3. Quarantäne: Der Auftrag wird nicht in die SelectLine geschrieben, um die Datenintegrität des ERPs zu schützen. Gleichzeitig wird der Auftrag in Shopware nicht als „erfolgreich exportiert“ markiert.
4. Alerting: Die Schnittstelle loggt den spezifischen Fehler detailliert („Auftrag #10452 fehlgeschlagen: Artikel 9988-X in SelectLine gesperrt“) und benachrichtigt den Shop-Administrator.

Dieses Vorgehen garantiert, dass Administratoren exakt wissen, wo das Problem liegt, die Stammdaten in SelectLine korrigieren (z.B. den Artikel entsperren) und den Import des Auftrags über das Dashboard der Schnittstelle per Knopfdruck erneut anstoßen können. Es geht kein Umsatz verloren und das ERP bleibt von fehlerhaften Datensätzen verschont.

Fazit

Die Automatisierung komplexer B2B-Aufträge, die über CSV-Uploads generiert und durch Freigabeprozesse verzögert werden, erfordert weit mehr als nur den Transport von Daten von A nach B. Es geht um die semantische Übersetzung von E-Commerce-Logik in strikte, buchhalterische ERP-Richtlinien.

Die offizielle OEM-Anbindung für SelectLine bietet exakt die tiefe Integration, die für solche Hochlastszenarien und verschachtelten Workflows zwingend erforderlich ist. Indem sie Shopware-Statusänderungen exakt abhört, Rundungsdifferenzen durch präzises Preis-Mapping eliminiert und gigantische CSV-Warenkörbe über asynchrone Warteschlangen ressourcenschonend verarbeitet, verwandelt sie potenzielle administrative Flaschenhälse in einen lautlosen, fehlerfreien Hintergrundprozess. Für Unternehmen, die ihren B2B-Einkauf skalieren möchten, ist diese architektonische Stabilität das Fundament für ein verlässliches und profitables E-Commerce-Geschäft.

Welche Vorteile bringt die Verknüpfung mit sich und welche Kriterien sollte die Schnittstelle erfüllen?

Die Antworten auf diese Fragen finden Sie im SelectLine-Gastartikel auf dem Shopware Blog.

https://www.shopware.com/de/news/checkliste-fuer-die-erfolgreiche-verknuepfung-von-shopware-und-warenwirtschaft/

Im Zeitraum vom 01.07.2020 – 31.12.2020 ist im Rahmen des Konjunkturpakets der Bundesregierung der gesetzliche Mehrwertsteuersatz von 19% auf 16% und von 7% auf 5% gesenkt.
Was müssen Sie nun in der Schnittstelle zur Warenwirtschaft und im Shopware beachten bzw. umstellen.

Als Erstes müssen Sie im Shop dafür sorgen, dass die Mehrwertsteuersätze entsprechend vorhanden sind. Dazu können Sie entweder

• Beste Methode: das Shopware Plugin, das laut Shopware am 29.06.2020 im Shopware Community Store verfügbar sein soll
• manuell neue Steuersätze anlegen und den Artikeln im Shop zuweisen und danach einen erneuten Preisupload durchführen.
• den bestehenden Steuersatz jeweils einfach ändern (Nicht empfehlenswert, da dies auch alte Bestellungen ändern würde)

• Dieses Shopware AG Plug-In macht ein einmaliges Update auf alle Netto-Preise mit den entsprechenden Abschlägen, dass die Bruttopreise am Ende identisch sind.
• Erstellt neue MwSt. ID’s für 16% und 5%
• Ordnet allen Artikeln die neue MwSt. ID’s zu
• Die alten MwSt. ID’s von 19% und 7% dürfen nicht gelöscht und nicht überschrieben werden.
• Dadurch ist dann am 01.01.2021 eine Zurückstellung möglich.
• In der Bestellungen-Tabelle sind die MwSt. ID’s der Artikel zu dem jeweiligem Tag zugeordnet. (30.06. 19% und 01.07. 16%)

Möglichkeit 2: Der Brutto-Preis wird günstiger (Änderung des Mwst. Satzes)
Hier werden Zeitgesteuert die Änderungen durch diesen Shopware AG Plug-In durchgeführt:

• Erstellt neue MwSt. ID’s für 16% und 5%
• Ordnet allen Artikeln die neue MwSt. ID’s zu
• Die alten MwSt. ID’s von 19% und 7% dürfen nicht gelöscht und nicht überschrieben werden.
• Dadurch ist dann am 01.01.2021 eine Zurückstellung möglich.
• In der Bestellungen-Tabelle sind die MwSt. ID’s der Artikel zu dem jeweiligem Tag zugeordnet. (30.06. 19% und 01.07. 16%)