Tipi di webhook di Visibilità integrata avanzata
Il webhook di Visibilità integrata avanzata consente a FedEx di inviare quasi in tempo reale dati sugli eventi di monitoraggio protetti a un URL di destinazione per le spedizioni associate a uno o più Codici Cliente FedEx specifici.
Potete creare un progetto webhook di Visibilità integrata avanzata sul FedEx Developer Portal e poi associarlo a uno o più Codici Cliente FedEx o numeri di monitoraggio FedEx in base al tipo di sottoscrizione selezionato.
Accedete a:
SOTTOSCRIZIONE DEI CODICI CLIENTE DI VISIBILITÀ INTEGRATA AVANZATA o SOTTOSCRIZIONE DEI NUMERI DI MONITORAGGIO DI VISIBILITÀ INTEGRATA AVANZATA, per visualizzare i passaggi per creare il rispettivo webhook di Visibilità integrata avanzata.
Panoramica sulla Visibilità integrata avanzata FedEx
I clienti FedEx possono iscriversi a un Codice Cliente o un numero di monitoraggio per ricevere gli eventi della spedizione in transito quasi in tempo reale, dalla creazione dell'etichetta per la prova di consegna dei colli, inclusa la Prova di consegna fotografica.
Tipi di sottoscrizione
I clienti FedEx possono effettuare la sottoscrizione alla Visibilità integrata avanzata scegliendo tra le opzioni seguenti:
- Per Codice Cliente: sottoscrivete un Codice Cliente FedEx per ricevere aggiornamenti sulle spedizioni abbinate ad esso.
- Per numero di monitoraggio: iscrivetevi al Numero di monitoraggio FedEx per ricevere aggiornamenti sulle spedizioni corrispondenti ai numeri di monitoraggio specificati tramite endpoint API.
Nota: attualmente per la fatturazione le sottoscrizioni richiedono un Codice Cliente FedEx a 9 cifre valido negli Stati Uniti. Ai clienti viene addebitata una quota mensile in base alla quantità di numeri di monitoraggio. Per maggiori informazioni sulle tariffe di Visibilità integrata avanzata, consultate la Guida alle tariffe - Panoramica sulla Visibilità integrata avanzata.
Se siete iscritti tramite Codice Cliente, le iscrizioni al momento richiedono Codici Cliente di spedizione FedEx a 9 cifre con sede negli Stati Uniti.
La tabella seguente offre informazioni sulle funzioni di sottoscrizione dei Codici Cliente e di sottoscrizione dei numeri di monitoraggio alla Visibilità integrata avanzata
| Funzioni | Sottoscrizione dei Codici Cliente | Sottoscrizione dei numeri di monitoraggio |
|---|---|---|
| Risposta | Dati protetti = dati relativi alle informazioni di identificazione personale - Dati del mittente e del destinatario - CDO (Opzione di consegna utile) Prova di consegna firmata (SPOD)/risposta | Dati anonimi (aggiornamenti sulla spedizione/in transita) escluse le PII (informazioni di identificazione personale)/risposta |
| Associazione | Associazione tramite Codice Cliente = Associazione di tutti i numeri di monitoraggio collegati contemporaneamente | Associazione dei numeri di monitoraggio |
| Proprietà | I Codici Cliente devono essere di proprietà dell'utente stesso | I numeri di monitoraggio non devono necessariamente essere di proprietà dell'utente |
| Filtri | Possibilità di filtrare gli eventi per spedizioni in ingresso, in uscita e di terzi |
Non è possibile filtrare gli eventi |
| Integrazione | L'associazione dei Codici Cliente avviene tramite l'interfaccia utente | L'associazione dei numeri di monitoraggio avviene tramite endpoint API |
| Limitazione | È possibile aggiungere fino a 100 Codici Cliente | È possibile aggiungere fino a 1.000 numeri di monitoraggio per richiesta |
| Caso d'uso adeguato | Clienti di prima parte: se il cliente è proprietario dei Codici Cliente | Clienti di terze parti: se il cliente dispone di numeri di monitoraggio appartenenti a clienti di prima parte |
Visibilità integrata FedEx: confronto delle funzionalità per tipo di sottoscrizione
| Funzionalità/elemento dati | Sottoscrizione dei numeri di monitoraggio | Sottoscrizione dei Codici Cliente | Note |
|---|---|---|---|
| Prova di consegna firmata (SPOD) | Non disponibile | Disponibile (necessaria configurazione) | Immagine della firma in formato TIFF, inviata nel carico utile |
| Prova di consegna fotografica (PPOD) | Disponibile (necessaria configurazione) | Disponibile (necessaria configurazione) | Immagine JPEG della posizione di consegna, con codifica Base64 |
| Prova fotografica di tentata consegna (PPODA) | Disponibile (necessaria configurazione) | Disponibile (necessaria configurazione) | Per i tentativi di consegna, viene fornita un'immagine JPEG |
| Coordinate GPS (gpsPodCoordinates) | Non disponibile | disponibili | Mascherate nelle sottoscrizioni basate su monitoraggio |
| Informazioni di contatto (nome, telefono, azienda) | Mascherate | disponibili | Tra mittente, destinatario, origine, destinazione, broker, ecc. |
| Indirizzo e codice postale | Mascherate | disponibili | i valori streetLines e postalCode sono mascherati nei carichi utili basati su monitoraggio |
| Codici Cliente | Mascherate | disponibili | Include i valori del Codice Cliente billTo, del mittente e del destinatario |
| Dati finanziari del collo (ad es. declaredValue, codAmount) | Mascherate | disponibili | I valori di dogana, pagamento in contrassegno e dichiarati sono mascherati |
| Dettagli di richieste e resi (codici di richiesta, motivi del reso) | Mascherate | disponibili | Dettagli completi mostrati solo agli utenti con sottoscrizione basata su Codice Cliente |
| Dati su merce e contenuti | Mascherate | disponibili | Include codici parte, descrizioni, quantità |
| ID dipendente (ad es. personale dell'evento) | Mascherate | Non disponibile | Mascherato in entrambi i casi per questioni di privacy |
| Notifiche sugli eventi e funzionalità EDD/EDTW | disponibili | disponibili | Funzionalità di data/ora di consegna stimata supportata in entrambe le opzioni |
| Spedizione multicollo | disponibili | disponibili | Con informazioni di monitoraggio aggiuntive |
| Punteggi di fiducia e rischio sulla consegna stimata | disponibili | disponibili | Opzione esclusiva del livello Premium |
Campi dati mascherati per la Sottoscrizione del Numero di monitoraggio a Visibilità integrata avanzata
Riepilogo
Quando i clienti effettuano la sottoscrizione agli aggiornamenti del monitoraggio delle spedizioni con la Sottoscrizione dei numeri di monitoraggio alla Visibilità integrata avanzata anziché la Sottoscrizione dei Codici Cliente alla Visibilità integrata avanzata, alcuni campi dati specifici vengono mascherati per tutelare la privacy del cliente e per adempiere alle policy di sicurezza dei dati.
Il mascheramento garantisce che le informazioni sensibili, come dettagli di contatto personali, indirizzi e valori finanziari, siano accessibili solo alle parti autorizzate. I clienti che utilizzano la Sottoscrizione dei numeri di monitoraggio alla Visibilità integrata avanzata vedranno "XXXXX" per i campi mascherati elencati di seguito, anche se tali dati potrebbero essere ancora disponibili attraverso la Sottoscrizione dei numeri di monitoraggio alla Visibilità integrata avanzata.
Le implicazioni di questo mascheramento includono:
- Visibilità limitata rispetto ai dettagli di origine/destinazione e alle parti coinvolte.
- Assenza di identificatori personali (ad es. nomi, numeri di telefono) e dati finanziari o relativi alla dogana.
- Protezione progettata delle informazioni di spedizione proprietarie o sensibili per garantire sicurezza e conformità normativa.
Ai clienti che necessitano dell'accesso ai campi mascherati per casi d'uso operativi o aziendali si consiglia di effettuare la sottoscrizione con il proprio Codice Cliente.
I punti dati contrassegnati come MASCHERATO nella Sottoscrizione dei numeri di monitoraggio alla Visibilità integrata avanzata:
Eventi di scansione
- 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
Dati del mittente
- 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
Dati destinatario
- 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
Posizione di origine e destinazione
- 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
Dettagli delle modifiche relative a consegna e indirizzo
- 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
Informazioni sul Broker
- 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
Dettagli del collo e finanziari
- trackResult/packageDetail/customsValue/value
- trackResult/packageDetail/declaredValue/value
- trackResult/packageDetail/originalTransportationCharge/value
- trackResult/codDetail/codAmount/value
Informazioni su richieste e merce
- trackResult/inquiries/[Array]/categoryCode
- trackResult/inquiries/[Array]/code
- trackResult/inquiries/[Array]/createTime
- trackResult/inquiries/[Array]/statusCode
- trackResult/commodityInfo/[Array]/description
- trackResult/commodityInfo/[Array]/code
Contenuti del collo e motivi del reso
- trackResult/contents/[Array]/partNumber
- trackResult/contents/[Array]/partCode
- trackResult/contents/[Array]/description
- trackResult/contents/[Array]/quantity
- trackResult/returnReason/[Array]/code
- trackResult/returnReason/[Array]/description
Dati fatturazione
- trackResult/billToParties/[Array]/billToParty/accountNumber
Vantaggi per il cliente:
- Aumentate la fiducia dei destinatari con notifiche proattive per le modifiche in transito alla data di consegna stimata e alla finestra temporale del giorno di consegna.
- Riducete i costi del servizio clienti per le chiamate "Dov'è il mio ordine" (WISMO, Where Is My Order) e le controversie sulla consegna fornendo una Prova di consegna fotografica FedEx.
- Migliorate l'esperienza dei clienti fornendo notifiche quasi in tempo reale sullo stato della spedizione.
- Ottenete efficienza operativa ricevendo aggiornamenti push in tempo reale sulle spedizioni, invece di dover sempre controllare gli aggiornamenti sul monitoraggio per ogni spedizione.
Funzioni e monitoraggio degli eventi
Monitoraggio degli eventi
Questa funzione consente di monitorare lo stato delle spedizioni inviando loro notifiche proattive su vari aggiornamenti del ciclo di spedizione. Fornisce ai clienti la possibilità di scegliere la fase esatta del processo/degli eventi di spedizione per cui desiderano ricevere una notifica/un avviso. Gli eventi di spedizione disponibili sono:
- Spedito: questa opzione fornisce una notifica quando si verifica l'evento di spedizione selezionato. Esempio: etichetta creata, ritiro, ecc...
- In transito: questa opzione fornisce una notifica per gli eventi di transito della spedizione. Esempio: in transito, articolo trattenuto presso l'ufficio di consegna, ecc...
- Consegna: questa opzione fornisce una notifica per gli eventi di consegna della spedizione. Esempio: in consegna, consegnato, ecc...
- Eccezioni: questa opzione fornisce una notifica per le eccezioni di consegna. Esempio: ritardo per operazioni di sdoganamento, ecc...
- Opzioni di consegna utili: selezionate questa opzione per ricevere notifiche per alcuni eventi di monitoraggio personalizzati. Esempio: richiesta di HAL (Fermo deposito) accettata, ecc...
Per maggiori informazioni sulle opzioni disponibili per gli eventi di spedizione, consultate la tabella Codici di stato e stati degli eventi di monitoraggio della Visibilità integrata avanzata.
Prova di consegna
Questa funzionalità viene utilizzata per confermare che l'ordine è arrivato a destinazione. Ciò include:
- Prova di consegna fotografica (PPOD): consente ai clienti di ricevere una foto che mostra l'esatta posizione del collo una volta consegnato alla porta di casa.
La Visibilità integrata avanzata fornisce le immagini della prova di consegna fotografica (PPOD) nel carico utile JSON in formato Base64. Le immagini possono poi essere convertite in formato JPEG.
Nota:
- La Prova di consegna fotografica è disponibile nei seguenti Paesi: Stati Uniti, Canada, Porto Rico, Hong Kong, Nuova Zelanda, Regno Unito e Irlanda.
- La Prova di consegna fotografica è disponibile solo per FedEx Ground, FedEx Express e per colli per indirizzi privati.
- La Prova di consegna fotografica è disponibile per le consegne idonee nel caso in cui non è richiesta la Prova di consegna firmata. La Prova di consegna fotografica e la Prova di consegna firmata non sono utilizzabili insieme.
- La Prova di consegna fotografica è disponibile per le consegne a Nessuna firma richiesta (NSR) che non vengono consegnate direttamente a un cliente (es. spedizioni date in mano direttamente al cliente durante la consegna).
- La Prova di consegna fotografica supporta immagini di dimensioni comprese tra 14.000 e 33.000 byte (applicabili a immagini con risoluzione 320 x 240).
- Fotografia della prova del tentativo di consegna (PPODA, Picture Proof of Delivery Attempt): il servizio PPODA consente ai clienti di ricevere una foto che mostra l'esatta posizione in cui il collo deve essere consegnato, nel caso in cui la consegna non possa essere completata. La Visibilità integrata avanzata fornisce le immagini della prova di consegna fotografica (PPOD) nel carico utile JSON in formato Base64. Le immagini possono poi essere convertite in formato JPEG.
- La PPODA è disponibile negli Stati Uniti e a Porto Rico.
- La PPODA è disponibile solo per FedEx Ground, FedEx Express e per colli per indirizzi privati e aziendali.
- L'immagine PPODA può essere:
- Fotografia PPODA dell'Avviso di tentativo di consegna sulla porta.
- Fotografia dell'ostruzione nel punto di consegna (ad es., cancello chiuso).
- Immagine PPOD dei colli consegnati alla fermata.
- La PPODA supporta immagini di dimensioni comprese tra 14.000 e 33.000 byte (applicabili a una risoluzione 320 x 240)
- Prova di consegna firmata (SPOD): consente ai clienti di ricevere un'immagine della firma del destinatario, oltre al nome, alla data, all'ora e al luogo di consegna. L'informazione sulla Prova di consegna firmata (SPOD) sarà presentata con un'array di byte al posto di un'immagine. L'array di byte è una stringa codificata base64 che deve essere decodificata per avere l'immagine della firma definitiva in formato PNG.
- Il servizio SPOD non è disponibile per la Sottoscrizione dei numeri di monitoraggio alla Visibilità integrata avanzata.
- La dimensione dell'immagine della Prova di consegna firmata (SPOD) sarà compresa tra 4.000 e 6.000 byte (applicabile a immagini con risoluzione 400 x 95).
- La dimensione dell'immagine della Prova di consegna firmata (SPOD) sarà compresa tra 5.000 e 8.000 byte (applicabile a immagini con risoluzione 230 x 150).
- Prova di consegna GPS (GPSPOD):
- La Prova di consegna GPS consente ai clienti di ricevere le coordinate geografiche del luogo di consegna.
Nota: il servizio GPSPOD è disponibile per impostazione predefinita per la Sottoscrizione dei Codici Cliente alla Visibilità integrata avanzata.
- La Prova di consegna GPS consente ai clienti di ricevere le coordinate geografiche del luogo di consegna.
Eventi relativi alla finestra temporale e alla data di consegna stimate
Questa funzionalità aiuta i destinatari delle spedizioni a pianificare i propri programmi fornendo una data e/o un intervallo di tempo per le consegne delle spedizioni. Ciò include:
- Data di consegna stimata (EDD): questa opzione fornisce una data stimata di consegna della spedizione al destinatario. Esempio: 20 novembre 20XX.
- Alla finestra oraria di consegna stimata (EDTW): questa opzione fornisce al destinatario una finestra temporale stimata per la consegna della spedizione il giorno della consegna effettiva. Esempio: dalle 14:00 alle 18:00.
Filtro basato sugli eventi
Questa funzionalità consente ai clienti di organizzare i propri progetti webhook in base ai metodi di fatturazione delle spedizioni. Le opzioni sono:
- In ingresso: selezionate questa opzione per le spedizioni che vi verranno consegnate e saranno pagate da voi in qualità di destinatario.
- In uscita: selezionate questa opzione per le spedizioni che verranno spedite da voi e saranno pagate da voi in qualità di mittente.
- Terze parti: selezionate questa opzione per le spedizioni in ingresso e in uscita che vi vengono fatturate in qualità di soggetto terzo pagante.
Nota: il vostro Codice Cliente FedEx verrà utilizzato per fatturare o pagare le spedizioni. Per quanto riguarda il soggetto terzo pagante, potreste non essere il mittente o il destinatario, ma le spese verranno fatturate sul vostro Codice Cliente FedEx.
Criteri di ripetizione
Questa funzionalità impedisce a FedEx di inviare dati sugli eventi di monitoraggio in caso di problemi lato client. FedEx tratterrà i dati e tenterà di inviarli nuovamente entro un arco di 3 tentativi a intervalli di 5 minuti.
Se non ricevete una risposta positiva nell'intervallo di tempo stabilito, FedEx interrompe la riconsegna di quell'evento specifico. Tuttavia, il cliente può richiedere gli eventi non visualizzati negli ultimi 7 giorni attraverso il pulsante manuale "RIPROVA" nella pagina Dettagli del progetto webhook di Visibilità integrata avanzata.
Per ulteriori informazioni sui criteri di ripetizione, fare riferimento alla sezione Meccanismo di ripetizione.
