Fedex Logo

OPRET EN
WEBHOOK ADMINISTRER WEBHOOKS

Sådan fungerer Advanced Integrated Visibility

Advanced Integrated Visibility-webhooken giver FedEx mulighed for at sende sikre trackingopdateringer næsten i realtid til en bestemt URL. Disse opdateringer gælder for forsendelser, der er knyttet til et eller flere FedEx-kundenumre. For at bruge denne funktion skal du oprette et Advanced Integrated Visibility-webhookprojekt.

Sådan tilgår du siden Advanced Integrated Visibility

Du kan få adgang til opsætning af Advanced Integrated Visibility på to måder:

Mulighed 1: Via Mine projekter

    1. Gå til Mine projekter i det venstre navigationspanel.

    2. Klik på fanen Webhooks.

    3. Vælg +OPRET ET WEBHOOK-PROJEKT.

Mulighed 2: Via API-kataloget

    1. Åbn API-kataloget fra det venstre navigationspanel.

    2. Søg i Advanced Integrated Visibility.

    3. Brug WEBHOOK-filteret til at finde det rigtige kort.

    4. På kortet:

  •  Klik på Oversigt, derefter på knappen Dokumentation , og vælg +OPRET ET WEBHOOK-PROJEKT.
  •  Eller gå til DOKUMENTER, og klik på +OPRET ET WEBHOOK-PROJEKT.

 

Trin 1: Vælg virksomhedstype

Klik på +OPRET ET PROJEKT, og vælg din virksomhedstype fra rullemenuen:

    1. Sender med FedEx og skal integrere FedEx-webhook i systemet.

    2. Sælger eller leverer softwareløsninger, som anvender FedEx-data og er ikke certificeret FedEx Compatible-udbyder.

    3. Er certificeret FedEx Compatible-udbyder.

 

Vælg derefter Avanceret Integrated Visibility Tracking Number Subscription som dit abonnement.

Opret et Advanced Integrated Visibility Tracking Number Subscription

Du kan oprette et Advanced Integrated Visibility Tracking Number abonnement for at modtage sikre trackingopdateringer næsten i realtid for ét eller flere FedEx-trackingnumre. Disse opdateringer sendes til en destinations-URL, du angiver.

 

Trin til oprettelse af abonnementet

Der er fire primære trin i processen:

    1. Konfigurer projekt

    2. Angiv projektoplysninger

    3. Bekræft oplysninger, og acceptér vilkår

    4. Tilføj trackingnummer

 

Trinvise instruktioner

    1. På siden Konfigurer webhook:

         Kontrollér faktureringskundenummeret

         Din organisations standardfaktureringskontonummer vil blive vist.

         For at ændre det:

  •  Klik på TILFØJ FAKTURERINGSKONTO TIL DIN ORGANISATION (hvis du kun har den ene konto), eller
  •  Klik på VÆLG EN ANDEN FAKTURERINGSKONTO (hvis du har flere konti).

 

Bemærk: Du kan se prisoplysninger på siden Oversigt over Advanced Integrated Visibility .

 

2. Vælg funktioner

  •  Vælg de funktioner, du skal bruge.
  •  Klik på Næste for at fortsætte.

Tip: Hvis du vil vide mere om hver funktion, skal du klikke på ikonet hjælp (?) ved siden af funktionen.

Beskrivelser af funktioner

Feltnavn Beskrivelse
Leveringsbevis Bekræfter, at en forsendelse er blevet leveret. Inkluderer:
  • Billede som leveringsbevis (PPODA): Leverer et billede, der viser det nøjagtige leveringssted.
  • Underskrevet kvittering (SPOD): Leverer et billede af modtagers underskrift, navn, leveringsdato, tidspunkt og adresse.
Forventet levering Hjælper modtagerne med at planlægge ved at tilbyde:
  • Forventet leveringsdato (EDD)
  • Tidsperioden for forventet leveringstid (EDTW)
Trackinghændelser Giver mulighed for at vælge én eller flere hændelseskategorier for at modtage notifikationer:
  • Send
  • I transit
  • Levering
  • Undtagelser

 

Angiv følgende oplysninger på siden Angiv oplysninger:

Feltnavn Beskrivelse
Navn på webhook-projekt Et unikt, udfyldt navn til dit webhook-projekt. Et foreslået navn udfyldes automatisk, men kan redigeres. Navnet må ikke gentages i nogen anden webhook.
Destinations-URL Det sikre HTTPS-slutpoint, hvor FedEx sender trackinghændelsesdata.
Krav:
  • Skal være gyldig og fungerende
  • Skal følge standardiseret syntaks
  • Må ikke indeholde fedex.com eller dets underdomæner
  • Kan genbruges på tværs af flere webhooks
Se afsnittet Forretningsregler og Bedste praksis for at få flere oplysninger.
Sikkerhedstoken Anvendes som delt hemmelighed til at godkende og validere webhook-svar via HMAC.
Krav:
  • 26 - 100 tegn
  • Skal indeholde mindst ét stort bogstav, ét lille bogstav og ét tal
  • Kan genbruges på tværs af flere webhooks
Datasprog (land) Vælg det foretrukne sprog for oversættelse af trackingdata fra rullemenuen.
Tracking-type Vælg, hvordan trackingdata skal leveres:
  • Detaljeret tracking – Fuld hændelseshistorik
  • Hændelsesspecifik tracking – Kun den seneste hændelse
E-mailadresse Angiv en gyldig e-mailadresse for at modtage notifikationer.
E-mail-sprog (land) Vælg det fortrukne sprog til e-mailnotifikationer.
Bemærk: Kun amerikanske landeindstillinger understøttes (f.eks. en-US, es-US).

3. På siden Bekræft oplysninger:

  •  Gennemse detaljerne i dit webhook-projekt.
  •  Tjek og acceptér vilkår og betingelser.
  •  Klik på Opret for at afslutte opsætningen af webhook-projektet.

4. Når din anmodning er afsendt:

  •  FedEx opretter et nyt webhook-projekt.
  •  Du modtager produktionsnøgler til Advanced Integrated Visibility Tracking Number Subscription API.
  •  Du kan bruge denne API til at tilknytte trackingnumre til dit projekt.

For at få mere at vide henvises du til siden med dokumentation for Advanced Integrated Visibility Tracking Number Subscription API.

Sådan tilføjer du et trackingnummer til en webhook

For at tilføje et trackingnummer til dit webhook-abonnement ved brug af Advanced Integrated Visibility Tracking Number Subscription API skal du følge disse trin:

 

Trinvis proces

1. Opret et abonnementsprojekt

· Følg trinnene fra forrige afsnit, eller se vejledningen Kom godt i gang.

2. Generér et OAuth-token

  •  Du skal bruge et OAuth-token for at foretage API-opkald.
  •  Brug Authorization API'en til at generere tokenet.
  •  Se dokumentationen for Authorization API i API-kataloget for detaljerede trin.

3. Tilgå API-dokumentation

  • Klik på Projektoplysninger i navigationsmenuen til venstre.
  • Under fanen Produktionsnøgler skal du scrolle ned og finde dokumentation for Advanced Integrated Visibility Tracking Number Subscription API.

Oversigt over API-slutpunkter

Slutpunkt Formål
Track Number Association Tilføj eller fjern trackingnumre til eller fra et givent webhook-abonnement. Dette er et asynkront job. Et job-id returneres i svaret.
Track Number Job Details Indeholder oplysninger om et bestemt job-id, f.eks. hvor mange trackingnumre der blev tilføjet eller stadig behandles.
Track Number Job Status Returnerer en oversigt over alle job, der i øjeblikket behandles.

 

Brug OAuth-tokenet fra trin 2 med Track Number Association-slutpunktet for at tilføje trackingnumre til din webhook.

Valideringsregler

  •  Webhook-navnet skal være unikt.
  •  Destinations-URL'en skal følge standardiseret syntaktisk format.
  •  Alle påkrævede felter skal udfyldes.
  •  Mindst ét gyldigt FedEx-forsendelseskundenummer skal være tilknyttet.

 

Valideringsresultater

Status Oplysninger
Gennemført Der vises en bekræftelsesmeddelelse:
"<> er oprettet. Det kan tage op til 10 minutter, før ændringerne træder i kraft."
Mislykket Hvis FedEx modtager et andet svar end 200 (OK) eller 202 (Accepteret), betragtes valideringen af webhook-destinations-URL'en som mislykket.
CLOSE

Response

Copy