Das Plugin IntoSymbioConnector stellt eine Schnittstelle zwischen SYMBIOCOMMERCE und Shopware (=> Version 6.5) bereit. Der Connector deckt die folgenden Bereiche ab:

Kategorien

Initial Anlage, neue Kategorien, Änderungen (inhaltlich und Baumstruktur), Deaktivierung

Produkte

• Initial Anlage, neue Artikel, Änderungen, Deaktivierung

• Einzel- und Variantenartikel

• Einschliesslich Produkt-Media-Dateien

Lagerbestand

Aktualisierung des Lagerbestands aus SYMBIOCOMMERCE

Kunden

Übertragung neu angelegter Kunden inklusive Adressbuch

Bestellungen

Übertragung neuer Bestellungen

Versandinformationen

Import der Versandinformationen per CSV-Datei und automatische Bestimmung des Bestellstatus (teilweise oder vollständig ausgeliefert) in Shopware.

Im Folgenden zeigen wir, wie Sie das Plugin anwenden können. Anschliessend geben wir Ihnen auch Tipps für die Behebung häufig auftauchender Fehler.

Inhalt

Nach der erfolgreichen Installation können Sie mit der Konfiguration beginnen. In zwei Schritten nehmen Sie folgende Einstellungen vor (alle Felder sind obligatorisch):

Zugangsdaten für das Symbio-API

1. Symbio-API URL: Die URL für das produktive SYMBIOCOMMERCE-System (oder das Staging System) haben Sie von Symbionet erhalten.

2. Client-id: Den Namen des Clients haben Sie von Symbionet erhalten.

3. Username: Ein gültiger Nutzer des SYMBIOCOMMERCE-Accounts des Shopbetreibers.

   1. Legen Sie auf SYMBIOCOMMERCE in der Nutzerverwaltung Ihres Geschäftskontos einen neuen, separaten Nutzer an, der nur im Zusammenhang mit dem SYMBIO Connector verwendet wird. So verhindern Sie, dass das Passwort ungewollt verändert wird und dadurch dann die Verbindung zu SYMBIOCOMMERCE fehlschlägt.

   2. Weisen Sie dem Nutzer die Administratorrechte zu.

• Client-Secret: Das Client-Secret des Clients haben Sie von Symbionet erhalten.

• Die Id des Sales-Group-Channels: Für den SYMBIO Shop tragen Sie “3” ein. Ab Version 5.3.2 ist dieser Parameter nicht mehr nötig.

• Land (ISO-2): Der zweistellige ISO-Code des Landes, in dem Sie die Verkaufsgruppe anbieten wollen.

• Währung (ISO-3): Der dreistellige ISO-Code der Währung, die Sie für die Verkaufsgruppe nutzen.

Symbio-Konfiguration:

1. Hauptkategorie für Symbio-Kategoriebaum: Wählen Sie eine Kategorie aus der Auswahlliste. Welche genau, hängt vom Setup Ihres Shops bzw. der verwendeten Verkaufskanäle ab.

   In der PlugInConfig treffen Sie auch eine Auswahl, welche bestehende Kategorie als Root dienen soll. Beim Aufruf der Kategorien über den Endpunkt /services/product/api/external/v1/categories wird die ganze Struktur aus SYMBIOCOMMERCE geliefert. In der Select-Box können Sie die entsprechende Kategorie auswählen.

2. Medien-Ordner für Produktbilder: Wählen Sie einen Medienordner aus, in dem die aus SYMBIOCOMMERCE importierten Produktbilder abgelegt werden.

3. Produkt-Sichtbarkeit - Sales-Channel: Wählen Sie einen Verkaufskanal aus, dem die SYMBIOCOMMERCE-Produkte zugeordnet werden.

4. Standard-Steuersatz: Wählen Sie für Ihre Produkte den gesetzlichen Steuersatz aus. Dieser wird den Produkten beim Import zugeordnet.

5. Liste der Bestell- und Zahlungsstatuscodes zur Übertragung: Wählen Sie einen oder mehrere Statuscodes aus, bei deren Auftreten die Übertragung einer Bestellung zu SYMBIOCOMMERCE ausgelöst wird.

6. ERP Wert - Versandkosten:
   In spezifischen Fällen können Sie dieses Feld benutzen, um einen Wert für die Versandkosten einzutragen.

   Über die SYMPIOCOMMERCE Bestell-API wird der Wert beim Auslesen der Bestellung mitgeliefert, um ins ERP-System übertragen zu werden.

Bestellexport

1. Datum, ab wann die Bestellungen übertragen werden sollen.

2. Verzögerung der Bestellübertragung in Minuten erfassen

Produkt-Synchronisation

1. Preise überschreiben: Wenn die Produkt-Synchronisation von SYMBIOCOMMERCE auf Shopware durchgeführt wird und der Radio-Button aktiviert ist, werden die Preise im Shop überschrieben.

2. Medien aktualisieren: Bei der Produkt-Synchronisation werden die Medien (Bilder, Videos, PDFs) auf den aktuellen Stand der Daten von SYMBIOCOMMERCE im Shop gesetzt. Dabei können in Shopware hinzugefügte Medien überschrieben werden, falls es Differenzen zu SYMBIOCOMMERCE Medien gibt.
   
   

Storefront Einstellungen

1. Verfügbarkeiten überprüfen: Ist diese Funktion aktiv, wird beim Hinzufügen eines Artikels in den Warenkorb seine Verfügbarkeit überprüft. So können jene Artikel, die in der Zwischenzeit nicht mehr verfügbar sind, nicht in den Warenkorb gelegt werden.

2. Download-Tab anzeigen: Ist der Radio-Button aktiv und sind dem Produkt/Artikel PDF-Dateien zugewiesen, werden die PDF-Dateien in der Detailübersicht des Produkts unter dem Reiter “Downloads” angezeigt. Sie können mittels Klick heruntergeladen werden.

Die einzelnen Import- und Export-Funktionen der Schnittstelle werden über Scheduled-Tasks gesteuert. Die Ausführungsintervalle sind in dieser Tabelle zusammengefasst:

Eine Änderung der Intervalle oder eine Deaktivierung der Tasks ist zur Zeit nur über die Bearbeitung der Tabelle scheduled_task in der Shopware-Datenbank möglich.

Synchronisation Sperre

Zwischen 16:00 und 04:00 Uhr (UTC) werden Synchronisationen gesperrt.

Eine aus SYMBIOCOMMERCE übernommene Kategorie erkennen Sie in der Administration an den in der Karte Symbio-Daten angezeigten Feldern.

In der Karte Symbio-Daten finden sie die Felder:

• Symbio-CategoryId finden Sie die zugehörige CategoryId aus SYMBIOCOMMERCE.

• Erzeugt zeigt den Zeitstempel der ersten Übertragung.

• Aktualisiert zeigt den Zeitstempel der letzten Aktualisierung.

• Prüfsumme enthält die Prüfsumme der zuletzt an SYMBIOCOMMERCE übermittelten Daten.

Auf SYMBIO Commerce hinzugefügte Artikel werden in Shopware hinzugefügt. Das Produkt bleibt aktiviert.

Einen aus SYMBIOCOMMERCE übernommenen Artikel (in Shopware als Produkt bezeichnet) erkennen Sie in der Administration an den in der Karte Symbio-Daten angezeigten Feldern und dienen der Identifikation der Produkte und Varianten.

In der Karte Symbio-Daten finden Sie die Felder:

• SymbioProductId zeigt die ProductId aus SYMBIOCOMMERCE - ist bei Varianten leer.

• SymbioArticleId zeigt die ArticleId aus SYMBIOCOMMERCE - ist bei Produkten leer.

• SymbioArticleSKU zeigt die SKU des Artikels aus SYMBIOCOMMERCE - ist bei Produkten leer.
  
  

Handelt es sich um ein Einzelprodukt (d.h. das Produkt hat keine Varianten), sind alle diese drei Felder gefüllt. Wenn es sich um die Kopfdarstellung eines Variantenprodukts handelt, ist nur das Feld SymbioProductId gefüllt.

Handelt es sich um eine Produktvariante, sind dagegen nur die Felder SymbioArticleId und SymbioArticleSKU gefüllt.

• Erzeugt zeigt den Zeitstempel der ersten Übertragung.

• Aktualisiert zeigt den Zeitstempel der letzten Aktualisierung.

• Prüfsumme enthält die Prüfsumme der zuletzt an SYMBIOCOMMERCE übermittelten Daten.

Die Produktabbildungen werden aus SYMBIOCOMMERCE ebenfalls automatisch zu Shopware übertragen.

Aktualisierung der Medien:

• Auf SYMBIO Commerce gelöschte Producktbilder werden auf Shopware gelöscht.

• Auf SYMBIO Commerce hinzugefügte Produktbilder werden auf Shopware hinzugefügt.

• Auf SYMBIO Commerce hinzugefügte Artikelbilder werden auf Shopware übernommen.

• Auf SYMBIO Commerce gelöschte Artikelbilder werden auf Shopware gelöscht.

• Wird auf SYMBIO Commerce ein Bild mit einem anderen überschrieben, wird dies nicht übernommen, weil die Medien-Id gleich bleibt.

• Auf Shopware gelöschte Bilder werden wieder neu angelegt.

Die Produktabbildungen sind an den Feldern in der Karte SYMBIO-Daten erkennbar.

In der Karte Symbio-Daten finden Sie die Felder:

• SymbioMediaId identifiziert die Produktabbildung in SYMBIOCOMMERCE.

• Erzeugt zeigt den Zeitstempel der ersten Übertragung.

• Aktualisiert zeigt den Zeitstempel der letzten Aktualisierung.

• Prüfsumme enthält die Prüfsumme der zuletzt an SYMBIOCOMMERCE übermittelten Daten.

Kundendaten und Adressen werden nach ihrer Erfassung oder Aktualisierung in Shopware an SYMBIOCOMMERCE übertragen. Eine erfolgreiche Übertragung erkennen Sie in der Administration an den in der Karte Symbio-Daten angezeigten Feldern.

Empfänger, die noch nicht in SYMBIOCOMMERCE existieren, werden vor einer Übertragung einer Bestellung mit Symbio-Artikeln angelegt. Eine Prüfung anhand der SymbioID stellt sicher, dass kein Empfänger doppelt angelegt wird.

In der Karte Symbio-Daten finden Sie folgende Felder:

In Shopware getätigte Bestellungen werden dem konfigurierten Intervall entsprechend (Scheduled Task) an SYMBIOCOMMERCE übertragen. Eine erfolgreich übertragene Bestellung erkennen Sie an den Feldern in der Karte Symbio-Daten.

In der Karte Symbio-Daten finden Sie die Felder:

SymbioOrderId identifiziert die Bestellung im SYMBIOCOMMERCE.

SymbioOrderStatus zeigt den von SYMBIOCOMMERCE vergebenen Order-Status an. Dieser sollte in der Regel "APPROVED" sein, wird hier ein anderer Wert gezeigt, so sollte die ordnungsgemässe Verarbeitung der Bestellung in SYMBIOCOMMERCE überprüft werden.

SymbioZeitstempel gibt den Zeitpunkt der Übertragung an SYMBIOCOMMERCE an.

Button 'Auftrag zurücksetzen'

Falls eine Bestellung nicht erfolgreich übertragen wurde, haben Sie die Möglichkeit, die Übertragung zu zurückzusetzen, indem Sie auf den Button 'Auftrag zurücksetzen' klicken. Dadurch wird sichergestellt, dass die Bestellung beim nächsten Übertragungsintervall erneut übermittelt wird.

Im Falle, dass die Bestellung zwar in SYMBIOCOMMERCE erstellt wurde, jedoch die Rückmeldung an den SYMBIO Shop unterbrochen wurde, entsteht bei einer erneuten erfolgreichen Übertragung keine doppelte Bestellung.

Der Import der Versandmeldungen aus dem Kunden ERP erfolgt per CSV-Import. Dabei werden zu jeder Bestellung die übermittelten Trackingcodes und die zugehörigen Lieferpositionen und -mengen importiert. Der Bestellstatus wird entsprechend angepasst auf "teilweise ausgeliefert" bzw. "vollständig ausgeliefert". Die übermittelten Tracking-URLs werden in der Bestellung abgelegt und damit auch dem Kunden in seiner Bestellübersicht angezeigt.

Datentrennzeichen: ; (Semikolon)

Die zu verarbeitenden CSV-Dateien sind ohne Header und enthalten je Packstück eine Zeile mit den folgenden Feldern:

Connector / SYMBIOCOMMERCE

• GET https://{{Host}}/services/product/api/external/v1/categories

   

• GET https://{{Host}}/services/product/api/external/v3/selling-products/channels/{shop-channelId}

   

• POST https://{{Host}}/services/product/api/external/v1/resource-planning/article-availability

   

• POST https://{{Host}}/services/recipient/api/external/v1/addresses/

   

• POST https://{{Host}}/services/recipient/api/external/v1/recipients

   

• PUT https://{{Host}}/services/recipient/api/external/v1/recipients

   

• POST https://{{Host}}/services/order/api/external/v2/order-placement/submit/channel/{channelId}/countryIso/{countryIso}

Sollte es bei der Verarbeitung der Messages (z.B. Neuanlage oder Aktualisierung eines Produkts, Übertragung von Bestellungen zu SYMBIOCOMMERCE usw.) zu schwerwiegenden Fehlern kommen, werden diese Messages in die Shopware-Tabelle dead_messages verschoben. Zusätzlich wird in der Spalte exception_message die Fehlerursache beschrieben.