FedEx-afzender | FedEx Developer Portal

1 Een organisatie aanmaken of lid worden van een organisatie

Word lid van de organisatie van uw bedrijf om samen te werken met uw team. Als uw bedrijf geen organisatie heeft, kunt u er een aanmaken.

Lid worden van een bestaande organisatie

1. Een uitnodiging aanvragen

Vraag de beheerder van uw organisatie om u een uitnodiging te sturen. U hebt 24 uur de tijd om die te accepteren. Als de uitnodiging is verlopen, vraag de beheerder dan om deze opnieuw te versturen.

2. De uitnodiging accepteren

Log in met uw bestaande gebruikersnaam en wachtwoord. Als uw gebruikersnaam aan een andere organisatie gekoppeld is, maak dan een nieuwe aan.

Een nieuwe organisatie aanmaken

Wanneer u een organisatie maakt, wordt u de beheerder. Als beheerder kunt u gebruikers uitnodigen om lid te worden van de organisatie, projecten en gebruikersrollen toewijzen, en verzendaccounts beheren.

Ga voor meer informatie over gebruikersrollen naar Richtlijnen voor organisatiebeheer.

1. Meld u aan bij het FedEx Developer Portal.

2. Selecteer Mijn projecten in het menu en selecteer vervolgens Een organisatie maken.

3. Voer de volgende gegevens in:

Voor Ik werk voor een bedrijf dat, selecteert u Verzendt met FedEx en moet FedEx-API's in hun eigen applicaties integreren
Voer uw bedrijfsnaam, bedrijfswebsite en een organisatienaam in die uw team zal herkennen, zoals uw bedrijfsnaam, afdeling, divisie of regio.

4. Selecteer Maken.

U kunt gegevens later bijwerken of toevoegen onder Organisatie beheren in het menu.

Een verzendaccount toevoegen

1. Selecteer Verzendaccounts toevoegen op de tegel Accounts toevoegen. Als u geen FedEx-account hebt, selecteert u Een account aanmaken om een nieuw account te openen of neemt u contact op met de ondersteuning van FedEx.

2. Selecteer + Account toevoegen.

3. Voer uw FedEx-accountnummer, een accountbijnaam en het factuuradres in dat u bij het instellen van het account hebt gebruikt.

4. Accepteer de licentieovereenkomst voor eindgebruikers of stuur deze door naar een bevoegde vertegenwoordiger binnen uw bedrijf.

Een facturatie-account toevoegen

1. Selecteer het tabblad Facturatie-accounts. Als u geen FedEx-facturatie-account hebt, selecteer dan Facturatie-account openen om een nieuw account aan te maken of neem contact op met de ondersteuning van FedEx.

2. Selecteer Facturatie-account toevoegen. Facturatie-accounts moeten gevestigd zijn in de Verenigde Staten.

3. Voer uw FedEx-accountnummer, een accountbijnaam en het Amerikaanse factuuradres in dat u tijdens het aanmaken van uw account hebt gebruikt.

4. Lees en accepteer de licentieovereenkomst voor eindgebruikers.

Gebruikers uitnodigen als beheerder

1. Selecteer in het menu Organisatie beheren het tabblad Gebruikers.

2. Selecteer + Gebruikers toevoegen.

3. Selecteer een land of gebied en een voorkeurstaal, en kies vervolgens een gebruikersrol: kijker, bijdrager of beheerder.

4. (Optioneel) Wijs de gebruiker toe aan een project. U kunt op elk moment gebruikers toewijzen vanaf de Overzichtspagina van het project.

5. Voer de e-mailadressen van de gebruikers in en klik op Uitnodigen. U kunt maximaal 20 gebruikers tegelijk uitnodigen, waarbij elk e-mailadres wordt gescheiden door een komma. Uitnodigingen vervallen na 24 uur.

Een organisatie maken

2 Een project aanmaken

Een API-project aanmaken

1. Selecteer in het menu Mijn projecten, selecteer vervolgens het tabblad API's en kies + API-project maken.

2. Bevestig uw API-behoeften.

3. Selecteer de API's die in uw project moeten worden opgenomen.

4. Maak een projectnaam aan en selecteer de landen waarnaar u wilt verzenden om een testverzendaccount te ontvangen. Voor binnenlandse zendingen binnen Europa hebt u voor elk land een apart testaccount nodig. U kunt later landen toevoegen of verwijderen.

5. Selecteer Instellingen onder Meldingen om uw voorkeuren voor meldingen in te stellen.

6. Lees en accepteer de Algemene voorwaarden.

Een Advanced Integrated Visibility-project aanmaken

Vereisten

Prijzen bekijken: abonnees ontvangen maandelijks een rekening op basis van het aantal tracking-nummers. Ga naar de Prijsgids voor meer informatie over prijzen.
Accounts instellen: voor de Zichtbaarheid van zendingen-webhook is een facturatie-account uit de VS en minstens één verzendaccount vereist; deze twee accounttypes sluiten elkaar uit. Alleen beheerders kunnen facturatie- en verzendaccounts toevoegen op de pagina Organisatie beheren.

1. Maak een bestemmings-URL aan in uw applicatie of platform om callbacks te ontvangen. De URL moet:

HTTPS gebruiken
RFC1918 IP-ruimte, fedex.com en de subdomeinen daarvan en IP-adressen zoals localhost of 127.0.0.1 uitsluiten.

2. Genereer een beveiligingstoken voor authenticatie. Het token moet:

26-100 tekens, minstens één hoodletter, minstens één kleine letter en minstens één cijfer bevatten

3. Ga in het menu naar Mijn projecten en selecteer vervolgens het tabblad Advanced Integrated Visibility.

4. Selecteer Een Advanced Integrated Visibility-project maken.

5. Selecteer het gebruikerstype.

FedEx-afzender: verzendt met FedEx en moet de FedEx-API's in hun eigen applicaties integreren
FedEx Compatible Provider: is een gecertificeerde FedEx Compatible Provider
FedEx Integrator Provider: verkoopt of levert een softwareoplossing die FedEx-technologie gebruikt en is een gevalideerde FedEx Integrator Provider

6. Selecteer het abonnementstype. U kunt zich abonneren op gebeurtenissen via accountnummers of tracking-nummers.

7. Bevestig het facturatie-account en selecteer de functies die u wilt, zoals bewijs van aflevering, verwachte levering, traceergebeurtenissen of filteren op basis van gebeurtenissen.

8. Projectgegevens invoeren.

Voer een unieke en herkenbare projectnaam in.
Voer de bestemmings-URL en het beveiligingstoken in dat u heeft aangemaakt.
Voer een e-mailadres en voorkeurstaal in voor meldingen over updates en onderbrekingen voor Advanced Integrated Visibility.

9. Accepteer de FedEx Developer Portal-licentieovereenkomst en het bestelformulier en selecteer Maken.

Let op: afhankelijk van het door u gekozen abonnementstype gelden mogelijk aanvullende stappen. Ga voor meer informatie naar onze Webhook-documentatie.

GA NAAR MIJN PROJECTEN

3 Uw integratie testen

Gebruik deze stappen om uw API-integratie te verifiëren en te bevestigen dat uw applicatie testgegevens kan verzenden en ontvangen.

Testreferenties ophalen

1. Selecteer Mijn Projecten in het menu en selecteer vervolgens de Projectnaam.

2. Op het tabblad API-sleutels, onder Testsleutel, vindt u uw testgegevens.

3. Log in en download de JSON API-verzameling via de knop JSON-schema downloaden bovenaan de documentatiepagina. Bekijk voorbeeldaanvragen voor de eindpunten die uw integratie gebruikt.

4. Vraag een OAuth-toegangstoken aan voor gebruik bij elke API-transactie.

Let op: het token is één uur geldig en u kunt uw applicatie zo instellen dat deze wordt vernieuwd voordat het verloopt. Ga voor meer informatie naar de Documentatie voor API Authorization.

5. Selecteer in het menu API-catalogus, kies de API waarmee u wilt werken en selecteer Documentatie.

6. Selecteer in het menu het eindpunt.

7. Verzend voorbeeldaanvragen met uw testgegevens en de FedEx-test-URL en bevestig vervolgens dat de antwoorden overeenkomen met de documentatievoorbeelden. Ga voor meer informatie naar de Sandbox-virtualisatiegids.

8. Voer tests uit met Advanced Integrated Visibility om voorbeeldgegevens te genereren en te bevestigen dat uw applicatie de traceringsinformatie correct verwerkt.

Let op: testen verifieert uw callback-URL niet. Ga voor meer informatie naar de Documentatie voor Advanced Integrated Visibility.

4 Naar productie verplaatsen

Uw project verplaatsen naar productie

Stel uw productieconfiguratie in voordat u live gaat. U kunt de sleutel hernoemen, extra accounts toevoegen nadat het project live is gegaan, en het accountnummer bekijken dat tijdens het aanmaken van het project is geselecteerd. Dit accountnummer verplaatst uw project naar productie.

Let op: voor Advanced Integrated Visibility-projecten op basis van accountnummers is geen productieactivering vereist.

1. Selecteer Mijn Projecten in het menu en selecteer vervolgens de Projectnaam.

2. Selecteer het tabblad Productiesleutel.

3. Uw productiereferenties veilig ophalen en opslaan.

Kopieer de productie-API-sleutel en de geheime sleutel naar een veilige locatie.
Als u een productiesleutel aanvraagt, moet u deze op een veilige locatie opslaan, omdat deze slechts één keer voorkomt. Als u de productiesleutel kwijtraakt, kunt u later een nieuwe aanmaken.

4. Selecteer Volgende om de details van uw project op het tabblad Productiesleutel te bekijken.

Om meer verzendaccounts toe te voegen, selecteert u Bewerken bovenaan de tabel met verzendaccounts.

5 Uw API valideren

Uw API valideren

Sommige FedEx-API's vereisen validatie van verzendlabels voordat u ze in productie kunt gebruiken. Bekijk de API-validatievereisten voordat u begint.

1. Selecteer Mijn Projecten in het menu en selecteer vervolgens de Projectnaam.

2. Op het tabblad API-sleutels, onder Testsleutel, vindt u uw testgegevens.

3. Na voltooiing van de tests zet u uw project naar productie in het FedEx Developer Portal om te beginnen met valideren.

Als u een productiesleutel aanvraagt, moet u deze op een veilige locatie opslaan, omdat deze slechts één keer voorkomt. Als u de productiesleutel kwijtraakt, kunt u later een nieuwe aanmaken.

4. Geef de vereiste informatie op het labeloverzichtsblad op, waaronder contactgegevens, de services die u wilt implementeren, het accountnummer en de productie-API-sleutel.

5. Maak testlabels aan in de FedEx-testomgeving en dien deze vervolgens in bij de streepjescode-analysegroep van FedEx ter beoordeling. Het duurt maximaal drie werkdagen om het label te evalueren.

Best practices om vertragingen te voorkomen:

Print en scan labels met minimaal 600 DPI. Dien geen bestanden in die rechtstreeks via API's zijn gegenereerd.
Vraag voor thermische printers het afbeeldingstype aan dat overeenkomt met uw printer, bijvoorbeeld ZPLII voor Zebra-printers.
Gebruik geldige afzender- en ontvangeradressen voor voorbeeldlabels. Maak alleen labels aan voor de services die u wilt gebruiken.
Voor FedEx-rembourszending (COD) dient u het COD-retourlabel bij te voegen.
Voeg voor FedEx International Express® de aanvullende (secundaire) luchtvrachtbrief (AWB) toe.
Dien voor zendingen die uit meerdere pakketten bestaan een label in voor elk pakket.

Dien uw materialen in via een van de volgende opties:

E-mail de PDF en het labeloverzichtsblad naar label@fedex.com.
Stuur fysieke labels naar:

FedEx Services

WTC-Business Solutions Testing

10 FedEx Parkway

2nd Floor Horizontal

Collierville, TN 38017

Let op: voor fysieke labels moet u ervoor zorgen dat er geen zichtbare defecten zijn, zoals inktlijnen of schade. Vergroot of verklein labels niet tijdens het afdrukken.

6. De streepjescode-analysegroep van FedEx beoordeelt uw inzending en keurt de labels goed of af. Als de labels worden afgewezen, reageer dan op de feedback en dien ze opnieuw in.

7. Na goedkeuring stuurt de streepjescode-analysegroep van FedEx u een e-mail nadat uw productiegegevens voor verzendlabeltransacties zijn geautoriseerd.

Let op: goedkeuring geldt per project. Elk nieuw project vereist goedkeuring.

8. Vervang de test-URL's en inloggegevens door uw productie-URL's en inloggegevens.

9. Voer een laatste productietest uit met voorbeeldgegevens om te bevestigen dat alles werkt zoals verwacht.