SKAPA EN
WEBHOOK HANTERA WEBHOOKAR

Typer av Advanced Integrated Visibility-webhookar

Advanced Integrated Visibility webhooken gör det möjligt för FedEx skicka säkra spårningsdata praktiskt taget i realtid till en destinations-URL för försändelser som är kopplade till ett eller flera specifika FedEx-kontonummer.

Du kan skapa ett Advanced Integrated Visibility-webhook-projekt i FedEx Developer Portal och därefter koppla det till ett eller flera FedEx-kontonummer eller FedEx-spårningsnummer, beroende på din valda prenumerationstyp.

Gå till:

ADVANCED INTEGRATED VISIBILITY – KONTONUMMERBASERAD PRENUMERATION eller ADVANCED INTEGRATED VISIBILITY – SPÅRNINGSNUMMERBASERAD PRENUMERATION , för att visa stegen för att skapa respektive Advanced Integrated Visibility-webhook.

Översikt över FedEx Advanced Integrated Visibility

FedEx-kunder kan prenumerera på kontonummer eller spårningsnummer för att få försändelseuppdateringar praktiskt taget i realtid – från etikettskapande till leverans av paket, inklusive leveransbevis i bildformat.

Prenumerationstyper

FedEx-kunder kan prenumerera på Advanced Integrated Visibility med följande alternativ:

Utifrån kontonummer: Prenumerera på FedEx-kontonummer för att få uppdateringar för försändelser som matchar kontona.
Utifrån spårningsnummer: Prenumerera på FedEx-spårningsnummer för att få uppdateringar för försändelser som matchar de spårningsnummer som har angetts via API-slutpunkter.

Obs! Prenumerationsfunktionerna kräver för närvarande 9-siffriga FedEx-konton som är baserade i USA för fakturering och kunderna debiteras en månadsavgift baserat på antalet spårningsnummer. Du hittar mer information om Advanced Integrated Visibility-priserna i prislistan för Advanced Integrated Visibility.

Om prenumerationen är kopplad till ett kontonummer krävs för närvarande USA-baserade försändelsekonton med niosiffriga FedEx-kontonummer.

I tabellen nedan finns information om funktionerna med kontonummerbaserad prenumeration och spårningsnummerbaserad Advanced Integrated Visibility-prenumeration

Funktioner	Kontonummerbaserad prenumeration	Spårningsnummerbaserad prenumeration
Svar	Säkra data = personlig identifierbar information, avsändar- och mottagardata, signerat leveransbevis, smidiga leveransalternativ/svar	Anonyma data (inkluderar försändelseuppgifter och uppdateringar under transport, inkluderar inte personlig identifierbar information/svar)
Association	Association till ett kontonummer = association till alla länkade spårningsnummer på en gång	Association till spårningsnummer
Ägande	Kontonummer måste ägas av användaren	Spårningsnummer måste inte ägas av användaren
Filtrering	Möjlighet att filtrera händelserna efter inkommande försändelser, utgående försändelser och tredjepartsförsändelser	Kan inte filtrera händelser
Integrering	Association till kontonummer sker via användargränssnittet	Association till spårningsnummer sker via API-slutpunkten
Begränsning	Kan lägga till upp till 100 kontonummer	Kan lägga till upp till 1 000 spårningsnummer per begäran
Lämpliga tillämpningar	Förstapartskunder – om kunden äger kontonumren	Tredjepartskunder – om kunden har spårningsnummer som tillhör förstapartskunder

FedEx Integrated Visibility – funktionsjämförelse per prenumerationstyp

Funktion/dataelement	Spårningsnummerbaserad prenumeration	Kontonummerbaserad prenumeration	Anteckningar
SPOD (signerat leveransbevis)	Ej tillgängligt	Tillgänglig (konfiguration krävs)	Signaturbild i TIFF-format, levereras i datan
PPOD (leveransbevis i bildformat)	Tillgänglig (konfiguration krävs)	Tillgänglig (konfiguration krävs)	JPEG-bild av leveransplatsen, base64-kodad
PPODA (bildbevis på leveransförsök)	Tillgänglig (konfiguration krävs)	Tillgänglig (konfiguration krävs)	För leveransförsök, JPEG-bild tillhandahålls
GPS-koordinater (gpsPodCoordinates)	Ej tillgängligt	Tillgänglig	Maskade för spårningsbaserade prenumerationer
Kontaktuppgifter (namn, telefonnummer, företag)	Maskade	Tillgänglig	För avsändare, mottagare, avsändningsland, destination, agent osv.
Gatuadress och postnummer	Maskade	Tillgänglig	streetLines och postalCode maskas i spårningsbaserade data
Kontonummer	Maskade	Tillgänglig	Inkluderar kontovärden för billTo, avsändare och mottagare
Finansiella paketuppgifter (t.ex. declaredValue, codAmount)	Maskade	Tillgänglig	Uppgifter om tull, postförskott och deklarerade värden maskas
Begärande- och returinformation (begärandekoder, returorsaker)	Maskade	Tillgänglig	Fullständig information visas endast för kontobaserade prenumeranter
Varu- och innehållsdata	Maskade	Tillgänglig	Inkluderar artikelnummer, beskrivningar, kvantiteter
Medarbetar-ID (t.ex. eventpersonal)	Maskade	Ej tillgängligt	Maskas i båda fallen av sekretesskäl
Händelseaviseringar och EDD/EDTW	Tillgänglig	Tillgänglig	Funktioner med beräknat leveransdatum/beräknad leveranstid stöds för båda
Försändelse med flera paket (MPS)	Tillgänglig	Tillgänglig	Med ytterligare spårningsinformation
Förtroende för beräknad leverans och riskpoäng	Tillgänglig	Tillgänglig	Ingår endast på premiumnivån

Fält med maskerade data för spårningsnummerbaserade Advanced Integrated Visibility-prenumerationer

Sammanfattning

När kunder prenumererar på spårningsuppdateringar med hjälp av en spårningsnummerbaserad Advanced Integrated Visibility-prenumeration istället för en kontonummerbaserad Advanced Integrated Visibility-prenumeration maskas specifika datafält för att upprätthålla kundintegriteten och uppfylla dataskyddspolicyer.

Maskningen säkerställer att känslig information, som personliga kontaktuppgifter, adresser och finansiella värden, bara är tillgängliga för behöriga parter. Kunder som använder en spårningsnummerbaserad Advanced Integrated Visibility-prenumeration kommer att se ”XXXXX” för de maskade fälten som listas nedan, även om dessa data kan vara tillgängliga via den spårningsnummerbaserade Advanced Integrated Visibility-prenumerationen.

Exempel på följder av den här maskningen:

Begränsad insikt i ursprungs-/destinationsuppgifter och involverade parter.
Frånvaro av personliga identifierare (t.ex. namn och telefonnummer) och finansiella data eller tullrelaterade data.
Skydd av proprietär eller känslig försändelseinformation för säkerhets- och bestämmelseefterlevnad.

Kunder som behöver åtkomst till de här maskade fälten för verksamhets- eller affärsrelaterade användningsfall rekommenderas att prenumerera med hjälp av sina kontonummer.

Data som är MASKADE i spårningsnummerbaserade Advanced Integrated Visibility-prenumerationer:

Skanna händelser

scanEvent/location/locationContactAndAddress/address/streetLines
scanEvent/location/locationContactAndAddress/contact/phoneNumber
scanEvent/location/locationContactAndAddress/contact/companyName
scanEvent/location/locationContactAndAddress/contact/personName
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/address/streetLines
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/phoneNumber
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/companyName
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/personName

Avsändarinformation

trackResult/shipperInfo/contactAndAddress/address/postalCode
trackResult/shipperInfo/contactAndAddress/address/streetLines
trackResult/shipperInfo/contactAndAddress/contact/phoneNumber
trackResult/shipperInfo/contactAndAddress/contact/companyName
trackResult/shipperInfo/contactAndAddress/contact/personName
trackResult/shipperInfo/account/value

Mottagarinformation

trackResult/recipientInfo/contactAndAddress/address/postalCode
trackResult/recipientInfo/contactAndAddress/address/streetLines
trackResult/recipientInfo/account/value
trackResult/recipientInfo/contactAndAddress/contact/phoneNumber
trackResult/recipientInfo/contactAndAddress/contact/companyName
trackResultecipientInfo/contactAndAddress/contact/personName

Ursprungs- och destinationsplats

trackResult/originLocation/locationDetail/locationContactAndAddress/contact/personName
trackResult/originLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/originLocation/locationDetail/locationContactAndAddress/contact/companyName
trackResult/originLocation/locationDetail/locationContactAndAddress/address/streetLines
trackResult/originLocation/locationDetail/locationContactAndAddress/address/postalCode
trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/personName
trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/companyName
trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/streetLines
trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/postalCode

Uppgifter om leverans- och adressändring

trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/streetLines
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/postalCode
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/gpsPodCoordinates
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/personName
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/companyName
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/streetLines
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/postalCode
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/personName
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/companyName

Agentinformation

trackResult/broker/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/broker/locationDetail/locationContactAndAddress/contact/companyName
trackResult/broker/locationDetail/locationContactAndAddress/contact/personName
trackResult/broker/locationDetail/locationContactAndAddress/address/streetLines
trackResult/broker/locationDetail/locationContactAndAddress/address/postalCode

Paketuppgifter och finansiella uppgifter

trackResult/packageDetail/customsValue/value
trackResult/packageDetail/declaredValue/value
trackResult/packageDetail/originalTransportationCharge/value
trackResult/codDetail/codAmount/value

Begärande- och varuinformation

trackResult/inquiries/[Array]/categoryCode
trackResult/inquiries/[Array]/code
trackResult/inquiries/[Array]/createTime
trackResult/inquiries/[Array]/statusCode
trackResult/commodityInfo/[Array]/description
trackResult/commodityInfo/[Array]/code

Paketinnehåll och returorsak

trackResult/contents/[Array]/partNumber
trackResult/contents/[Array]/partCode
trackResult/contents/[Array]/description
trackResult/contents/[Array]/quantity
trackResult/returnReason/[Array]/code
trackResult/returnReason/[Array]/description

Faktureringsinformation

trackResult/billToParties/[Array]/billToParty/accountNumber

Kundfördelar:

Förbättra mottagarnas förtroende med proaktiva aviseringar för ändringar under transport av beräknat leveransdatum och tidsfönster för leveransdagen.
Sänk kundtjänstkostnaderna för WISMO-samtal (where is my order, var är min beställning) samt minska antalet leveranstvister genom att tillhandahålla FedEx-leveransbevis i bildformat.
Förbättra kundupplevelsen genom att erbjuda aviseringar om leveransstatus praktiskt taget i realtid.
Uppnå operativ effektivitet genom att få push-uppdateringar om försändelser i realtid, i stället för att regelbundet undersöka och kontrollera spårningsuppdateringar för varje enskild försändelse.

Funktioner och spårningshändelser

Spårningshändelser

Den här funktionen möjliggör försändelsespårning genom att meddela kunderna om olika uppdateringar. Funktionen ger kunderna alternativen att välja det exakta skedet i försändelseprocessen/de händelser som de vill få aviseringar om. Följande försändelsehändelser är tillgängliga:

Skicka: Det här alternativet skapar aviseringar när den valda försändelsehändelsen inträffar. Exempel: etikett har skapats, upphämtning osv.
Under transport: Det här alternativet skapar aviseringar för försändelsens transporthändelser. Exempel: under transport, förvaras för leverans osv.
Leverans: Det här alternativet skapar aviseringar för försändelsens leveranshändelser. Exempel: försändelsen är ute för leverans, har levererats osv.
Undantag: Det här alternativet skapar aviseringar för leveransundantag. Exempel: försenad klarering osv.
Smidiga leveransalternativ: Välj det här alternativet för att få aviseringar för anpassade spårningshändelser. Exempel: begäran om att förvara på ett kontor har godkänts.

Se tabellen Statuskoder och statusar för Advanced Integrated Visibility-spårningshändelser för mer information om tillgängliga alternativ för försändelsehändelser.

Leveransbevis

Den här funktionen används för att bekräfta att en beställning har kommit fram till sin avsedda destination. Följande ingår:

Leveransbevis i bildformat (PPOD): Med PPOD kan kunderna få en bild på sina pakets exakta placering efter att de har levererats till kundernas adress.
Advanced Integrated Visibility levererar PPOD-bilder i ett Base64-format i JSON-datan. Bilderna kan därefter konverteras till JPEG-format.

OBS!
Bildbevis på leveransförsök (PPODA): Med PPODA kan kunderna få en bild på den exakta plats som paketet kommer att levereras till, ifall leveransen inte kan slutföras. Advanced Integrated Visibility levererar PPODA-bilder i ett Base64-format i JSON-datan. Bilderna kan därefter konverteras till JPEG-format.

Signerat leveransbevis (SPOD): Med SPOD kan kunderna få en bild på mottagarens signatur samt hans eller hennes namn, leveransdatum, tid och plats. SPOD-informationen kommer att presenteras som en bytematris i stället för en bild. Bytematrisen är en base64-kodad sträng som måste avkodas för att du ska få signaturbilden i PNG-format.

Leveransbevis med GPS-data (GPSPOD):
- Med GPSPOD kan kunderna få geografiska koordinater för leveransplatsen.
  
  Obs! GPSPOD är tillgängligt som standard för kontonummerbaserade Advanced Integrated Visibility-prenumerationer.

Beräknat leveransdatum och tidsfönster för leverans

Den här funktionen hjälper mottagare av försändelser att planera sina scheman genom att tillhandahålla ett datum- och/eller tidsintervall för försändelseleveranser. Följande ingår:

Beräknat leveransdatum (EDD): Det här alternativet ger ett beräknat datum för leverans av försändelsen till mottagaren. Exempel: 20 nov. 20XX.
Tidsfönster för beräknad leverans (EDTW): Det här alternativet ger mottagaren ett beräknat tidsfönster på dagen för den faktiska leveransen av försändelsen. Exempel: kl. 14.00 till 18.00.

Händelsebaserad filtrering

Den här funktionen låter kunderna organisera sina webhookprojekt baserat på faktureringsmetoden för sina försändelser. Alternativen är följande:

Inkommande: Välj det här alternativet för försändelser som kommer att levereras till dig och som kommer att betalas av dig som mottagare.
Utgående: Välj det här alternativet för försändelser som kommer att skickas av dig och som kommer att betalas av dig som avsändare.
Tredje part: Välj det här alternativet för inkommande och utgående försändelser som faktureras till dig som tredjepartsbetalare.

Obs! Ditt FedEx-kontonummer kommer att användas för att fakturera eller betala för försändelserna. För tredjepartsbetalare: Avgifterna kommer att faktureras till ditt FedEx-kontonummer, oavsett om du varken är avsändare eller mottagare.

Policy för upprepade försök

Den här funktionen förhindrar FedEx från att skicka data om spårningshändelser i händelse av ett problem på klientsidan. FedEx kommer att spara alla data och göra tre försök att skicka igen, med fem minuters intervall mellan försöken.

Om FedEx inte får ett framgångsrikt svar inom den definierade tidsperioden kommer FedEx att stoppa omleveransen av den specifika händelsen. Kunderna kan däremot begära att få ta del av missade händelser från de senaste sju dagarna via knappen ”FÖRSÖK IGEN” på informationssidan för Advanced Integrated Visibility-webhookprojektet.

Se avsnittet Mekanism för upprepade försök för mer information om policyer för upprepade försök.

Request
Response

Response

Copy

SKAPA EN WEBHOOK HANTERA WEBHOOKAR