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:
- Via Mine projekter: Venstre navigationspanel → fanen Webhooks → +OPRET ET WEBHOOK-PROJEKT
- Via API-kataloget:
- Venstre navigationspanel → API-katalog
- Søg efter eller filtrér efter Advanced Integrated Visibility
- 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:
- Sender med FedEx og skal integrere FedEx-webhook i systemet.
- Sælger eller leverer softwareløsninger, som anvender FedEx-data og er ikke certificeret FedEx Compatible-udbyder.
- 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):
- Klik på Advanced Integrated Visibility – Account Number, og klik derefter på Næste.
- Vælg faktureringskonti, acceptér betalingsbetingelserne og klik på Næste.
Der skal tilføjes mindst én faktureringskonto.
På siden Bekræft oplysninger:
- Gennemse projektoplysningerne.
- Acceptér vilkår og betingelser.
- Hvis tilpassede priser gælder, vises det relaterede dokument automatisk.
Når oprettelsen er gennemført, vises en bekræftelsesmeddelelse:
"Du har tilføjet produktet til 'Mit projekt'."
Trin 3: 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 4: Projektoversigt – Konfigurer webhook
- Naviger til siden Projektoversigt .
- Vælg fanen Webhooks.
- Klik på knappen + Konfigurer webhooks for at starte konfigurationen af webhooks. Du vil blive omdirigeret til fanen Webhooks.
Beskrivelser af funktioner
| Feltnavn | Beskrivelse |
|---|---|
| Leveringsbevis | Bekræfter, at en forsendelse er blevet leveret. Inkluderer: Billede som leveringsbevis (PPOD): 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 modtagere med at planlægge ved at angive: Forventet leveringsdato (EDD) Tidsrum for forventet levering (EDTW) |
| Trackinghændelser | Giver mulighed for at vælge én eller flere begivenhedskategorier for at modtage notifikationer: Send Undervejs Levering Undtagelser Brugerdefinerede leveringsmuligheder |
| Hændelsesbaseret filter | Filtrerer webhook-svar til at inkludere: Indgående forsendelser Udgående forsendelser Tredjepartsforsendelser |
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: Skal være gyldigt og fungere 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 1 stort bogstav, 1 lille bogstav og 1 numerisk tegn 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 – komplet 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). |
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 angivet for webhook-projektet.
2. Markér afkrydsningsfeltet for at acceptere vilkår og betingelser.
3. Klik på Opret for at afslutte opsætningen af webhook.
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.
