Herstellerdatenimport von Google Sheets nach Shopware 6 automatisieren

Mehrere Hersteller aus Google Sheets in Shopware 6 importieren – Workflow-Analyse

Diese n8n-Workflow-Vorlage automatisiert den Prozess des Imports mehrerer Produkthersteller aus einem Google Sheet in eine Shopware 6 E-Commerce-Plattform. Sie ermöglicht es Unternehmen, Herstellerdaten – einschließlich Namen, Websites, Beschreibungen, Übersetzungen und Logo-Bildern – effizient direkt aus einer strukturierten Tabelle zu verwalten und zu synchronisieren, wodurch manuelle Eingaben reduziert und Fehler minimiert werden.

Was der Workflow tut

Der Workflow ruft Herstellerdaten aus einem Google Sheet ab, formatiert sie in eine gültige Importstruktur, die mit der Shopware 6 Sync-API kompatibel ist, importiert jeden Hersteller in Shopware und lädt bedingt deren Logo hoch, falls vorhanden. Er unterstützt mehrsprachige Inhalte für internationale Shops und stellt sicher, dass Medien (Logos) korrekt über eindeutige Identifikatoren mittels MD5-Hashing zugeordnet werden. Der gesamte Prozess wird manuell ausgelöst und in Batches ausgeführt, um Skalierbarkeit und Zuverlässigkeit zu gewährleisten.

Hauptmerkmale und Fähigkeiten

• Mehrsprachigkeitsunterstützung: Verarbeitet bis zu drei zusätzliche Sprachübersetzungen pro Hersteller durch dynamisches Mapping von Übersetzungsfeldern.
• Medienverwaltung: Lädt Herstellerlogos automatisch in Shopware hoch und verknüpft sie über konsistente Medien-IDs, die auf dem Herstellernamen basieren.
• Upsert-Logik: Nutzt die upsert-Funktionalität von Shopware, um entweder neue Hersteller zu erstellen oder bestehende ohne Duplikate zu aktualisieren.
• Batch-Verarbeitung: Verarbeitet Hersteller in Batches mithilfe des „Split In Batches“-Knotens, was hilft, Timeouts und API-Ratenbegrenzungen zu vermeiden.
• Bedingte Ausführung: Versucht den Logo-Upload nur dann, wenn eine Medienentität während des Import-Schritts erfolgreich erstellt wurde.
• Sichere Authentifizierung: Nutzt OAuth2 mit dem Client Credentials Grant Type für sicheren Zugriff auf die Google Sheets- und Shopware-APIs.
• Wiederverwendbare Struktur: Leicht erweiterbar für mehr Sprachen oder zusätzliche Felder durch Modifikation der Logik im Code-Knoten.

Hauptknoten und ihre Zwecke

Anwendungsfälle und Vorteile

Anwendungsfälle:

• Onboarding neuer Marken in einen B2B- oder B2C-Online-Shop.
• Synchronisierung aktualisierter Herstellerinformationen (einschließlich lokalisierter Inhalte) über mehrsprachige Shops hinweg.
• Automatisierung der Verwaltung digitaler Assets durch Verknüpfung von Markenlogos während der Erstellung.
• Migration von Altdaten aus Tabellenkalkulationen in moderne E-Commerce-Systeme.

Vorteile:

• Zeitersparnis: Eliminiert stundenlange manuelle Dateneingabe im Shopware-Backend.
• Genauigkeit: Reduziert menschliche Fehler durch automatisierte Verarbeitung und Validierung.
• Skalierbarkeit: Unterstützt Massenoperationen und kann Hunderte von Einträgen durch Batching verarbeiten.
• Bereit für Lokalisierung: Integrierte Unterstützung für die Übersetzung von Namen und Beschreibungen verbessert die Bereitschaft für globale Märkte.
• Erweiterbarkeit: Kann angepasst werden, um Produkte, Kategorien oder Lieferanten mit ähnlichen Mustern zu importieren.

Schritt-für-Schritt-Workflow-Logik

1. Workflow-Initiierung
   Der Benutzer löst den Workflow manuell aus, indem er auf "Workflow ausführen" klickt.

2. Konfigurationseinrichtung
   Der Einstellungen-Knoten legt wesentliche Umgebungsvariablen fest:

   • shopware_url: Basis-URL der Shopware-Instanz
   • default_language_code: Standard-Locale (z. B. de_DE)

3. Daten aus Google Sheets abrufen
   Der Knoten Hersteller aus Google Sheet abrufen holt alle Zeilen aus einer vordefinierten Tabelle. Jede Zeile repräsentiert einen Hersteller mit Spalten wie:

   • name (erforderlich, eindeutig)
   • website
   • description
   • logo_url
   • Optionale Übersetzungsfelder: translation_language_code_1, translation_name_1 usw.

4. Daten mit Code transformieren
   Der Knoten Import-Anfrage-Body erstellen verarbeitet jedes Element:

   • Extrahiert Kernfelder und optionale Übersetzungen.
   • Erstellt ein verschachteltes translations-Objekt, das mit Sprachcodes indiziert ist.
   • Generiert eine deterministische Medien-ID mit md5("media-" + name), um Konsistenz über mehrere Ausführungen hinweg zu gewährleisten.
   • Erstellt ein finales manufacturer-Objekt, das für die Shopware Sync-API strukturiert ist.

5. Batch-Verarbeitungsschleife
   Der Knoten Hersteller durchlaufen teilt das Array der transformierten Elemente in einzelne Batches auf, was eine sequentielle Verarbeitung ermöglicht.

6. Import in Shopware
   Für jeden Batch:

   • Der Knoten Hersteller importieren sendet eine POST-Anfrage an https://your-shopware-url.com/api/_action/sync.
   • Enthält den Parameter import-manufacturer mit der vollständigen Payload.
   • Verwendet die OAuth2-Authentifizierung, die unter den Anmeldeinformationen "SW6 Demo" konfiguriert ist.

7. Bedingte Prüfung des Logo-Uploads
   Nach dem Import prüft der Knoten Wenn Logo vorhanden, ob die API-Antwort eine Medienentität enthält:

   • Überprüfter Pfad: $json.data['import-manufacturer'].result[0].entities.media
   • Wenn vorhanden, wird mit dem Upload fortgefahren; andernfalls wird er übersprungen.

8. Logo-Upload nach Shopware
   Der Knoten Herstellerlogo hochladen:

   • Ruft den Medien-Upload-Endpunkt mit der vom Import zurückgegebenen Medien-ID auf.
   • Übergibt die externe logo_url als Parameter, damit Shopware das Bild abrufen und speichern kann.
   • Setzt dynamische Query-Parameter:
     • extension: Abgeleitet von der Logo-URL (z. B. .png, .jpg)
     • fileName: Basierend auf dem Herstellernamen

9. Abschluss
   Sobald alle Elemente verarbeitet und (falls zutreffend) Medien hochgeladen wurden, endet der Workflow.

Abschließende Hinweise

Dieser Workflow veranschaulicht, wie n8n SaaS-Plattformen wie Google Sheets und Shopware 6 miteinander verbindet, um komplexe Geschäftsprozesse zu automatisieren. Mit klarer Dokumentation durch Sticky Notes und modularem Design dient er sowohl als praktisches Werkzeug als auch als Lernressource für Entwickler und Nicht-Entwickler gleichermaßen. Durch Befolgen der enthaltenen TODOs – wie das Verbinden von Konten, das Erstellen des richtigen Tabellenformats und das Konfigurieren von OAuth2-Integrationen – können Benutzer diese Automatisierung schnell in Produktionsumgebungen einsetzen.