Ö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 webhook via ett av följande alternativ:
1. Via Mina projekt:
- Vänster navigationspanel → fliken Webhookar → +SKAPA ETT Webhook-PROJEKT
2. Via API-katalog:
Vänster navigationspanel → API-katalog
Sök efter eller filtrera efter Advanced Integrated Visibility
Välj:
- Ö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:
1. Skickar med FedEx och behöver integrera FedEx-webhook i sitt system.
2. Säljer eller tillhandahåller en programvarulösning som använder FedEx-data och inte är certifierad FedEx Compatible Provider.
3. Är FedEx Compatible Provider.
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:
Steg 1: Aktivering av kontonummerbaserad Advanced Integrated Visibility-prenumeration
Det här steget hanteras av en FedEx-administratör eller FedEx-representant på begäran av tredjepartskunder.
- MNDA-dokument: FedEx-administratören eller FedEx-representanten samlar in det ömsesidiga sekretessavtalet (MNDA) tillsammans med en samlad lista över förstaparts/avsändares kontonummer.
Obs! Vid den här uppladdningen är det tillåtet att använda kontonummer som redan är kopplade till andra företag.
- Om tillämpligt kommer anpassad prissättning aktiveras på organisationsnivå.
Obs! Den här funktionen finns inte med i juli-versionen
Steg 2: + Skapa projekt
På sidan Välj produkter:
1. Klicka på Advanced Integrated Visibility – Kontonummer och klicka sedan på Nästa.
2. Välj faktureringskonton, godkänn betalningsvillkoren och klicka på Nästa.
Minst ett faktureringskonto måste läggas till.
3. På sidan Bekräfta uppgifter:
- Granska projektuppgifterna.
- Godkänn Villkoren.
- Om anpassad prissättning gäller, kommer det relaterade dokumentet visas automatiskt.
4. Ett bekräftelsemeddelande visas när projektet har skapats:
”Du har lagt till produkten till ’Mina projekt’.”
5. Projektöversikt – aktiveringsprocess för API-nyckel
- På sidan Projektöversikt under fliken API-nycklar i avsnittet API:er kommer produktionsstatusen för prenumerationen initialt att visas som ”Inaktiverad.”
- En FedEx-administratör eller representant kommer att aktivera produkten vid förfrågan.
- När den är aktiverad, blir fliken Produktionsnyckel tillgänglig och produktionsstatusen kommer att uppdateras till ”Väntar på bekräftelse.”
- Efter den slutliga aktiveringen av FedEx-administratören eller representanten, kommer produktionsstatusen att visas som ”Aktiverad.”
Steg 3: Projektöversikt – Konfigurera webhook
1. Gå till sidan Projektöversikt.
2. Välj fliken Webhookar.
3. Klicka på knappen +Konfigurera webhookar för att starta webhook-konfigurationen, vilket tar dig till fliken Webhookar
Funktionsbeskrivningar
| Fältnamn | Beskrivning |
|---|---|
| Leveranskvitto | Bekräftar att en försändelse har levererats. Inkluderar:
|
| Beräknad leverans | Hjälper mottagare att planera genom att tillhandahålla:
|
| Spårningshändelser | Det går att välja en eller flera händelsekategorier för att ta emot aviseringar
|
| Händelsebaserad filtrering | Filtrerar webhook-svar för att inkludera:
|
2. 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 men 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:
|
| Säkerhetstoken | En delad hemlig nyckel som används för att autentisera och validera webhook-svar via HMAC. Krav:
|
| 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:
|
| 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.
- För att koppla mer än 100 konton, använd API:et webhooks.
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:
- Namnet på webhooken måste vara unikt.
- Destinations-URL:en måste följa ett standardiserat syntaktiskt format. (säker HTTPS, ingen fedex.com eller dess underdomäner).
- Alla obligatoriska fält måste vara ifyllda – inga obligatoriska fält får lämnas tomma.
- Åtminstone ett giltigt FedEx-försändelsekontonummer 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.
