Fedex Logo

OPRET EN
WEBHOOK ADMINISTRER WEBHOOKS

Sådan fungerer Advanced Integrated Visibility

Oversigt over Advanced Integrated Visibility-webhook

Advanced Integrated Visibility-webhook'en giver FedEx mulighed for sikkert at sende trackinghændelsesdata næsten i realtid til en specifik destinations-URL for forsendelser, der er knyttet til et specifikt FedEx-kundenummer.

For at bruge denne funktion skal en FedEx-administrator eller DI-administrator oprette et Advanced Integrated Visibility-webhook-projekt.

 

Navigationsmuligheder

Du kan få adgang til siden Advanced Integrated Visibility-webhooks på to måder:

Mulighed 1: Via Mine projekter

  •  Naviger til Mine Projekter fra det venstre navigationspanel.
  •  Klik på fanen Webhooks.

Mulighed 2: Via API-kataloget

  •  Gå til API-kataloget fra det venstre navigationspanel.
  •  Brug søgefeltet til at finde Advanced Integrated Visibility, eller vælg det i afsnittet FILTRE.
  •  Vælg en af følgende på Webhook-kortet:
  •  Klik på Dokumenter → klik derefter på + Administrer webhooks

Visning af et Avancerede Integrated Visibility Tracking Number Subscription-project

1. FedEx personlig adgang og opsætning

  •  En FedEx-administrator eller FedEx-medarbejder vil igangsætte opsætningen.
  •  Organisationsprofilen oprettes af en udpeget administrator på vegne af CSP-kunder.
  •  Et berettiget amerikansk-baseret faktureringskundenummer tilføjes på organisationsniveau af administratoren på vegne af kunden.
  •  Administratoren, der udfører denne opsætning, skal have de relevante tilladelser til at administrere konfigurationer på organisationsniveau.

2. Se arbejdsgang for Tracking Number Subscription

2.1 Se abonnementet

  •  Når en FedEx-administrator eller -repræsentant opretter et projekt, kan brugere se det tilknyttede Advanced Integrated Visibility – Tracking Number Subscription-projekt på deres dashboard.

2. Se Funktioner

  •  Brugere kan udforske de tilgængelige funktioner, der er forbundet med abonnementsprojektet for bedre forståelse og anvendelse.

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

 

På siden Detaljer vises følgende 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).

 

Trinvis proces

4. Opret et abonnementsprojekt

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

5. 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.

6. 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-navne skal være unikke.
  •  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