Fedex Logo

Soorten Advanced Integrated Visibility-webhooks

De Advanced Integrated Visibility-webhook maakt het voor FedEx mogelijk om nagenoeg in realtime beveiligde trackinggegevens te verzenden naar een bestemmings-URL voor zendingen die zijn gekoppeld aan specifieke FedEx-accountnummer(s).

U kunt een Advanced Integrated Visibility-webhookproject aanmaken op het FedEx Developer Portal en het vervolgens koppelen aan één of meer FedEx-accountnummers of FedEx-trackingnummers, afhankelijk van het door u geselecteerde abonnementstype.

Ga naar:

ABONNEMENT VOOR ADVANCED INTEGRATED VISIBILITY OP BASIS VAN ACCOUNTNUMMER of ABONNEMENT VOOR ADVANCED INTEGRATED VISIBILITY OP BASIS VAN TRACKING-NUMMER om de stappen te bekijken voor het aanmaken van de betreffende Advanced Integrated Visibility-webhook.

 

 

Overzicht van FedEx Advanced Integrated Visibility


FedEx-klanten kunnen op een accountnummer of trackingnummer abonneren om bijna in real time verzendgebeurtenissen tijdens het transport te ontvangen, van het aanmaken van labels tot bewijs van aflevering van pakketten, inclusief een foto van het bewijs van aflevering.

Abonnementstypen


FedEx-klanten kunnen zich op de volgende manieren abonneren op Geavanceerde geïntegreerde zichtbaarheid:

  • Op basis van accountnummer: abonneer op een FedEx-accountnummer om updates te ontvangen over zendingen die aan het account zijn gekoppeld.
  • Op basis van trackingnummer: abonneer op een FedEx-trackingnummer om updates te ontvangen over zendingen die aan de specifieke trackingnummers zijn gekoppeld door middel van API-eindpunten.

Opmerking: voor abonnementen zijn momenteel de Amerikaanse FedEx-accountnummers van 9 tekens vereist voor facturering. Klanten krijgen maandelijks een factuur op basis van het aantal trackingnummers. Raadpleeg de Overzicht van Geavanceerde geïntegreerde zichtbaarheid-prijsgids voor meer informatie over de prijzen van Geavanceerde geïntegreerde zichtbaarheid.

Als abonnementen zijn geabonneerd per accountnummer, dan zijn er momenteel negencijferige FedEx-verzendaccounts in de VS vereist.

In de tabel hieronder staat informatie over de functies van het abonnement op basis van accountnummer en het abonnement op basis van tracking-nummer voor Advanced Integrated Visibility

Specificaties Abonnement op basis van accountnummers Abonnement op basis van tracking-nummers
Antwoord  Beveiligde gegevens = persoonlijk identificeerbare informatie (PII), gegevens van de afzender en ontvanger, SPOD CDO's (Handige afleveroptie)/antwoord Anonieme gegevens (inclusief zending, transportupdates, exclusief PII - persoonlijk identificeerbare informatie/antwoord
Koppeling Koppeling van een accountnummer = alle gelinkte trackingnummers worden tegelijk gekoppeld Koppeling van trackingnummers 
Eigendom Accountnummers moeten eigendom zijn van de gebruiker Trackingnummers hoeven geen eigendom te zijn van de gebruiker
Filters Heeft de mogelijkheid om gebeurtenissen te filteren op 'inkomend', 'uitgaand' en 'zendingen van derde partijen'
Kan gebeurtenissen niet filteren
Integratie Koppeling van accountnummers gaat via UI Koppeling van trackingnummers gaat via API-eindpunt
Beperking Kan maximaal 100 accountnummers toevoegen Kan maximaal 1000 trackingnummers toevoegen per verzoek
Passend gebruiksscenario Eerstegraads klanten- als de klant eigenaar is van de accountnummers Derdegraads klanten- als de klant trackingnummers heeft die eigendom zijn van eerstegraads klanten

 

FedEx geïntegreerde zichtbaarheid – functievergelijking per abonnementstype

Functie/gegevenselement Abonnement op basis van tracking-nummers Abonnement op basis van accountnummers Opmerkingen
SPOD (Bewijs met handtekening) Niet beschikbaar Beschikbaar (configuratie vereist) Handtekeningsafbeelding in TIFF-indeling, geleverd in laadvermogen
PPOD (Bewijs van aflevering met foto) Beschikbaar (configuratie vereist) Beschikbaar (configuratie vereist) JPEG-afbeelding van afleverlocatie, Base64-gecodeerd
PPODA (Bewijs van afleverpogingen met foto) Beschikbaar (configuratie vereist) Beschikbaar (configuratie vereist) Afleverpogingen, JPEG-afbeelding gegeven
GPS-coördinaten (gpsPodCoordinates) Niet beschikbaar Beschikbaar Gemaskeerd in abonnementen op basis van trackingnummer
Contactinformatie (naam, telefoonnummer, bedrijf) Gemaskeerd Beschikbaar Binnen afzender, ontvanger, herkomst, bestemming, inklaringsagent, etc.
Adres en postcode Gemaskeerd Beschikbaar streetLines en postalCode zijn gemaskeerd in laadvermogens op basis van trackingnummer
Accountnummers Gemaskeerd Beschikbaar Inclusief billTo, afzender en ontvangeraccountwaardes
Pakketfinanciën (bijv., declaredValue, codAmount) Gemaskeerd Beschikbaar Douane, Rembourszending (COD, Collect on delivery) en aangegeven waardes zijn gemaskeerd
Gegevens over aanvragen en retourzendingen (aanvraagcodes, redenen voor retourzending) Gemaskeerd Beschikbaar De volledige gegevens worden alleen weergegeven voor abonnees met accounts
Gegevens over artikelen en inhoud Gemaskeerd Beschikbaar Omvat onderdelencodes, beschrijvingen, hoeveelheden
Medewerker-ID (bijv., personeel voor gebeurtenissen) Gemaskeerd Niet beschikbaar Die worden in beide gevallen om privacyredenen gemaskeerd
Gebeurtenismeldingen & EDD/EDTW Beschikbaar Beschikbaar De functies voor verwachte leverdatum/-tijd worden op beide ondersteund
Zending die uit meerdere pakketten bestaat (MPS) Beschikbaar Beschikbaar Met aanvullende trackinginformatie
Vertrouwens- en risicoscores voor verwachte levering Beschikbaar Beschikbaar Alleen onderdeel van premium niveau

 

Gemaskeerde velden voor een op trackingnummer gebaseerd abonnement voor Geavanceerde geïntegreerde zichtbaarheid

Overzicht

Wanneer klanten zich abonneren op zendingstrackingupdates met het op trackingnummer gebaseerde abonnement voor Geavanceerde geïntegreerde zichtbaarheid in plaats van het op accountnummer gebaseerde abonnement voor Geavanceerde geïntegreerde zichtbaarheid, worden specifieke gegevensvelden gemaskeerd om de privacy van de klant te waarborgen en de gegevensbeveiligingsbeleidsregels na te leven.

Het maskeren zorgt ervoor dat gevoelige informatie, zoals persoonlijke contactgegevens, adressen en financiële waardes, alleen toegankelijk zijn voor geautoriseerde partijen. Klanten die het op trackingnummer gebaseerde abonnement voor Geavanceerde geïntegreerde zichtbaarheid gebruiken, zien 'XXXXX' voor de gemaskeerde velden die hieronder staan, hoewel deze gegevens beschikbaar kunnen zijn via het op trackingnummer gebaseerde abonnement voor Geavanceerde geïntegreerde zichtbaarheid.

De implicaties van die maskering zijn:

  • Beperkte zichtbaarheid in herkomst-/bestemmingsgegevens en betrokken partijen.
  • Het ontbreken van persoonlijke identificatoren (bijv. namen, telefoonnummers) en financiële of douanegerelateerde gegevens.
  • Ontworpen bescherming van eigendoms- of gevoelige zendingsinformatie voor de naleving van beveiliging en wetgeving.

Klanten die toegang nodig hebben tot deze gemaskeerde velden voor operationele of zakelijke gebruiksscenario's, wordt geadviseerd om zich aan te melden met hun Accountnummer.

Gegevenspunten die zijn GEMASKEERD in het op trackingnummer gebaseerde abonnement voor Geavanceerde geïntegreerde zichtbaarheid:

Scanactiviteiten

  • 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

Informatie afzender

  • 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

Gegevens geadresseerde

  • 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

Herkomst- en bestemmingslocatie

  • 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

Leverings- en adreswijzigingsgegevens

  • 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

Gegevens inklaringsagent

  • 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

Pakket- en financiële gegevens

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

Aanvraag- en artikelinformatie

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

Inhoud van het pakket en reden voor retourzending

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

Factureringsgegevens

  • trackResult/billToParties/[Array]/billToParty/accountNumber

Voordelen voor de klant:

  • Verbeter het vertrouwen van de ontvanger met proactieve meldingen voor wijzigingen onderweg in de verwachte leverdatum en het tijdvenster van de leverdatum.
  • Verminder de kosten van de klantenservice voor WISMO-oproepen (waar is mijn bestelling) en leveringsgeschillen door een foto van het bewijs van aflevering van FedEx te leveren.
  • Verbeter de klantervaring door bijna in real time meldingen over de verzendstatus te geven.
  • Verhoog de operationele efficiëntie door in real time gepushte updates over zendingen te ontvangen, in plaats van voortdurend te moeten controleren of er voor elke zending trackingupdates zijn.

Functies en trackinggebeurtenissen


Trackinggebeurtenissen

Met deze functie kan de status van zendingen worden getraceerd en worden klanten proactief op de hoogte gehouden van verschillende updates tijdens de zending. Klanten hebben de mogelijkheid om te kiezen voor welke fase van de zending of gebeurtenissen ze specifiek een melding/waarschuwing willen ontvangen. De beschikbare verzendgebeurtenissen zijn:

  • Verzenden: met deze optie ontvangt u een melding zodra de geselecteerde verzendgebeurtenis plaatsvindt. Bijvoorbeeld: label aangemaakt, opgehaald, enz.
  • Onderweg: met deze optie ontvangt u een melding voor gebeurtenissen tijdens het transport van de zending. Bijvoorbeeld: onderweg, artikel vastgehouden op afleverkantoor, enz.
  • Aflevering: met deze optie ontvangt u een melding voor gebeurtenissen tijdens de aflevering van de zending. Bijvoorbeeld, onderweg voor bezorging, afgeleverd, enz.
  • Uitzonderingen: met deze optie ontvangt u meldingen voor afleveruitzonderingen. Bijvoorbeeld: vertragingen bij inklaring, enz.
  • Handige afleveropties: selecteer deze optie om meldingen te ontvangen voor een aantal gepersonaliseerde trackinggebeurtenissen. Bijvoorbeeld: aanvraag voor vasthouden op locatie geaccepteerd.

Raadpleeg de tabel Statuscodes en Statussen van Geavanceerde geïntegreerde zichtbaarheid-trackinggebeurtenissen voor meer informatie over de beschikbare opties voor verzendgebeurtenissen.


Bewijs van aflevering


Deze functie bevestigt dat een bestelling op de beoogde bestemming is aangekomen. Dit omvat:

  • Bewijs van aflevering met foto (PPOD): met PPOD kunnen klanten een foto ontvangen die de exacte locatie van hun pakket toont nadat het bij hun voordeur is afgeleverd.
    Geavanceerde geïntegreerde zichtbaarheid levert de PPOD-afbeeldingen in het JSON-laadvermogen in een Base64-indeling. De afbeeldingen kunnen vervolgens in een JPEG-indeling worden omgezet.

    Opmerking:

    • PPOD is beschikbaar in de VS, Canada, Puerto Rico, Hongkong, Nieuw-Zeeland, het Verenigd Koninkrijk en Ierland.
    • PPOD is alleen beschikbaar voor FedEx Ground, FedEx Express en particuliere pakketten/adressen.
    • PPOD is beschikbaar voor in aanmerking komende bezorgingen wanneer SPOD niet is vereist. PPOD en SPOD zijn niet tegelijk beschikbaar.
    • PPOD is beschikbaar voor afleveringen waarvoor geen handtekening is vereist en die niet rechtstreeks aan een klant worden overgedragen (bijv. rechtstreeks aan een klant overgedragen tijdens bezorging).
    • PPOD ondersteunt een afbeeldingsformaat tussen 14000 en 33000 bytes (van toepassing op afbeeldingen met een resolutie van 320 x 240).

     

  • Bewijs van afleverpoging met foto (PPODA): PPODA stelt klanten in staat om een foto te ontvangen van de exacte locatie waarop het pakket is geleverd, indien de levering niet kan worden voltooid. Advanced Integrated Visibility levert de PPODA-afbeeldingen in het JSON-laadvermogen in een Base64-indeling. De afbeeldingen kunnen vervolgens naar een JPEG-indeling worden omgezet.
    • PPODA is beschikbaar in de VS en Puerto Rico.
    • PPODA is alleen beschikbaar voor FedEx Ground, FedEx Express en particuliere en commerciële pakketten/adressen.
    • PPODA-afbeelding kan zijn:
      1. PPODA-afbeelding van een deurlabel aan een deur.
      2. Foto van belemmering voor het afleverpunt (bijv. een gesloten poort).
      3. PPOD-afbeelding van pakketten geleverd op de stopplaats.
    • PPODA ondersteunt een afbeeldingsformaat tussen 14000 en 33000 bytes (van toepassing op afbeeldingen met een resolutie van 320 x 240).
  •  

  • Bewijs met handtekening (SPOD): met SPOD kunnen klanten een afbeelding krijgen van de handtekening van de ontvanger, evenals hun naam, de afleverdatum, tijd en locatie. De SPOD-informatie wordt weergegeven als een bytereeks in plaats van een afbeelding. De bytereeks is een base64-gecodeerde tekenreeks die moet worden gedecodeerd om de uiteindelijke handtekeningafbeelding in PNG-indeling te krijgen
    • SPOD is niet beschikbaar voor op trackingnummer gebaseerde abonnementen voor Geavanceerde geïntegreerde zichtbaarheid.
    • Het formaat van de SPOD-afbeelding is tussen 4000 en 6000 bytes (van toepassing op afbeeldingen met een resolutie van 400 x 95).
    • Het formaat van de SPOD-afbeelding is tussen 5000 en 8000 bytes (van toepassing op afbeeldingen met een resolutie van 230 x 150).
  •  

  • GPS bewijs van aflevering (GPSPOD):
    • Met GPS POD kunnen klanten de geografische coördinaten ontvangen van de afleverlocatie.

      Let op: GPSPOD is standaard beschikbaar voor op accountnummer gebaseerde abonnementen voor Geavanceerde geïntegreerde zichtbaarheid.

Gebeurtenissen voor verwachte leverdatum en tijdvenster van aflevering


Deze functie helpt ontvangers van de zendingen bij het plannen van hun schema door een datumbereik en/of tijdsperiode voor zendingsleveringen aan te bieden. Dit omvat:

  • Verwachte leverdatum (EDD): met deze optie ontvangt de ontvanger een verwachte leverdatum van de zending. Bijvoorbeeld: 20 november 20XX.
  • Geschatte leverperiode (EDTW): met deze optie ontvangt de ontvanger een geschat tijdvenster voor de levering van de zending op de dag van aflevering. Bijvoorbeeld: tussen 14.00 en 18.00 uur.


Filteren op basis van gebeurtenissen


Met deze functie kunnen klanten hun webhookprojecten ordenen op basis van de factureringsmethoden voor de zendingen. De opties zijn:

  • Import: selecteer deze optie voor zendingen die aan u worden afgeleverd en door u als ontvanger worden betaald.
  • Uitgaand: selecteer deze optie voor zendingen die door u worden verzonden en door u als verzender worden betaald.
  • Extern: selecteer deze optie voor import- of uitgaande zendingen die bij u als externe betaler in rekening worden gebracht.

Opmerking: uw FedEx-accountnummer wordt gebruikt om de zendingen te factureren of betalen. Als externe betaler bent u mogelijk niet de afzender of ontvanger, maar worden de kosten wel via uw FedEx-accountnummer in rekening gebracht.


Beleid voor opnieuw proberen

Deze functie voorkomt dat FedEx trackinggebeurtenisgegevens verzendt wanneer er een probleem is aan de klantzijde. FedEx bewaart de gegevens en probeert ze 3 keer opnieuw te verzenden binnen intervallen van 5 minuten.

Als FedEx binnen de bepaalde tijd geen succesvolle reactie ontvangt, stopt FedEx met het opnieuw leveren van die specifieke gebeurtenis. De klant kan echter een verzoek indienen voor gemiste gebeurtenissen van de afgelopen 7 dagen via een handmatige knop 'OPNIEUW PROBEREN' op de pagina met gegevens van het Advanced Integrated Visibility-webhookproject.

Raadpleeg het gedeelte Mechanismen voor opnieuw proberen voor meer informatie over het beleid voor opnieuw proberen.

CLOSE

Response

Copy