FALLSTUDIE

Heineken (Pivovarna Laško Union)

Shopify-Order-Integration in SAP für zwei Retail-Stores.

Kurzüberblick

  • Branche: FMCG / Getränke / E‑Commerce
  • Kunde: Pivovarna Laško Union d.o.o. (Heineken Group)
  • Lieferumfang: Integrationsservice zur Synchronisation von Shopify-Bestellungen nach SAP
  • Rolle: Systemarchitektur, Backend-Implementierung, SAP-Integrationslogik
  • Integrationspunkte: Shopify Admin API (Orders/Products/Inventory), SAP-Order-Messaging, HTTP Basic Auth
  • Status: Produktiv

Kontext

Der Kunde betreibt zwei Shopify-Shops (rundasekunda.si und union-experience.si), während die gesamte Auftragsabwicklung in SAP stattfindet. Manuelle Neueingaben führten zu Verzögerungen und vermeidbaren Fehlern. Ziel war eine deterministische, SAP-taugliche Order-Pipeline ohne manuelle Schritte.

Problem

  • Bestellungen waren nicht sofort in SAP verfügbar und bremsten das Fulfillment.
  • Manuelles Copy/Paste erzeugte Fehler in Kunden- und Positionsdaten.
  • Operations verbrachte Zeit mit Administration statt mit Ausführung.

Die Integration musste deterministisch, SAP-kompatibel und robust gegenüber Shopify-Datenvarianten sein.

Projektziele

  • Bestellungen aus zwei Shopify-Shops ziehen und in SAP-kompatible Order-Messages mappen.
  • Positionen, Preise, Steuern und Kundendaten vollständig übernehmen.
  • Adress-Edge-Cases und USt-IDs zuverlässig behandeln.
  • Order-Confirmation und Payment-State-Transitions unterstützen.
  • Bei Bedarf Endpoints für Produkt- und Bestandssync bereitstellen.

Rahmenbedingungen & Herausforderungen

  • SAP erfordert strikte Message-Strukturen und Qualifier-Handling.
  • Shopify-Daten sind flexibel und variieren pro Bestellung (Billing vs. Shipping, optionale Adressfelder).
  • Payment-Gateways beeinflussen SAP-Zahlungsbedingungen und müssen korrekt gemappt werden.
  • Refunds und Partial-Refunds müssen in den Positionen abgebildet werden.

Lösungsüberblick

Wir implementierten einen Python/Flask-Integrationsservice, der Bestellungen aus Shopify abruft, in SAP-kompatible Order-Messages transformiert und Endpoints für Confirmations sowie Payment-State-Updates bereitstellt.

Das Ergebnis ist eine deterministische Pipeline aus zwei Shopify-Shops direkt nach SAP — ohne manuelle Eingriffe.

Architektur & technischer Ansatz

Shopify-Integration

  • Nutzt die Shopify Admin API (REST + GraphQL) über den offiziellen Client.
  • Unterstützt zwei Shops über umgebungsbasierte Konfiguration.
  • Filtert Bestellungen nach Payment- und Fulfillment-Status.

Erzeugung von SAP-Order-Messages

  • Erzeugt SAP-kompatible Order-Messages mit Headern, Partnerdaten und Positionen.
  • Mapped Steuern, Rabatte und Versand als strukturierte Line Items.
  • Setzt Zahlungsbedingungen basierend auf dem Shopify-Gateway.

Adress- und USt-Logik

  • Wählt Billing vs. Shipping abhängig vom Länderkontext.
  • Extrahiert Firmen-/USt-IDs aus zusätzlichen Adressfeldern.
  • Normalisiert Felder, um SAP-Parsing-Probleme zu reduzieren.

Operative Endpoints

  • Order-Export-Endpoint für SAP-Ingestion.
  • Confirmation-Endpoint, um Bestellungen in Shopify nach SAP-Ingestion zu schließen.
  • Payment-State-Endpoints für Unpaid/Paid-Transitions.
  • Produkt- und Bestands-Endpoints für optionale SAP → Shopify Flows.

Technologie-Stack

  • Python
  • Flask
  • ShopifyAPI (Shopify Admin API client)
  • lxml / objectify (XML generation)
  • HTTP Basic Auth

Implementierungsprozess

  1. SAP-Order-Anforderungen modelliert und mit Shopify-Datenstrukturen abgeglichen.
  2. Order-Extraktion und Filtering für beide Shops implementiert.
  3. Message-Generation-Pipeline mit allen erforderlichen Segmenten aufgebaut.
  4. Adress-/USt-Parsing sowie Payment-Term-Mapping ergänzt.
  5. Operative Endpoints für Confirmations und Payment-States implementiert.
  6. Produkt-/Bestands-Endpoints für optionale Backflows ergänzt.

Ergebnisse & Wirkung

  • Bestellungen fließen automatisch nach SAP — ohne manuelle Neueingabe.
  • Weniger operative Fehler durch das Kopieren von Bestelldaten.
  • Schnellere Auftragsabwicklung und höhere Fulfillment-Genauigkeit.
  • Eine Integrationsschicht deckt beide Shopify-Shops ab.

Reflexion

Der zentrale Zuverlässigkeitsfaktor war die strikte Einhaltung der SAP-Message-Struktur und die sorgfältige Normalisierung der Shopify-Daten. Shopify-Bestellungen sind flexibel, SAP ist streng. Die Integration wirkt als deterministischer Übersetzer zwischen beiden.

Zusammenfassung

Dieses Projekt lieferte eine produktionsreife Shopify → SAP Integration für Heineken’s slowenische Operations. Sie eliminiert manuelle Order-Handling-Schritte, reduziert Fehler und schafft einen konsistenten Order-Flow aus zwei Shopify-Shops direkt nach SAP.