Benutzer-Werkzeuge

Webseiten-Werkzeuge


public:shopware-fatchipafterbuy

Shopware-Afterbuy-Connector

Wichtig: Diese Erweiterung befindet sich aktuell im Betastatus. Vor Nutzung in Produktivsystemen raten wir dazu, diese Erweiterung ausführlich in einer Testumgebung zu prüfen und natürlich eine Datensicherung anzulegen.

1. Vorwort / Anmerkungen

1.1 Voraussetzungen

  • php-curl
  • PHP 7.1
  • Shopware 5.3

1.2 Beschränkungen

Die maximale Anzahl an Varianten für einen Artikel ist aktuell auf 250 begrenzt. Shopware-Artikel müssen über einen Hersteller und einen Preis verfügen. Artikel ohne Hersteller und Preis werden importiert, sind aber keine validen Artikel und werden von daher auf inaktiv gesetzt. Shopware unterstützt keine negativen Preise.

1.3 bitte beachten!

Die Konfiguration bezüglich des führenden Systems sollte nicht im Betrieb geändert werden. Es werden stets die IDs des führenden Systems verwendet, was bei Änderung dazu führen kann, dass Duplikate erstellt werden.

Es empfiehlt sich, das nicht führende System vor Inbetriebnahme zu leeren.

2. Installation

2.1 Über den Pluginmanager / Community-Store

Die Installation von Plugins über den Pluginmanager wird hier beschrieben: https://docs.shopware.com/de/shopware-5-de/einstellungen/plugin-manager

2.2 manuelle Installation

Entpacken Sie das heruntergeladene Archiv und verschieben Sie dessen Inhalt in das Verzeichnis custom/plugins. Anschließend kann die Erweiterung wie gewohnt über den Plugin-Manager installiert werden.

3. Konfiguration

Die Konfiguration ist über den Plugin-Manager vorzunehmen. Öffnen Sie dazu den Pluginmanager und wechseln Sie nach „Installiert“, um dort mit einem Click auf die Plugineinstellungen für das jeweilige Plugin zu öffnen.

3.1 Grundeinstellungen

Führendes System

Shopware

  • Artikel und Kategorien (noch nicht übermittelt oder geändert seit letztem Export) werden von Shopware an Afterbuy übertragen.
  • Bestellungen (seit letztem Import) werden aus Afterbuy importiert.
  • Der Status von abgeschlossenen Bestellungen wird vor jedem Bestellimport an Afterbuy übermittelt.

Afterbuy

  • Artikel und Kategorien werden von Afterbuy importiert.
  • Im Shop getätigte Bestellungen werden an Afterbuy übermittelt.
  • Der Status nicht versendeter Bestellungen (Status „Offen“) wird seitens Shopware regelmäßig bei Afterbuy abgefragt. Hat sich dieser in Afterbuy geändert, wird er nach Shopware übertragen und die Bestellung als „ausgeliefert“ markiert. Ist diese Bestellung darüber hinaus in Afterbuy als bezahlt markiert, in Shopware aber nicht, wird dieser Status im Shop ebenfalls entsprechend gesetzt.

Afterbuy Zugangsdaten

  • User & Passwort: Die Zugangsdaten, mit denen Sie sich bei Afterbuy anmelden
  • Partner Id & Partner Password: Die Zugangsdaten für die bestellten Schnittstellen (Diese finden Sie in Ihrem Afterbuy-Konto unter Einstellungen → Tarif & Rechnung → Tarifinformationen im unteren Teil der Seite)

Alle Artikel exportieren

3. Konfiguration

Ist Shopware das führende System, werden standardmäßig alle Artikel an Shopware übermittelt. Wird diese Option deaktiviert, können einzelne Artikel in den jeweiligen Artikeleinstellungen explizit zum Export markiert werden.

3.2 Bestellimporteinstellungen

Ist Shopware das führende System, müssen beim Bestellimport Zahlungsarten, Versandart und die Kundengruppe zugeordnet werden. Die entsprechenden Zahlungsarten selbst müssen im Shop selbst nicht aktiv sein, sollten aber für die korrekte Zuordnung angelegt werden.

3.3 Cronjob-Konfiguration

Es gibt 2 Möglichkeiten, die Cronjobs für automatisierte Synchronisationsaufgaben zu konfigurieren:

  • als Shopware Cronjob
  • als Terminal-Command

Shopware Cronjob Hinweis: Sind die Shopware Cronjobs derart konfiguriert, dass sie über die Url (wie im Browser) aufgerufen werden, besteht die Gefahr, dass diese je nach Serverkonfiguration vorzeitig durch einen Timeout beendet werden. (Standardeinstellung sind hier 30s) Die einzelnen Aufgaben erfordern mitunter mehr Zeit. Es empfiehlt sich daher, diese so zu konfigurieren, dass sie direkt auf der Shell „abgearbeitet“ werden. Dies wird seitens Shopware hier beschrieben: https://docs.shopware.com/de/shopware-5-de/einstellungen/system-cronjobs#wie-starte-ich-einen-cronjob

Shopware Cronjob Die grundsätzliche Konfiguration einzelner Cronjobs wird hier beschrieben: https://docs.shopware.com/de/shopware-5-de/einstellungen/system-cronjobs#konfiguration-in-shopware

Diese Erweiterung stellt 2 Cronjobs bereit, die je nach Konfiguration für das führende System entsprechende Aufgaben abarbeiten. Diese sind standardmäßig deaktiviert und müssen daher aktiviert und ggf. getimed. Dies erfolgt in den Shopware-Grundeinstellungen im Reiter Cronjobs.

Die von der Erweiterung bereitgestellten Cronjobs lauten:

  • Sync Afterbuy Orders
  • Sync Afterbuy Products

Anmerkung: Die Afterbuy-API ist je Abruf auf 250 Elemente limitiert. Sollte sich zeigen, dass beispielsweise Bestellungen schneller eintreffen, als dass diese Importiert werden, so muss der entsprechende Cronjob häufiger - also in geringeren Zeitabständen ausgeführt werden.

Anmerkung²: Es besteht keine Abhängigkeit zwischen den Cronjobs. Sollen also lediglich Produkte oder Bestellungen übermittelt werden, muss nur der entsprechende Cronjob aktiviert werden.

Terminal-Command Für fachkundige Anwender empfiehlt sich ggf. die Ausführung als Command in der Shell. Die Nutzung von CLI-Befehlen wird seitens Shopware hier beschrieben: https://docs.shopware.com/de/shopware-5-de/tutorials-und-faq/shopware-cli

Die bereitgestellten Commands lauten:

  • Afterbuy:Update:Orders
  • Afterbuy:Update:Products

4. Die Logdatei

Diese Erweiterung nutzt den von Shopware bereitgestellten Logger mit dem jeweiligen Debug-Level. Unter „Einstellungen → Logfile“ kann dieses im Tab „System-Log“ aufgerufen werden.

5. Verbindungstest

Mittels „Einstellungen“ » „Afterbuy Connector“ » „Verbindungstest“ kann die Verbindung nach dem Speichern der Zugangsdaten getestet werden. Die Ausgabe erscheint als Shopware-Mitteilung und wird auch im Shopware-Log gespeichert.

public/shopware-fatchipafterbuy.txt · Zuletzt geändert: 2019/03/13 12:43 von stephanaltmann