FedEx Versender
Grundvoraussetzung
Sie müssen über eine FedEx-Benutzer-ID verfügen, um sich im FedEx Developer Portal anzumelden und eine Organisation zu erstellen.
Treten Sie der Organisation Ihres Unternehmens bei, um mit Ihrem Team zusammenzuarbeiten. Falls Ihr Unternehmen keine Organisation hat, erstellen Sie eine.
Einer vorhandenen Organisation beitreten
1. Fordern Sie eine Einladung an
Bitten Sie den Administrator Ihrer Organisation, Ihnen eine Einladung zu senden. Sie haben 24 Stunden Zeit, sie anzunehmen. Wenn die Einladung abläuft, bitten Sie den Administrator, sie erneut zu senden.
2. Nehmen Sie die Einladung an
Melden Sie sich mit Ihrer bestehenden Benutzer-ID und Ihrem Passwort an. Wenn Ihre Benutzer-ID mit einer anderen Organisation verknüpft ist, erstellen Sie eine neue ID.
Eine neue Organisation erstellen
Wenn Sie eine Organisation erstellen, werden Sie der Administrator. Als Administrator können Sie Benutzer*innen einladen, der Organisation beizutreten, Projekte und Benutzerrollen zuweisen und Abrechnungskonten verwalten.
Weitere Informationen zu Benutzerrollen finden Sie in den Richtlinien zur Organisationsverwaltung.
1. Melden Sie sich beim FedEx Developer Portal an.
2. Wählen Sie im Menü Meine Projekte und dann Organisation erstellen aus.
3. Geben Sie die folgenden Details ein:
- Wählen Sie bei Ich arbeite für ein Unternehmen, das die Option Versendet mit FedEx und muss FedEx APIs in die eigenen Anwendungen integrieren aus.
- Geben Sie Ihren Firmennamen, die Unternehmenswebsite und einen Organisationsnamen ein, den Ihr Team erkennt, wie z. B. den Firmennamen, die Abteilung, den Geschäftsbereich oder die Region.
4. Wählen Sie Erstellen aus.
Sie können Details später unter Organisation verwalten im Menü aktualisieren oder hinzufügen.
Ein Versandkonto hinzufügen
1. Wählen Sie Versandkonten hinzufügen auf der Kachel Konten hinzufügen aus. Falls Sie kein FedEx Kundenkonto besitzen, wählen Sie Konto erstellen aus, um ein neues zu eröffnen, oder kontaktieren Sie den FedEx Support.
2. Wählen Sie + Konto hinzufügen aus.
3. Geben Sie Ihre FedEx Kundennummer, einen Kontospitznamen und die Rechnungsadresse ein, die Sie bei der Kontoeinrichtung verwendet haben.
4. Akzeptieren Sie die Endbenutzer-Lizenzvereinbarung, oder leiten Sie sie an eine*n autorisierte*n Vertreter*in in Ihrem Unternehmen weiter.
Ein Abrechnungskonto hinzufügen
1. Wählen Sie die Registerkarte Abrechnungskonten aus. Wenn Sie kein FedEx Abrechnungskonto haben, wählen Sie Abrechnungskonto eröffnen, um ein neues zu eröffnen, oder kontaktieren Sie den FedEx Support.
2. Wählen Sie Abrechnungskonto hinzufügen aus. Abrechnungskonten müssen in den Vereinigten Staaten ansässig sein.
3. Geben Sie Ihre FedEx Kundennummer, einen Kontospitznamen und eine US-amerikanische Rechnungsadresse ein, die Sie bei der Kundenkontoeröffnung verwendet haben.
4. Lesen und akzeptieren Sie die Endbenutzer-Lizenzvereinbarung.
Benutzer*innen als Administrator einladen
1. Wählen Sie im Menü Organisation verwalten und dann die Registerkarte Benutzer aus.
2. Wählen Sie + Benutzer hinzufügen.
3. Wählen Sie ein Land oder Gebiet und eine bevorzugte Sprache aus und wählen Sie dann eine Benutzerrolle: Viewer, Contributor oder Admin.
4. (Optional) Weisen Sie den*die Benutzer*in einem Projekt zu. Sie können Benutzer*innen jederzeit über die Übersichtsseite des Projekts zuweisen.
5. Geben Sie die E-Mail-Adressen der Benutzer*innen ein und klicken Sie auf Einladen. Sie können bis zu 20 Benutzer*innen auf einmal einladen, wobei jede E-Mail durch ein Komma getrennt sein muss. Einladungen sind 24 Stunden lang gültig.
Ein API-Projekt erstellen
1. Wählen Sie im Menü Meine Projekte, dann die Registerkarte APIs und anschließend + API-Projekt erstellen aus.
2. Bestätigen Sie Ihre API-Anforderungen.
3. Wählen Sie die APIs aus, die Sie in Ihr Projekt aufnehmen möchten.
4. Erstellen Sie einen Projektnamen und wählen Sie die Länder aus, in die Sie versenden möchten, um ein Testversandkonto zu erhalten. Für innereuropäische Sendungen benötigen Sie für jedes Land ein eigenes Testkonto. Sie können später Länder hinzufügen oder entfernen.
5. Wählen Sie Einstellungen unter Benachrichtigungen, um Ihre Benachrichtigungseinstellungen festzulegen.
6. Lesen Sie die Allgemeinen Geschäftsbedingungen und akzeptieren Sie diese.
Ein Advanced Integrated Visibility-Projekt erstellen
Grundvoraussetzungen
- Preisgestaltung überprüfen: Abonnenten zahlen eine monatliche Gebühr basierend auf der Anzahl der Sendungsverfolgungsnummern. Weitere Informationen zur Preisgestaltung finden Sie im Preisleitfaden.
- Konten einrichten: Shipment Visibility Webhook erfordert ein abrechnungsfähiges Konto mit Sitz in den USA sowie mindestens ein Versandkonto. Diese beiden Kontotypen schließen sich gegenseitig aus. Nur Administratoren können auf der Seite Organisation verwalten Abrechnungs- und Versandkonten hinzufügen.
1. Erstellen Sie eine Ziel-URL in Ihrer Anwendung oder Plattform, um Callbacks zu empfangen. Die URL muss:
- HTTPS verwenden
- Schließen Sie RFC1918-IP-Bereich, fedex.com und Subdomains sowie IP-Adressen wie localhost oder 127.0.0.1 aus.
2. Generieren Sie ein Sicherheitstoken zur Authentifizierung. Das Token muss:
- 26–100 Zeichen, mindestens einen Großbuchstaben, mindestens einen Kleinbuchstaben und mindestens eine Zahl enthalten
3. Wählen Sie im Menü Meine Projekte und dann die Registerkarte Advanced Integrated Visibility aus.
4. Wählen Sie Ein Advanced Integrated Visibility-Projekt erstellen.
5. Wählen Sie den Benutzertyp aus.
- FedEx Versender: Versendet mit FedEx und muss FedEx APIs in die eigenen Anwendungen integrieren.
- FedEx Compatible Provider: ist ein zertifizierter FedEx Compatible Provider
- FedEx Integrator Provider: Verkauft oder stellt eine Softwarelösung bereit, die FedEx Technologie verwendet und ein validierter FedEx Integrator Provider ist
6. Wählen Sie den Abonnementtyp aus. Sie können Ereignisse über Kundennummern oder Sendungsverfolgungsnummern abonnieren.
7. Bestätigen Sie das Abrechnungskonto und wählen Sie die gewünschten Funktionen aus, wie z. B. Zustellnachweis, voraussichtliche Zustellung, Tracking-Ereignisse oder ereignisbasierte Filterung.
8. Geben Sie Projektdetails ein.
- Geben Sie einen eindeutigen und wiedererkennbaren Projektnamen ein.
- Geben Sie die Ziel-URL und das Sicherheitstoken ein, das Sie erstellt haben.
- Geben Sie eine E-Mail-Adresse und Ihre bevorzugte Sprache für Benachrichtigungen über Aktualisierungen und Ausfälle von Advanced Integrated Visibility an.
9. Akzeptieren Sie die Lizenzvereinbarung und das Bestellformular im FedEx Developer Portal und wählen Sie Erstellen aus.
Hinweis: Je nach gewähltem Abonnementtyp können zusätzliche Schritte erforderlich sein. Weitere Informationen finden Sie in unserer Dokumentation zum Webhook.
Mit diesen Schritten überprüfen Sie Ihre API-Integration und bestätigen, dass Ihre Anwendung Testdaten senden und empfangen kann.
Testanmeldedaten abrufen
1. Wählen Sie im Menü Meine Projekte und dann den Projektnamen.
2. Auf der Registerkarte API-Schlüssel finden Sie unter Testschlüssel Ihre Testanmeldedaten.
3. Melden Sie sich an und laden Sie die JSON-API-Sammlung über die Schaltfläche JSON-Schema herunterladen oben auf der Dokumentationsseite herunter. Überprüfen Sie Beispielanfragen für die Endpunkte, die Ihre Integration verwendet.
4. Fordern Sie ein OAuth-Zugriffstoken an, das Sie bei jeder API-Transaktion verwenden können.
Hinweis: Das Token ist eine Stunde lang gültig. Sie können Ihre Anwendung so konfigurieren, dass es vor Ablauf der Gültigkeitsdauer aktualisiert wird. Details finden Sie in der API Authorization-Dokumentation.
5. Wählen Sie im Menü API-Katalog und dann die API aus, mit der Sie arbeiten möchten, und wählen Sie Dokumentation aus.
6. Wählen Sie im Menü den Endpunkt aus.
7. Senden Sie Testanfragen mit Ihren Testzugangsdaten und der FedEx-Test-URL, und überprüfen Sie anschließend, ob die Antworten mit den Beispielen in der Dokumentation übereinstimmen. Details finden Sie im Sandbox-Virtualisierungsleitfaden.
8. Führen Sie Tests mit Advanced Integrated Visibility durch, um Beispieldaten zu generieren und zu bestätigen, dass Ihre Anwendung die Tracking-Informationen korrekt verarbeitet.
Hinweis: Beim Testen wird Ihre Callback-URL nicht authentifiziert. Details finden Sie unter Dokumentation zu Advanced Integrated Visibility.
Ihr Projekt in die Produktion verschieben
Richten Sie Ihre Produktionskonfiguration ein, bevor Sie live gehen. Sie können den Schlüssel umbenennen, weitere Kundenkonten hinzufügen, nachdem das Projekt live gegangen ist, und die Kundennummer überprüfen, die Sie bei der Projekterstellung ausgewählt haben. Mit dieser Kundennummer wird Ihr Projekt in die Produktion überführt.
Hinweis: Bei Advanced Integrated Visibility-Projekten, die auf einer Kundennummer basieren, ist keine Produktionsaktivierung erforderlich.
1. Wählen Sie im Menü Meine Projekte und dann den Projektnamen.
2. Wählen Sie die Registerkarte Produktionsschlüssel aus.
3. Rufen Sie Ihre Produktionsanmeldeinformationen ab und speichern Sie sie sicher.
- Kopieren Sie den Produktions-API-Schlüssel und den geheimen Schlüssel an einen sicheren Ort.
- Wenn Sie einen Produktionsschlüssel anfordern, speichern Sie ihn an einem sicheren Ort, da er nur einmal angezeigt wird. Wenn Sie ihn verlieren, können Sie später einen neuen erstellen.
4. Wählen Sie Weiter, um Ihre Projektdetails auf der Registerkarte Produktionsschlüssel anzuzeigen.
Wählen Sie oben in der Tabelle mit den Versandkonten Bearbeiten aus, um weitere Versandkonten hinzuzufügen.
Die Validierungsschritte unterscheiden sich je nach Region
Die folgenden Schritte gelten nur für Kunden in den USA und Kanada. Wenn Sie außerhalb dieser Länder leben, besuchen Sie die Seite API-Validierung, um Unterstützung zu erhalten.
Ihre API validieren
Einige FedEx APIs erfordern eine Versandetikett-Validierung, bevor Sie diese in der Produktion verwenden können. Prüfen Sie die API-Validierungsanforderungen, bevor Sie beginnen.
1. Wählen Sie im Menü Meine Projekte und dann den Projektnamen.
2. Auf der Registerkarte API-Schlüssel finden Sie unter Testschlüssel Ihre Testanmeldedaten.
3. Nach Abschluss der Tests übertragen Sie Ihr Projekt im FedEx Developer Portal in die Produktionsumgebung, um mit der Validierung zu beginnen.
- Wenn Sie einen Produktionsschlüssel anfordern, speichern Sie ihn an einem sicheren Ort, da er nur einmal angezeigt wird. Wenn Sie ihn verlieren, können Sie später einen neuen erstellen.
4. Geben Sie auf dem Etikettendeckblatt die erforderlichen Informationen an, einschließlich Kontaktdetails, den zu implementierenden Services, der Kundennummer und dem Produktions-API-Schlüssel.
5. Erstellen Sie Testetiketten in der FedEx-Testumgebung und reichen Sie diese anschließend zur Überprüfung bei der FedEx Barcode Analysis Group ein. Für die Etikettenprüfung sollten drei Werktage eingeplant werden.
Bewährte Verfahren zur Vermeidung von Verzögerungen:
- Drucken und scannen Sie Etiketten mit mindestens 600 DPI. Senden Sie keine Dateien ab, die direkt von APIs generiert werden.
- Fordern Sie bei Thermodruckern den Bildtyp an, der zu Ihrem Drucker passt, z. B. ZPLII für Zebra-Drucker.
- Verwenden Sie gültige Versender- und Empfängeradressen für die Musteretiketten. Erstellen Sie Etiketten nur für die Services, die Sie auch nutzen möchten.
- Bei FedEx Nachnahme (C.O.D.) legen Sie bitte das C.O.D.-Rücksendeetikett bei.
- Fügen Sie für FedEx International Express® den zusätzlichen (sekundären) Frachtbrief (AWB) bei.
- Bei Mehrpaketsendungen (MPS) senden Sie bitte ein Etikett für jedes Paket ab.
Senden Sie Ihre Materialien mit einer der folgenden Optionen ab:
- Senden Sie das PDF und das Etikettendeckblatt per E-Mail an label@fedex.com.
- Senden Sie physische Etiketten an:
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017, USA
Hinweis: Stellen Sie bei physischen Etiketten sicher, dass keine sichtbaren Mängel wie Tintenstreifen oder Beschädigungen bestehen. Vergrößern oder verkleinern Sie Etiketten beim Drucken nicht.
6. Die FedEx Bar Code Analysis Group prüft Ihre Einreichung und genehmigt Etiketten oder lehnt diese ab. Wenn die Etiketten abgelehnt werden, berücksichtigen Sie das Feedback und reichen Sie sie erneut ein.
7. Nach der Genehmigung erhalten Sie von der FedEx Barcode Analysis Group eine E-Mail, nachdem Ihre Produktionsberechtigungen für Versandetikettentransaktionen autorisiert wurden.
Hinweis: Genehmigungen werden auf Projektbasis erteilt. Jedes neue Projekt bedarf einer Genehmigung.
8. Ersetzen Sie die Test-URLs und Zugangsdaten durch Ihre Produktions-URLs und Zugangsdaten.
9. Führen Sie einen abschließenden Produktionstest mit Beispieldaten durch, um zu bestätigen, dass alles wie erwartet funktioniert.
