Arten von Advanced Integrated Visibility-Webhooks
Mit dem Advanced Integrated Visibility-Webhook kann FedEx in nahezu Echtzeit gesicherte Daten zu Sendungsverfolgungsereignissen an eine Ziel-URL senden, sofern die Sendung mit einer bestimmten FedEx Kundennummer verknüpft ist.
Sie können einen Advanced Integrated Visibility-Webhook im FedEx Developer Portal erstellen und ihn dann, je nach ausgewähltem Abonnementtyp, entweder mit einer oder mehreren FedEx Kundennummern oder FedEx Sendungsverfolgungsnummern verknüpfen.
Gehe zu:
ADVANCED INTEGRATED VISIBILITY-KUNDENNUMMER-ABONNEMENT oder ADVANCED INTEGRATED VISIBILITY-SENDUNGSNUMMER-ABONNEMENT zum Anzeigen der Schritte zum Erstellen des jeweiligen Advanced Integrated Visibility-Webhooks.
FedEx Advanced Integrated Visibility – Übersicht
FedEx Kund*innen können für eine Kunden- oder Sendungsverfolgungsnummer Updates in nahezu Echtzeit zu Sendungsereignissen während des Transports abonnieren – vom Erstellen des Etiketts bis zum Zustellnachweis der Pakete, einschließlich Zustellnachweisbild.
Abonnementtypen
FedEx Kund*innen können Advanced Integrated Visibility mit den folgenden Optionen abonnieren:
- Nach Kundennummer: Abonnieren Sie eine FedEx Kundennummer, um Updates für Sendungen zu erhalten, die mit dem Kundenkonto übereinstimmen.
- Nach Sendungsverfolgungsnummer: Mit einem Abonnement nach FedEx Sendungsverfolgungsnummer erhalten Sie Updates für Sendungen, die mit den über API-Endpunkte bereitgestellten spezifischen Sendungsverfolgungsnummern abgeglichen werden.
Hinweis: Für Abonnements ist derzeit eine neunstellige FedEx Kundennummer (USA) für die Rechnungsstellung erforderlich. Kund*innen wird basierend auf der Anzahl der Sendungsverfolgungsnummern monatlich eine Gebühr in Rechnung gestellt. Im Übersichts-Preisleitfaden für Advanced Integrated Visibility finden Sie weitere Informationen zu Advanced Integrated Visibility-Preisen.
Für ein Abonnement nach Kundennummer benötigen Sie derzeit ein 9-stelliges FedEx Versandkonto (USA).
In der folgenden Tabelle finden Sie Informationen zu den Besonderheiten des Kundennummer-Abonnements und des Advanced Integrated Visibility-Sendungsnummer-Abonnements.
| Funktionen | Kundennummer-Abonnement | Sendungsnummer-Abonnement |
|---|---|---|
| Antwort | Gesicherte Daten = Personenbezogene Daten von Versender*in und Empfänger*in SPOD CDOs (praktische Zustelloptionen)/Antwort | Anonyme Daten (einschließlich Sendung-, „Im Transit“-Updates, ausschließlich personenbezogene Daten/Antwort |
| Zuordnung | Zuordnung nach einer Kundennummer = Alle verknüpften Sendungsverfolgungsnummern werden gleichzeitig zugeordnet | Zuordnung von Sendungsverfolgungsnummern |
| Inhaberschaft | Kundennummern müssen im Besitz der Benutzer*innen sein | Sendungsverfolgungsnummern müssen nicht im Besitz der Benutzer*innen sein |
| Filterung | Bietet die Möglichkeit, Ereignisse nach eingehenden Sendungen, ausgehenden Sendungen und Sendungen Dritter zu filtern |
Ereignisse können nicht gefiltert werden |
| Integration | Zuordnung von Kundennummern über UI | Zuordnung von Sendungsverfolgungsnummern über API-Endpunkte |
| Beschränkung | Es können bis zu 100 Kundennummern hinzugefügt werden | Es können bis zu 1.000 Sendungsverfolgungsnummern pro Anfrage hinzugefügt werden |
| Passender Anwendungsfall | First-Party-Kund*innen: Wenn Kund*innen im Besitz der Kundennummern sind | Third-Party-Kund*innen: Wenn Kund*innen über Sendungsverfolgungsnummern verfügen, die First-Party-Kund*innen gehören |
FedEx Integrated Visibility – Funktionsvergleich nach Abonnementtyp
| Funktion/Datenelement | Sendungsnummer-Abonnement | Kundennummer-Abonnement | Anmerkungen |
|---|---|---|---|
| SPOD (Signature Proof of Delivery, Unterschriftsnachweis) | Nicht verfügbar | Verfügbar (Konfig. erforderlich) | Unterschriftsbild in TIFF-Format, in Payload bereitgestellt |
| PPOD (Picture Proof of Delivery, Zustellnachweis mit Bild) | Verfügbar (Konfig. erforderlich) | Verfügbar (Konfig. erforderlich) | JPEG-Bild des Zustellungsorts, base64-kodiert |
| PPODA (Picture Proof of Delivery Attempt, Zustellversuch mit Bild) | Verfügbar (Konfig. erforderlich) | Verfügbar (Konfig. erforderlich) | Bei Zustellerversuchen, JPEG-Bild bereitgestellt |
| GPS-Koordination (gpsPodCoordinates) | Nicht verfügbar | Verfügbar | In auf Sendungsverfolgungsnummern basierten Abonnements maskiert |
| Kontaktinformationen (Name, Rufnummer, Unternehmen) | Maskiert | Verfügbar | Für Versender*in, Emfpfänger*in, Ursprung, Bestimmungsort, Zollagent*in etc. |
| Adresse und Postleitzahl | Maskiert | Verfügbar | streetLines und postalCode werden in Payloads maskiert, die auf Sendungsverfolgungsnummern basieren |
| Kundennummern | Maskiert | Verfügbar | Enthält billTo, Kundennummern Versender*innen und Empfänger*innen |
| Finanzangaben zu Paket (z. B. declaredValue, codAmount) | Maskiert | Verfügbar | Zoll, Bezahlung per Nachnahme und deklarierte Werte sind maskiert |
| Details zu Anfragen und Rückgaben (Anfragecodes, Rückgabegrund) | Maskiert | Verfügbar | Vollständige Details nur bei kontobasierten Abonnent*innen |
| Daten zu Waren und Inhalten | Maskiert | Verfügbar | Enthält Teilecodes, Beschreibungen, Mengen |
| Mitarbeiter*innen-ID (z. B. Veranstaltungspersonal) | Maskiert | Nicht verfügbar | Aus Datenschutzgründen in beiden Fällen maskiert |
| Ereignisbenachrichtigung und EDD/EDTW | Verfügbar | Verfügbar | Bei beiden Optionen unterstützte Funktionen für Datum/Uhrzeit der voraussichtlichen Zustellung |
| Sendung mit mehreren Paketen (Multi-Parcel Shipment, MPS) | Verfügbar | Verfügbar | Mit zusätzlichen Sendungsverfolgungsinformationen |
| Zuverlässigkeits- und Risikobewertung für voraussichtliche Zustellung | Verfügbar | Verfügbar | Nur Teil der Premium-Stufe |
Maskierte Datenfelder für Advanced Integrated Visibility-Abonnements auf Basis der Sendungsverfolgungsnummer
Übersicht
Wenn Kund*innen Sendungsverfolgungs-Updates mithilfe des Advanced Integrated Visibility-Abonnements auf Basis der Sendungsverfolgungsnummer anstatt des Advanced Integrated Visibility-Abonnements auf Basis der Kundennummer abonnieren, werden bestimmte Datenfelder maskiert, um den Schutz von Kundendaten zu gewährleisten und Datensicherheitsrichtlinien einzuhalten.
Durch diese Maskierung wird sichergestellt, dass vertrauliche Informationen – wie persönliche Kontaktdaten, Adressen und finanzielle Werte – nur für berechtigte Personen zugänglich sind. Kund*innen mit einem Advanced Integrated Visibility-Abonnement auf Basis der Sendungsverfolgungsnummer wird bei den unten aufgeführten maskierten Feldern XXXXX angezeigt, auch wenn diese Daten über das Advanced Integrated Visibility-Abonnement auf Basis der Sendungsverfolgungsnummer verfügbar sein können.
Diese Maskierung hat folgende Konsequenzen:
- Begrenzte Einblicke in die Details für Ursprung/Bestimmungsort und beteiligte Parteien
- Fehlen von personenbezogenen Daten (z. B. Namen, Telefonnummern) und Finanz- oder Zolldaten
- Schutz proprietärer oder vertraulicher Sendungsinformationen aus Gründen der Sicherheit und der Einhaltung von Vorschriften.
Kund*innen, die für betriebliche oder geschäftliche Anwendungsfälle Zugriff auf diese maskierten Felder benötigen, sollten Updates mithilfe ihrer Kundennummer abonnieren.
Datenpunkte, die in Advanced Integrated Visibility-Abonnements auf Basis der Sendungsverfolgungsnummer MASKIERT sind:
Scan-Vorgänge
- 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
Absenderinformation
- 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
Empfängerinformationen
- 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
Ursprung und Bestimmungsort
- 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
Zustellungs- und Adressänderungsdetails
- 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
Zollagent-Informationen
- 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
Paket- und Finanzdetails
- trackResult/packageDetail/customsValue/value
- trackResult/packageDetail/declaredValue/value
- trackResult/packageDetail/originalTransportationCharge/value
- trackResult/codDetail/codAmount/value
Informationen zu Anfragen und Waren
- trackResult/inquiries/[Array]/categoryCode
- trackResult/inquiries/[Array]/code
- trackResult/inquiries/[Array]/createTime
- trackResult/inquiries/[Array]/statusCode
- trackResult/commodityInfo/[Array]/description
- trackResult/commodityInfo/[Array]/code
Paketinhalt und Rückgabegrund
- trackResult/contents/[Array]/partNumber
- trackResult/contents/[Array]/partCode
- trackResult/contents/[Array]/description
- trackResult/contents/[Array]/quantity
- trackResult/returnReason/[Array]/code
- trackResult/returnReason/[Array]/description
Rechnungsstellungsinformationen
- trackResult/billToParties/[Array]/billToParty/accountNumber
Vorteile für Kund*innen:
- Stärken Sie das Vertrauen des*der Empfänger*in mit proaktiven Benachrichtigungen zu Änderungen am voraussichtlichen Zustelldatum/Zeitfenster am Tag der Zustellung.
- Reduzieren Sie die Kosten für WISMO-Anrufe (Where Is My Order?) beim Kundendienst und für beanstandete Zustellungen, indem Sie FedEx einen P.O.D. (Proof of Delivery, Zustellnachweis) mit Bild bereitstellen.
- Verbessern Sie das Kundenerlebnis, indem Sie in nahezu Echtzeit Benachrichtigungen zum Versandstatus versenden.
- Verbessern Sie die betriebliche Effizienz, indem Sie Push-Benachrichtigungen zum aktuellen Stand von Sendungen in Echtzeit erhalten, anstatt ständig nach Updates für jede Sendung zu suchen.
Funktionen und Sendungsverfolgungsereignisse
Sendungsverfolgungsereignisse
Mit dieser Funktion können der Sendungsstatus verfolgt und Kund*innen proaktiv zu verschiedenen Updates im Lebenszyklus der Sendung informiert werden. Kund*innen erhalten die Option, die Phase des Sendungsprozesses bzw. das Sendungsereignis auszuwählen, für die eine Benachrichtigung/Warnung gesendet werden soll. Folgende Sendungsereignisse sind verfügbar:
- Versenden: Mit dieser Option wird eine Benachrichtigung gesendet, wenn das ausgewählte Sendungsereignis eintritt. Beispiel: Etikett erstellt, Abgeholt usw.
- In Transit: Mit dieser Option wird eine Benachrichtigung bei Ereignissen gesendet, die während des Transports auftreten. Beispiel: In Transit, Artikel im Zustellbüro usw.
- Zustellung: Mit dieser Option wird eine Benachrichtigung bei Ereignissen in Zusammenhang mit der Zustellung gesendet. Beispiel: In Zustellung, Zugestellt usw.
- Ausnahmen: Mit dieser Option wird eine Benachrichtigung bei Zustellausnahmen gesendet. Beispiel: Verzögerte Zollabfertigung usw.
- Praktische Zustelloptionen: Wählen Sie diese Option aus, um Benachrichtigungen über einige individuelle Sendungsverfolgungsereignisse zu erhalten. Beispiel: An Station zur Abholung bereithalten
Weitere Informationen zu den verfügbaren Optionen für Sendungsereignisse finden Sie in der Tabelle Statuscodes und Status für Advanced Integrated Visibility-Sendungsverfolgungsereignisse.
Zustellnachweis
Mit dieser Funktion wird bestätigt, dass eine Bestellung erfolgreich an ihrem Bestimmungsort angekommen ist. Sie umfasst Folgendes:
- Bildnachweis (Picture Proof of Delivery, PPOD): Beim Bildnachweis erhalten Kund*innen ein Foto, das den genauen Standort ihres Pakets zeigt, sobald es an ihrer Haustür zugestellt wurde.
Advanced Integrated Visibility liefert die PPOD-Bilder in der JSON-Payload in einem base64-Format. Die Bilder können dann in ein JPEG-Format umgewandelt werden.Hinweis:
- PPOD ist in den USA, in Kanada, in Puerto Rico, in Hongkong, in Neuseeland, im Vereinigten Königreich und in Irland erhältlich.
- PPOD ist nur für FedEx Ground, FedEx Express sowie für Pakete an Privatadressen verfügbar.
- PPOD ist für bestimmte Zustellungen verfügbar, wenn SPOD nicht erforderlich ist. PPOD und SPOD sind nicht in Kombination verfügbar.
- PPOD ist verfügbar für Zustellungen, bei denen keine Unterschrift erforderlich ist und die nicht direkt an eine*n Kund*in übergeben werden (z. B. nicht bei der Zustellung an eine*n Kund*in übergeben werden).
- PPOD unterstützt Bildgrößen von 14.000 bis 33.000 Bytes (gilt für Bilder mit einer Auflösung von 320 x 240).
- Bild von Zustellversuch (PPODA): Beim PPODA erhalten Kund*innen ein Foto, das den genauen Standort zeigt, an dem das Paket zugestellt werden soll, sofern die Zustellung nicht abgeschlossen werden kann. Advanced Integrated Visibility liefert die PPOD-Bilder in der JSON-Payload in einem base64-Format. Die Bilder können dann in ein JPEG-Format umgewandelt werden.
- PPODA ist in den USA und in Puerto Rico verfügbar.
- PPODA ist nur für FedEx Ground, FedEx Express sowie für Pakete an Privat- und Geschäftsadressen verfügbar.
- Inhalte des PPODA-Bildes:
- PPODA-Bild von Benachrichtigung (Door Tag) an Tür.
- Foto von Hindernis am Zustellpunkt (z. B. verschlossenes Tor).
- PPOD-Bild von den am Stopp zugestellten Paketen.
- PPODA unterstützt Bildgrößen von 14.000 bis 33.000 Bytes (gilt für Bilder mit einer Auflösung von 320 x 240).
- Unterschriftsnachweis (Signature Proof of Delivery, SPOD): Bei SPOD erhalten Kund*innen ein Bild der Unterschrift des*der Empfänger*in mit Name, Zustellungsdatum, -zeit und -standort. Die SPOD-Informationen werden als Byte-Array und nicht als Bild dargestellt. Das Byte-Array ist eine base64-kodierte Zeichenfolge, die dekodiert werden muss, um das endgültige Signaturbild im PNG-Format zu erhalten.
- SPOD (Signature Proof of Delivery, Unterschriftsnachweis) ist für Advanced Integrated Visibility-Abonnements auf Basis der Sendungsverfolgungsnummer nicht verfügbar.
- Die SPOD-Bildgröße liegt zwischen 4.000 und 6.000 Byte (gilt für Bilder mit einer Auflösung von 400 x 95).
- Die SPOD-Bildgröße liegt zwischen 5.000 und 8.000 Byte (gilt für Bilder mit einer Auflösung von 230 x150).
- GPS-Zustellnachweis (GPSPOD):
- Der GPSPOD ermöglicht es Kund*innen, die geografischen Koordinaten des Zustellorts abzurufen.
Note: GPSPOD ist standardmäßig für Advanced Integrated Visibility-Abonnements auf Basis der Kontonummer verfügbar.
- Der GPSPOD ermöglicht es Kund*innen, die geografischen Koordinaten des Zustellorts abzurufen.
Ereignisse „Voraussichtliches Zustelldatum“ und „Zeitfenster für die Zustellung“
Diese Funktion hilft den Empfänger*innen der Sendungen bei der Zeitplanung, indem ein Datum und/oder ein Zeitfenster für die Zustellung der Sendung angegeben wird. Sie umfasst Folgendes:
- Voraussichtliches Zustelldatum (Estimated delivery date, EDD): Diese Option stellt dem*der Empfänger*in ein voraussichtliches Zustelldatum der Sendung bereit. Beispiel: 20. November 20XX
- Zeitfenster für die voraussichtliche Zustellung (Estimated delivery time window, EDTW): Diese Option stellt dem*der Empfänger*in ein Zeitfenster für die voraussichtliche Zustellung der Sendung am Tag der aktuellen Zustellung bereit. Beispiel: 14:00 bis 18:00 Uhr.
Ereignisbasierte Filterung
Mit dieser Funktion können Kund*innen ihre Webhook-Projekte basierend auf der Art der Rechnungsstellung für Sendungen organisieren. Optionen:
- Eingehend: Wählen Sie diese Option für Sendungen aus, die Ihnen zugestellt werden und die von Ihnen als Empfänger*in bezahlt werden.
- Ausgehend: Wählen Sie diese Option für Sendungen aus, die von Ihnen versendet werden und die von Ihnen als Versender*in bezahlt werden.
- Dritte: Wählen Sie diese Option für eingehende oder ausgehende Sendungen aus, die Ihnen als Drittzahlende*r in Rechnung gestellt werden.
Hinweis: Ihre FedEx Kundennummer wird für die Abrechnung bzw. Bezahlung der Sendungen genutzt. Für den*die Drittzahlende*n sind Sie eventuell nicht der*die Versender*in oder der*die Empfänger*in, aber die Kosten werden Ihrer FedEx Kundennummer in Rechnung gestellt.
Einstellungen für erneutes Senden
Diese Funktion verhindert, dass FedEx im Falle eines clientseitigen Fehlers Daten zu Sendungsverfolgungsereignissen sendet. FedEx speichert die Daten und versucht, sie innerhalb von 3 Versuchen im Abstand von 5 Minuten erneut zu senden.
Wenn FedEx in der festgelegten Zeitspanne keine Antwort erhält, stoppt FedEx die erneute Zustellung dieses bestimmten Ereignisses. Der*die Kund*in kann jedoch verpasste Ereignisse der letzten 7 Tage über die Schaltfläche „ERNEUT VERSUCHEN“ auf der Advanced Integrated Visibility-Webhook-Projektdetailseite manuell anfordern.
Weitere Informationen zu den Einstellungen für erneutes Zustellen finden Sie im Abschnitt zum Mechanismus für erneutes Zustellen.
