Benutzer-Werkzeuge

Webseiten-Werkzeuge


public:faqoxid2afterbuy

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen gezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
Nächste Überarbeitung Beide Seiten der Revision
public:faqoxid2afterbuy [2019/03/04 22:16]
kamiarnader [Artikelexporte]
public:faqoxid2afterbuy [2020/04/17 13:29]
markusmichalski [Update von Version 1.1.x oder 1.2.x auf 1.3.x]
Zeile 4: Zeile 4:
 https://​github.com/​FATCHIP-GmbH/​plugin-oxid5-oxid2afterbuy (private) https://​github.com/​FATCHIP-GmbH/​plugin-oxid5-oxid2afterbuy (private)
  
-===== Requirements ​=====+===== Anforderungen ​=====
  
   - OXID eShop ab Version 4.7.x/5.0.x   - OXID eShop ab Version 4.7.x/5.0.x
Zeile 10: Zeile 10:
   - Afterbuy Partnerdaten für Schnittstelle ([[info@afterbuy.de]])   - Afterbuy Partnerdaten für Schnittstelle ([[info@afterbuy.de]])
   - Aktivierung der Option //10 Freifelder für Produkte aktivieren//​ in Ihrem Afterbuy Account unter //​Konfiguration -> Einstellungen//​   - Aktivierung der Option //10 Freifelder für Produkte aktivieren//​ in Ihrem Afterbuy Account unter //​Konfiguration -> Einstellungen//​
 +  - FTP-Zugang zu Ihrem Shopsystem
 +  - Für OXID Versionen ab 6.2. benötigen Sie SSH-Zugriff auf die Shopinstallation.
 +
 ===== Installation ===== ===== Installation =====
  
   - Kopieren Sie den Inhalt aus dem //​copy_this//​ Ordner in das Hauptverzeichnis Ihres OXID eShops (bei FTP - binären Übertragungsmodus nutzen). \\ \\ {{:​public:​faq:​fc_oxid2afterbuy_1_1.png?​direct&​800|}} \\ \\   - Kopieren Sie den Inhalt aus dem //​copy_this//​ Ordner in das Hauptverzeichnis Ihres OXID eShops (bei FTP - binären Übertragungsmodus nutzen). \\ \\ {{:​public:​faq:​fc_oxid2afterbuy_1_1.png?​direct&​800|}} \\ \\
 +  - In **OXID Versionen ab 6.2** (Ältere Versionen können diesen Schritt überspringen) müssen Sie nun die Modulkonfiguration einlesen. Loggen Sie sich dazu per SSH auf den Server ein auf dem sich die Shopinstallation befindet und navigieren Sie zu dem Verzeichnis in welchem sich die Ordner //source// und //vendor// befinden. Setzen sie hier das folgende Kommando ab: //​./​vendor/​bin/​oe-console oe:​module:​install-configuration source/​modules/​fc/​fcoxid2afterbuy///​. Im Anschluss sollten Sie die Meldung //Module configuration has been installed.//​ erhalten.
   - Aktivieren Sie Plugin im OXID Administrationsbereich unter //​Erweiterungen -> Module -> FATCHIP OXID 2 Afterbuy Connector//​. \\ \\ {{:​public:​faq:​fc_oxid2afterbuy_1_2.png?​direct&​800|}} \\ \\   - Aktivieren Sie Plugin im OXID Administrationsbereich unter //​Erweiterungen -> Module -> FATCHIP OXID 2 Afterbuy Connector//​. \\ \\ {{:​public:​faq:​fc_oxid2afterbuy_1_2.png?​direct&​800|}} \\ \\
   - Erstellen Sie Cronjobs für folgende Batch-Scripte unter ''​modules/​fc/​fcoxid2afterbuy/​batch/'':​ \\ \\   - Erstellen Sie Cronjobs für folgende Batch-Scripte unter ''​modules/​fc/​fcoxid2afterbuy/​batch/'':​ \\ \\
Zeile 28: Zeile 32:
 ===== Update ===== ===== Update =====
  
-==== Update von Version 1.1.x auf 1.2.x ====+==== Update von Version 1.1.x oder 1.2.x auf 1.6.x ====
  
   - Kopieren Sie den Inhalt aus dem //​copy_this//​ Ordner in das Hauptverzeichnis Ihres OXID eShops (bei FTP - binären Übertragungsmodus nutzen).   - Kopieren Sie den Inhalt aus dem //​copy_this//​ Ordner in das Hauptverzeichnis Ihres OXID eShops (bei FTP - binären Übertragungsmodus nutzen).
Zeile 44: Zeile 48:
   - Navigieren Sie im Admin dann zu //​Erweiterungen -> Module//. Dort wird ihnen angezeigt, dass Modulpfade fehlen. Bestätigen Sie mit //Ja//, dass das Modul restlos aus dem System entfernt wird. \\ \\ {{:​public:​faq:​fc_oxid2afterbuy_2_1.png?​direct&​800|}} \\ \\   - Navigieren Sie im Admin dann zu //​Erweiterungen -> Module//. Dort wird ihnen angezeigt, dass Modulpfade fehlen. Bestätigen Sie mit //Ja//, dass das Modul restlos aus dem System entfernt wird. \\ \\ {{:​public:​faq:​fc_oxid2afterbuy_2_1.png?​direct&​800|}} \\ \\
   - Kopieren Sie den Inhalt aus dem //​copy_this//​ Ordner in das Hauptverzeichnis Ihres OXID eShops (bei FTP - binären Übertragungsmodus nutzen).   - Kopieren Sie den Inhalt aus dem //​copy_this//​ Ordner in das Hauptverzeichnis Ihres OXID eShops (bei FTP - binären Übertragungsmodus nutzen).
-  - Aktivieren Sie das Plugin unter //​Erweiterungen -> Module -> FATCHIP OXID 2 Afterbuy Connector//​. **Der Aktivierungsprozess kann hier etwas dauern, da ihre bisherigen Daten einmalig in die neue Datenbankstruktur ​mirgiert ​werden** +  - Aktivieren Sie das Plugin unter //​Erweiterungen -> Module -> FATCHIP OXID 2 Afterbuy Connector//​. **Der Aktivierungsprozess kann hier etwas dauern, da ihre bisherigen Daten einmalig in die neue Datenbankstruktur ​migriert ​werden** 
-  - Prüfen Sie an einer Bestellung und einem Artikel, ob die Daten erfolgreich ​mirgriert ​worden sind (Jeweils im Reiter "​Afterbuy"​)+  - Prüfen Sie an einer Bestellung und einem Artikel, ob die Daten erfolgreich ​migriert ​worden sind (Jeweils im Reiter "​Afterbuy"​)
   - Optional können Sie nach erfolgter Migration aus den Tabellen //​oxarticles//,​ //oxorder// und //oxuser// sämtliche Datenbankspalten entfernen, die mit einem "​FCAFTEBUY_"​ beginnen. Erneuern Sie anschließend die Views unter //Service -> Tools//   - Optional können Sie nach erfolgter Migration aus den Tabellen //​oxarticles//,​ //oxorder// und //oxuser// sämtliche Datenbankspalten entfernen, die mit einem "​FCAFTEBUY_"​ beginnen. Erneuern Sie anschließend die Views unter //Service -> Tools//
  
Zeile 90: Zeile 94:
  
 ^ Konfiguration ^ Beschreibung ^ ^ Konfiguration ^ Beschreibung ^
-**Bestellungen direkt beim Bestellabschluss an Afterbuy übertragen**  ​| Wenn Sie Bestellung im Modus "​Afterbuy als datenführendes System"​ an Afterbuy übertragen wollen, aktivieren Sie diesen haken. | +| Bestellungen direkt beim Bestellabschluss an Afterbuy übertragen | Wenn Sie Bestellung im Modus "​Afterbuy als datenführendes System"​ an Afterbuy übertragen wollen, aktivieren Sie diesen haken. | 
-**Liste der Zahlarten, die Bankdaten an Afterbuy übertragen sollen**  ​| Eine Auflistung der ZahlungsIDs,​ welche Bankdaten übermitteln sollen. | +| Liste der Zahlarten, die Bankdaten an Afterbuy übertragen sollen | Eine Auflistung der ZahlungsIDs,​ welche Bankdaten übermitteln sollen. | 
-**Liste der Feldnamen, die als Bankname identifiziert werden sollen** | Eine Auflistung von Feldnamen, die in den Zahlarteneinstellungen das Feld Bankname repräsentieren. | +| Liste der Feldnamen, die als Bankname identifiziert werden sollen | Eine Auflistung von Feldnamen, die in den Zahlarteneinstellungen das Feld Bankname repräsentieren. | 
-**Liste der Feldnamen, die als BLZ identifiziert werden sollen** | Eine Auflistung von Feldnamen, die in den Zahlarteneinstellungen das Feld Bankleitzahl/​BLZ repräsentieren. | +| Liste der Feldnamen, die als BLZ identifiziert werden sollen | Eine Auflistung von Feldnamen, die in den Zahlarteneinstellungen das Feld Bankleitzahl/​BLZ repräsentieren. | 
-**Liste der Feldnamen, die als Kontonummer identifiziert werden sollen** | Eine Auflistung von Feldnamen, die in den Zahlarteneinstellungen das Feld Kontonummer repräsentieren. | +| Liste der Feldnamen, die als Kontonummer identifiziert werden sollen | Eine Auflistung von Feldnamen, die in den Zahlarteneinstellungen das Feld Kontonummer repräsentieren. | 
-**Liste der Feldnamen, die als Kontoinhaber identifiziert werden sollen** | Eine Auflistung von Feldnamen, die in den Zahlarteneinstellungen das Feld Kontoinhaber repräsentieren. | +| Liste der Feldnamen, die als Kontoinhaber identifiziert werden sollen | Eine Auflistung von Feldnamen, die in den Zahlarteneinstellungen das Feld Kontoinhaber repräsentieren. | 
-**Verhalten für Feedbackdatum und Erstkontakt-Mail** | Hängt von Ihrer Afterbuy-Einstellung ab. Näheres hierzu in der passenden [[https://​doku.afterbuy.de/​bin/​view/​Einstellungen/​Abwicklungseinstellungen|Afterbuy-Dokumenation]]. | +| Verhalten für Feedbackdatum und Erstkontakt-Mail | Hängt von Ihrer Afterbuy-Einstellung ab. Näheres hierzu in der passenden [[https://​doku.afterbuy.de/​bin/​view/​Einstellungen/​Abwicklungseinstellungen|Afterbuy-Dokumenation]]. | 
-**Versandkostenberechnung** | Entscheiden Sie, ob die Versandkosten aus dem Shop übergeben werden soll oder ob Afterbuy die Berechnungen selber durchführen soll | +| Versandkostenberechnung | Entscheiden Sie, ob die Versandkosten aus dem Shop übergeben werden soll oder ob Afterbuy die Berechnungen selber durchführen soll | 
-**Ausweisung der MwSt** | Entscheiden Sie, ob die Mehrwertsteuer ausgewiesen werden soll oder nicht. | +| Ausweisung der MwSt | Entscheiden Sie, ob die Mehrwertsteuer ausgewiesen werden soll oder nicht. | 
-**Shop-Kundennummer für Kunden in Afterbuy verwenden.** | Entscheiden Sie, ob Sie wünschen, dass der neue Kunde mit der Kundennummer des Shops in Afterbuy angelegt wird. | +| Shop-Kundennummer für Kunden in Afterbuy verwenden. | Entscheiden Sie, ob Sie wünschen, dass der neue Kunde mit der Kundennummer des Shops in Afterbuy angelegt wird. | 
-**Kundenenidentifizierung ​zwischen Shop und Afterbuy** | Wählen Sie über welchen Identifikator Kundendaten zwischen Shop und Afterbuy ausgetauscht werden. | +Kundenidentifizierung ​zwischen Shop und Afterbuy | Wählen Sie über welchen Identifikator Kundendaten zwischen Shop und Afterbuy ausgetauscht werden. | 
-**Behandlung von eBay-Namen** | Entscheiden Sie, ob eBay-Namen überschrieben werden sollen oder nicht. | +| Behandlung von eBay-Namen | Entscheiden Sie, ob eBay-Namen überschrieben werden sollen oder nicht. | 
-**Liste der PaymentIDs, die bei Bestellabschluss als bezahlt markiert werden sollen.** | Hier können Sie auflisten, welche Zahlarten direkt bei Bestellabschluss als bezahlte Bestellung an Afterbuy übertragen werden sollen. | +| Liste der PaymentIDs, die bei Bestellabschluss als bezahlt markiert werden sollen. | Hier können Sie auflisten, welche Zahlarten direkt bei Bestellabschluss als bezahlte Bestellung an Afterbuy übertragen werden sollen. | 
-**Afterbuy Markierungs-ID (Afterbuy Farbzuweisung).** | | +| Afterbuy Markierungs-ID (Afterbuy Farbzuweisung). | | 
-**Afterbuy-Zahlarten** | Eine Auflistung der in Afterbuy verfügbaren Zahlarten. Es ist möglich, dass Afterbuy neue Zahlarten implementiert. Diese können hier ergänzt und dann unter //Zahlarten zuweisen// verwendet werden. |+| Afterbuy-Zahlarten | Eine Auflistung der in Afterbuy verfügbaren Zahlarten. Es ist möglich, dass Afterbuy neue Zahlarten implementiert. Diese können hier ergänzt und dann unter //Zahlarten zuweisen// verwendet werden. | 
 ==== Logaufzeichnungen,​ Ausgaben und Betriebsmodus ==== ==== Logaufzeichnungen,​ Ausgaben und Betriebsmodus ====
  
Zeile 110: Zeile 115:
  
 ^ Konfiguration ^ Beschreibung ^ ^ Konfiguration ^ Beschreibung ^
-**Vorgangsprotokollierung**  ​| Hier können Sie das Logging konfigurieren. |+| Vorgangsprotokollierung | Hier können Sie das Logging konfigurieren. | 
 + 
 +Es stehen folgende Optionen bereit: 
 + 
 +^ Option ^ Protokollierung ^ 
 +| Protokollierung aus | keine | 
 +| Nur Fehler protokollieren | oxideshop.log | 
 +| Fehler und Warnungen protokolieren | oxideshop.log | 
 +| Sämtliche Vorgänge protokollieren (Große Logfiles) | oxideshop.log | 
 +| Sämtliche Vorgänge + Entwickler-Informationen protokollieren (Sehr große Logfiles) | oxideshop.log und fco2a_api.log (API-Kommunikation) | 
  
-**Bitte beachten Sie, dass Sie die höchste Einstellung nur verwenden um tiefgreigende ​Analysen vorzunehmen. Es werden dabei Dateien im Logverzeichnis Ihres OXID-eShops abgelegt, welche die Zugangsdaten zu Ihrem Afterbuy Account beinhalten!**+**Bitte beachten Sie, dass Sie die höchste Einstellung nur verwenden um tiefgreifende ​Analysen vorzunehmen. Es werden dabei Dateien im Logverzeichnis Ihres OXID-eShops abgelegt, welche die Zugangsdaten zu Ihrem Afterbuy Account beinhalten!**
 ===== Bedienung ===== ===== Bedienung =====
  
Zeile 146: Zeile 161:
 Nach dem Crondurchlauf sollten Kategorien, Artikel und Attribute importiert und zugewiesen sein. Wiederholte Crondurchläufe aktualisieren die bereits importierten Artikel. Nach dem Crondurchlauf sollten Kategorien, Artikel und Attribute importiert und zugewiesen sein. Wiederholte Crondurchläufe aktualisieren die bereits importierten Artikel.
  
-Unterhalb der Aktivierung zum Export finden Sie die Anzeige, welche die Afterbuy-ProduktID ausgibt.+Als OXID-Artikelnr. wird die "​externe Artikelnummer"​ verwendet.
  
 ==== Bestell-Import ==== ==== Bestell-Import ====
Zeile 156: Zeile 171:
   - Bei Fehlern kontrollieren Sie bitte das Protokoll unter <​Shoproot>/​log/​fcAfterbuy.log.   - Bei Fehlern kontrollieren Sie bitte das Protokoll unter <​Shoproot>/​log/​fcAfterbuy.log.
  
-Unter //Bestelungen ​verwalten -> Bestellungen//​ finden Sie den Reiter //​oxid2afterbuy//​. Hier befinden sich die Afterbuy-Werte einer Bestellung, sollte diese importiert worden sein.+Unter //Bestellungen ​verwalten -> Bestellungen//​ finden Sie den Reiter //​oxid2afterbuy//​. Hier befinden sich die Afterbuy-Werte einer Bestellung, sollte diese importiert worden sein.
  
 ==== Bestellexport ==== ==== Bestellexport ====
Zeile 162: Zeile 177:
 Um Bestellungen nach Afterbuy zu übertragen,​ muss Afterbuy als führendes System konfiguriert sein und die Option //​Bestellungen direkt beim Bestellabschluss an Afterbuy übertragen//​ muss ebenfalls aktiviert werden. Um Bestellungen nach Afterbuy zu übertragen,​ muss Afterbuy als führendes System konfiguriert sein und die Option //​Bestellungen direkt beim Bestellabschluss an Afterbuy übertragen//​ muss ebenfalls aktiviert werden.
  
-Beachten Sie in dem Konfigurationsbereich //​Bestellungen übertragen//​ die weiteren Detailoptionen,​ gerade wenn Sie Bankdaten an Afterbuy übertragen möchten. Da das Plugin nicht vorhersehen kann in welchen Feldern der einzelnen Zahlarten sich welche Bankdaten befinden, kann das hier konofiguriert ​werden. Für die OXID-Voreingerichtete Zahlart //​Lastschrift//​ ist die Konfiguration bereits hinterlegt.+Beachten Sie in dem Konfigurationsbereich //​Bestellungen übertragen//​ die weiteren Detailoptionen,​ gerade wenn Sie Bankdaten an Afterbuy übertragen möchten. Da das Plugin nicht vorhersehen kann in welchen Feldern der einzelnen Zahlarten sich welche Bankdaten befinden, kann das hier konfiguriert ​werden. Für die OXID-Voreingerichtete Zahlart //​Lastschrift//​ ist die Konfiguration bereits hinterlegt.
  
  
Zeile 181: Zeile 196:
 {{:​public:​faq:​fc_oxid2afterbuy_4_4.png?​direct&​800|}} {{:​public:​faq:​fc_oxid2afterbuy_4_4.png?​direct&​800|}}
  
-Unter //​oxid2afterbuy -> Verwaltung -> Wartung/​Aktionen//​ gibt es im Moment nur eine Option: //Aftterbuy ​Bewegungsdaten zurücksetzen//​. Wenn Sie den entsprechenden Button betätigen werden nach der Sicherheitsabfrage **sämtliche Afterbuy-Daten von Artikeln, Bestellungen und Benutzern gelöscht**. ​+Unter //​oxid2afterbuy -> Verwaltung -> Wartung/​Aktionen//​ gibt es im Moment nur eine Option: //Afterbuy ​Bewegungsdaten zurücksetzen//​. Wenn Sie den entsprechenden Button betätigen werden nach der Sicherheitsabfrage **sämtliche Afterbuy-Daten von Artikeln, Bestellungen und Benutzern gelöscht**. 
 + 
 +==== Afterbuy Bestelldetails einsehen ====
  
 +Wenn eine Bestellung von Afterbuy importiert oder nach Afterbuy exportiert wurde, können Sie die Afterbuy-Kenndaten im Reiter //​Afterbuy//​ der jeweiligen Bestellung einsehen.
 ===== FAQs ===== ===== FAQs =====
  
public/faqoxid2afterbuy.txt · Zuletzt geändert: 2021/10/18 08:45 von markusmichalski