Opsætning af Advanced Integrated Visibility-webhook
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 kanaladministrator 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 denne proces:
- Konfigurer projekt
- Angiv projektoplysninger
- Vælg forsendelseskonti
- Bekræft oplysninger, og acceptér vilkår
Trin 1: Konfigurer projekt
På siden Konfigurér webhook:
- Faktureringskontonummer:
- Gennemgå standardfaktureringskontoen.
- For at ændre den:
- Klik på TILFØJ FAKTURERINGSKONTO TIL DIN ORGANISATION (hvis der kun findes én konto), eller
- Klik på VÆLG EN ANDEN FAKTURERINGSKONTO (hvis der er flere konti).
Bemærk: En amerikansk-baseret faktureringskonto er påkrævet. For prisoplysninger henvises du til Prisvejledning til oversigt over Advanced Integrated Visibility.
Funktionsvalg:
- Vælg de funktioner, du vil aktivere, og klik derefter på Næste.
Beskrivelser af funktioner
| Feltnavn | Beskrivelse |
|---|---|
| Leveringsbevis | Bekræfter, at en forsendelse er blevet leveret. 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 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 | Filtrér webhook-svar til at inkludere: Indgående forsendelser Udgående forsendelser Tredjepartsforsendelser |
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 webhook-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.
