Installation

Zuerst benötigen Sie ein FedEx Konto und müssen dort API-Zugangsdaten anlegen. Anschließend installieren und konfigurieren Sie die Erweiterung und die Versandarten in Ihrem Shop.

Bei der Einführung unserer Erweiterung sollten Sie mit einem FedEx Testkonto starten. Die folgende Anleitung beschreibt, wie Sie ein Testkonto erhalten.

API-Zugangsdaten erhalten

Um mit den FedEx APIs sowohl in der Produktiv- als auch in der Testumgebung zu kommunizieren, ist eine Registrierung als Entwickler notwendig. Gehen Sie dazu wie folgt vor:

1. Registrieren Sie ein kostenloses Konto im FedEx Developer Portal oder melden Sie sich mit Ihrem bestehenden Konto an.
2. Wechseln Sie zu My Projects und klicken Sie auf den Button Create Project, um Ihr neues Projekt zu registrieren.
   
3. Vergeben Sie einen Namen für Ihr neues Projekt und klicken Sie auf Next.
4. Wählen Sie die Produkte aus, die Sie in Ihrem Projekt verwenden möchten. Für das FedEx Plugin benötigen Sie:
   1. Account Registration API
   2. Rates and Transit Times API
5. Klicken Sie auf Next, um fortzufahren.
6. Akzeptieren Sie die Bedingungen und legen Sie Ihr neues Projekt an.
7. Kopieren Sie den API Key und den Secret Key. Sie benötigen beides in der Erweiterung.
   

Wenn Sie Integrator sind und den "Test FedEx Integrator Account" nutzen möchten: Wenden Sie sich an den FedEx Support, um Testkontonummern zu erhalten. Sie benötigen sie, um die Shopware Erweiterung mit der FedEx API zu verbinden.

Erweiterung installieren und konfigurieren

Sobald Sie API Key, Secret Key und die Testkontonummern haben, wechseln Sie in die Shopware Administration und installieren die Erweiterung über Erweiterungen > Meine Erweiterungen.

Prüfen Sie die Einstellungen in diesem Bereich, bevor Sie die Erweiterung aktivieren, und stellen Sie sicher, dass sie zu Ihren Anforderungen passen. Die einzelnen Felder ändern Sie wie unten beschrieben über Meine Erweiterungen > FedEx Shipping Rates > Konfigurieren.

Allgemeine Einstellungen

In diesem Bereich nehmen Sie einige grundlegende Einstellungen vor.

Feld	Typ	Beschreibung
Gewichtseinheit	Auswahlfeld	Wählen Sie aus, welche Gewichtseinheit Sie für Ihre Produkte im Shop verwenden.
Verpackungsart	Auswahlfeld	Verwenden Sie die Voreinstellung Your packaging, werden die Versandkosten aus Absender- und Empfängeradresse sowie dem Gewicht des Warenkorbs berechnet. Sie können aber auch eine FedEx Markenverpackung nutzen und eine der vordefinierten FedEx Boxgrößen wählen. Achten Sie darauf, die passenden FedEx Boxgrößen zu kaufen und dass Ihre Produkte die maximalen Gewichte nicht überschreiten: https://developer.fedex.com/api/en-us/guides/api-reference.html#packagetypes
Caching aktivieren	Schalter	API-Anfragen werden üblicherweise zwischengespeichert. Deaktivieren Sie das Caching nur zu Testzwecken.
Hinweis anzeigen, warum eine Versandart nicht verfügbar ist	Schalter	Zeigt einen Hinweis an, warum die FedEx Versandarten nicht verfügbar sind. Die Meldung erscheint nur im Fehlerfall, zum Beispiel bei fehlenden Produktgewichten oder ungültigen Adressen.
Log Level	Auswahlfeld	Legt fest, ob nur Fehler oder auch Debug-Informationen im Logfile erfasst werden.
Fehlermeldungen in der Storefront anzeigen	Schalter	Aktivieren Sie diese Einstellung, um einzelne Fehlermeldungen direkt in der Storefront anzuzeigen. Nutzen Sie sie nur zu Testzwecken und nicht in einem Live-Shop.

Verbindung zur FedEx API herstellen

Nachdem Sie die allgemeinen Einstellungen vorgenommen haben, wechseln Sie zu Einstellungen > Erweiterungen > FedEx und verbinden Ihren Shop in drei Schritten mit der FedEx API.

1. Wählen Sie den gewünschten Modus. Installieren Sie die Erweiterung zum ersten Mal, wählen Sie Test. Haben Sie alle Tests abgeschlossen und Live-Zugangsdaten von FedEx erhalten, wählen Sie Live.
   Tragen Sie Ihren API Key und Ihr API Secret ein und klicken Sie auf den Button Verbindung prüfen. Ihre Zugangsdaten werden validiert; ist alles in Ordnung, können Sie mit Schritt zwei fortfahren.
   
2. Tragen Sie Ihre Kontonummer und Ihre Adressdaten ein.
   Bitte beachten Sie: Verwenden Sie den Modus Test FedEx Integrator Account, erhalten Sie die Kontonummer und die Dummy-Adressdaten ausschließlich vom FedEx Support.
   Klicken Sie nach dem Ausfüllen der Felder auf den Button Adresse validieren. Ist alles in Ordnung, geht es weiter zum letzten Schritt drei.
3. Sie müssen Ihre Verbindung bestätigen, indem Sie eine PIN oder Rechnungsdaten eingeben. Wählen Sie eine der beiden Methoden und klicken Sie auf PIN erzeugen bzw. Rechnung validieren. Nach der Bestätigung ist die API-Verbindung für Ihren Shop endgültig eingerichtet.

Versandarten konfigurieren

Bei der Installation der Erweiterung werden die FedEx Versandarten automatisch mit gängigen Einstellungen angelegt. Selbstverständlich können Sie die Versandarten nach Ihren Bedürfnissen bearbeiten und anpassen. Weitere Informationen finden Sie in der Shopware 6 Dokumentation.

Vergessen Sie nicht, die Versandarten den Verkaufskanälen zuzuordnen, in denen Sie sie verwenden möchten.
Achtung: Wenn Sie das FedEx Plugin deaktivieren oder deinstallieren, entfernen Sie die Versandarten vorher aus den Verkaufskanälen.

Verfügbare Versandarten

Die folgenden FedEx Versandarten werden unterstützt:

• FedEx First Overnight® Freight
• FedEx First Overnight®
• FedEx Priority Overnight®
• FedEx Standard Overnight®
• FedEx 2Day®
• FedEx Economy
• FedEx International Ground® und FedEx Domestic Ground®
• FedEx 1Day® Freight
• FedEx 2Day® Freight
• FedEx 3Day® Freight
• FedEx International Priority® Freight
• FedEx International Economy® Freight
• FedEx® International Deferred Freight
• FedEx International Connect Plus®
• FedEx International First®
• FedEx International Priority® Express
• FedEx International Priority®
• FedEx International Economy®
• FedEx International Priority DirectDistribution®
• FedEx International Economy DirectDistribution
• FedEx Express Saver®
• FedEx SameDay® City
• FedEx First
• FedEx Priority
• FedEx Priority Express
• FedEx Priority Express Freight
• FedEx Priority Freight
• FedEx Economy Freight
• FedEx Europe First®
• International Distribution Freight
• FedEx® Regional Economy
• FedEx® Regional Economy Freight
• FedEx Economy (nur Großbritannien)

Sie sind sich nicht sicher, welche Versandart für Ihr Land verfügbar ist? Eine vollständige Liste finden Sie hier: https://developer.fedex.com/api/en-us/guides/api-reference.html#servicetypes

Zusätzliche Versandgebühr hinzufügen

Zusätzlich zu den von FedEx gelieferten Versandkosten können Sie eine weitere Gebühr für Ihre Versandarten festlegen. Nutzen Sie dazu in der Shopware Administration die Funktion Preismatrix hinzufügen bei einer Versandart. Ein hier hinterlegter Preis wird auf den FedEx Preis der Versandart aufgeschlagen.

Regeln für die Verfügbarkeit

Standardmäßig werden die FedEx Versandarten ausgeblendet, wenn ein Kunde nicht angemeldet ist oder für den aktuellen Warenkorb keine gültigen FedEx Versandarten gefunden wurden. Zusätzlich können Sie weitere Versandregeln definieren, zum Beispiel um den Versand nur für bestimmte Kundengruppen freizuschalten.

Wird Ihre FedEx Versandart nach Registrierung oder Anmeldung nicht angezeigt, prüfen Sie bitte die folgenden Punkte:

• Haben Sie die Erweiterung unter Einstellungen > Erweiterungen > FedEx erfolgreich mit der FedEx API verbunden?
• Haben die Produkte im Warenkorb ein Gewicht?
• Passen Ihre Versandregeln zum aktuellen Kunden?
• Haben Sie die neuen Versandarten dem Verkaufskanal Ihres Shops zugeordnet?

Fehler- und Debug-Logfile

Tritt bei der API-Verbindung ein Fehler auf, wird er in eine Datei im Ordner var/log des Shopware Basisverzeichnisses geschrieben. In der Konfiguration der Erweiterung können Sie zusätzlich festlegen, dass auch Debug-Informationen protokolliert werden.

Verwenden Sie für Ihre Tests bitte ausschließlich echte Empfängeradressen. Andernfalls erhalten Sie eine FedEx Fehlermeldung wie "Invalid service and packaging combination. Please update and try again".