Kom igång
FedEx Developer Portal erbjuder en uppsättning programmeringsgränssnitt (API:er) för att integrera FedEx i dina applikationer. De här anvisningarna innehåller information om hur du konfigurerar en organisation, skapar ett projekt, testar din integration, flyttar ett projekt till produktion och, i vissa fall, validerar ditt API.
Typer av användare:
FedEx erbjuder integreringstjänster till tre typer av användare: FedEx avsändare, verifierade programvarulösningar som kallas FedEx Compatible Providers och validerade FedEx-integratörsleverantörer.
FedEx-avsändare:
Företag som skickar med FedEx och behöver integrera FedEx API:er i sina egna applikationer.
Lösning eller tjänsteleverantör:
Företag som behöver integrera med FedEx API:er för att bygga en lösning, applikation eller plugin som kan säljas och/eller distribueras till en extern organisation som skickar försändelser med FedEx.
- FedEx-kompatibel leverantör: Verifierat företag med ett avtal genom programmet för FedEx-kompatibla leverantörer.
- FedEx-integratörsleverantör: Ett validerat företag med ett avtal genom FedEx integratörsprogram.
Välj det alternativ nedan som beskriver din verksamhet bäst. Det finns en upplevelse för dig, oavsett användartyp.
Välj för att komma igång.
Which of the following best describes your business?
Select user
- FedEx Shipper: Company who integrates FedEx APIs into their own applications.
- FedEx Compatible Provider: Company validated by the FedEx Compatible program who integrates with FedEx APIs to build a solution, application or plugin that can be sold and/or distributed to an external organization.
- FedEx Integrator Provider: Validated company with a contractual agreement through the FedEx Integrator Program.
Förutsättningar
Du behöver ett FedEx användar-ID för att logga in i FedEx Developer Portal och skapa en organisation.
Om ditt företag inte har någon organisation kan du skapa en sådan. Du kan också välja att gå med i en befintlig organisation.
Skapa en ny organisation
Klicka på Skapa eller gå med i organisationen i navigeringsfältet.
Obs! När du skapar en organisation blir du automatiskt organisationens administratör.
Administratörer kan:
Bjud in användare att gå med
tilldela användare olika roller (t.ex. deltagare eller läsare) och projekt
hantera försändelsekonton.
Mer information om de olika rollerna finns i vår guide för organisationsadministration.
Företagstypen du ska välja är "Säljer eller tillhandahåller en programvarulösning som använder FedEx-teknik och är en verifierad integratörsleverantör".
Ange företagsnamn och webbplats-URL samt ett unikt organisationsnamn. Organisationsnamnet kan matcha ditt företags namn eller representera en specifik grupp (avdelning, division, region eller plats). Den här informationen krävs för att validera din begäran.
Obs! Välj ett organisationsnamn som alla andra användare kan känna igen (t.ex. företagets namn, en avdelning, ett område eller en plats).
Ange var ditt företag är beläget och var din programvara kommer att säljas eller distribueras.
Lägg till ett faktureringskonto och verifiera kontot
Obs! En transport- och logistikleverantör i FedEx integratörsprogram måste använda sitt eget kontonummer. Kunders FedEx-konton kan inte användas.
Ange ditt FedEx-kontonummer. Om du inte har något befintligt FedEx-konto kan du öppna ett konto på fedex.com eller kontakta FedEx kundtjänst.
Ange ett alias för kontot och faktureringsadressen som är kopplad till kontot. Välj Nästa.
Obs! Faktureringsadressen måste stämma överens med våra registrerade uppgifter för det här konto. Det kommer att bli standardfaktureringskontot för din organisation.
Innan du kan slutföra skapa din organisation måste du verifiera ditt konto. Välj ett verifieringsalternativ (telefon – endast tillgänglig för integratörer i USA och Kanada, e-post eller SMS) och markera Nästa.
När du får din autentiseringskod ska du ange den och välja Skicka.
Godkänn villkoren
Läs det globala integratörsavtalet och programhandboken. Markera kryssrutorna för att bekräfta att du godkänner villkoren och välj sedan Accepterar.
Ett bekräftelsefönster visas. Du kan klicka på Hantera organisation för att redigera detaljer om det behövs.
Bjud in användare
Obs! Endast administratörer kan bjuda in användare.
Välj hantera organisation från navigeringsmenyn till vänster.
Gå till fliken Användare och välj Lägg till användare.
Fyll i formuläret och tilldela lämpliga roller till de nya användarna: Läsare, deltagare eller administratör.
Läs mer om användarroller i guiden för organisationsadministration.
Du kan tilldela användare till projekt (om tillämpligt) under listrutan Projekt.
Ange e-postadressen för varje användare och klicka sedan på Bjud in.
Gå med i en befintlig organisation
Begära en inbjudan: Be att organisationens administratör skickar en inbjudan till dig. Du har 24 timmar på dig att acceptera den innan den löper ut. Du kan be administratören att skicka om inbjudan om det behövs.
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.
Gå med i en befintlig organisation
Steg 1: Be organisationens administratör att skicka en inbjudan till dig
Om ditt företag redan har skapat en organisation kan du be organisationens administratör att bjuda in dig. Du har 24 timmar på dig att acceptera inbjudan. Om du skulle missa att göra det kan du be administratören att skicka inbjudan igen.
Steg 2: Acceptera inbjudan
För att kunna acceptera inbjudan måste du antingen logga in med ditt befintliga användar-ID och lösenord eller skapa ett nytt konto, om ditt befintliga användar-ID redan är kopplat till en annan organisation.
Skapa ett API-projekt
Gå till sidan Mina projekt och öppna fliken API:er. Klicka på knappen Skapa API-projekt.
Steg 1: Välj det eller de API:er som du vill inkludera i projektet
Granska API-kvoterna, anropsbegränsningarna och uppgifterna för API-validering.
Steg 2: Konfigurera projektuppgifter
- Ge projektet ett identifierbart namn som är unikt för organisationen.
- Välj de länder som du planerar att skicka försändelser i, så skapar vi ett testkonto. Om du vill kunna testa inrikes försändelser av paket i ett europeiskt land måste du ha ett separat testkonto för varje land. Du kan alltid lägga till/ta bort länder vid ett senare tillfälle.
- Välj aviseringsinställningar för att få information om de senaste API-uppdateringarna och eventuell avbrottsrelaterad information.
Steg 3: Läs och godkänn villkoren, inklusive licensavtalet för FedEx Developer Portal
En bekräftelseskärm visas när du har godkänt villkoren och klickat på knappen Skapa. Du kan därefter visa dina autentiseringsuppgifter för tester i det nya projektet.
Skapa ett webbhookprojekt
Förutsättningar
- Prisöversikt: prenumeranter debiteras en månadsavgift baserat på antalet spårningsnummer. Mer information om priser finns i Prislista.
- Skapa konton: För Advanced Integrated 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.
Skapa en giltig URL (ett återanrop) i din destinationsapplikation eller på din destinationsplattform
Din destinations-URL kommer att användas för att ta emot autentiseringskoder och meddelanden samt aviseringar om webhooksbelastning från FedEx. Din URL måste använda HTTPS för att säkerställa säkerheten. Din URL kommer att blockeras om den innehåller något av följande:
- Plats för RFC1918 i IP-adressen
- fedex.com eller någon av dess underdomäner
- Alla med IP-adresser i URL:en (inklusive localhost, 127.0.0.1)
Skapa en säkerhetstoken
Den här säkerhetstoken kan användas som en hemlig nyckel för att autentisera och validera information som överförs mellan din organisation och FedEx. Din säkerhetstoken måste innehålla följande:
- Minst 26 tecken och högst 100 tecken
- En stor bokstav
- En liten bokstav
- Ett numeriskt tecken
Exempel: Y1F6OiVUQW2JPSElmRE9U0IY5
När du har angett en URL och säkerhetstoken är du redo att skapa ett webhookprojekt. Gå till sidan Mina projekt och öppna fliken Webhookar. Klicka på knappen Skapa ett webhookprojekt.
Välj prenumerationstyp
FedEx-avsändare kan få konto- eller spårningsnummer att prenumerera på deras händelser.
Steg 1: Bekräfta faktureringskontot och välj funktioner
- Granska standardfaktureringskontot som anges för att bekräfta eller välj ett annat konto från din organisation.
- Konfigurera ditt projekt genom att välja funktioner som alternativ för leveransbevis, alternativ för beräknad leverans, spårningshändelser och händelsebaserad filtrering.
Steg 2: Ange projektinformation
- Ge projektet ett identifierbart namn som är unikt för organisationen.
- Ange information om din destinations-URL och säkerhetstoken som du skapade under autentiseringen (se stegen ovan).
- Ange en e-postadress och föredraget språk för att få information om de senaste webhookuppdateringarna och eventuell avbrottsrelaterad information.
Steg 3: Läs och godkänn villkoren
En bekräftelseskärm visas när du har godkänt villkoren, inklusive licensavtalet för FedEx Developer Portal och orderformuläret, och klickat på knappen Skapa.
Det kan förekomma fler steg, beroende på ditt val av prenumerationstyp. Du hittar mer information i dokumentationen.
Hämta dina autentiseringsuppgifter för tester–API-nyckel, hemlig nyckel och försändelsekonton – på fliken Testnyckel på sidan API-projektöversikt.
Steg 1: Begär en OAuth-åtkomsttoken
OAuth-åtkomsttoken måste användas med varje API-transaktion. Token är endast giltig i en timme, så du måste programmera applikationen att uppdatera token innan sessionen upphör att gälla. Mer information finns i dokumentationen om auktorisering av API:er.
Steg 2: Granska API-dokumentationen
Klicka på dokumentationen för varje API för att läsa företagskontexten och få en förståelse för hur API:et används. Logga in för att ladda ner JSON API-sviten via knappen högst upp på dokumentationssidan. Du kan även granska exempelbegärandena för slutpunkten som matchar den önskade integreringen.
Steg 3: Använd sandlådemiljön för att testa exempeltransaktioner
Klicka på önskad slutpunkt i den vänstra menyn för att gå till den specifika sandlådemiljön. Identifiera de exempelbegäranden som matchar ditt användningsfall och använd därefter dina autentiseringsuppgifter för tester och FedEx test-URL:er för att implementera dina anrop till slutpunkten på det sätt som beskrivs i exempelbegärandena. Verifiera att svaren på API-anropen stämmer överens med de som visas i dokumentationen. Läs mer om vår testupplevelse i guiden för virtualisering i sandlådemiljö.
Testa med webhookar
Tester kan bidra till att få en bättre uppfattning om huruvida URL:en som du skapade är giltig. Det gör det möjligt för FedEx att identifiera din URL och upprätta en anslutning till URL:en för att skicka data. Tester kan även tillhandahålla exempeltestdata som kan hjälpa dig att kontrollera och bekräfta om du kan behandla spårningsdata som tillhandahålls i din applikation. Testerna autentiserar däremot inte din URL. Läs mer om hur du testar din webbhook-URL i vår webbhookdokumentation.
Gå till sidan Projektöversikt och öppna fliken Produktionsnyckel. Projekt med Advanced Integrated Visibility-prenumeration på kontonummer behöver inte flyttas till produktion.
Steg 1: Konfigurera projektet
- Byt namn på nyckeln efter behov.
- Kontrollera kontonumret som du valde i steg 1 av projektskapandet. Det används för att flytta projektet till produktionsmiljön. När projektet är under produktion kan du lägga till fler konton efter behov.
Steg 2: Hämta projektnycklar
Spara din API-produktionsnyckel och hemliga produktionsnyckel på en säker plats. Av säkerhetsskäl visar vi bara din hemliga nyckel en gång. Om du tappar bort den kan du skapa en ny.
När du har hämtat dina projektnycklar och klickat på Nästa visas din projektinformation på fliken Produktionsnyckel.
- Klicka på Redigera högst upp i försändelsekontotabellen för att lägga till fler försändelsekonton i ditt projekt.
Valideringsstegen varierar beroende på region
Följande steg gäller endast för kunder i USA och Kanada. Gå till sidan API-validering om du bor i ett annat land.
Vissa API:er kräver validering av försändelseetiketter om de ska användas i vår produktionsmiljö. Se om ditt API kräver validering.
Steg 1. Utveckla och testa FedEx API:er med ditt onlinebaserade program
När du har utvecklat ett onlinebaserat program är det dags att slutföra testningen med autentiseringsuppgifterna för testmiljön (konton, API-nyckeln och den hemliga nyckeln för testmiljön). Testmiljöns API-nyckel och hemliga nyckel är alltid tillgängliga på sidan Projektöversikt.
Steg 2: Flytta projektet till produktionsmiljön
När du har testat med FedEx API:er kan du börja valideringsprocessen genom att flytta projektet till produktionsmiljön på FedEx Developer Portal. Du kommer att se produktionsmiljöns API-nyckel och den hemliga nyckeln när du har gjort det. Du kan endast se produktmiljöns hemliga nyckel en gång, men du kan skapa en ny vid ett senare tillfälle.
Steg 3: Fyll i etikettens försättsblad
Fyll i hela etikettens försättsblad med lämpliga kontaktuppgifter och de tjänster som du planerar att implementera. Ange kontonumret och produktionsnyckeln.
Steg 4: Skapa och skicka in testetiketter till streckkodsteamet
Skapa testetiketter i den FedEx-testmiljö som är associerad med applikationen och skicka sedan testetiketterna till FedEx utvärderingsteam för godkännande. Streckkodsteamet behöver tre arbetsdagar på sig för att utvärdera en etikett.
Följ denna bästa praxis för att undvika förseningar:
- Etiketterna måste skrivas ut och skannas med minst 600 DPI. SKICKA INTE FILER SOM SKAPATS AV API:ER.
- Om du använder en termoskrivare måste etikettens bildtyp begäras i enlighet med skrivarmodellen. Exempel: ZPLII for Zebra-skrivare.
- Använd avsändar-/mottagaradressinformation när du skapar provetiketter för utvärdering. Skapa endast provetiketter för de specifika tjänster som du ansöker om.
- Etiketten för FedEx® postförskott (C.O.D.) måste även ha motsvarande returetikett för C.O.D.
- FedEx International Express®-försändelser måste även ha en fraktsedelsetikett (AWB) i reserv.
- Flerkolliförsändelser måste ha en etikett för varje paket i försändelsen.
- Skicka PDF:n och etikettens försättsblad med e-post till label@fedex.com.
- Fysiska etiketter ska skickas till nedanstående adress:
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
De skannade etiketterna kan endast godkännas om de inte har några synliga defekter (t.ex. linjer som går genom streckkoden, fläckar i bläcket eller fysiska skador).
Var uppmärksam på utskriftskvaliteten och oavsiktlig förstoring/förminskning av etiketterna (dvs. skalning) om du skickar etiketter via e-post. Det är de vanligaste anledningarna till varför etiketter inte godkänns.
Steg 5: Granska etikettutvärderingen
Teamet som godkänner streckkoder kommer att utvärdera de inskickade testetiketterna och godkänna eller avslå dem. Streckkodsteamet kommer att kontakta dig angående de inskickade etiketterna. Gå vidare till nästa steg om etiketterna godkänns. Om etiketterna avslås ska du korrigera dem enligt anvisningarna och skicka in dem för godkännande igen.
Steg 6: Aktivera applikationen
När testetiketterna har godkänts för produktionsstatus av streckkodsteamet kommer de att godkänna dina autentiseringsuppgifter för produktion för att överföra den identifierade etikettstransaktionen och meddela dig att valideringen har godkänts via e-post. Godkännandet gäller endast för det specifika projektet.
Steg 7: Ersätt URL:en och autentiseringsuppgifterna
Ersätt testmiljöns URL och autentiseringsuppgifter med produktionsmiljöns URL och autentiseringsuppgifter. Testa implementeringen igen i produktionsmiljön med hjälp av exempeldata.
Förutsättningar
Din verksamhet måste vara en FedEx-kompatibel leverantör. Ändra till ”icke kompatibel leverantör” ovan om din verksamhet inte ingår i programmet för FedEx-kompatibla leverantörer.
Steg 1: Få en inbjudan att gå med i en organisation
FedEx kommer att skapa en organisation och därefter bjuda in en teammedlem att gå med i organisationen. Den användaren kommer att bli administratör för din organisation.
Steg 2: Acceptera inbjudan
För att kunna acceptera inbjudan måste du antingen logga in med ditt befintliga användar-ID och lösenord eller skapa ett nytt konto, om ditt befintliga användar-ID redan är kopplat till en annan organisation.
Steg 3: Bjud in användare
En administratör kan bjuda in användare till sin organisation och tilldela roller och projekt till användarna. Öppna fliken Användare. Klicka på knappen Lägg till användare.
- Välj en användarroll: läsare, deltagare eller administratör. Läs mer om roller i vår guide för organisationsadministration.
- Om du har befintliga projekt tilldelar du ett projekt till användaren. Du kan även tilldela användare till projekt på alla översiktssidor för projekt.
- Ange e-postadresserna till användarna som du vill ska gå med i din organisation under den valda rollen.
Gå till API-katalogen för att välja lämpliga API:er eller webhookar för din lösning. Din FedEx Customer Technology Consultant (CTC) och Compatible Channel Manager kan hjälpa till att välja rätt API:er för din lösning utifrån företagets behov.
Steg 1: Fyll i PIW
Gå tillbaka till Compatible Provider Community (CPC) för att fylla i Product Information Worksheet (PIW).
Steg 2: Granska projektet eller projekten som FedEx har skapat
När PIW har godkänts kommer FedEx att skapa dina projekt. Varje version av varje lösning kommer att ha ett separat projekt i FedEx Developer Portal.
Steg 3: Delta i API-demostrationen med ditt team
FedEx Compatible-teamet kommer att hålla en teknisk demonstration om API:erna för ditt team tillsammans med FedEx CTC- och certifieringsteamen. FedEx-teamet kommer att diskutera Compatible Program Verification och nya API-funktioner samt svara på frågor.
Hämta dina autentiseringsuppgifter för tester–API-nyckel och hemlig nyckel – på fliken Testnyckel på sidan API-projektöversikt.
Steg 1: Skapa kundnycklar
Använd Credential Registration API för att skapa kundnycklar. Det här är ett privat API som du bara hittar i API-avsnittet längst ner på sidan API-projektöversikt.
Steg 2: Begär en OAuth-åtkomsttoken
OAuth-åtkomsttoken måste användas med varje API-transaktion. Token är endast giltig i en timme, så du måste programmera applikationen att uppdatera token innan sessionen upphör att gälla. Mer information finns i dokumentationen om auktorisering av API:er. Se till att välja Återförsäljare i listrutan när du visar exempelkoden.
Steg 3: Granska API-dokumentationen
Klicka på dokumentationen för varje API för att läsa företagskontexten och få en förståelse för hur API:et används. Logga in för att ladda ner JSON API-sviten via knappen högst upp på dokumentationssidan. Du kan även granska exempelbegärandena för slutpunkten som matchar den önskade integreringen.
Steg 4: Använd sandlådemiljön för att testa exempeltransaktioner
Klicka på önskad slutpunkt i den vänstra menyn för att gå till den specifika sandlådemiljön. Identifiera de exempelbegäranden som matchar ditt användningsfall och använd därefter dina autentiseringsuppgifter för tester och FedEx test-URL:er för att implementera dina anrop till slutpunkten på det sätt som beskrivs i exempelbegärandena. Verifiera att svaren på API-anropen stämmer överens med de som visas i dokumentationen. Läs mer om vår testupplevelse i guiden för virtualisering i sandlådemiljö.
Steg 5: Verifiera varje lösning
När du har testat dina lösningar är det dags att skicka in testfallen till verifieringsteamet för att verifiera varje lösning. FedEx kommer att granska allt som du skickar in och uppdatera när din verifiering är godkänd.
Testa med webhookar
Om din organisation har åtkomst till webhookar kan tester hjälpa dig att få en bättre uppfattning om huruvida URL:en som du skapade är giltig. Det gör det möjligt för FedEx att identifiera din URL och upprätta en anslutning till URL:en för att skicka data. Tester kan även tillhandahålla exempeltestdata som kan hjälpa dig att kontrollera och bekräfta om du kan behandla spårningsdata som tillhandahålls i din applikation. Testerna autentiserar däremot inte din URL. Läs mer om hur du testar din webbhook-URL i vår webbhookdokumentation.
FedEx kommer därefter att flytta ditt eller dina projekt till produktion. Gå till sidan API-projektöversikt och öppna fliken Produktionsnyckel. Klicka på länken Skapa hemlig nyckel under kolumnen Hemlig nyckel.
Nu kan du testa implementeringen igen i produktionsmiljön med hjälp av exempeldata.
Förutsättningar
Du behöver ett användar-ID och konto från FedEx för att logga in i FedEx Developer Portal och skapa en organisation.
Du kan antingen skapa en organisation om det inte redan finns en för ditt företag eller gå med i företagets befintliga organisation.
Skapa en ny organisation
Klicka på Skapa eller gå med i organisationen i navigeringsfältet.
Obs! När du skapar en organisation blir du automatiskt organisationens administratör.
Administratörer kan:
bjuda in användare
tilldela användare olika roller (t.ex. deltagare eller läsare) och projekt
hantera försändelsekonton.
Mer information om de olika rollerna finns i vår guide för organisationsadministration.
Företagstypen du ska välja är "Säljer eller tillhandahåller en programvarulösning som använder FedEx-teknik och är en verifierad integratörsleverantör".
Ange företagsnamn och webbplats-URL samt ett unikt organisationsnamn. Organisationsnamnet kan matcha ditt företags namn eller representera en specifik grupp (avdelning, division, region eller plats). Den här informationen krävs för att validera din begäran.
Obs! Välj ett organisationsnamn som alla andra användare kan känna igen (t.ex. företagets namn, en avdelning, ett område eller en plats).
Ange var ditt företag är beläget och var din programvara kommer att säljas eller distribueras.
Lägg till ett faktureringskonto och verifiera kontot
Obs! En transport- och logistikleverantör i FedEx integratörsprogram måste använda sitt eget kontonummer. Kunders FedEx-konton kan inte användas.
Ange ditt FedEx-kontonummer. Om du inte har något befintligt FedEx-konto kan du öppna ett konto på fedex.com eller kontakta FedEx kundtjänst.
Ange ett alias för kontot och faktureringsadressen som är kopplad till kontot. Välj Nästa.
Obs! Faktureringsadressen måste stämma överens med våra registrerade uppgifter för det här konto. Det kommer att bli standardfaktureringskontot för din organisation.
Innan du kan slutföra skapa din organisation måste du verifiera ditt konto. Välj ett verifieringsalternativ (telefon – endast tillgänglig för integratörer i USA och Kanada, e-post eller SMS) och markera Nästa.
När du får din autentiseringskod ska du ange den och välja Skicka.
Godkänn villkoren
Läs FedEx integratörsavtal och programhandboken. Markera kryssrutorna för att bekräfta att du godkänner villkoren och välj sedan Accepterar.
Ett bekräftelsefönster visas. Du kan klicka på Hantera organisation för att redigera detaljer om det behövs.
Bjud in användare
Obs! Endast administratörer kan bjuda in användare.
Välj hantera organisation från navigeringsmenyn till vänster.
Gå till fliken Användare och välj Lägg till användare.
Fyll i formuläret och tilldela lämpliga roller till de nya användarna: Läsare, deltagare eller administratör.
Läs mer om användarroller i guiden för organisationsadministration.
Du kan tilldela användare till projekt (om tillämpligt) under listrutan Projekt.
Ange e-postadressen för varje användare och klicka sedan på Bjud in.
Gå med i en befintlig organisation
Begära en inbjudan: Be att organisationens administratör skickar en inbjudan till dig. Du har 24 timmar på dig att acceptera den innan den löper ut. Du kan be administratören att skicka om inbjudan om det behövs.
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.
Skapa ett API-projekt
Gå till sidan Mina projekt och välj Skapa projekt.
Fyll i fältet Projektnam. Rekommenderat namnformat är ”Projektnamn_applikationsnamn”. Välj Nästa när du är klar.
Välj API- och Advanced Integrated Visibility-produkter för ditt projekt.
Obs! Advanced Integrated Visibility-produkter är endast tillgängliga för FedEx-integratörsleverantörer i USA.
Obs! Om du väljer betalprodukter uppmanas du att tilldela ett faktureringskonto till projektet och du måste godkänna de obligatoriska villkoren.
Tilldela fakturering och godkänn villkoren
Tilldela ett faktureringskonto från listan över konton som lagts till i organisationen. Det här steget är endast nödvändigt om du har valt en betalprodukt vid ett tidigare tillfälle.
Godkänn villkoren som kopplas till produkten.
Bekräfta uppgifterna
Granska dina valda produkter. Verifiera tillhandahållet faktureringskonto.
Granska och godkänn licensavtalet för FedEx Developer Portal.
Klicka på Skapa för att generera projektet och visa autentiseringsuppgifter för tester.
Konfigurera Advanced Integrated Visibility i ett projekt
Förutsättningar
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 Advanced Integrated Visibility 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.
Skapa en giltig URL för återanrop i din destinationsapplikation eller på din destinationsplattform – Din applikations/plattforms URL:
måste använda HTTPS för säkerhet
får inte inkludera IP-utrymme RFC1918, underdomäner till fedex.com eller direkta IP-adresser (t.ex. 127.0.0.1).
Generera en säkerhetstoken
Måste bestå av 26–100 tecken och innehålla:
- en versal
- en gemen
- en siffra
Exempel: Y1F6OiVUQW2JPSElmRE9U0IY5
Konfigurera Advanced Integrated Visibility
Välj Advanced Integrated Visibility. Markera funktioner som leveransbevis, beräknad leverans, spårningshändelser och händelsebaserad filtrering.
Ange din destinations-URL och säkerhetstoken.
Ange en e-postadress för uppdateringar och avbrottsmeddelanden som rör Advanced Integrated Visibility.
Bekräfta uppgifter
Granska och godkänn licensavtalet för FedEx Developer Portal och orderformuläret.
Välj Skapa för att slutföra konfigurationen.
Obs! Fler steg kan tillkomma beroende på ditt val av prenumeration. Läs dokumentationen för ytterligare information.
Hämta autentiseringsuppgifterna för tester och börja utföra tester
Granska API-dokumentation
- Läs API-dokumentationen för utförlig information om våra olika API:er och deras företagskontext samt integreringsprocesser.
- Ladda ned JSON-schemat från relevant API:s dokumentationssida.
- Granska exempelbegäranden för de önskade slutpunkterna.
Få autentiseringsuppgifter för tester
Gå till fliken API-nyckel på sidan Projektöversikt. Du hittar din API-nyckel och hemliga nyckel under rubriken Testnyckel.
Granska API-dokumentation
- Det krävs en OAuth-token för alla API-transaktioner och den upphör att gälla efter en timme.
- Din applikation måste uppdatera din token innan den upphör att gälla.
- Mer information finns i vår API Authorization-dokumentation.
Testa API-transaktioner i sandlådemiljö
- Gå till relevant API i API-katalogen och välj Dokumentation.
- Välj önskad API-slutpunkt i menyn till vänster.
- Använd exempelförfrågningar som matchar ditt användningsfall.
- Implementera API-anrop med dina autentiseringsuppgifter för tester och FedEx test-URL:er.
- Verifiera att svaren matchar dokumentationen.
- Mer information finns i vår Guide för virtualisering i sandlådemiljö.
Testa Advanced Integrated Visibility
När du testar Advanced Integrated Visibility validerar du ditt URL-format och hjälper till att upprätta en anslutning mellan FedEx och din applikation.
Testet tillhandahåller prov på testdata för bearbetning av spårningsinformation.
Obs! Testning autentiserar inte din URL.
Mer information finns i dokumentationen för Advanced Integrated Visibility.
Det krävs en validering för att flytta API:er till produktion. Nivån på valideringen kan variera beroende på API.
Utveckla och testa FedEx API:er
- Använd dina autentiseringsuppgifter för tester (API-nyckel och hemlig nyckel) från sidan Projektöversikt.
- Identifiera alla testfall för de regioner/områden där du vill distribuera din lösning (se testkonton och testfall för integratörer).
- Innan du kör testfallen måste du slutföra registreringstransaktionerna med hjälp av tillhandahållna testkontonummer.
- Utför alla nödvändiga testfall.
Gå till sidan med din Projektöversikt.
Välj Begär produktionsnycklar. FedEx kommer att få din begäran om produktionsnycklar och du kommer att meddelas när de har beviljats.
Fyll i PIW och Validation Cover Sheet
Fyll i produktinformationsbladet (PIW) och Integrator Validation Cover Sheet med dina kontaktuppgifter och planerade FedEx-tjänster.
Leverera filer
Samla ihop och komprimera följande filer i en .zip-fil för att undvika begränsningar från e-postleverantörer. Skicka till validationmtp@fedex.com.
Obligatoriska filer
- Ifyllt PIW (PDF).
- Ifyllt Validation Cover Sheet (PDF).
Skärmbilder (PDF):
Kundanpassad lösning som visar FedEx-tjänster/specialhantering
Ansvarsfriskrivning
Slutanvändaravtal
Flöde för slutkundsregistrering
- Slutregistreringstransaktioner för kunder med flerfaktorsautentisering (JSON)
- Skannade försändelseetiketter för alla tillämpliga testfall (PDF/PNG)
- Försändelsetransaktioner för tre etikettformat: PDF, PNG och ZPL (JSON) (för tillämpliga frakt- och pris-API:er)
Bästa praxis för att undvika förseningar
- Etiketter måste skrivas ut och skannas med minst 600 DPI.
- Etiketter för termoskrivare måste matcha skrivarmodellen (t.ex. ZPLII for Zebra-skrivare).
- FedEx International Express® -försändelser måste även ha en fraktsedelsetikett (AWB) i reserv.
- Flerkolliförsändelser (MPS) måste ha en etikett för varje paket.
Utvärdering av etiketter
Valideringsteamet kommer att godkänna eller avslå det du skickar in.
- Vid avslag kan du göra korrigeringar baserat på den feedback du fick och skicka in igen
- Vid godkännande får du ett e-postmeddelande som bekräftar att valideringen har lyckats. När du har fått e-postmeddelandet kommer dina autentiseringsuppgifter för produktion att godkännas för försändelseetikettstransaktioner.
Följ anvisningarna efter valideringen
Granska och implementera eventuella krav efter valideringen efter behov.
När du har meddelats att dina produktionsnycklar har godkänts kan du hämta dem från fliken Projektöversikt.
- Kopiera och spara din API-produktionsnyckel och hemliga nyckel på ett säkert sätt.
- Din hemliga nyckel visas endast en gång – om du tappar bort den måste du skapa en ny.
