VedronERP · Versand & Transporteure
FedEx-Integration
FedEx bietet internationale und Expresssendungen weltweit. Die Integration verwendet die FedEx Ship API v1 (REST) mit OAuth2-Authentifizierung, um Sendungen zu erstellen, PDF-Etiketten zu generieren und Zolldokumente für Nicht-EU-Ziele zu erstellen.
Schritt 1 — FedEx-Entwicklerkonto erstellen
- Gehen Sie zu developer.fedex.com und klicken Sie auf "Registrieren" (oder melden Sie sich an, wenn Sie bereits ein FedEx.com-Konto haben).
- Erstellen Sie die Organisation Ihres Unternehmens im Portal oder treten Sie ihr bei.
- Klicken Sie auf "Meine Projekte" → "Projekt erstellen".
- Wählen Sie "Ship API" (und optional "Track API") aus dem API-Katalog.
- Geben Sie Ihre FedEx-Kontonummer ein, wenn Sie dazu aufgefordert werden — damit wird die Abrechnung mit Ihrem Projekt verknüpft.
- Schließen Sie die Projekteinrichtung ab, um Ihre Test-(Sandbox-)Zugangsdaten zu erhalten.
Schritt 2 — API-Zugangsdaten abrufen
Gehen Sie nach dem Erstellen des Projekts zur Projektübersichtsseite und öffnen Sie den Tab "API-Zugangsdaten". Dort finden Sie:
- [API-Schlüssel] — auch Client-ID genannt. Identifiziert Ihre Anwendung.
- [Secret-Schlüssel] — auch Client-Secret genannt. WICHTIG: wird nur einmal angezeigt. Sofort kopieren und speichern — bei Verlust muss er neu generiert werden.
- [Kontonummer] — Ihre 9-stellige FedEx-Abrechnungskontonummer. Erscheint separat in der Projektübersicht.
Warning: Der Secret-Schlüssel wird nur einmal bei der Erstgenerierung angezeigt. Speichern Sie ihn sofort an einem sicheren Ort. Wenn Sie ihn verlieren, müssen Sie ihn neu generieren und alle Systeme, die ihn verwenden, aktualisieren.
Schritt 3 — Testumgebung (Sandbox)
FedEx stellt eine Sandbox-Umgebung zum Testen bereit. Die Sandbox verwendet separate Testzugangsdaten (ebenfalls in Ihrem Projekt angezeigt) und die Basis-URL apis-sandbox.fedex.com. Verwenden Sie die Sandbox, um sicherzustellen, dass Ihre Integration gültige Etiketten erstellt, bevor Sie live gehen.
Schritt 4 — Produktionszertifizierung
FedEx erfordert einen Validierungsprozess, bevor Sie echte Produktionsetiketten drucken können. Dazu gehört:
- Reichen Sie bei FedEx ein Produktinformationsarbeitsblatt und ein Validierungsdeckblatt ein.
- Stellen Sie während des Tests erstellte Musterlabels für die Barcode-Überprüfung bereit.
- Die Barcode-Analysegruppe von FedEx überprüft Etiketten innerhalb von 3 Werktagen.
- Nach der Genehmigung wechselt Ihr Projekt in den Produktionsstatus.
- Rufen Sie Ihren Produktions-API-Schlüssel und Secret-Schlüssel von der Projektübersichtsseite ab.
Schritt 5 — Zugangsdaten im ERP konfigurieren
Gehen Sie zur Zugangsdatenseite, wählen Sie FedEx und geben Sie folgende Felder ein:
- [API-Schlüssel] — Ihr Produktions-API-Schlüssel (Client-ID) aus dem FedEx-Entwicklerportal.
- [Secret-Schlüssel] — Ihr Produktions-Secret-Schlüssel (Client-Secret).
- [Kontonummer] — Ihre 9-stellige FedEx-Abrechnungskontonummer.
- [Absendername] — Der auf dem Etikett als Versender gedruckte Name.
- [Absenderfirma] — Ihr Firmenname.
- [Absenderstraße] — Ihre Versandadresse.
- [Absender-PLZ] — Postleitzahl des Versandorts.
- [Absenderstadt] — Stadt des Versandorts.
- [Absenderland] — 2-stelliger Ländercode (z. B. DE, NL, PL).
- [Absendertelefon] — Kontakttelefon des Absenders.
- [Absender-E-Mail] — Kontakt-E-Mail des Absenders.
Eine FedEx-Sendung erstellen
- Öffnen Sie die Bestellung, die Sie versenden möchten.
- Klicken Sie auf "Sendung erstellen" und wählen Sie FedEx als Transportunternehmen.
- Überprüfen Sie Name, Adresse, Stadt, Postleitzahl und Land des Empfängers.
- Geben Sie das Paketgewicht in kg ein.
- Geben Sie optional Abmessungen ein (Länge, Breite, Höhe in cm).
- Wählen Sie den FedEx-Servicetyp (siehe unten).
- Wählen Sie den Abholtyp: "Abgabe bei FedEx-Standort" oder "Geplante Abholung".
- Für Sendungen außerhalb der EU füllen Sie die Zollerklärungsdetails aus.
- Klicken Sie auf "Sendung erstellen", um die Anfrage abzusenden.
- Laden Sie das PDF-Etikett (4x6-Zoll-Format) herunter und drucken Sie es.
Verfügbare FedEx-Servicetypen
- INTERNATIONAL_PRIORITY — Schnellster internationaler Service, zeitdefinite Lieferung
- INTERNATIONAL_ECONOMY — Kostengünstiger international, tagesdefinite Lieferung
- EUROPE_FIRST_INTERNATIONAL_PRIORITY — Prioritätslieferung an europäische Ziele bis 9:00 oder 10:00 Uhr
- FEDEX_EXPRESS_SAVER — Economy Express innerhalb Europas/international
- PRIORITY_OVERNIGHT — Lieferung am nächsten Werktag bis 10:30 Uhr (USA und ausgewählte Märkte)
- FEDEX_GROUND — Bodenlieferung (USA, Kanada)
- FEDEX_2_DAY — 2-Werktage-Lieferung (USA und ausgewählte Märkte)
Zolldokumentation (Nicht-EU-Sendungen)
Für Sendungen an Ziele außerhalb der EU (z. B. Großbritannien, USA, Schweiz, Norwegen) sind eine Handelsrechnung und eine Zollerklärung erforderlich. Das ERP fordert Sie zur Eingabe folgender zusätzlicher Details auf:
- Warenbeschreibung — Was sich im Paket befindet (z. B. "Elektronik", "Zubehör")
- HS-/Zolltarif-Code — Der Harmonisierte System-Code für die Waren (ermitteln Sie den richtigen Code für Ihre Produktkategorie)
- Herstellungsland — Wo die Waren produziert wurden
- Deklarierter Wert — Wert pro Einheit in der Sendungswährung
- Stückzahl — Menge
- Zollzahlung — typischerweise "SENDER" (Sie zahlen) oder "RECIPIENT" (Kunde zahlt)
Tip: EU-Exporteure benötigen möglicherweise auch ihre EORI-Nummer für die Zollkonformität beim Export außerhalb der EU. Wenden Sie sich an FedEx oder Ihren Zollspediteur, wenn Sie unsicher sind.
OAuth-Token & Authentifizierung
Das ERP verwaltet die OAuth2-Authentifizierung automatisch. Es verwendet Ihren API-Schlüssel und Secret-Schlüssel, um ein Zugriffstoken von FedEx anzufordern (gültig für 1 Stunde) und erneuert es vor jeder Sendungsanfrage. Keine manuelle Token-Verwaltung erforderlich.
Warning: Wenn Authentifizierungsfehler auftreten (401 Unauthorized), wurden Ihre Zugangsdaten möglicherweise im FedEx-Entwicklerportal neu generiert. Aktualisieren Sie den API-Schlüssel und den Secret-Schlüssel auf der ERP-Zugangsdatenseite.