Oversigt
Advanced Integrated Visibility-webhook'en giver FedEx mulighed for at sende sikrede trackinghændelsesdata næsten i realtid til en præciseret destinations-URL for forsendelser, der er knyttet til ét eller flere specifikke FedEx-kundenumre. Du kan oprette et webhook-projekt for at tilgå denne funktionalitet via FedEx Developer Portal.
Navigationsstier
Du kan tilgå siden til webhook-oprettelse via en af følgende:
1. Via Mine projekter:
- Venstre navigationspanel → fanen Webhooks → +OPRET ET WEBHOOK-PROJEKT
2. Via API-kataloget:
Venstre navigationspanel → API-katalog
Søg eller filtrer efter Advanced Integrated Visibility
Vælg:
- Oversigt → Klik på Dokumentation → I Sandbox-konsollen skal du klikke på + OPRET ET PROJEKT
- Dokumenter → Klik på +OPRET EN WEBHOOK
Trin til oprettelse af webhook
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.
Bemærk: I øjeblikket er FedEx Advanced Integrated Visibility-webhook-løsningen ikke tilgængelig for denne mulighed. Som medlem af FedEx Compatible-programmet skal du, hvis du ønsker at tilgå Basic Integrated Visibility eller andre FedEx-integrationsløsninger, henvende dig til din kanaladministrator. Hvis du ikke ved, hvem din kanalmanager er, skal du kontakte din virksomhedsadministrator.
Vælg derefter Avanceret Integrated Visibility Account Number Subscription som dit abonnement.
Sådan opretter du et Advanced Integrated Visibility Account Number Subscription
Der er fire primære trin i processen:
Trin 1: Aktivering af Advanced Integrated Visibility Account Number Subscription
Dette trin administreres af en FedEx-administrator eller FedEx-medarbejder efter anmodning fra tredjepartskunder.
- MNDA-dokument: FedEx-administratoren eller FedEx-medarbejderen indhenter den gensidige fortrolighedsaftale (MNDA) sammen med en samlet liste over førsteparts/afsenders kundenumre.
Bemærk: Identiske kundenumre tilknyttet andre organisationer er tilladt under dette upload.
- Hvis det er relevant, vil tilpassede priser være aktiveret på organisationsniveau.
Bemærk: Denne funktion er ikke inkluderet i July Experience.
Trin 2: + Opret projekt
På siden Vælg produkt(er):
1. Klik på Advanced Integrated Visibility – Account Number, og klik derefter på Næste.
2. Vælg faktureringskonti, acceptér betalingsbetingelserne og klik på Næste.
Der skal tilføjes mindst én faktureringskonto.
3. På siden Bekræft oplysninger:
- Gennemse projektoplysningerne.
- Acceptér vilkår og betingelser.
- Hvis tilpassede priser gælder, vises det relaterede dokument automatisk.
4. Når oprettelsen er gennemført, vises en bekræftelsesmeddelelse:
"Du har tilføjet produktet til 'Mit projekt'."
5. Projektoversigt – Proces for aktivering af API-nøgle
- På siden Projektoversigt, under fanen API-nøgler i afsnittet API'er, vises produktionsstatus for abonnementet i første omgang som "Deaktiveret".
- En FedEx-administrator eller -medarbejder vil aktivere produktet efter anmodning.
- Når det er aktiveret, bliver fanen Produktionsnøgle tilgængelig, og produktionsstatus opdateres til "Afventer bekræftelse".
- Efter FedEx-administratorens eller -medarbejderens endelige aktivering vil produktionsstatus blive vist som "Aktiveret".
Trin 3: Projektoversigt – Konfigurer webhook
1. Naviger til siden Projektoversigt .
2. Vælg fanen Webhooks.
3. Klik på knappen + Konfigurer webhooks for at starte konfigurationen af webhooks, som vil blive omdirigeret til fanen Webhooks.
Beskrivelser af funktioner
| Feltnavn | Beskrivelse |
|---|---|
| Leveringsbevis | Bekræfter, at en forsendelse er blevet leveret. Inkluderer:
|
| Forventet levering | Hjælper modtagerne med at planlægge ved at tilbyde:
|
| Trackinghændelser | Giver mulighed for at vælge én eller flere hændelseskategorier for at modtage notifikationer:
|
| Hændelsesbaseret filter | Filtrerer webhook-svar til at inkludere:
|
2. 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:
|
| Sikkerhedstoken | Anvendes som delt hemmelighed til at godkende og validere webhook-svar via HMAC. Krav:
|
| Datasprog (land) | Vælg det foretrukne sprog for oversættelse af trackingdata fra rullemenuen. |
| Tracking-type | Vælg, hvordan trackingdata skal leveres:
|
| 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). |
Trin 3: Vælg forsendelseskonti
På siden Vælg forsendelseskonti:
- Vælg et eller flere FedEx-kundenumre, der skal tilknyttes dit webhook-projekt.
Vigtige bemærkninger:
- Kun konti, der ikke allerede er tilknyttet andre webhooks, vises.
- Du skal tilknytte mindst én konto for at fortsætte.
- Der kan maksimalt tilføjes 100 konti via webhook-UI.
- Hvis du vil tilknytte mere end 100 konti, skal du bruge webhooks-API'en.
Kontakt FedEx kundeservice eller helpdesk for at anmode om API-adgang.
Trin 4: Bekræft oplysninger, og opret
På siden Bekræft oplysninger:
1. Gennemse alle de oplysninger, du har indtastet for webhook-projektet.
2. Markér afkrydsningsfeltet for at acceptere vilkår og betingelser.
3. Klik på Opret for at afslutte webhook-opsætningen.
Når indsendelsen er gennemført, oprettes webhook'en med et systemgenereret abonnement-id og indstilles til statussen Aktiv.
Valideringsregler
Generelle krav:
- Webhook-navnet skal være unikt.
- Destinationens URL skal følge et standardiseret syntaktisk format (sikker HTTPS, ikke indeholde fedex.com eller dennes underdomæner).
- Alle påkrævede felter skal udfyldes – intet obligatorisk felt må stå tomt.
- Mindst ét gyldigt FedEx-forsendelseskundenummer skal være tilknyttet webhook'en.
Vellykket bekræftelse:
Hvis webhook'en oprettes, modtager kunden en bekræftelsesmeddelelse:
<<Webhook name>> er oprettet. Det kan tage op til 10 minutter, før ændringerne træder i kraft.
Mislykket bekræftelse:
Hvis FedEx modtager et andet svar end HTTP 200 (OK) eller 202 (Accepteret) fra destinations-URL'en, vil webhook-valideringen blive betragtet som mislykket.
