Kom i gang

Start din integration som en FedEx-kompatibel udbyder ved at udnytte de fordele, der leveres med FedEx API'er. Følgende instruktioner vil guide dig gennem hvert trin i processen med at udvide FedEx-funktioner og -indstillinger i din løsning.


Trin 1:

Gennemse API'er for at afgøre, hvad du har brug for til din applikation.

  • Gå til API-katalog for at bestemme de rigtige API'er til din applikation.
  • Vælg en API for at se dens oversigt, ændre log og nøglefunktioner.
Skærmbillede af siden Prisoversigt
  • Se API-dokumenter for at se flere eksempler på anmodnings- og svarelementer i dit valg af programmeringssprog, fejlkoder og meget mere.
Skærmbillede af siden Prisdokumentation
  • Se Meddelelser for planlagte serviceopdateringer, og se, hvad der er nyt.

Trin 2:

Tilmeld dig, eller log ind for at begynde at integrere med FedEx API'er.

  • Log ind med dit fedex.com bruger-ID og din adgangskode for at begynde at integrere med FedEx API'er.
  • Hvis du endnu ikke har et bruger-id, kan du tilmelde dig gratis.

Trin 3:

Opret eller tilmeld dig en organisation.

Du skal enten oprette en organisation, hvis der endnu ikke findes en for din virksomhed, eller tilmelde dig din virksomheds eksisterende organisation. Du kan have mange brugere, der er tilknyttet til din organisation, men du kan ikke have mange organisationer tilknyttet til et bruger-id.

Hvis du opretter din organisation, vises du automatisk som administrator for den organisation. En administrator kan invitere brugere til at deltage i deres organisation, tildele dem roller og projekter samt administrere forsendelseskonti. Hvis du vil vide mere om, hvilke roller der er bedst for hvem, skal du se vores Vejledning til organisationsadministration. Hvis du vil oprette din egen organisation, skal du klikke på Mine projekter og derefter klikke på knappen "Opret organisation". Denne knap vises kun, hvis du endnu ikke har tilknyttet dit bruger-id til en eksisterende organisation. Derfra kan du begynde at oprette en organisation ved at udfylde følgende (alle markeret med en * er valgfrie):

  • Indtast et organisationsnavn.
  • Indtast e-mailadresser for alle de teammedlemmer, du gerne vil invitere. De tilføjes automatisk som en fremviser, der ikke er knyttet til nogen projekter.*
skærmbillede af siden Opret din organisation

Du kan også tilmelde dig din virksomheds organisation ved at udføre følgende:

  • Hvis din virksomhed allerede har oprettet en organisation, skal du bede organisationens administrator om at invitere dig til at deltage. Du har 24 timer til at acceptere deres invitation, men hvis du ikke når det indenfor dette tidsrum, kan du bede dem om at sende invitationen igen.
  • For at acceptere invitationen skal du enten logge ind med dit eksisterende bruger-id og din adgangskode eller oprette et nyt, hvis dit eksisterende bruger-id allerede er tilknyttet en organisation.

Trin 4:

Tilføj en forsendelseskonto.

En administrator kan tilføje lige så mange forsendelseskonti, som det er nødvendigt under organisationen. For at begynde skal du klikke på knappen "Tilføj konto" på fanen Forsendelseskonti på siden Administrer organisation. Derfra kan du tilføje en eksisterende forsendelseskonto til din organisation ved at udføre følgende trin:

  1. Fuldstændige kontooplysninger
  • Indtast dit kontonummer, et hvilket som helst kontonavn og faktureringsadresse, der er knyttet til kontoen. Dette vil blive valideret for at være sikker på, at det stemmer overens med kontooplysningerne for at forhindre svigagtige aktiviteter.

  • Gå til Ship Admin-siden for at se forsendelseskonti tilknyttet dit bruger-id. Kontakt din FedEx-salgsrepræsentant for at oprette nye forsendelseskonti.

skærmbillede af siden Tilføj forsendelseskonto
  1. slutbrugerlicensaftale
skærmbillede af siden Udfør slutbrugerlicensaftale

Trin 5:

Føj brugere til din organisation for at begynde at samarbejde med dine kolleger.

En administrator kan invitere brugere til deres organisation og tildele dem roller og projekter. For at starte skal du klikke på knappen "Tilføj brugere" på fanen Brugere på siden Administrer organisation. Derfra kan du begynde at tilføje brugere ved at foretage følgende trin (alle markeret med en * er valgfrie):

  1. Indtast e-mailadresse for den eller de brugere, der skal tilmelde sig din organisation. Indtast flere e-mailadresser ved at trykke på et mellemrum, komma, semikolon eller indtastningstast på dit tastatur.
  2. Vælg en rolle, hvis standardindstillingen Fremviser ikke svarer til brugernes behov.*
  3. Vælg et projekt, der er tilknyttet din organisation, som brugerne skal tildeles. Hvis du endnu ikke har oprettet et, dækkes det i det næste trin.*
skærmbillede af siden Tilføj brugere

En administrator har altid adgang til alle projekter, men en bidragyder eller fremviser skal tildeles et projekt, medmindre bidragyderen oprettede projektet. Uanset om en bruger har accepteret invitationen eller ej, kan du hurtigt opdatere deres projekter eller roller direkte fra fanen Brugere på skærmen Organisationsadministration. Det eneste, du skal gøre, er at klikke på cirkumflekset ved siden af rollen eller projektet. Så vises der en rullemenu med de valgmuligheder, som du kan vælge imellem. Foretag dit valg, og vælg knappen "Anvend" for at gemme valget.

skærmbillede af siden Administrer organisation

Trin 6:

Opret et projekt for at få legitimationsoplysninger.

På siden Mine projekter kan en administrator eller bidragyder oprette et projekt ved at vælge knappen "Opret projekt". Derfra kan de begynde at oprette et projekt ved at udføre følgende trin (alle markeret med en * er valgfrie):

1. Konfigurer projekt        

  • Giv dit projekt et identificerbart navn, der er unikt for din organisation.
  • Start med at vælge mindst et API, som skal føjes til dit projekt. Du kan altid tilføje eller fjerne API'er senere.         
skærmbillede af trin 1 for at oprette et projekt 

2. Acceptér vilkår

skærmbillede af trin 2 for at oprette et projekt
       
         3.  Konfigurer dit projekt
 
  • Vælg de lande, du planlægger at sende indenfor, så vi kan tildele dig en testkonto til forsendelse. For at kunne teste forsendelsespakker indenlandsk i et europæisk land skal du have en separat testkonto for hvert land. Du kan altid tilføje eller fjerne lande på et senere tidspunkt.*
  • Vælg Ja, hvis du planlægger at bruge FedEx SmartPost® Returns eller FedEx Freight® LTL.*
  • Når du klikker på knappen "Opret", vil du se en bekræftelsesskærm. I dit nye projekt kan du nu se dine testoplysninger. 
skærmbillede af trin 3 for at oprette et projekt

Trin 7:

Integrer API'er i din applikation, og test din implementering.

  1. Hent testoplysninger (API-nøgle, hemmelig nøgle og forsendelseskonti) fra fanen Testnøgle på siden Projektoversigt.
skærmbillede af siden testnøgler
  1. Anmod om en OAuth-adgangstoken, der skal bruges til hver API-transaktion. Sessionen for denne token er kun gyldig i en time, så du bliver nødt til at programmere din applikation for at opdatere tokenen, før sessionen udløber. Se API-godkendelsesdokumenterne for flere detaljer.
  2. Vælg dokumenter til API'erne på din testtasteside, og læs forretningskonteksten for bedst at forstå, hvordan du bruger det valgte API. Gennemse eksempler på forespørgsler for det slutpunkt, der matcher din ønskede integration.
  3. Implementér dine opkald til disse slutpunkter som beskrevet i eksempelanmodningerne, og konfigurer dem til at bruge dine testoplysninger.
  4. Kontrollér, at de modtagne API-opkaldssvar svarer til dem, der er vist i dokumentationen.
  5. Test din implementering fuldstændigt i FedEx-testmiljøet ved hjælp af testoplysningerne og FedEx' test-URI'er.

Trin 8:

Flyt dit projekt til produktion.

Klik på fanen Produktionsnøgle på siden Projektoversigt. Derfra kan du begynde at flytte dit projekt til produktion ved at udføre følgende trin (alle markeret med en * er valgfrie):

  1. Konfigurer projekt.
  • Omdøb din produktions-API-nøgle.*
  • Der skal tilføjes en forsendelseskonto på dette tidspunkt, men du kan tilføje flere, efter at dit projekt er flyttet til produktion. Hvis du ikke har nogen forsendelseskonti tilknyttet din organisation, eller hvis slutbrugerlicensaftalen ikke er underskrevet for forsendelseskonti, der er føjet til din organisation, vises de ikke i rullemenuen.
skærmbillede af trin 1 på siden produktionsnøgler
  1. Få projektnøgler.
  • Dernæst vises din produktions-API-nøgle og hemmelige produktionsnøgle. Sørg for at kopiere dem til et sikkert sted.
  • For at holde din hemmelige produktionsnøgle sikker viser vi den kun én gang. Hvis du mister den, kan du oprette en ny.
skærmbillede af trin 2 på siden produktionsnøgler 

Trin 9:

Fuldfør din integration.

  1. Nogle API'er kræver enten basis- eller forsendelsesetiketcertificering til brug i vores produktionsmiljø. Fuldfør certificeringsprocessen for alle API'er i dit projekt med dette krav.
skærmbillede af siden certificering
  1. Når alle API'er er blevet certificeret og aktiveret, skal du opdatere dine API-anmodninger ved at erstatte test-URI'er, nøgler og forsendelseskonti med produktions-URI'er, nøgler og forsendelseskonti
  2. Test igen din implementering i produktionsmiljøet ved hjælp af eksempeldata.
  3. Vi håber, du vil nyde fordelene ved din nye integration!


Trin 1: 

FedEx opretter en kompatibel udbyderorganisation.

  • FedEx vil oprette en organisation og inviterer derefter et teammedlem til at deltage i organisationen. Denne bruger udpeges som “administrator” for din organisation.
  • Når certificering og integration er udført, kan du nemt sende løsningen til dine kunder.

Trin 2:

Accepter invitation.

  • Accepter invitationen for at få adgang til API-integrationsdele og dokumentation. For at acceptere invitationen skal du enten logge ind med dit FedEx-bruger-id og din adgangskode eller oprette nye, hvis du ikke allerede har legitimationsoplysninger.
skærmbillede af Tilmeld dig for at begynde at integrere med FedEx API-side

Trin 3:

Inviter brugere til din organisation.

  • Som administrator kan du invitere alle teammedlemmer, der skal have adgang til projektet eller organisationen. Hvis du ønsker at vide mere om de forskellige roller, skal du se Vejledning til organisationsadministration.
skærmbillede af Administrer organisationsbrugeres side
  • Hvis din organisation allerede er oprettet, skal du bede organisationens administrator eller FedEx om at invitere dig til at deltage. Du har 24 timer til at acceptere deres invitation, men hvis du ikke når det indenfor dette tidsrum, kan du bede dem om at sende invitationen igen.

Trin 4:

Vælg de API'er, du har brug for til din løsning.

  • Gå til API-katalog for at bestemme de rigtige API'er til din løsning. Din FedEx Customer Technology Consultant (CTC) og Compatible Channel Manager kan hjælpe dig med at vælge de rigtige API'er til din løsning efter dine forretningsbehov.

skærmbillede af API-katalogside
  • Vælg en API for at se en oversigt, ændre logfiler og nøglefunktioner.

skærmbillede af oversigtsside for API til adressebekræftelse
  • Se dokumentation til API'er for at se anmodnings- og svarelementer, eksempler på dit valgte sprog, fejlobjekter og mere.

skærmbillede af dokumentationsside for API til adressebekræftelse
  • Gå tilbage til Salesforce for at udfylde produktinformationsarket (PIW) og angiv de API'er, du gerne vil føje til din løsning.


Trin 5:

FedEx opretter projekt(er).

Når produktinformationsarket (PIW) er godkendt, opretter FedEx dit/dine projekt(er). Hver version af hver af dine løsninger har et separat projekt på FedEx Developer Portal. Hvis en bruger ikke er en administrator i organisationen, skal de inviteres for at se hvert projekt. 

Dette er også det tidspunkt, hvor FedEx Compatible-teamet sammen med FedEx CTC og certificeringsteams vil organisere en teknisk demonstration af API'erne sammen med dit team. FedEx-teamet vil diskutere de nye muligheder og funktioner, der er tilgængelige med den version af API'er, du anvender. Teamet vil være i stand til at løse tekniske spørgsmål vedrørende API'er, API-afprøvning og alle processer, der skal afsluttes for at starte processen med 'certificering*' for API'er.

* Certificering – Processen defineret af det FedEx Compatible-program for at opfylde kravene til programoverensstemmelse. Der kræves kompatibel programcertificering for at sikre, at alle kompatible udbydere implementerer, markedsfører og distribuerer FedEx-teknologi til afsendere (kunder) som defineret af FedEx-teknologi og servicestandarder.


Trin 6:

Integrer API'er i din applikation, og certificer til det kompatible program.

  1. Du har nu adgang til din Test API-nøgle og Test hemmelig nøgle for at starte kørsel af transaktioner. Hent dem fra fanen Testnøgle på siden Projektoversigt.
skærmbillede af fanesiden Projektoversigtstestnøgle
  1. For at oprette kundenøgler skal du bruge legitimationsregistrerings-API'en, som kun er en privat API, der findes i API-sektionen i hvert af dine projekter.
  2. Når du har oprettet et par kundenøgler, skal du fortsætte og anmode om et OAuth-adgangstoken, der skal bruges sammen med hver API-transaktion. Sessionen for denne token er kun gyldig i en time, så du bliver nødt til at programmere din applikation for at opdatere tokenen, før sessionen udløber. Se API-godkendelsesdokumenterne for flere detaljer. Når du ser kodeeksempler, skal du sørge for, at der er valgt "Forhandler" i rullemenuen for eksempler.
skærmbillede af eksempelkode-"prøve"-rullemenu for API-side til registrering af legitimationsoplysninger
  1. Vælg dokumenter til API'erne på din testtasteside, og læs forretningskonteksten for bedst at forstå, hvordan du bruger det valgte API. Gennemse eksempler på forespørgsler for det slutpunkt, der matcher din ønskede integration.
  2. Implementér dine opkald til disse slutpunkter som beskrevet i eksempelanmodningerne, og konfigurer dem til at bruge dine testoplysninger.
  3. Kontrollér, at de modtagne API-opkaldssvar svarer til dem, der er vist i dokumentationen.
  4. Test din implementering fuldstændigt i FedEx-testmiljøet ved hjælp af testoplysningerne og FedEx' test-URI'er.
  5. Når du har testet dine løsninger fuldstændig, skal du certificere hver løsning i Salesforce. FedEx vil gennemgå alle de indsendte oplysninger og opdatere dig, når din certificering er godkendt.

Trin 7:

FedEx flytter projekt(er) til produktion.

  • FedEx flytter derefter dit/dine projekt(er) til produktion.
  • Du vil derefter kunne se din produktions-API-nøgle på fanen Produktion på siden Projektoversigt.
skærmbillede af kompatibel version med oprettelseslink vist for fanesiden Projektoversigts-testnøgle

Trin 8:

Opret produktionshemmelig nøgle.

  • Din produktionshemmelige nøgle skal genereres ved at klikke på linket Generer hemmelig i kolonnen Hemmelig nøgle.
  • Du er nu i stand til at teste din implementering igen i produktionsmiljøet ved hjælp af eksempeldata.
  • Vi håber, du vil nyde fordelene ved din nye integration!