FedEx Transportföretag | FedEx Developer Portal

1 Skapa eller gå med i en organisation

Gå med i ditt företags organisation och börja samarbeta med ditt team. Om ditt företag inte redan har en organisation kan du skapa en.

Gå med i en befintlig organisation

1. Begär en inbjudan

Be att organisationens administratör skickar en inbjudan till dig. Du har 24 timmar på dig att acceptera den. Du kan be administratören att skicka en ny inbjudan om den skulle bli ogiltig.

2. Acceptera inbjudan

Logga in med ditt befintliga användar-ID och lösenord. Om ditt ID redan är kopplat till en annan organisation måste du skapa ett nytt ID.

Skapa en ny organisation

När du skapar en organisation blir du administratör för den. Som administratör kan du bjuda in användare att gå med i organisationen, tilldela projekt och användarroller samt hantera faktureringskonton.

Mer information om användarroller finns i Riktlinjer för organisationsadministration.

1. Logga in i FedEx Developer Portal.

2. Välj Mina projekt på menyn och välj sedan Skapa en organisation.

3. Ange följande uppgifter:

Under Jag arbetar för ett företag som: väljer du Skickar försändelser med FedEx och behöver integrera FedEx API:er i sina egna applikationer.
Ange ditt företagsnamn, företagets webbplats och ett organisationsnamn som ditt team kommer att känna igen, exempelvis relevant företagsnamn, avdelning, filial eller region.

4. Välj Skapa.

Du kan uppdatera eller lägga till uppgifter senare från menyn, under Hantera organisation.

Lägga till ett försändelsekonto

1. Välj Lägg till försändelsekonton i panelen Lägg till konton. Om du inte har något Fedex-konto väljer du Skapa ett konto om du vill öppna ett nytt konto eller kontaktar supporten hos FedEx.

2. Välj + Lägg till konto.

3. Ange ditt FedEx-kontonummer, ett alias för kontot och den faktureringsadress som du använde när du skapade kontot.

4. Acceptera slutanvändaravtalet eller vidarebefordra det till en behörig representant för ditt företag.

Lägga till ett faktureringskonto

1. Välj fliken Faktureringskonton. Om du inte har något FedEx-faktureringskonto väljer du Öppna ett faktureringskonto om du vill öppna ett nytt konto eller kontaktar supporten hos FedEx.

2. Välj Lägg till ett faktureringskonto. Faktureringskonton måste vara baserade i USA.

3. Ange ditt FedEx-kontonummer, ett alias för kontot och den faktureringsadress i USA som du använde när du skapade kontot.

4. Läs och godkänn slutanvändaravtalet.

Bjuda in användare som administratör

1. Välj Manage Organization från menyn och välj sedan fliken Users .

2. Välj + Lägg till användare.

3. Välj ett land eller område och ett språk och välj sedan en användarroll: läsare, deltagare eller admin.

4. (Valfritt) Tilldela användaren till ett projekt. Du kan när som helst tilldela användare från sidan Översikt för projektet.

5. Ange användarnas e-postadresser och klicka på Bjud in. Du kan bjuda in högst 20 användare åt gången, och deras e-postadresser ska avgränsas med kommatecken. Inbjudningar upphör att gälla efter 24 timmar.

Skapa en organisation

2 Skapa ett projekt

Skapa ett API-projekt

1. Välj Mina projekt från menyn, välj fliken API:er och välj sedan + Skapa API-projekt.

2. Bekräfta dina API-behov.

3. Välj de API:er som ska tas med i ditt projekt.

4. Skapa ett projektnamn och välj de länder som du planerar att skicka försändelser till, så får du ett testkonto. Om du vill kunna testa inrikesförsändelser inom Europa måste du ha ett separat testkonto för varje land. Du kan lägga till eller ta bort länder senare.

5. Välj Inställningar under Aviseringar för att välja aviseringsalternativ.

6. Läs och acceptera villkoren.

Skapa ett Advanced Integrated Visibility-projekt

Förutsättningar

Granska prissättning: Prenumeranter debiteras en månadsavgift baserat på antalet spårningsnummer. Mer information om priser finns i prislistan.
Skapa konton: För Shipment Visibility-webhookar krävs ett USA-baserat faktureringskonto och minst ett försändelsekonto. De två kontotyperna är ömsesidigt uteslutande. Endast administratörer kan lägga till fakturerings- och försändelsekonton på sidan Hantera organisation.

1. Skapa en destinations-URL i din applikation eller plattform så att den kan ta emot återanrop. URL-adressen måste uppfylla följande krav:

Den ska använda HTTPS
Den ska inte innehålla IP-intervallet RFC1918, underdomäner till fedex.com eller direkta IP-adresser som localhost eller 127.0.0.1

2. Skapa en säkerhetstoken för autentisering Token måste uppfylla följande:

Den ska innehålla 26–100 tecken, varav minst en ska vara stor bokstav, minst en ska vara liten bokstav, och minst en ska vara en siffra

3. Välj sedan Advanced Integrated Visibility från menyn Mina projekt.

4. Välj Skapa ett Advanced Integrated Visibility-projekt.

5. Välj användartyp.

FedEx-avsändare: skickar försändelser med FedEx och behöver integrera FedEx API:er i sina egna applikationer
FedEx Compatible Provider: är en certifierad FedEx- Compatible Provider
FedEx Integratörsleverantör: Säljer eller tillhandahåller en programvarulösning som använder FedEx-teknik och är en verifierad integratörsleverantör

6. Välj prenumerationstyp. Du kan prenumerera på händelser antingen per kontonummer eller per spårningsnummer.

7. Bekräfta faktureringskontot och markera önskade funktioner, såsom leveransbevis, beräknad leverans, spårningshändelser eller händelsebaserad filtrering.

8. Ange projektinformation.

Ange ett unikt och lättidentifierat projektnamn.
Ange den destinations-URL och en säkerhetstoken som du skapade.
Ange en e-postadress och önskat språk för meddelanden om uppdateringar och driftsstatus för Advanced Integrated Visibility.

9. Godkänn licensavtalet för FedEx Developer Portal och orderformuläret och välj sedan Skapa.

Obs! Beroende på vilken prenumerationstyp du har valt kan du behöva utföra ytterligare steg. Mer information finns i vår Webhook-dokumentation.

GÅ TILL MINA PROJEKT

3 Testa din integrering

Verifiera din API-integrering och bekräfta att din applikation kan skicka och ta emot testdata genom att utföra stegen nedan.

Skaffa autentiseringsuppgifter för tester

1. Välj Mina projekt på menyn och välj sedan projektets namn.

2. Hitta dina autentiseringsuppgifter för testet på fliken API-nycklar, under Testnyckel.

3. Logga in och hämta JSON API-samlingen med hjälp av knappen Ladda ned JSON-schema, som visas längst upp på dokumentationssidan. Granska exempelbegärandena för slutpunkterna som din integrering använder.

4. Begär en OAuth-åtkomsttoken, som måste användas för varje API-transaktion.

Obs! Token är giltig i en timme, och du kan konfigurera applikationen för att uppdatera den innan den upphör att gälla. Mer information finns i API Authorization-dokumentationen.

5. Välj API-katalog på menyn, välj det API som du vill arbeta med och välj sedan Dokumentation.

6. Välj slutpunkten från menyn.

7. Skicka exempelbegäranden med dina autentiseringsuppgifter för testet och FedEx URL-adress för testet, och bekräfta sedan att svaren stämmer överens med exemplen i dokumentationen. Mer information finns i guiden för virtualisering i sandlådemiljö.

8. Kör tester med Advanced Integrated Visibility för att generera exempeldata och bekräfta att din applikation bearbetar spårningsinformationen på rätt sätt.

Obs! Din URL för återanrop autentiseras inte med hjälp av testet. Mer information finns i dokumentation för Advanced Integrated Visibility.

4 Flytta till produktion

Flytta ditt projekt till produktionsmiljön

Ställ in projektets produktionskonfiguration innan du aktiverar det. Du kan byta namn på nyckeln, lägga till ytterligare konton efter att projektet har aktiverats och granska kontonumret som valdes när projektet skapades. Det kontonumret används för att flytta projektet till produktionsmiljön.

Obs! Kontonummerbaserade Advanced Integrated Visibility-projekt behöver inte aktiveras för produktionsmiljön.

1. Välj Mina projekt på menyn och välj sedan projektets namn.

2. Välj fliken Produktionsnyckel .

3. Hämta och spara dina autentiseringsuppgifter för produktion på ett säkert sätt.

Kopiera API-produktionsnyckeln och den hemliga nyckeln till en säker plats.
När du begär en produktionsnyckel bör du spara den på en säker plats eftersom den endast visas en gång. Om du tappar bort den kan du skapa en ny senare.

4. Välj Nästa för att visa information om projektet på fliken Produktionsnyckel.

Klicka på Redigera längst upp i försändelsekontotabellen för att lägga till fler försändelsekonton.

5 Validera ditt API

Validera ditt API

Vissa API:er kräver validering av försändelseetiketter innan de kan användas i produktionsmiljön. Granska valideringskraven för API:er innan du börjar.

1. Välj Mina projekt på menyn och välj sedan projektets namn.

2. Hitta dina autentiseringsuppgifter för testet på fliken API-nycklar, under Testnyckel.

3. När testet är klart kan du flytta projektet till produktionsmiljön i FedEx Developer Portal och påbörja valideringsprocessen.

När du begär en produktionsnyckel bör du spara den på en säker plats eftersom den endast visas en gång. Om du tappar bort den kan du skapa en ny senare.

4. Uppge nödvändiga uppgifter på etikettens försättsblad, inklusive kontaktuppgifter, de tjänster du vill implementera, ditt kontonummer och din API-produktionsnyckel.

5. Skapa testetiketter i FedEx testmiljö och skicka dem sedan till streckkodsteamet hos FedEx för granskning. Etikettgranskningen kan ta tre arbetsdagar.

Bästa praxis för att undvika förseningar:

Skriv ut och skanna etiketter med en upplösning på minst 600 DPI. Skicka inte filer som genererats direkt från API:erna.
Om du använder termoskrivare ska du begära den bildtyp som stämmer överens med din skrivare, exempelvis ZPLII för Zebra-skrivare.
Använd giltiga adresser för transportföretag och mottagare på dina exempeletiketter. Skapa etiketter endast för de tjänster som du planerar att använda.
För FedEx postförskott (C.O.D.) ska C.O.D.-returetiketten tas med.
För FedEx International Express® ska du även bifoga reservfraktsedeln (AWB).
För flerkolliförsändelser (MPS) ska en etikett skickas in för varje paket.

Skicka in dina material på något av följande sätt:

Skicka PDF-filen och etikettens försättsblad via e-post till label@fedex.com.
Skicka fysiska etiketter med post till:

FedEx Services

WTC-Business Solutions Testing

10 FedEx Parkway

2nd Floor Horizontal

Collierville, TN 38017

Obs! För fysiska etiketter ska du se till att de inte har några synliga defekter som bläcklinjer eller skador. När du skriver ut etiketter ska du inte förstora eller förminska dem.

6. Streckkodsteamet hos FedEx granskar dina inskickade testetiketterna och godkänner eller avvisar dem. Om etiketterna avvisas ska du åtgärda dem utifrån den återkoppling du fått och skicka in dem på nytt.

7. Efter godkännande skickar streckkodsteamet hos FedEx ett e-postmeddelande till dig så snart de har beviljat att dina autentiseringsuppgifter för produktionsmiljön används för transaktioner med försändelseetiketter.

Obs: Godkännande gäller per projekt. Varje nytt projekt måste godkännas för sig.

8. Ersätt testmiljöns URL och autentiseringsuppgifter med produktionsmiljöns URL och autentiseringsuppgifter.

9. Kör ett sista produktionstest med exempeldata för att bekräfta att allt fungerar som förväntat.