Aan de slag

FedEx Developer Portal biedt een suite met Application Programming Interfaces (API's) om FedEx te integreren in uw applicaties. Met deze instructies kunt u een organisatie instellen, een project maken, uw integratie testen, een project verplaatsen naar productie en voor sommige gevallen uw API valideren.

Soorten gebruikers:

FedEx biedt integratieservices voor drie soorten gebruikers: FedEx-afzenders, geverifieerde softwareoplossingen die bekendstaan als FedEx Compatible Providers en gevalideerde FedEx Integrator Providers.

FedEx-afzender:

Een bedrijf dat met FedEx verzendt en FedEx-API's moet integreren in zijn eigen applicaties.

Oplossing of serviceprovider:

Een bedrijf dat met FedEx-API's moet integreren om een oplossing, applicatie of plug-in te ontwikkelen die kan worden verkocht en/of gedistribueerd naar een externe organisatie die met FedEx verzendt.

FedEx Compatible Provider: geverifieerd bedrijf met een contractuele overeenkomst via het FedEx Compatible-programma.
FedEx Integrator Provider: gevalideerd bedrijf met een contractuele overeenkomst via het Integrator-programma van FedEx.

Selecteer een optie hieronder die uw onderneming het best beschrijft. U kunt altijd aan de slag gaan, ongeacht het soort gebruiker dat u bent.

Selecteer om aan de slag te gaan.

Which of the following best describes your business?

Select user

EXPAND ALL

1 Een organisatie aanmaken of lid worden van een organisatie

Als uw bedrijf geen organisatie heeft, maak er dan een aan. Word anders lid van een bestaande organisatie.

Een nieuwe organisatie aanmaken

Klik in de navigatiebalk op Een organisatie aanmaken of lid worden van een organisatie.

Let op: als maker bent u automatisch aangewezen als beheerder van de organisatie.

Beheerders kunnen:

Gebruikers uitnodigen om deel te nemen

Gebruikersrollen (bijv. bijdrager, kijker) en projecten toewijzen

Verzendaccounts beheren

Ga voor meer informatie over deze rollen naar onze Gids voor organisatiebeheer.

Voor het type bedrijf selecteert u 'Verkoopt of levert een softwareoplossing die gebruikmaakt van FedEx-technologie en een gevalideerde FedEx Integrator Provider is.'

Verstrek uw bedrijfsnaam, website-URL en een unieke organisatienaam. De organisatienaam kan overeenkomen met de naam van uw bedrijf of een specifieke groep vertegenwoordigen (afdeling, divisie, regio, locatie). Deze informatie is noodzakelijk om uw aanvraag te valideren.

Let op: kies een organisatienaam die alle andere gebruikers zullen herkennen (bijv. bedrijfsnaam, afdeling, regio, locatie).

Geef de locatie van uw bedrijf op en waar uw softwareoplossing verkocht of gedistribueerd wordt.

Facturatie-account en verificatie-account toevoegen

Let op: als verzend- en logistiekleverancier in het Integrator-programma van FedEx moet u uw eigen accountnummer gebruiken. U kunt geen FedEx-account van een klant gebruiken.

Voer uw FedEx-accountnummer in. Als u nog geen FedEx-account hebt, kunt u er een openen op fedex.com of contact opnemen met een medewerker van de ondersteuning van FedEx.

Voer een accountbijnaam en het factuuradres in dat aan het account is gekoppeld. Selecteer Volgende.

Let op: het factuuradres moet overeenkomen met onze gegevens voor dit account. Dit wordt het standaard facturatie-account voor uw organisatie.

U moet uw account verifiëren om het aanmaken van uw organisatie te voltooien. Kies een verificatieoptie (telefoon alleen beschikbaar voor integrator in de VS & CA, e-mailadres, sms) en selecteer Volgende.

Voer na ontvangst de verificatiecode in en selecteer Indienen.

Accepteer de voorwaarden

Lees de Wereldwijde Integrator-overeenkomst en het programmahandboek. Vink de selectievakjes aan om te bevestigen dat u de voorwaarden accepteert en selecteer vervolgens Accepteren.

Er verschijnt een bevestigingsscherm. Klik op Organisatie beheren om indien nodig details te wijzigen.

Gebruikers uitnodigen

Let op: alleen beheerders kunnen gebruikers uitnodigen.

Selecteer Organisatie beheren in het navigatiemenu aan de linkerkant.

Ga naar het tabblad Gebruikers en selecteer Gebruikers toevoegen.

Vul het formulier in en wijs de juiste rol toe aan de nieuwe gebruiker(s): Kijker, Bijdrager of Beheerder.

Zie de Gids voor organisatiebeheer voor meer informatie over gebruikersrollen.

Wijs gebruikers toe aan projecten (indien van toepassing) via het vervolgkeuzemenu Projecten.

Voer de e-mailadressen voor elke gebruiker in en selecteer vervolgens Uitnodigen.

Lid worden van een bestaande organisatie

Vraag een uitnodiging aan: vraag de beheerder van uw organisatie om u een uitnodiging te sturen. U hebt 24 uur de tijd om deze te accepteren voordat de uitnodiging verloopt. Vraag de beheerder indien nodig om de uitnodiging opnieuw te versturen.

Accepteer de uitnodiging: log in met uw bestaande gebruikersnaam en wachtwoord. Als uw gebruikersnaam al gekoppeld is aan een andere organisatie, moet u een nieuwe aanmaken.

Een organisatie maken

Lid worden van een bestaande organisatie

Stap 1: vraag de beheerder van uw organisatie om u een uitnodiging te sturen.

Als uw bedrijf al een organisatie heeft aangemaakt, vraagt u de beheerder van de organisatie u uit te nodigen om lid te worden. U hebt 24 uur de tijd om deze uitnodiging te accepteren. Als u dit tijdvenster mist, kunt u altijd vragen de uitnodiging opnieuw te versturen.

Stap 2: de uitnodiging accepteren.

Om de uitnodiging te accepteren, moet u zich aanmelden met uw bestaande gebruikersnaam en wachtwoord of, als uw bestaande gebruikersnaam al is gekoppeld aan een organisatie, moet u een nieuwe aanmaken.

2 Een project aanmaken

Een API-project aanmaken

Ga naar de pagina Mijn projecten en open het tabblad API's. Klik op de knop API-project maken.

Stap 1: selecteer de API('s) die u wilt opnemen in uw project

De API-quota, tariefbeperkingen en API-validatiegegevens controleren.

Stap 2: de projectgegevens configureren

Geef uw project een naam die u makkelijk kunt herkennen en die uniek is voor uw organisatie.
Selecteer de landen waarbinnen u wilt verzenden, zodat wij u een testverzendaccount kunnen toewijzen. Om de binnenlandse verzending van pakketten in een Europees land te testen, dient u per land over een afzonderlijk testaccount te beschikken. U kunt altijd later landen toevoegen/verwijderen.
Om op de hoogte te worden gesteld van de nieuwste API-updates en informatie over storingen, kunt u uw meldingsvoorkeuren instellen.

Stap 3: lees en accepteer de voorwaarden, inclusief de FedEx Developer Portal-licentieovereenkomst.

Zodra u de voorwaarden hebt geaccepteerd en op de knop Maken heeft geklikt, krijgt u een bevestigingsscherm te zien. U kunt dan uw testreferenties in uw nieuwe project bekijken.

Webhookproject aanmaken

Vereisten

Prijzen bekijken: abonnees ontvangen maandelijks een rekening op basis van het aantal trackingnummers. Ga naar de Prijsgids voor meer informatie over prijzen.
Accounts instellen: voor Advanced Integrated Visibility-webhooks is een factureeraccount uit de VS vereist en minstens één verzendacount. Deze twee accounttypes sluiten elkaar niet uit. Alleen beheerders kunnen factureer- en verzendaccounts toevoegen op de pagina Organisatie beheren.

Een geldige (callback) URL aanmaken in uw bestemmingsapplicatie of platform

Uw bestemmings-URL zal worden gebruikt om authenticatiecodes en berichten te ontvangen, evenals meldingen voor webhook-nettoladingen van FedEx. Uw URL moet ter beveiliging HTTPS gebruiken. Uw URL wordt geblokkeerd als deze het volgende bevat:

RFC1918 IP-ruimte
fedex.com of een van de bijbehorende subdomeinen
IP-adressen in de URL (inclusief localhost, 127.0.0.1)

Een beveiligingstoken genereren

Deze beveiligingstoken kan worden gebruikt als een geheime sleutel voor het verifiëren en valideren van informatie die tussen uw organisatie en FedEx wordt verzonden. Uw beveiligingstoken moet omvatten:

Een minimale lengte van 26 tekens en een maximale lengte van 100 tekens
1 hoofdletter
1 kleine letter
1 cijfer

Bijvoorbeeld: Y1F6OiVUQW2JPSElmRE9U0IY5

Nadat u uw URL en beveiligingstoken hebt gedefinieerd, bent u klaar om een webhook-project te maken. Ga naar de pagina Mijn projecten en open het tabblad Webhooks. Klik op de knop Webhook-project maken.

Selecteer het abonnementstype

FedEx-afzenders kunnen hun gebeurtenissen abonneren op accountnummer of trackingnummer.

Stap 1: factureringsaccount bevestigen en functies selecteren

Controleer het standaardfactureeraccount in de lijst om die te bevestigen of een ander account van uw organisatie te selecteren.
Configureer uw project door functies te selecteren, zoals opties voor bewijs van aflevering, opties voor verwachte levering, trackinggebeurtenissen of filteren op basis van gebeurtenissen.

Stap 2: projectgegevens invoeren

Geef uw project een naam die u makkelijk kunt herkennen en die uniek is voor uw organisatie.
Voer uw bestemmings-URL en de beveiligingstokengegevens in die u hebt gemaakt voorafgaand aan het instellen van de authenticatie (zie de stappen hierboven).
Om op de hoogte te worden gesteld van de nieuwste webhook-updates en informatie over storingen, moet u uw e-mailadres en voorkeurstaal invoeren.

Stap 3: de voorwaarden lezen en accepteren

Zodra u de voorwaarden inclusief de FedEx Developer Portal-licentieovereenkomst en het Bestelformulier hebt geaccepteerd en op de knop Maken hebt geklikt, krijgt u een bevestigingsscherm te zien.

Er kunnen extra stappen volgen afhankelijk van uw selectie van het abonnementstype. Bekijk de documentatie voor meer informatie.

Ga naar Mijn projecten

3 Uw integratie testen

Op de pagina API-projectoverzicht haalt u uw testreferenties — API-sleutel, geheime sleutel en verzendaccount(s) — op van het tabblad Testsleutel.

Stap 1: een OAuth-toegangstoken aanvragen

De OAuth-toegangstoken moet bij elke API-transactie worden gebruikt. De token is slechts één uur geldig. Het is dus noodzakelijk dat u uw applicatie programmeert om de token te vernieuwen, voordat de sessie verloopt. Ga voor meer informatie naar de API Authorization-documentatie.

Stap 2: API-documentatie nalezen

Klik op de documentatie voor elk van uw API's om de zakelijke context te lezen en te begrijpen hoe u de API moet gebruiken. Meld u aan om de JSON API-verzameling te downloaden via de knop bovenaan de documentatiepagina. U kunt ook voorbeeldaanvragen bekijken voor het eindpunt dat overeenkomt met uw gewenste integratie.

Stap 3: gebruik de sandbox om voorbeeldtransacties te testen

Klik op het gewenste eindpunt in de navigatie aan de linkerkant om naar die specifieke sandbox te gaan. Identificeer de voorbeeldaanvragen die overeenkomen met uw gebruiksscenario en gebruik vervolgens de testgegevens en de FedEx-test-URL's om uw oproepen voor het eindpunt te implementeren zoals beschreven in de voorbeeldaanvragen. Controleer of de reacties op de API-aanroepen die u ontvangt, overeenkomen met de reacties die in de documentatie staan vermeld. Ga voor meer informatie over de testervaring naar de Sandbox-visualisatiegids.

Testen met webhooks

Testen kan u helpen om een beter idee te krijgen of de URL geldig is. Hiermee kan FedEx uw URL identificeren en een verbinding met uw URL opzetten om gegevens te verzenden. Testen kan u ook voorzien van testgegevens waarmee u kunt controleren en bevestigen of de trackinggegevens in uw applicatie worden verwerkt. Testen verifieert echter niet uw URL. Raadpleeg onze webhookdocumentatie voor meer informatie over hoe u uw webhook-URL kunt testen.

4 Naar productie verplaatsen

Ga naar uw pagina Projectoverzicht en open het tabblad Productiesleutel. Abonnementsprojecten van geavanceerde geïntegreerde zichtbaarheid-accountnummers hoeven niet naar productie te worden verplaatst.

Stap 1: project configureren

Geef uw sleutel indien nodig een andere naam.
Controleert u het accountnummer dat u in stap 1 van de projectaanmaakproces hebt geselecteerd. Dit wordt gebruikt om uw project naar productie te verplaatsen. Zodra uw project live is in productie, kunt u, indien nodig, meer accounts toevoegen.

Stap 2: projectsleutels ophalen

Kopieer uw productie-API-sleutel en de geheime sleutel voor productie zal worden weergegeven op een veilige plek. Om uw geheime productiesleutel veilig te houden, laten we deze slechts één keer zien. Als u uw geheime sleutel kwijtraakt, kunt u een nieuwe genereren.

Nadat u uw productiesleutels hebt gekregen en op Volgende klikt, kunt u uw projectgegevens zien op het tabblad Productiesleutel.

Om meer verzendaccounts aan uw project toe te voegen, klikt u op Bewerken bovenaan de tabel verzendaccounts.

5 Uw API valideren

Sommige API's vereisen verzendlabelvalidatie voor gebruik in onze productieomgeving. Bekijk of er voor uw API validatie is vereist.

Stap 1. FedEx-API's ontwikkelen en testen met uw internettoepassing

Wanneer u klaar bent met de ontwikkeling van uw internettoepassing, is het tijd om te testen met behulp van de testgegevens (testverzendaccount(s), API-sleutel en Geheime sleutel). Uw API-sleutel en geheime sleutel voor het testen worden weergegeven op de pagina Projectoverzicht en kunnen op elk moment worden bekeken.

Stap 2: Uw project verplaatsen naar productie

Nadat u hebt getest met de FedEx-API's moet u het validatieproces starten door uw project te verplaatsen naar productie op de FedEx Developer Portal. Wanneer dit succesvol is verlopen, ziet u uw API-sleutel en geheime sleutel voor productie. Uw geheime sleutel voor productie ziet u maar één keer, maar u kunt deze later opnieuw genereren.

Stap 3: Het etiketoverzichtsblad invullen

Vul het Labeloverzichtsblad volledig in met de juiste contactgegevens en met de diensten die u wilt implementeren. Voeg uw accountnummer en de productiesleutel toe. Voeg uw accountnummer en de productiesleutel toe.

Stap 4: testlabels genereren en verzenden naar de streepjescode-analysegroep

Genereer testlabels binnen de FedEx-testomgeving die is verbonden met de toepassing en verzend de testlabels naar een labelbeoordelingsteam van FedEx voor goedkeuring. De streepjescode-analysegroep heeft drie werkdagen nodig voor de beoordeling van het label.

Volg deze best practices om vertraging bij de verwerking te voorkomen:

Labels moeten worden afgedrukt en gescand op minimaal 600 DPI. VERZEND GEEN DOOR API'S GEGENEREERDE BESTANDEN.
Voor thermische printers moet het beeldtype van het label worden opgevraagd in overeenstemming met het printermodel. Voorbeeld: ZPLII voor Zebra-printers.
Gebruik de adresgegevens van de afzender/geadresseerde bij het maken van voorbeeldetiketten voor beoordeling. Maak alleen voorbeeldetiketten voor de specifieke diensten die worden aangevraagd.
Op het FedEx® Rembourszending (C.O.D.)-label moet ook het overeenkomstige land van bestemming staan. Retourlabel.
Voor FedEx International Express®-zendingen moet ook het aanvullende/secundaire Luchtvrachtbrief (AWB)-label zijn bijgesloten.
Voor zendingen die uit meerdere pakketten bestaan (MPS), moet er per pakket één etiket zijn.
E-mail de PDF en het labeloverzichtsblad naar: label@fedex.com
Fysieke etiketten kunnen naar het onderstaande adres worden gezonden:

FedEx-services

WTC-Business Solutions Testing

10 FedEx Parkway

2nd Floor Horizontal

Collierville, TN 38017

Als de gescande labels geen zichtbare fouten bevatten (zoals lijnen door de streepjescode, vlekken in de inkt of fysieke beschadiging), kunnen ze door inspectie komen en worden goedgekeurd. 

Als u fysieke etiketten stuurt, let dan op de afdrukkwaliteit en onbedoelde vergroting/verkleining van etiketten (d.w.z. schaling). Dit zijn de belangrijkste twee redenen waarom labels niet door het beoordelingsproces komen.

Stap 5: de labelevaluatie controleren

De streepjescode-analysegroep beoordeelt de ingezonden testetiketten en keurt de etiketten goed of af. De streepjescode-analysegroep neemt contact met u op inzake de goedkeuring of afkeuring van de ingezonden etiketten. Als de etiketten worden goedgekeurd, gaat u door met de volgende stap. Als de etiketten worden afgekeurd, corrigeert u ze zoals aangegeven en zendt u ze opnieuw in voor goedkeuring.

Stap 6: de applicatie inschakelen

Wanneer de testlabels zijn goedgekeurd voor productiestatus door de streepjescode-analysegroep, autoriseert deze groep uw productiegegevens om de geïdentificeerde verzendlabeltransactie door te sturen en krijgt u via e-mail een bericht van de geslaagde validatie. Uw goedkeuring geldt per project.

Stap 7: De URL en de gegevens vervangen

Vervang de test-URL en de testgegevens door de productie-URL en de productiegegevens. Test uw implementatie in de productieomgeving opnieuw met gebruik van voorbeeldgegevens.

EXPAND ALL

1 Neem contact op met FedEx om uw organisatie te maken

Vereiste

Uw bedrijf moet een bestaande FedEx Compatible Provider zijn. Als uw bedrijf geen onderdeel is van het Compatible-programma, dan moet u uw selectie hierboven veranderen naar 'Non-Compatible Provider'.

Stap 1: een uitnodiging ontvangen om deel te nemen aan een organisatie

FedEx maakt een organisatie aan en nodigt dan één teamlid uit om lid te worden van de organisatie. Deze gebruiker wordt aangewezen als de beheerder van uw organisatie.

Stap 2: de uitnodiging accepteren

Stap 3: gebruikers uitnodigen

Een beheerder kan gebruikers uitnodigen om lid te worden van hun organisatie en rollen en projecten aan hen toewijzen. Open het tabblad Gebruikers. Klik op de knop Gebruikers toevoegen.

Selecteer een gebruikersrol: kijker, bijdrager of beheerder. Ga voor meer informatie naar onze Gids voor organisatiebeheer.
Als u bestaande projecten hebt, wijs dan een project aan de gebruiker toe. U kunt ook gebruikers aan projecten toewijzen op de pagina Projectoverzicht.
Voer het e-mailadres in van de gebruikers die u aan uw organisatie wilt toevoegen onder de geselecteerde rol.

Gebruikers uitnodigen

2 Selecteer producten voor FedEx om een of meerdere projecten te maken

Ga naar de API-catalogus om te bepalen wat de juiste API's of webhooks zijn voor uw oplossing. Uw FedEx Customer Technology Consultant (CTC) en Compatible Channel manager kunnen u helpen de juiste API's voor uw oplossing te kiezen, afhankelijk van uw zakelijke behoeften.

Stap 1: de PIW invullen

Ga terug naar de Compatible Provider Community (CPC) om het Product Information Worksheet (PIW) in te vullen.

Stap 2: project(en) controleren dat/die door FedEx zijn aangemaakt

Zodra de PIW is goedgekeurd, zal FedEx uw project(en) opzetten. Voor elke versie van elke oplossing wordt een apart project opgezet in het FedEx Developer Portal.

Stap 3: met uw team deelnemen aan de API-demo

Het FedEx Compatible-team samen met de FedEx CTC- en certificeringsteams organiseren een technische demonstratie van de API's voor uw team. Het FedEx-team zal verificatie voor het Compatible-programma en nieuwe API-functies bespreken en vragen beantwoorden.

Ga naar Mijn projecten

3 Test uw integratie en voltooi de verificatie.

Op de pagina API-projectoverzicht haalt u uw testreferenties — API-sleutel en geheime sleutel — op van het tabblad Testsleutel.

Stap 1: sleutels voor klanten maken

Gebruik de gegevensregistratie-API om sleutels voor klanten te maken. Dit is een privé-API die alleen in het API-gedeelte kan worden gevonden onderaan de pagina API-projectoverzicht.

Stap 2: een OAuth-toegangstoken aanvragen

Stap 3: API-documentatie nalezen

Stap 4: gebruik de sandbox om voorbeeldtransacties te testen

Stap 5: elke oplossing verifiëren

Na het volledig testen van uw oplossingen, moet u testcases indienen bij het verificatieteam om elke oplossing te verifiëren. FedEx bekijkt alles wat wordt ingediend en licht u in zodra uw verificatie is goedgekeurd.

Testen met webhooks

Als uw organisatie toegang tot webhooks heeft, dan kan testen u helpen om een beter idee te krijgen of de URL die u hebt gemaakt geldig is. Hiermee kan FedEx uw URL identificeren en een verbinding met uw URL opzetten om gegevens te verzenden. Testen kan u ook voorzien van testgegevens waarmee u kunt controleren en bevestigen of de trackinggegevens in uw applicatie worden verwerkt. Testen verifieert echter niet uw URL. Raadpleeg onze webhookdocumentatie voor meer informatie over hoe u uw webhook-URL kunt testen.

4 De geheime sleutel voor productie genereren

FedEx zal dan uw project(en) naar productie brengen. Ga naar uw pagina API-projectoverzicht en open het tabblad Productiesleutel. Klik op de link Geheime sleutel genereren onder de kolom Geheime sleutel.

U kunt nu uw implementatie opnieuw testen in de productieomgeving met behulp van voorbeeldgegevens.

EXPAND ALL

1 Een organisatie aanmaken of lid worden van een organisatie

Maak een organisatie aan als die voor uw bedrijf nog niet bestaat of word lid van de bestaande organisatie van uw bedrijf.

Een nieuwe organisatie aanmaken

Klik in de navigatiebalk op Een organisatie aanmaken of lid worden van een organisatie.

Let op: als maker bent u automatisch aangewezen als beheerder van de organisatie.

Beheerders kunnen:

Gebruikers uitnodigen om deel te nemen

Gebruikersrollen (bijv. bijdrager, kijker) en projecten toewijzen

Verzendaccounts beheren

Ga voor meer informatie over deze rollen naar onze Gids voor organisatiebeheer.

Voor het type bedrijf selecteert u 'Verkoopt of levert een softwareoplossing die gebruikmaakt van FedEx-technologie en een gevalideerde FedEx Integrator Provider is.'

Verstrek uw bedrijfsnaam, website-URL en een unieke organisatienaam. De organisatienaam kan overeenkomen met de naam van uw bedrijf of een specifieke groep vertegenwoordigen (afdeling, divisie, regio, locatie). Deze informatie is noodzakelijk om uw aanvraag te valideren.

Let op: kies een organisatienaam die alle andere gebruikers zullen herkennen (bijv. bedrijfsnaam, afdeling, regio, locatie).

Geef de locatie van uw bedrijf op en waar uw softwareoplossing verkocht of gedistribueerd wordt.

Facturatie-account en verificatie-account toevoegen

Let op: als verzend- en logistiekleverancier in het Integrator-programma van FedEx moet u uw eigen accountnummer gebruiken. U kunt geen FedEx-account van een klant gebruiken.

Voer uw FedEx-accountnummer in. Als u nog geen FedEx-account hebt, kunt u er een openen op fedex.com of contact opnemen met een medewerker van de ondersteuning van FedEx.

Voer een accountbijnaam en het factuuradres in dat aan het account is gekoppeld. Selecteer Volgende.

Let op: het factuuradres moet overeenkomen met onze gegevens voor dit account. Dit wordt het standaard facturatie-account voor uw organisatie.

U moet uw account verifiëren om het aanmaken van uw organisatie te voltooien. Kies een verificatieoptie (telefoon alleen beschikbaar voor integrator in de VS & CA, e-mailadres, sms) en selecteer Volgende.

Voer na ontvangst de verificatiecode in en selecteer Indienen.

Accepteer de voorwaarden

Lees de Integrator-overeenkomst van FedEx en het programmahandboek. Vink de selectievakjes aan om te bevestigen dat u de voorwaarden accepteert en selecteer vervolgens Accepteren.

Er verschijnt een bevestigingsscherm. Klik op Organisatie beheren om indien nodig details te wijzigen.

Gebruikers uitnodigen

Let op: alleen beheerders kunnen gebruikers uitnodigen.

Selecteer Organisatie beheren in het navigatiemenu aan de linkerkant.

Ga naar het tabblad Gebruikers en selecteer Gebruikers toevoegen.

Vul het formulier in en wijs de juiste rol toe aan de nieuwe gebruiker(s): Kijker, Bijdrager of Beheerder.

Zie de Gids voor organisatiebeheer voor meer informatie over gebruikersrollen.

Wijs gebruikers toe aan projecten (indien van toepassing) via het vervolgkeuzemenu Projecten.

Voer de e-mailadressen voor elke gebruiker in en selecteer vervolgens Uitnodigen.

Een organisatie maken

Lid worden van een bestaande organisatie

Vraag een uitnodiging aan: vraag de beheerder van uw organisatie om u een uitnodiging te sturen. U hebt 24 uur de tijd om deze te accepteren voordat de uitnodiging verloopt. Vraag de beheerder indien nodig om de uitnodiging opnieuw te versturen.

Accepteer de uitnodiging: log in met uw bestaande gebruikersnaam en wachtwoord. Als uw gebruikersnaam al gekoppeld is aan een andere organisatie, moet u een nieuwe aanmaken.

2 Een project aanmaken

Een API-project aanmaken

Ga naar uw pagina Mijn Projecten en selecteer Project aanmaken.

Vul het veld Projectnaam in. De aanbevolen naamindeling is 'ProjectName_ApplicationName'. Selecteer Volgende als u klaar bent.

Selecteer de API en Advanced Integrated Visibility-producten voor uw project.

Let op: Advanced Integrated Visibility-producten zijn alleen beschikbaar voor Amerikaanse FedEx-integratorproviders.

Let op: als u betaalde producten selecteert, wordt u gevraagd een facturatie-account aan het project toe te wijzen en de vereiste voorwaarden te accepteren.

Facturering toewijzen en voorwaarden accepteren

Wijs een facturatie-account toe uit de lijst van accounts die aan de organisatie zijn toegevoegd. Deze stap is alleen nodig als u eerder een betaald product hebt geselecteerd.

Accepteer de algemene voorwaarden die bij het product horen.

Gegevens bevestigen

Controleer de geselecteerde producten. Controleer het opgegeven facturatie-account.

Bekijk en accepteer de Licentieovereenkomst voor het FedEx Developer Portal.

Klik op Aanmaken om uw project te genereren en testgegevens weer te geven.

Advanced Integrated Visibility configureren in een project

Vereisten

Vereisten

Prijzen bekijken: abonnees ontvangen maandelijks een rekening op basis van het aantal tracking-nummers. Ga naar het Bestelformulier voor meer informatie over prijzen.
Accounts instellen: voor Advanced Integrated Visibility is een factureeraccount uit de VS vereist en minstens één verzendacount. Deze twee accounttypes sluiten elkaar niet uit. Alleen beheerders kunnen factureer- en verzendaccounts toevoegen op de pagina Organisatie beheren.

Maak een geldige callback-URL in uw bestemmingsapplicatie of platform – Uw applicatie-/platform-URL:

U moet om beveiligingsredenen HTTPS gebruiken.

Mag niet de RFC1918 IP-ruimte, fedex.com-subdomeinen of directe IP-adressen (bijv. 127.0.0.1) bevatten.

Een beveiligingstoken genereren

Moet 26 tot 100 tekens lang zijn en het volgende bevatten:
- 1 hoofdletter
- 1 kleine letter
- 1 cijfer
Bijvoorbeeld: Y1F6OiVUQW2JPSElmRE9U0IY5

Advanced Integrated Visibility configureren

Kies Advanced Integrated Visibility. Selecteer de functies zoals bewijs van aflevering, verwachte levering, traceergebeurtenissen en filteren op basis van gebeurtenissen

Voer uw bestemmings-URL en beveiligingstoken in.

Geef een e-mailadres op voor updates en storingsmeldingen van Advanced Integrated Visibility.

Gegevens bevestigen

Bekijk en accepteer de Licentieovereenkomst voor FedEx Developer Portal en het Bestelformulier.

Selecteer Aanmaken om het instellen te voltooien.

Let op: afhankelijk van uw abonnementstype kunnen extra stappen van toepassing zijn. Bekijk de documentatie voor meer informatie.

Ga naar Mijn projecten

3 Uw integratie testen

Testgegevens ophalen en testen starten

API-documentatie nalezen
- Lees de API-documentatie om de verschillende API's die wij aanbieden te begrijpen, samen met hun zakelijke context en integratieprocessen.
- Download het JSON-schema van de documentatiepagina van de relevante API.
- Bekijk voorbeeldaanvragen voor de gewenste eindpunten.
Testreferenties ophalen

Op de pagina Projectoverzicht gaat u naar het tabblad API-sleutels. Uw API-sleutel en geheime sleutel staan vermeld onder de kop Testsleutel.
API-documentatie nalezen
- Voor alle API-transacties is een OAuth-token vereist die binnen een uur verloopt.
- Uw applicatie moet het token vernieuwen voordat het verloopt.
- Ga voor meer informatie naar de API Authorization-documentatie.
API-transacties testen in de sandbox
- Ga naar de relevante API in de API-catalogus en selecteer Documentatie.
- Selecteer het gewenste API-eindpunt in het menu aan de linkerkant.
- Gebruik voorbeeldaanvragen die passen bij uw gebruiksscenario.
- Implementeer API-aanroepen met uw testgegevens en FedEx-test-URL's.
- Controleer de antwoorden aan de hand van de documentatie.
- Ga naar de Sandbox-virtualisatiegids voor meer informatie.

Advanced Integrated Visibility testen

Advanced Integrated Visibility-tests valideren uw URL-indeling en helpen een verbinding tot stand te brengen tussen FedEx en uw applicatie.

De test biedt voorbeeldtestgegevens voor het verwerken van traceerinformatie.

Let op: bij testen wordt uw URL niet geverifieerd.

Ga naar de documentatie over Advanced Integrated Visibility voor meer informatie.

4 Uw API valideren

Validatie is vereist om API's over te zetten naar productie. Het validatieniveau kan per API verschillen.

FedEx-API's ontwikkelen en testen

Gebruik uw testreferenties (API-sleutel en geheime sleutel) van de pagina Projectoverzicht.
Identificeer testcases voor de regio's/gebieden waar u uw oplossing wilt uitrollen (zie Integrator-testcasebasislijn).
Voltooi registratietransacties met behulp van de verstrekte testaccountnummers voordat u testcases uitvoert.
Voer alle vereiste testcases uit.

Ga naar de pagina Projectoverzicht.

Selecteer Productiesleutels aanvragen. FedEx ontvangt uw aanvraag voor productiesleutels en u ontvangt een bericht zodra ze zijn goedgekeurd.

De PIW en het validatieoverzichtsblad invullen

Vul het Product Information Worksheet (PIW) en overzichtsblad voor integratorvalidatie in met uw contactgegevens en beoogde FedEx-diensten.

Dien de te leveren items in

Verzamel en comprimeer de volgende items in een .zip-bestand om beperkingen van e-mailproviders te vermijden. Stuur het bestand naar validationmtp@fedex.com.

Vereiste te leveren items

Ingevulde PIW (PDF).
Ingevuld Validatieoverzichtsblad (PDF).

Screenshots (PDF):

Klantgerichte oplossing die FedEx-services/speciale afhandeling weergeeft

Verklaring van de disclaimer

EULA-overeenkomst

Eindklantregistratieflow

Registratietransacties van eindklanten met multifactorauthenticatie (JSON)
Gescande verzendlabels voor alle toepasselijke testcases (PDF/PNG)
Verzendtransacties voor drie labelformaten: PDF, PNG en ZPL (JSON) (voor toepasselijke verzend- en beoordelings-API's)

Best practices om vertragingen te voorkomen

Labels moeten worden afgedrukt en gescand met minimaal 600 DPI.
Thermische printerlabels moeten overeenkomen met het printermodel (bijvoorbeeld ZPLII voor Zebra-printers).
Voor FedEx International Express®-zendingen is een aanvullend luchtvrachtbrief-label vereist.
Voor zendingen die uit meerdere pakketten bestaan (MPS), moet er per pakket één label zijn.

Labelbeoordeling

Het validatieteam zal uw inzending goedkeuren of afkeuren.

Als uw zending wordt afgekeurd, moet u wijzigingen aanbrengen en uw zending opnieuw indienen op basis van feedback

Als uw zending wordt goedgekeurd, ontvangt u een e-mailadres ter bevestiging van de geslaagde validatie. Zodra u de e-mail hebt ontvangen, worden uw productiereferenties geautoriseerd voor transacties met verzendlabels.

Volg de postvalidatie-instructies

Controleer en implementeer alle vereisten voor postvalidatie indien nodig.

5 Naar productie verplaatsen

Zodra u bericht hebt ontvangen dat uw productiesleutels zijn goedgekeurd, haalt u uw productiesleutels op via het tabblad Projectoverzicht.

Kopieer en sla uw API-productiesleutel en geheime sleutel veilig op.
De geheime sleutel wordt slechts één keer weergegeven. Als u de sleutel kwijtraakt, moet u een nieuwe genereren.