FedEx Integrator Provider
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 automatisch deren 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. Wählen Sie in der Navigationsleiste Organisation erstellen oder einer Organisation beitreten aus.
2. Geben Sie die folgenden Details ein:
- Wählen Sie bei Ich arbeite für ein Unternehmen, das die Option Verkauft oder stellt eine Softwarelösung bereit, die FedEx Technologie verwendet und ein validierter FedEx Integrator Provider ist 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.
- Geben Sie eine offizielle E-Mail-Adresse ein, die die Domain Ihres Unternehmens, das Land oder Gebiet, in dem Ihr Unternehmen eingetragen ist, sowie die Länder und Gebiete, in denen Sie Ihre Softwarelösung verkaufen oder vertreiben, enthält.
3. Wählen Sie Weiter aus.
Sie können Details später unter Organisation verwalten im Menü aktualisieren oder hinzufügen.
Ein Abrechnungskonto
1. Wählen Sie die Registerkarte Abrechnungskonten aus. Wenn Sie kein FedEx Abrechnungskonto haben, wählen SieAbrechnungskonto eröffnen, um ein neues zu eröffnen , oder kontaktieren Sie den FedEx-Support.
Hinweis: Verwenden Sie Ihre Kundennummer; es kann nicht die FedEx-Kundennummer eines Kunden sein.
2. Wählen Sie Abrechnungskonto hinzufügen aus.
3. Geben Sie Ihre FedEx Kundennummer, einen Kontospitznamen und eine US-amerikanische Rechnungsadresse ein, die Sie bei der Kundenkontoeröffnung verwendet haben.
Hinweis: Die Rechnungsadresse muss mit der Adresse übereinstimmen, die Sie bei der Kundenkontoeinrichtung angegeben haben. Dieses Konto wird zum Standardabrechnungskonto Ihrer Organisation.
4. Wählen Sie eine Authentifizierungsoption aus.
- Telefonanrufe sind nur für Integratoren in den Vereinigten Staaten und Kanada verfügbar.
5. Geben Sie den Authentifizierungscode ein, den Sie erhalten, und wählen Sie Absenden aus.
6. Lesen und akzeptieren Sie die FedEx Integrator-Vereinbarung.
Benutzer*innen als Administrator einladen
1. Navigieren Sie zu Organisation verwalten und wählen Sie die Registerkarte Benutzer aus.
2. Wählen Sie + Benutzer hinzufügen.
3. Geben Sie die folgenden Details ein.
- Das Land oder Territorium
- Die bevorzugte Sprache
4. Wählen Sie eine Benutzerrolle aus: Viewer, Contributor oder Admin.
5. (Optional) Weisen Sie den*die Benutzer*in einem Projekt zu.
- Sie können jederzeit über die Übersichtsseite des Projekts eine*n Benutzer*in zuweisen.
6. 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. Die Einladung ist 24 Stunden gültig.
Ein Projekt erstellen
1. Navigieren Sie im Menü zu Meine Projekte und wählen Sie + Projekt erstellen.
2. Geben Sie einen Projektnamen ein.
- Das empfohlene Namensformat lautet Projectname_applicationname. Wählen Sie Weiter aus, wenn Sie fertig sind.
Wählen Sie die APIs und Advanced Integrated Visibility-Produkte für Ihr Projekt aus.
- Advanced Integrated Visibility-Produkte sind nur für US-amerikanische FedEx Integrator Providers verfügbar.
- Wenn Sie kostenpflichtige Produkte auswählen, werden Sie aufgefordert, dem Projekt ein Abrechnungskonto zuzuweisen und die erforderlichen Bedingungen zu akzeptieren.
Ein Abrechnungskonto zuweisen
Hinweis: Dies ist nur erforderlich, wenn Sie ein kostenpflichtiges Produkt auswählen.
Weisen Sie ein Abrechnungskonto aus der Liste der zur Organisation hinzugefügten Kundenkonten zu. Abrechnungskonten müssen in den Vereinigten Staaten ansässig sein.
2. Akzeptieren Sie die Lizenzvereinbarung und das Bestellformular im FedEx Developer Portal und wählen Sie Erstellen aus.
Konfigurieren von Advanced Integrated Visibility in einem Projekt
Grundvoraussetzungen
- Preisgestaltung überprüfen: Abonnenten zahlen eine monatliche Gebühr basierend auf der Anzahl der Sendungsverfolgungsnummern. Weitere Informationen über die Preisgestaltung finden Sie im Bestellformular.
- 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
- RFC1918-IP-Bereich, fedex.com und Subdomains sowie IP-Adressen wie localhost oder 127.0.0.1 ausschließen
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 die 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. Details finden Sie in unserer Webhook-Dokumentation.
Mit diesen Schritten überprüfen Sie Ihre API-Integration und bestätigen, dass Ihre Anwendung Testdaten senden und empfangen kann.
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. 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.
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.
Bevor Sie Ihre APIs in die Produktion überführen können, müssen diese validiert werden. Der Validierungsgrad variiert je nach API. Prüfen Sie die API-Validierungsanforderungen, bevor Sie beginnen.
1. Wählen Sie im Menü die Option Meine Projekte und dann den Projektnamen aus.
2. Auf der Registerkarte API-Schlüssel finden Sie unter Testschlüssel Ihre Testanmeldedaten.
3. Identifizieren Sie Testfälle für die Regionen oder Gebiete, in denen Sie Ihre Lösung bereitstellen möchten. Einzelheiten finden Sie unter Integrator-Testfall-Baseline.
4. Schließen Sie Registrierungstransaktionen mit den bereitgestellten Testkundennummern ab, bevor Sie Testfälle ausführen.
5. Schließen Sie alle erforderlichen Testfälle ab.
6. Füllen Sie das Produktinformationsblatt (PIW) mit Ihren Kontaktdaten und Ihrer Auswahl an FedEx-Dienstleistungen aus.
7. Füllen Sie das Deckblatt für die Integratorenvalidierung aus.
Absenden der Arbeitsergebnisse
Senden Sie alle benötigten Materialien an validationmtp@fedex.com.
1. Bereiten Sie die folgenden Arbeitsergebnisse vor:
- Ausgefülltes PIW (PDF-Format)
- Ausgefülltes Validierungsdeckblatt (PDF-Format)
- Endkunden-Registrierungstransaktionen mit Multi-Faktor-Authentifizierung (JSON)
- Gescannte Versandetiketten für alle relevanten Testfälle (PDF oder PNG)
- Versandtransaktionen für drei Etikettenformate: PDF, PNG und ZPL (JSON) (für relevante Versand- und Bewertungs-APIs)
- Screenshots (PDF) zeigen:
- Kundenseitige Lösung, die FedEx Services und spezielles Handling anzeigt
- Haftungsausschluss
- Endbenutzer-Lizenzvereinbarung (EULA)
- Endkunden-Registrierungsprozess
2. Komprimieren Sie alle Dateien in eine einzige ZIP- Datei, um Einschränkungen des E-Mail-Anbieters zu umgehen.
3. Senden Sie die ZIP-Datei per E-Mail an das Validierungsteam.
Bewährte Verfahren zur Vermeidung von Verzögerungen
Befolgen Sie diese Richtlinien, um die Überprüfungszeit zu verkürzen:
- 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.
- Fügen Sie für FedEx International Express® den zusätzlichen (sekundären) Frachtbrief (AWB) bei.
- Fügen Sie für jedes Paket in Mehrpaketsendungen (MPS) ein Etikett hinzu.
Etikettbewertung
Das Validierungsteam prüft Ihre Einreichung.
- Sollte die Anfrage abgelehnt werden, reagieren Sie auf das Feedback und reichen Sie die Unterlagen erneut ein.
- Im Falle einer Genehmigung erhalten Sie eine Bestätigungs-E-Mail. Nach der Genehmigung sind Ihre Produktionsanmeldedaten für Versandetikett-Transaktionen autorisiert.
1. Wählen Sie im Menü Meine Projekte und dann den Projektnamen.
2. Im Abschnitt APIs kopieren und speichern Sie Ihren Produktions-API-Schlüssel und den geheimen Schlüssel sicher.
Hinweis: Speichern Sie Ihren geheimen Schlüssel an einem sicheren Ort, da er nur einmal angezeigt wird. Wenn Sie ihn verlieren, können Sie später einen neuen erstellen.
