Wir empfehlen, die Installation zu erst auf einer Shopware-Testumgebung, die entsprechend ihrem Live-Shop konfiguriert ist. Somit können in aller Ruhe die Funktionalität und Bestellungen getestet werden.
Das Plugin wird über die Shopware-Admin (Erweiterungen -> Meine Erweiterungen) installiert.
Über die Funktion "Erweiterung hochladen" ist die gelieferte zip-Datei hochzuladen.
Anschliessend ist das Plugin zu installieren und zu aktivieren.
Sollte auf der Configuratrationsseite die Schaltfläche «API Verbindung testen»
nicht sichtbar sein tun sie folgendes:
Wechsel auf die Server Console des Hostingservers. Ausführen des Komandos:
~/html$ bin/build-administration.sh
Damit wird die Administration neu gebaut und die neuen Frontendkomponenten werden nun angeziegt.
Für die Konfiguration sind die folgenden Einstellungen vorzunehmen:
Zugangsdaten
Ihre Zugangsdaten für das SYMBIOCOMMERCE-API erhalten Sie von Symbionet. Alle Felder sind auszufüllen.
Symbio-API URL: Die URL für das produktive SYMBIOCOMMERCE-System wird von Symbionet vergeben.
Client-id: Name des gewünschten Clients wird von Symbionet vergeben.
Username: Ein gültiger Benutzer des Accounts für den der SYMBIOShop aufgesetzt wurde.
Legen sie auf SYMBIOCOMMERCE in der Benutzerverwaltung ihres Geschäftskontos einen dezidierten Benutzer für den SYMBIOConnector an.
Vergeben sie ihm Administratorrechte. Somit wird verhindert, dass das Passwort ungewollt verändert wird und die Verbindung zu SYMBIOCOMMERCE fehlschlägt.
Client-Secret: Das Client-Secret des Clients, wird von Symbionet vergeben.
Die id des Sales-Group-Channels: Für SYMBIOShop wird die Id 3 verwendet.
Land (ISO-2): Das Land des Kataloges, welchen wir anbinden wollen.
Währung (ISO-3): Die Währung des Kataloges, welchen wir anbinden wollen.
Konfiguration
Hauptkategorie für Symbio-Kategoriebaum: Wählen Sie eine Kategorie aus der Auswahlliste. Welche dies ist, hängt vom Setup Ihres Shops bzw. der verwendeten Verkaufskanäle ab.
Medien-Ordner für Produktbilder: Wählen Sie einen Medienordner aus, in dem die aus SYMBIOCOMMERCE importierten Produktbilder abgelegt werden.
Produkt-Sichtbarkeit - Sales-Channel: Wählen Sie einen Verkaufskanal aus, dem die SYMBIOCOMMERCE-Produkte zugeordnet werden.
Standard-Steuersatz: Wählen Sie einen Steuersatz aus, der den Produkten beim Import zugeordnet wird.
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. Einige Statuscodes sind mehrfach vorhanden, stehen aber nicht für das Selbe. Wählen sie am Besten alle von diesen aus.
Bestellexport
Datum, ab wann die Bestellungen übertragen werden sollen.
Verzögerung der Bestellübertragung
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.
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 bei der Übertragung der Produkte aus SYMBIOCOMMERCE ebenfalls automatisch zu Shopware übertragen. Eine erfolgreich übertragene Produktabbildung erkennen Sie an den Feldern in der Karte Symbio-Daten.
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.
In der Karte Symbio-Daten finden sie die Felder:
SymbioRecipientId identifiziert den Empfänger in SYMBIOCOMMERCE.
SymbioRecipientIdentification identifiziert den Kunden in SYMBIOCOMMERCE.
Erzeugt zeigen den Zeitstempel der ersten Übertragung.
Aktualisiert zeigen den Zeitstempel der letzten Aktualisierung.
Prüfsumme enthält die Prüfsumme der zuletzt an SYMBIOCOMMERCE übermittelten Daten.
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.
Nachträgliche Änderungen in einer Bestellung werden nicht übertragen.
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 SymbioShop unterbrochen wurde, entsteht bei einer erneuten erfolgreichen Übertragung keine doppelte Bestellung.
