Ö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:
- Via Mina projekt: Den vänstra navigeringspanelen → Webhookar-fliken → +SKAPA ETT Webhook-PROJEKT
- Via API-katalogen:
- Den vänstra navigeringspanelen → API-katalogen
- Sök efter 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 inte är en certifierad FedEx Compatible Provider (FedEx-kompatibel leverantör).
- Ä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:
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örsta part/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:
- Klicka på Advanced Integrated Visibility – Kontonummer och klicka sedan på Nästa.
- Välj faktureringskonton, godkänn betalningsvillkoren och klicka på Nästa.
Minst ett faktureringskonto måste läggas till.
På sidan Bekräfta uppgifter:
- Granska projektuppgifterna.
- Godkänn villkoren.
- Om anpassad prissättning appliceras, kommer det relaterade dokumentet att visas automatiskt.
Ett bekräftelsemeddelande visas när projektet har skapats:
”Du har lagt till produkten till ’Mina projekt’.”
Steg 3: 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 4: Projektöversikt – Konfigurera webhook
- Gå till sidan Projektöversikt.
- Välj fliken Webhookar.
- Klicka på knappen + Konfigurera Webhookar för att påbörja webhook-konfiguration. Du kommer att omdirigeras till fliken Webhookar.
Funktionsbeskrivningar
| Fältnamn | Beskrivning |
|---|---|
| Leveranskvitto | Bekräftar att en försändelse har levererats. Det här ingår: Leveransbevis i bildformat (PPOD): 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 | Det går att välja en eller flera händelsekategorier för att ta emot aviseringar: Skicka 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 |
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 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.
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 all information 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.
