Schnittstelle: Shopware 6 - Einrichtung & Nutzung

Die Nutzung der Schnittstelle ist kostenfrei. Zur Freischaltung wenden Sie sich bitte an unseren Support unter support@nextpim.de

„Anbindung in drei Schritten“

Die Anbindung Ihres Shopware-Shops erfolgt in drei Schritten:

1. API-Zugang in Shopware einrichten
2. Medienordner anlegen
3. Übertragung in nextPIM konfigurieren und starten

Schritt 1: API in Shopware einrichten

1. Öffnen Sie in Shopware: Einstellungen → System → Integrationen

2. Legen Sie eine neue Integration an.

3. Die Integration muss mit Administrator-Rechten erstellt werden.

4. Speichern Sie die erzeugten API-Zugangsdaten (API-Key / Secret). Diese Zugangsdaten werden im späteren Verlauf in nextPIM benötigt.

 

Schritt 3: Übertragung in nextPIM konfigurieren

5.1 Verbindung einrichten

1. Öffnen Sie in nextPIM den zu übertragenden Katalog

2. Wählen Sie im Strukturbaum die oberste Ebene (Katalogname)

3. Wechseln Sie zu: Einstellungen → Shopware

4. Tragen Sie die API-Zugangsdaten aus Schritt 1 ein

5. Klicken Sie auf „Verbindung testen“

Nach erfolgreichem Test werden weitere Informationen aus Shopware geladen.

Wenn alles funktioniert, nehmen Sie bitte weitere Einstellungen vor:

Grundeinstellungen

• Produktkategorie
  Wählen Sie die Kategorie, in die die Produkte übertragen werden sollen.
  Diese Kategorie wird beim ersten Export mit dem Katalognamen aus nextPIM umbenannt. Bitte passen Sie den Katalognamen in nextPIM entsprechend an.

• Kategorie- / Produktlayout
  Das ausgewählte Layout wird nur bei Neuanlage verwendet.
  Bestehende Layout-Zuweisungen werden nicht überschrieben.

• Verkaufskanal
  Wählen Sie den Verkaufskanal, für den der Katalog übertragen werden soll.

Zusätzliche Einstellungen

Im Reiter „Zusätzliches“ können Sie u. a.:

• Preise bestimmten Verkaufskanälen zuweisen

• die zu übertragende Sprache auswählen

• Gefahrstoffinformationen an die Langbeschreibung anhängen

• Verkaufskanäle über Kategorien steuern

Verkaufskanäle über Kategorien

Tragen Sie bei Kategorien, die einem bestimmten Verkaufskanal zugeordnet werden sollen, den Namen des Verkaufskanals ein. So kann derselbe Artikel unterschiedlichen Kundengruppen mit individuellen Preisen angeboten werden.

 

 

Es ist außerdem möglich, jedes einzelne Produkt (auch einzelne Varianten) sowohl einem bestimmten Verkaufskanal zuzuweisen oder ganz vom Export auszuschließen: 

Preislisten & Verkaufskanäle

Alternativ können Artikel auch über Preislisten in unterschiedlichen Verkaufskanälen angeboten werden.

Voraussetzung:

• Ihr Shopware-Shop ist entsprechend konfiguriert

• In nextPIM sind auf Katalogebene Preislisten den Verkaufskanälen zugewiesen

 

Variantenanzeige

Der Schalter „Varianten in Listen darstellen“ entspricht der Shopware-Funktion:

• Deaktiviert: Nur das Hauptprodukt wird in Kategorien angezeigt

• Aktiviert: Varianten werden einzeln in der Kategorieübersicht dargestellt

Übertragung starten & terminieren

• Über den Kalender kann der Shopware-Export terminiert werden

• Bestätigen Sie die Einstellungen mit „OK“

• Starten Sie die Übertragung mit „Katalog senden“

In nextPIM wählen Sie lediglich die Startkategorie. Unterkategorien werden automatisch angelegt.

Sobald auch hier alle Einstellungen vorgenommen wurden, prüfen Sie bitte einmal die Verbindung zu Ihrem Webshop, damit Sie den Katalog anschließend übertragen können. 

Sobald die Einträge nach Ihren Wünschen konfiguriert sind, klicken Sie auf  "Katalog senden".

Übertragung starten & terminieren

• Über den Kalender kann der Shopware-Export terminiert werden

• Bestätigen Sie die Einstellungen mit „OK“

• Starten Sie die Übertragung mit „Katalog senden“

In nextPIM wählen Sie lediglich die Startkategorie. Unterkategorien werden automatisch angelegt.

 

Hintergrundjobs & Fehlerbehandlung

Nach dem Start wird ein Hintergrundjob ausgeführt.

Da Shopware bestimmte Pflichtfelder verlangt, kann es bei den ersten Übertragungen zu Fehlern kommen. Diese werden nach Job-Abschluss in einer downloadbaren Excel-Datei bereitgestellt.

Wichtige Hinweise

• Nach Korrektur der Fehler kann der Export einfach erneut gestartet werden

• Folgefehler sind möglich, da Shopware Produkte bereits beim ersten fehlenden Pflichtfeld ablehnt

• Erst ein fehlerfreier Lauf garantiert eine vollständige Darstellung im Shop

Nach erfolgreicher Erstübertragung werden bei Folgeexporten nur geänderte Artikel übertragen. Die initiale Medienübertragung kann zeitintensiver sein.

Erfolgreiche Übertragung:

8.2 Preise & Preislisten

• Netto- / Listenpreise

• Streichpreise

• Verkaufskanal-abhängige Preislisten

Bestelldetails

• Lieferzeiten

• Grundpreise

• Mengeneinheiten

 Lieferzeiten in Shopware und nextPIM müssen aufeinander abgestimmt sein.

Darüber hinaus können Sie die Grundpreisdaten so anpassen, wie Sie es für Ihre Produkte benötigen. 

 

 

An Ihren Webshop werden die Medien wie folgt übertragen:

Rubrik Merkmale

In nextPIM pflegen Sie die Eigenschaften, Vorteile und den Lieferumfang Ihrer Artikel an den Produkten, um diese Produktdaten für Ihren Webshop zu verwenden. 

Es stehen Ihnen sechs Merkmalssysteme zur Verfügung: 

udf_NMMARKETINGCLAIM-1.0

 

udf_NMTECHNICALDETAILS-1.0

 

 

 

udf_NMTOPFEATURES-1.0

 

 

udf_NMBENEFITS-1.0

 

 

udf_NMSCOPEOFSUPPLY-1.0

 

 

udf_NMOTHERS-1.0

 

Wie die Produktinformationen anschließend in Ihrem Webshop dargestellt werden, entscheiden Sie gemeinsam mit Ihrem Shopware Webentwickler bzw. Ihrer Marketing Agentur. 

Referenzartikel

Shopware 6 unterstützt aktuell folgende Referenztypen:

• Zubehör

• Ersatzteile

• Ähnliche Produkte

• Nachfolger

• Bestandteile

Welche Anforderung existieren an die Daten?

Derzeit werden von nextPIM folgende Daten geprüft, die bei Nichterfüllung der Bedingungen nicht übertragen und im Jobprotokoll als Fehlermeldung ausgegeben werden. 

- MimeSource muss gefüllt sein
- Beschreibung = "Hersteller Logo" und Verwendung = "logo" fügt bei Shopware dem Hersteller ein Logo hinzu

- Name muss gefüllt sein

• SupplierPID muss gefüllt und darf nicht doppelt vergeben sein
• Lieferzeit muss im Shop eingetragen sein
• SupplierPID darf nicht länger als 64 Zeichen sein
• Name darf nicht mehr als 255 Zeichen haben
• MetaDescription darf nicht länger als 255 Zeichen sein
• MetaTitel darf nicht länger als 255 Zeichen sein
• Preis muss gefüllt sein (mit on request oder net_list)
• Preisliste darf nicht abgelaufen sein (Zeitraum)
• Zahlen mit Kommazahlen müssen in diesem Format dargestellt werden: "X.XX"
  (Punkt als Trennzeichen, KEIN Komma !)
• net_list:
  •  Preis und Steuer müssen gefüllt sein
  •  Untergrenze muss bei mehreren Preisen gefüllt sein
• Merkmale:
  • Ein Merkmal darf nicht das Zeichen "<" enthalten (Hinweis: Inzwischen ist das Zeichen in SW 6 wieder erlaubt , sobald auf das <-Zeichen ein Leerzeichen folgt. Mit dem nächsten Regelupdate von nextPIM wird die Überprüfung angepasst) 
  • Der name (FNAME) darf nicht mehr als 255 Zeichen haben

​​​​​​​