FedEx-integratörsleverantör | 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. Välj Skapa eller gå med i organisation i navigeringsfältet.

2. Ange följande uppgifter:

Under Jag arbetar för ett företag som väljer du Säljer eller tillhandahåller en programvarulösning som använder FedEx-teknik och vill registreras som en verifierad integratörsleverantör
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.
Ange en officiell e-postadress där företagets domän ingår, landet eller området där företag är registrerat och de länder och områden där du säljer eller distribuerar din programvarulösning.

3. Välj Nästa.

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

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.

Obs! Använd ditt eget kontonummer – du får inte använda en kunds FedEx-kontonummer.

2. Välj Lägg till ett faktureringskonto.

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

Obs! Faktureringsadressen måste stämma överens med den adress som angavs när kontot skapades. Det här kontot blir din organisations standardfaktureringskonto.

4. Välj ett autentiseringsalternativ.

Alternativet telefonsamtal är endast tillgängligt för integratörer i USA och Kanada.

5. Ange den autentiseringskod som du fått och välj Skicka.

6. Läs och godkänn Avtalet för FedEx-integratörer.

Bjuda in användare som administratör

1. Navigera till Hantera organisation och välj fliken Användare.

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

3. Ange följande uppgifter:

Land eller område
Önskat språk

4. Välj en användarroll (läsare, deltagare eller administratör).

5. (Valfritt) Tilldela användaren till ett projekt.

Du kan när som helst tilldela användare från projektets översiktssida.

6. 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. Inbjudan är giltig i 24 timmar.

Skapa en organisation

2 Skapa ett projekt

Skapa ett projekt

1. Navigera till Mina projekt från menyn och välj + Skapa ett projekt.

2. Ange ett Projektnamn.

Rekommenderat namnformat är Projektnamn_applikationsnamn. Välj Nästa när du är klar.

3. Välj de API:er och Advanced Integrated Visibility-produkter som du vill ta med i ditt projekt.

Advanced Integrated Visibility-produkter är endast tillgängliga för FedEx-integratörsleverantörer i USA.
Om du väljer betalda produkter uppmanas du att tilldela ett faktureringskonto till projektet och du måste godkänna de obligatoriska villkoren.

Tilldela ett faktureringskonto

Obs! Detta krävs endast om du väljer en betald produkt.

1. Tilldela ett faktureringskonto från listan över konton som lagts till i organisationen. Faktureringskonton måste vara baserade i USA.

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

Konfigurera Advanced Integrated Visibility i ett projekt

Förutsättningar

Granska prissättning: Prenumeranter debiteras en månadsavgift baserat på antalet spårningsnummer. Mer information om priser finns i Beställningsformuläret.
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.

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. 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 Validera ditt API

Om du vill flytta dina API:er till produktion måste de först valideras. Vilken valideringsnivå som krävs varierar för olika API:er. 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. Identifiera testfall för de regioner eller områden där du vill distribuera din lösning. Mer information finns i testfallen för integratörstestet.

4. Slutför registreringstransaktioner med hjälp av de tillhandahållna testkontonumren innan du börjar köra testfallen.

5. Slutför alla nödvändiga testfall.

6. Ange dina kontaktuppgifter och dina val av FedEx-tjänster i Produktinformationsbladet (PIW).

7. Fyll i Validation Cover Sheet för integratörer.

Skicka filer

Skicka alla nödvändiga material till validationmtp@fedex.com.

1. Förbered följande filer:

Ifyllt PIW (PDF)
Ifyllt Validation Cover Sheet (PDF)
Registreringstransaktioner för slutkunder med flerfaktorsautentisering (JSON)
Skannade försändelseetiketter för alla tillämpliga testfall (PDF eller PNG)
Frakttransaktioner för tre etikettformat (PDF, PNG och ZPL (JSON)) för tillämpliga frakt- och pris-API:er
Skärmbilder (PDF) som visar följande:
- Kundens vy i en lösning som visar tjänster specialhantering från FedEx
- Ansvarsfriskrivning
- Slutanvändaravtal (EULA)
- Registreringsflöde för slutkunder

2. Komprimera alla filer i en enda .zip-fil för att undvika att överskrida e-postleverantörers storleksbegränsningar.

3. Skicka zip-filen till valideringsteamet i ett e-postmeddelande.

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

Följande riktlinjer kan minska granskningstiden:

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.
För FedEx International Express® ska du även bifoga reservfraktsedeln (AWB).
Bifoga en etikett för varje paket i en flerkolliförsändelse (MPS).

Utvärdering av etiketter

Valideringsteamet granskar det du har skickat in.

Om materialet avvisas ska du åtgärda det utifrån den återkoppling du fått och skicka in det på nytt.
Om materialet godkänns får du en bekräftelse om det via e-post. Efter godkännande blir dina autentiseringsuppgifter för produktion godkända för transaktioner för försändelseetiketter.

5 Flytta till produktion

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

2. Gå till avsnittet API:er och kopiera och spara din API-produktionsnyckel och din hemliga nyckel på ett säkert sätt.

Obs! Spara din hemliga nyckel på en säker plats, eftersom den bara visas en gång. Om du skulle tappa bort den kan du skapa en ny senare.