Typer af Advanced Integrated Visibility-webhooks
Advanced Integrated Visibility-webhooken giver FedEx mulighed for at sende sikrede trackinghændelsesdata næsten i realtid til en destinations-URL for forsendelser, der er knyttet til ét eller flere specifikke FedEx-kundenumre.
Du kan oprette et Advanced Integrated Visibility-webhookprojekt i FedEx Developer Portal og derefter knytte det til et eller flere FedEx-kundenumre eller FedEx-trackingnumre baseret på din valgte abonnementstype.
Gå til:
ADVANCED INTEGRATED VISIBILITY – ABONNEMENT EFTER KUNDENUMMER eller ADVANCED INTEGRATED VISIBILITY – ABONNEMENT EFTER TRACKINGNUMMER for at se trinnene til at oprette den respektive Advanced Integrated Visibility-webhook.
Oversigt over FedEx Advanced Integrated Visibility
FedEx-kunder kan abonnere på kundenummer eller trackingnummer for at modtage forsendelseshændelser næsten i realtid, lige fra etiketoprettelse til leveringsbevis af pakker, inklusive billede som leveringsbevis.
Abonnementstyper
FedEx-kunder kan abonnere på Advanced Integrated Visibility Advanced Integrated Visibility på følgende måder:
- Via kontonummer - Tilmeld dig med et FedEx-kontonummer for at få opdateringer på forsendelser, der er tilknyttet kontoen.
- Via trackingnummer – Abonner på FedEx-trackingnummer for at få opdateringer på forsendelser, der er tilknyttet et specifikt trackingnummer via API-slutpunkter.
Bemærk: Abonnementer kræver i øjeblikket en amerikansk baseret 9-cifret konto til fakturering, og kunder opkræves et månedligt gebyr baseret på antallet af trackingnumre. For at få mere at vide om priser på Advanced Integrated Visibility henvises du til Prisvejledning til oversigt over Advanced Integrated Visibility.
Hvis der abonneres via kundenummer, kræver abonnementer i øjeblikket et amerikansk FedEx-forsendelseskontonummer på ni cifre.
Nedenstående tabel giver dig oplysninger om funktionerne ved Advanced Integrated Visibility abonnement efter kundenummer og abonnement efter trackingnummer.
| Funktioner | Account Number Subscription | Tracking Number Subscription |
|---|---|---|
| Svar | Sikrede data = Data over personlige identifikationsoplysninger (PII), afsender- og modtagerdata SPOD CDO (Convenient Delivery Option)/svar | Anonyme data (herunder forsendelses- og transitopdateringer, eksklusive PII – personlige identifikationsoplysninger/svar) |
| Tilknytning | Tilknytning via kundenummer = tilknytning af alle linkede trackingnumre på én gang | Tilknytning af trackingnumre |
| Ejerskab | Kontonumre skal ejes af brugerne selv | Trackingnumre skal ikke nødvendigvis ejes af brugeren |
| Filtrering | Giver mulighed for at filtrere hændelser efter indgående og udgående forsendelser samt tredjepartsforsendelser |
Kan ikke filtrere hændelser |
| Integration | Tilknytning af kontonumre gøres gennem brugergrænseflade | Tilknytning af trackingnumre gøres gennem API-slutpunkt |
| Begrænsning | Kan tilføje op til 100 kontonumre | Kan tilføje op til 1.000 trackingnumre pr. anmodning |
| Relevant brugsmønster | Førstepartskunder – Hvis kunden ejer kontonumrene | Tredjepartskunder – Hvis kunder har trackingnumre, der tilhører førstepartskunder |
FedEx Integrated Visibility – Sammenligning af funktioner efter abonnementstype
| Funktion/dataelement | Tracking Number Subscription | Account Number Subscription | Bemærkninger |
|---|---|---|---|
| SPOD (underskrift som leveringsbevis) | Ikke tilgængelig | Tilgængelig (konfiguration påkrævet) | Billede af underskrift i TIFF-format, leveret i dataene |
| PPOD (billede som leveringsbevis) | Tilgængelig (konfiguration påkrævet) | Tilgængelig (konfiguration påkrævet) | JPEG-billede af leveringssted, base64-kodet |
| PPODA (billede som bevis på leveringsforsøg) | Tilgængelig (konfiguration påkrævet) | Tilgængelig (konfiguration påkrævet) | Ved leveringsforsøg, JPEG-billede leveret |
| GPS-koordinater (gpsPodCoordinates) | Ikke tilgængelig | Mulige | Skjult i abonnementer efter trackingnummer |
| Kontaktoplysninger (navn, telefonnummer, virksomhed) | Skjult | Mulige | På tværs af afsender, modtager, oprindelse, destination, speditør m.m. |
| Gadenavn og postnummer | Skjult | Mulige | streetLines og postalCode er skjult i trackingbaserede data |
| Kontonumre | Skjult | Mulige | Omfatter værdier for billTo, afsender- og modtagerkonto |
| Finansielle poster for pakker (f.eks. declaredValue, codAmount) | Skjult | Mulige | Toldbehandling, pr. efterkrav og deklareret værdi er skjult |
| Forespørgsler og returoplysninger (forespørgselskoder, årsager til returnering) | Skjult | Mulige | Komplette oplysninger vises kun til kontobaserede abonnenter |
| Data over varer og indhold | Skjult | Mulige | Omfatter partkoder, beskrivelser og mængder |
| Medarbejder-id (f.eks. hændelsespersonale) | Skjult | Ikke tilgængelig | Skjult i begge tilfælde af fortrolighedshensyn |
| Hændelsesnotifikationer og EDD/EDTW | Mulige | Mulige | Funktionerne forventet leveringsdato/-tidspunkt understøttet af begge abonnementer |
| Flerstyksforsendelse (MPS) | Mulige | Mulige | Med yderligere trackingoplysninger |
| Forventet leveringssikkerhed og risikoscore | Mulige | Mulige | Kun med Premium-niveau |
Skjulte datafelter for Avancerede Integrated Visibility Tracking Number Subscription
Oversigt
Når kunder abonnerer på forsendelsestrackingopdateringer ved brug af Advanced Integrated Visibility Tracking Number Subscription i stedet for Advanced Integrated Visibility Account Number Subscription, skjules specifikke datafelter for at beskytte brugerens data og overholde datasikkerhedspolitikker.
De skjulte data sikrer, at følsomme oplysninger – såsom personlige kontaktoplysninger, adresser og økonomiske værdier – kun kan tilgås af autoriserede parter. Kunder, der bruger Advanced Integrated Visibility Tracking Number Subscription vil se "XXXXX" i de skjulte felter anført nedenfor, selvom disse data kan være tilgængelige via Advanced Integrated Visibility Tracking Number Subscription.
Konsekvenserne af de skjulte data omfatter:
- Begrænset synlighed over oprindelses-/destinationsdetaljer og involverede parter.
- Fravær af personlige identifikationsoplysninger (f.eks. navne, telefonnumre) og finansielle eller toldrelaterede data.
- Designet beskyttelse af fortrolige eller følsomme forsendelsesoplysninger for at opfylde sikkerheds- og lovgivningsmæssige krav.
Kunder, der skal bruge adgang til disse skjulte felter med henblik på driftsmæssige eller forretningsrelaterede brugsmønstre, anbefales at abonnere via deres kontonummer.
Datapunkter, der er SKJULT i Advanced Integrated Visibility Tracking Number Subscription:
Scan 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
Afsenderoplysninger
- 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
Modtageroplysninger
- 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
Oprindelses- og destinationssted
- 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
Oplysninger om leverings- og adresseændringer
- 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
Speditøroplysninger
- 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
Pakkeoplysninger og finansielle detaljer
- trackResult/packageDetail/customsValue/value
- trackResult/packageDetail/declaredValue/value
- trackResult/packageDetail/originalTransportationCharge/value
- trackResult/codDetail/codAmount/value
Oplysninger om forespørgsler og varer
- trackResult/inquiries/[Array]/categoryCode
- trackResult/inquiries/[Array]/code
- trackResult/inquiries/[Array]/createTime
- trackResult/inquiries/[Array]/statusCode
- trackResult/commodityInfo/[Array]/description
- trackResult/commodityInfo/[Array]/code
Pakkeindhold og årsag til returnering
- trackResult/contents/[Array]/partNumber
- trackResult/contents/[Array]/partCode
- trackResult/contents/[Array]/description
- trackResult/contents/[Array]/quantity
- trackResult/returnReason/[Array]/code
- trackResult/returnReason/[Array]/description
Faktureringsoplysninger
- trackResult/billToParties/[Array]/billToParty/accountNumber
Kundefordele:
- Forbedr modtagernes tillid med proaktive notifikationer om ændringer af forventet leveringsdato og tidsrum for forsendelser i transit.
- Reducer kundeserviceomkostningerne for WISMO-opkald (hvor er min ordre) samt leveringstvister ved at yde FedEx-servicen Billede som leveringsbevis.
- Øg kundeoplevelsen ved at give notifikationer næsten i realtid om forsendelsesstatus.
- Opnå driftseffektivitet ved at få push-opdateringer i realtid på forsendelser i stedet for hele tiden at anmode om tracking-opdateringer på hver forsendelse.
Funktioner og trackinghændelser
Trackinghændelser
Denne funktion giver mulighed for at tracke status på forsendelser proaktivt og give kunder besked om forskellige opdateringer i forsendelsens livscyklus. Det giver kunden mulighed for at vælge den nøjagtige fase i forsendelsesprocessen/-hændelserne, som du ønsker at modtage notifikationer/advarsler om. De tilgængelige forsendelseshændelser er:
- Send: Denne mulighed giver notifikationer, når den valgte forsendelseshændelse sker. For eksempel: etiket oprettet, afhentet osv.
- I transit: Denne mulighed giver notifikationer om forsendelsens transithændelser. For eksempel: i transit, pakke tilbageholdt på leveringspunkt osv.
- Levering: Denne mulighed giver notifikationer om forsendelsens leveringshændelser. For eksempel: ude til levering, leveret osv.
- Undtagelser: Denne mulighed giver notifikationer om leveringsundtagelser. For eksempel: toldbehandlingsforsinkelse osv.
- Bekvemme leveringsmuligheder: Vælg denne mulighed for at modtage notifikationer om personligt tilpassede trackinghændelser. For eksempel: anmodning om opbevaring på FedEx-adresse accepteret.
For yderligere oplysninger om tilgængelige forsendelseshændelsesmuligheder henvises du til tabellen Statuskoder og statusser for Advanced Integrated Visibility-trackinghændelser.
Leveringsbevis
Denne funktion bruges til at anerkende, at en ordre er ankommet på den tilsigtede destination. Dette omfatter:
- Billede som leveringsbevis (PPOD): PPOD giver kunder mulighed for at modtage et billede, der viser den nøjagtige placering af deres pakke, når den er leveret på deres adresse.
Advanced Integrated Visibility leverer PPOD-billeder i JSON-dataene i formatet base64. Billederne kan derefter konverteres til JPEG-format.
Bemærk:
- PPOD er tilgængelig i USA, Canada, Puerto Rico, Hong Kong, New Zealand, Storbritannien og Irland.
- PPOD er kun tilgængelig for FedEx Ground, FedEx Express og privatpakker/-adresser.
- PPOD er tilgængelig for kvalificerede leveringer, når SPOD ikke er påkrævet. PPOD og SPOD kan ikke benyttes sammen.
- PPOD er tilgængelig for leveringer, hvor underskrift ikke er påkrævet (NSR), og som ikke leveres direkte til en kunde (f.eks. afleveret direkte til en kunde under levering).
- PPOD understøtter billedfiler fra 14.000 til 33.000 bytes (gælder for opløsning på 320 x 240).
- Billede som bevis på leveringsforsøg (PPODA): PPODA giver kunder mulighed for at modtage et billede af det nøjagtige leveringssted, i det tilfælde at leveringen ikke kan gennemføres. Advanced Integrated Visibility leverer PPOD-billeder i JSON-dataene i formatet base64. Billederne kan derefter konverteres til JPEG-format.
- PPODA er tilgængelig i USA og Puerto Rico.
- PPODA er kun tilgængelig med FedEx Ground, FedEx Express og private og kommercielle pakker/adresser.
- PPODA-billede kan være:
- PPODA-billede af dørmærke på dør.
- Billede af forhindring på leveringsstedet (f.eks. en låst låge).
- PPOD-billede af pakker leveret på stoppet.
- PPODA understøtter billedfiler fra 14.000 til 33.000 bytes (gælder for opløsning på 320 x 240)
- Underskrift som leveringsbevis (SPOD): SPOD giver kunder mulighed for at modtage et billede af modtagers underskrift samt dennes navn, leveringsdatoen, tidspunktet og adressen. Oplysningerne på underskrift som leveringsbevis vil blive præsenteret som et byte array i stedet for et billede. Byte-arrayet er en base64-kodet streng, som skal afkodes for at få det endelige underskriftbillede i PNG-format
- SPOD er ikke tilgængelig med Advanced Integrated Visibility Tracking Number Subscription.
- SPOD-billedstørrelsen vil være fra 4.000 til 6.000 bytes (gælder for opløsning på 400 x 95).
- SPOD-billedstørrelsen vil være fra 5.000 til 8.000 bytes (gælder for opløsning på 230 x 150).
- GPS-leveringsbevis (GPSPOD):
- GPS-leveringsbevis giver kunder mulighed for at modtage de geografiske koordinater på leveringslokationen.
Bemærk: GPSPOD er tilgængeligt som standard for Advanced Integrated Visibility Tracking Number Subscription.
- GPS-leveringsbevis giver kunder mulighed for at modtage de geografiske koordinater på leveringslokationen.
Hændelser vedrørende forventet leveringsdato og leveringstidsrum
Denne funktion hjælper modtagere af forsendelser med at planlægge deres tidsskemaer ved at oplyse dato og/eller tidsrum for levering af forsendelser. Dette omfatter:
- Forventet leveringsdato (EDD): Denne mulighed giver en forventet leveringsdato for forsendelsen til modtageren. For eksempel: 20. november 20XX.
- Tidsrum for forventet levering (EDTW): Denne mulighed giver modtager et forventet tidsrum for levering af forsendelsen på dagen for den faktiske levering. For eksempel: kl. 14.00-18.00.
Hændelsesbaseret filter
Denne funktion giver kunder mulighed for at organisere deres webhook-projekter baseret på faktureringsmetoderne for forsendelserne. Mulighederne er:
- Indgående: Vælg denne mulighed for forsendelser, der leveres til dig og vil være betalt af dig som modtager.
- Udgående: Vælg denne mulighed for forsendelser, der sendes af dig og vil være betalt for at dig som afsender.
- Tredjepart: Vælg denne mulighed for indgående og udgående forsendelser, der faktureres til dig som tredjepartsbetaler.
Bemærk: Dit FedEx-kontonummer vil blive brugt til at fakturere betaling for forsendelserne. For tredjepartsbetaler er du ikke nødvendigvis afsender eller modtager, men opkrævningerne faktureres til dit FedEx-kontonummer.
Politik om nye forsøg
Denne funktion forhindrer FedEx i at sende trackinghændelsesdata i tilfælde af et problem på kundens side. FedEx vil tilbageholde data og forsøge at sende dem igen i løbet af tre nye forsøg med fem minutters interval.
Hvis FedEx ikke modtager et vellykket svar i det definerede tidsrum, vil FedEx stoppe nye leveringsforsøg af den specifikke hændelse. Kunder kan dog anmode om manglende hændelser over en periode på de seneste syv dage via en manuel "NYT FORSØG"-knap på siden med projektoplysninger for Advanced Integrated Visibility-webhooken.
For yderligere oplysninger om politikker for nye forsøg henvises du til afsnittet Mekanismen Nyt forsøg .
