Konfiguration av Advanced Integrated Visibility Webhook
Översikt
Med Advanced Integrated Visibility-webhooken kan FedEx skicka säkra spårningsdata praktiskt taget i realtid till en specifik destinations-URL för försändelser som är kopplade till ett eller flera FedEx-kontonummer. Du kan skapa ett webhook-projekt för att få åtkomst till den här funktionen via FedEx Developer Portal.
Navigering
Du kommer åt sidan för att skapa en webhook via ett av följande:
- Via Mina projekt: Den vänstra navigeringspanelen → Webhookar-fliken→ +SKAPA ETT Webhook-PROJEKT
Via API-katalogen:
- Vänster navigeringspanel → API-katalog
- Sök eller filtrera efter Advanced Integrated Visibility
- Översikt → Klicka på Dokumentation → Klicka på +SKAPA ETT PROJEKT i sandlådekonsolen
- Dokument → Klicka på +SKAPA EN webhook
Så här skapar du en webhook steg för steg
Steg 1: Välj företagstyp
Klicka på +SKAPA ETT PROJEKT och välj företagstyp i rullgardinsmenyn:
- Skickar med FedEx och behöver integrera FedEx-webhook i sitt system.
- Säljer eller tillhandahåller en programvarulösning som använder FedEx-data och som inte är en certifierad FedEx Compatible Provider.
- Är en certifierad FedEx-kompatibel leverantör.
Obs! Lösningen för FedEx Advanced Integrated Visibility-webhooken är för närvarande inte tillgänglig för det här alternativet. Som medlem i FedEx Compatible-programmet kan du vända dig till din Channel Manager om du vill få åtkomst till Basic Integrated Visibility eller andra integreringslösningar från FedEx. Kontakta din företagsadministratör om du inte vet vem din Channel Manager är.
Välj sedan Kontonummerbaserad Advanced Integrated Visibility-prenumeration som prenumerationstyp.
Att skapa en kontonummerbaserad Advanced Integrated Visibility-prenumeration
Processen består av fyra huvudsteg:
- Konfigurera projekt
- Ange projektinformation
- Välj försändelsekonton
- Bekräfta uppgifter och godkänn villkor
Steg 1: Konfigurera projekt
Gör följande på sidan Konfigurera webhook:
- Faktureringskontonummer:
- Granska standardfaktureringskontot.
- För att ändra det:
- Klicka på LÄGG TILL FAKTURERINGSKONTO TILL DIN ORGANISATION (om det bara finns ett konto), eller
- Klicka på VÄLJ ETT ANNAT FAKTURERINGSKONTO (om det finns flera faktureringskonton).
Obs: Ett USA-baserat faktureringskonto krävs. För att få mer prisinformation, se prislistan för Advanced Integrated Visibility.
Val av funktioner:
- Välj de funktioner som du vill aktivera och klicka på Nästa.
Funktionsbeskrivningar
| Fältnamn | Beskrivning |
|---|---|
| Leveranskvitto | Bekräftar att en försändelse har levererats. Leveransbevis i bildformat (PPODA): Tillhandahåller ett foto som visar exakt leveransplats. Signerat leveransbevis (SPOD): Tillhandahåller en bild på mottagarens signatur, namn, leveransdatum, tid och plats. |
| Beräknad leverans | Underlättar planering genom att tillhandahålla: Beräknat leveransdatum (EDD) Tidsfönster för beräknad leverans (EDTW) |
| Spårningshändelser | Möjliggör val av en eller flera händelsekategorier för att ta emot aviseringar: Skickad Under transport Leverans- undantag Anpassade leveransalternativ |
| Händelsebaserad filtrering | Filtrerar webhook-svar så att de omfattar: Inkommande försändelser Utgående försändelser Tredjepartsförsändelser |
Ange följande information på sidan Ange uppgifter:
| Fältnamn | Beskrivning |
|---|---|
| Webhookprojektets namn | Ett unikt namn för webhook-projektet. Ett namnförslag fylls i automatiskt med kan redigeras. Namnet ska inte repeteras i andra webhook-projekt. |
| Destinations-URL | Den säkra HTTPS-slutpunkten dit FedEx kommer att skicka spårningshändelsedata. Krav: Måste vara giltig och fungera Måste följa standardiserad syntax Kan inte innehålla fedex.com eller dess underdomäner Kan återanvändas i flera webbhookar. Mer information finns i avsnittet Företagsregler och bästa praxis. |
| Säkerhetstoken | En delad hemlighet som används för att autentisera och validera webhook-svar via HMAC. Krav: 26–100 tecken Måste innehålla minst en stor bokstav, en liten bokstav och ett numeriskt tecken Kan återanvändas för flera webhookar |
| Språk för data (land) | Välj önskat språk för översättning av spårningsdata i rullgardinsmenyn. |
| Spårningstyp | Välj hur spårningsdata ska levereras: Detaljerad spårning – Fullständig händelsehistorik Händelsespecifik spårning – Endast den senaste händelsen |
| E-postadress | Ange en giltig e-postadress för att få aviseringar. |
| Språk för e-post (land) | Välj vilket språk du vill få e-postmeddelanden på. Obs! Endast språkvarianter för USA stöds (t.ex. en-US, es-US). |
Steg 3: Välj försändelsekonton
På sidan Välj försändelsekonton:
- Välj ett eller flera FedEx-kontonummer som kopplas till ditt webhook-projekt.
Viktig information:
- Endast konton som inte redan är kopplade till andra webhookar visas.
- Du måste koppla minst ett konto för att fortsätta.
- Som mest kan 100 konton läggas till via användargränssnittet för webhookar.
- Använd API för webhookar för att koppla fler än 100 konton.
Kontakta FedEx kundtjänst för att begära API-åtkomst.
Steg 4: Bekräfta uppgifter och skapa
På sidan Bekräfta uppgifter:
1. Granska uppgifterna som du har angett för webhook-projektet.
2. Markera rutan för att godkänna villkoren.
3. Klicka på Skapa för att slutföra webhook-konfigurationen.
Efter inlämningen kommer webhooken att skapas med ett systemgenererat prenumerations-ID och få statusen Aktiv.
Valideringsregler
Allmänna krav:
- Webhookens namn måste vara unikt.
- Destinations-URL:en måste vara i ett standardiserat syntaktiskt format (säker HTTPS, inte inkludera fedex.com eller dess underdomäner).
- Alla obligatoriska fält måste fyllas i – inget obligatoriskt fält ska lämnas tomt.
- Minst ett giltigt FedEx-försendelsekontonummer måste vara kopplat till webhooken.
Lyckad validering:
Du ska få ett bekräftelsemeddelande om webhooken kunde skapas:
<<Webhook name>> har skapats. Det kan ta upp till tio minuter innan ändringarna tillämpas.
Misslyckad validering:
Om FedEx tar emot något annat svar än HTTP 200 (OK) eller 202 (Accepted) från webhookens destinations-URL kommer webhook-valideringen att betraktas som misslyckad.
