Arbetsflöde med API kontra Advanced Integrated Visibility
Bilderna nedan visar hur händelsedata tas emot vid en API-begäran respektive med en webhook för Advanced Integrated Visibility.
Ö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 |
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!
- PPOD är tillgängligt i USA, Kanada, Puerto Rico, Hong Kong, Nya Zeeland, Storbritannien och Irland.
- PPOD är endast tillgängligt för försändelser som skickas med FedEx Ground eller FedEx Express och till bostadsadresser.
- PPOD är tillgängligt för berättigade leveranser när SPOD inte krävs. PPOD och SPOD är inte tillgängliga tillsammans.
- PPOD är tillgängligt för leveranser med alternativet ”Ingen signatur krävs” (NSR) och som inte levereras direkt till en kund (t.ex. överlämnas direkt till en kund vid leveransen).
- PPOD har stöd för bildstorlekar på 14 000 till 33 000 byte (tillämpligt för bildupplösningen 320 x 240).
- 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.
- PPODA är tillgängligt i USA och Puerto Rico.
- PPODA är endast tillgängligt för paket som skickas med FedEx Ground eller FedEx Express och till bostadsadresser eller kommersiella adresser.
- Exempel på PPODA:
- Bild på en dörretikett på en dörr.
- Bild på ett hinder vid leveransplatsen (t.ex. en låst grind).
- Bild på paket som har levererats vid stoppet.
- PPODA har stöd för bildstorlekar på 14 000 till 33 000 byte (tillämpligt för bildupplösningen 320 x 240)
- 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.
- SPOD är inte tillgängligt för spårningsnummerbaserade Advanced Integrated Visibility-prenumerationer.
- SPOD-bildens storlek kommer att vara mellan 4 000 och 6 000 byte (tillämpligt för bildupplösningen 400 x 95).
- SPOD-bildens storlek kommer att vara mellan 5 000 och 8 000 byte (tillämpligt för bildupplösningen 230 x 150).
- 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.
- Med GPSPOD kan kunderna få geografiska koordinater för leveransplatsen.
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.
