Tipuri de webhookuri Advanced Integrated Visibility
Webhookul Advanced Integrated Visibility permite FedEx să transmită aproape în timp real date securizate privind evenimentele de urmărire către un URL de destinație pentru expedierile asociate cu un anumit număr de cont FedEx.
Puteți crea un proiect bazat pe webhookul Advanced Integrated Visibility pe FedEx Developer Portal și apoi îl puteți asocia cu unul sau mai multe numere de cont FedEx sau numere de urmărire FedEx, în funcție de tipul de abonament selectat.
Navigați la:
ÎNREGISTRARE CU NUMĂR CONT ADVANCED INTEGRATED VISIBILITY sau ÎNREGISTRARE CU NUMĂR DE URMĂRIRE ADVANCED INTEGRATED VISIBILITY , pentru a vedea pașii pentru crearea webhookului Advanced Integrated Visibility corespunzător.
Prezentarea generală a webhookului FedEx Advanced Integrated Visibility
Clienții FedEx se pot abona la un număr de cont sau la un număr de monitorizare pentru a primi aproape în timp real evenimentele de expediere în tranzit, începând de la crearea etichetei până la dovada de livrare a coletelor, inclusiv fotografia de confirmare de primire.
Tipuri de abonamente
Clienții FedEx se pot abona la Advanced Integrated Visibility prin următoarele opțiuni:
- Prin numărul de cont - Abonați-vă la un număr de cont FedEx pentru a primi actualizări pentru expedierile asociate contului.
- Prin numărul de monitorizare - Abonați-vă la un număr de monitorizare FedEx pentru a primi actualizări pentru expedierile potrivite cu numerele de monitorizare specificate prin punctele finale API.
Notă: În prezent, abonamentele necesită un număr de cont FedEx format din 9 cifre din SUA pentru facturare, iar clienților li se percepe o taxă lunară în funcție de volumul de numere de monitorizare. Pentru a afla mai multe despre prețurile webhookurilor Advanced Integrated Visibility, consultați Ghidul de prețuri pentru Advanced Integrated Visibility.
Dacă sunteți abonat prin numărul de cont, abonamentele necesită în prezent conturi de expediere FedEx din SUA, cu 9 cifre.
Tabelul de mai jos vă oferă informații despre funcționalitățile înregistrării pe bază de număr de cont și ale înregistrării pe bază de număr de urmărire pentru proiecte bazate pe webhookul Advanced Integrated Visibility
| Opțiuni | Abonament bazat pe numărul de cont | Abonamente bazat pe numere de urmărire |
|---|---|---|
| Răspuns | Datele securizate pentru webhook bazate pe numărul de monitorizare includ: date personale identificabile (PII)Date despre expeditor și destinatar, SPOD (opțiune convenabilă de livrare) și CDO (Convenient Delivery Option) / răspuns | Date anonime (includ expedieri și actualizări în tranzit, excluzând datele personale identificabile - PII)/răspuns |
| Asocierea | Asocierea unui număr de cont = Asocierea tuturor numerelor de monitorizare conectate simultan | Asocierea numerelor de monitorizare |
| Deținerea | Numerele de cont trebuie să fie deținute de utilizator | Nu este obligatoriu ca numerele de monitorizare să fie deținute de utilizator |
| Filtrarea | Oferă opțiunea de a filtra evenimentele după expedieri de import, de export și terțe |
Nu poate filtra evenimente |
| Integrarea | Asocierea numerelor de cont se face prin interfața de utilizare | Asocierea numerelor de monitorizare se face prin punctul final API |
| Limitarea | Se pot adăuga până la 100 de numere de cont | Se pot adăuga până la 1000 de numere de monitorizare per cerere |
| Scenariu de utilizare optim | Clienți direcți - Dacă clientul deține numerele de cont | Clienți terți - Dacă clientul are numere de monitorizare aparținând clienților direcți |
FedEx Integrated Visibility – Comparație între caracteristici în funcție de tipul de abonament
| Caracteristică/Element de date | Abonamente bazat pe numere de urmărire | Abonament bazat pe numărul de cont | Note |
|---|---|---|---|
| SPOD (Semnătură de confirmare de primire) | Indisponibil(ă) | Disponibil (configurare necesară) | Imagine a semnăturii în format TIFF, livrată în datele transmise |
| PPOD (Imagine a confirmării de primire) | Disponibil (configurare necesară) | Disponibil (configurare necesară) | Imagine JPEG a locației de livrare, codificată în base64 |
| PPODA (Imagine a încercărilor de confirmare de primire) | Disponibil (configurare necesară) | Disponibil (configurare necesară) | Pentru încercările de livrare, imaginea JPEG furnizată |
| Coordonate GPS (gpsPodCoordinates) | Indisponibil(ă) | Disponibilă | Mascate în abonamentele bazate pe urmărire |
| Informații de contact (nume, telefon, companie) | Mascate | Disponibilă | Pentru expeditor, destinatar, origine, destinație, broker etc. |
| Adresă și cod poștal | Mascate | Disponibilă | streetLines și postalCode sunt mascate în datele transmise bazate pe monitorizare |
| Numere de cont | Mascate | Disponibilă | Include valorile billTo, expeditor și cont destinatar |
| Informații financiare despre colete (de exemplu, declaredValue, codAmount) | Mascate | Disponibilă | Vamă, COD și valorile declarate sunt mascate |
| Detalii interogare și returnare (coduri de interogare, motive ale returnării) | Mascate | Disponibilă | Detalii complete afișate numai pentru abonații cu cont |
| Detalii marfă și conținut | Mascate | Disponibilă | Include coduri ale pieselor, descrieri, cantități |
| ID angajat (de exemplu, personal eveniment) | Mascate | Indisponibil(ă) | Mascate în ambele cazuri din motive de confidențialitate |
| Notificări evenimente și EDD/EDTW | Disponibilă | Disponibilă | Dată/Oră de livrare estimată acceptată pentru ambele |
| Expediere cu mai multe colete (MPS) | Disponibilă | Disponibilă | Cu informații suplimentare de monitorizare |
| Scoruri de încredere și risc pentru livrarea estimată | Disponibilă | Disponibilă | Numai Parte a nivelului Premium |
Câmpuri de date mascate pentru Abonare pe baza numărului de monitorizare la Advanced Integrated Visibility
Rezumat
Atunci când clienții se abonează la actualizările de monitorizare a expedierilor utilizând Abonare pe baza numărului de monitorizare la Advanced Integrated Visibility în loc de Abonare pe baza numărului de cont la Advanced Integrated Visibility, câmpurile de date specifice sunt mascate pentru a menține confidențialitatea clienților și a respecta politicile de securitate a datelor.
Această mascare asigură că informațiile sensibile – cum ar fi datele de contact personale, adresele și valorile financiare – sunt accesibile numai părților autorizate. Clienții care utilizează Abonamentul pe bază de număr de monitorizare la Advanced Integrated Visibility vor vedea „XXXXX” pentru câmpurile mascate enumerate mai jos, chiar dacă aceste date pot fi disponibile prin intermediul Abonamentului pe bază de număr de monitorizare la Advanced Integrated Visibility.
Implicațiile acestei mascări includ:
- Vizibilitate limitată a detaliilor privind originea/destinația și părțile implicate.
- Absența identificatorilor personali (de exemplu, nume, numere de telefon) și a datelor financiare sau vamale.
- Protecție proiectată a informațiilor de expediere confidențiale sau sensibile pentru securitate și conformitate cu reglementările.
Clienții care au nevoie de acces la aceste câmpuri mascate pentru cazuri operaționale sau de afaceri sunt sfătuiți să se aboneze folosind numărul de cont.
Puncte de date care sunt MASCATE în Abonare pe bază de număr de monitorizare la Advanced Integrated Visibility:
Evenimente de scanare
- 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
Informații privind expeditorul
- 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
Informații privind destinatarul
- 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
Locație origine și destinație
- 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
Detalii livrare și schimbare adresă
- 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
Informații privind brokerul
- 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
Package and Financial Details
- trackResult/packageDetail/customsValue/value
- trackResult/packageDetail/declaredValue/value
- trackResult/packageDetail/originalTransportationCharge/value
- trackResult/codDetail/codAmount/value
Interogare și informații privind marfa
- trackResult/inquiries/[Array]/categoryCode
- trackResult/inquiries/[Array]/code
- trackResult/inquiries/[Array]/createTime
- trackResult/inquiries/[Array]/statusCode
- trackResult/commodityInfo/[Array]/description
- trackResult/commodityInfo/[Array]/code
Conținut colet și motiv returnare
- trackResult/contents/[Array]/partNumber
- trackResult/contents/[Array]/partCode
- trackResult/contents/[Array]/description
- trackResult/contents/[Array]/quantity
- trackResult/returnReason/[Array]/code
- trackResult/returnReason/[Array]/description
Date de facturare
- trackResult/billToParties/[Array]/billToParty/accountNumber
Beneficiile clienților:
- Creșterea nivelului de încredere al destinatarilor prin notificări proactive despre modificările apărute în tranzit privind data de livrare estimată și intervalul de timp din ziua livrării.
- Reducerea costurilor de asistență clienți pentru apelurile WISMO (unde se află comanda mea), precum și litigiile legate de livrare prin furnizarea serviciului FedEx de Fotografie de confirmare de primire.
- Îmbunătățirea experienței clienților prin trimiterea notificărilor aproape în timp real cu privire la starea expedierilor.
- Creșterea eficienței operaționale prin primirea în timp real a actualizărilor push privind expedierile, în loc de o interogare continuă în vederea verificării actualizărilor de monitorizare pentru fiecare expediere.
Caracteristici și evenimente de monitorizare
Evenimente de monitorizare
Această caracteristică permite monitorizarea stării expedierilor și notificarea proactivă a clienților cu privire la diferite actualizări din ciclul de viață al expedierilor. Aceasta oferă clienților opțiuni pentru a alege etapa exactă a procesului/evenimentelor de expediere pentru care doresc să primească o notificare/alertă. Evenimentele de expediere disponibile sunt:
- Expediere: această opțiune oferă notificare când are loc evenimentul de expediere selectat. Exemplu: etichetă creată, preluare etc.
- În tranzit: această opțiune oferă notificare pentru evenimentele privind tranzitul expedierii. Exemplu: în tranzit, articol reținut la sediul de livrare etc.
- Livrare: această opțiune oferă notificare pentru evenimentele de livrare a expedierii. Exemplu: trimisă spre livrare, livrată etc.
- Excepții: această opțiune oferă notificare pentru excepțiile privind livrarea. Exemplu: întârziere la vămuire etc.
- Opțiuni de livrare convenabile: selectați această opțiune pentru a primi notificare pentru unele evenimente de monitorizare personalizată. Exemplu: solicitarea de reținere a expedierii în locație este acceptată.
Pentru mai multe informații despre opțiunile disponibile pentru evenimentele de expediere, consultați tabelul Coduri de stare și stări pentru evenimentele de monitorizare bazate pe Advanced Integrated Visibility .
Confirmare de primire
Această funcție este utilizată pentru a confirma că o comandă a ajuns cu succes la destinația prevăzută. Aceasta include:
- Fotografia de confirmare de primire (PPOD): PPOD permite clienților să primească o fotografie cu locația exactă a coletului odată ce acesta este livrat la ușa lor.
Advanced Integrated Visibility livrează imaginile PPOD în datele transmise JSON în format base64. Imaginile pot fi apoi convertite în format JPEG.
Notă:
- PPOD este o opțiune disponibilă în SUA, Canada, Puerto Rico, Hong Kong, Noua Zeelandă, Regatul Unit și Irlanda.
- PPOD este disponibil numai pentru FedEx Ground și FedEx Express și colete/adrese rezidențiale.
- PPOD este disponibil pentru livrările eligibile atunci când SPOD nu este necesar. PPOD și SPOD nu sunt disponibile împreună.
- PPOD este disponibilă pentru livrări care nu necesită o semnătură (NSR) și care nu sunt date direct unui client (de ex., înmânate direct unui client în timpul livrării).
- PPOD acceptă imagini cu dimensiuni de la 14.000 la 33.000 de octeți (aplicabil pentru imagini cu rezoluția de 320 x 240).
- Fotografie cu încercarea de confirmare de primire (PPODA): PPODA permite clienților să primească o fotografie cu locația exactă unde urmează să fie livrat coletul, în cazul în care livrarea nu poate fi finalizată. Advanced Integrated Visibility livrează imaginile PPODA în datele transmise JSON în format base64. Imaginile pot fi apoi convertite în format JPEG.
- Opțiunea PPODA este disponibilă în SUA și în Puerto Rico.
- Opțiunea PPODA este disponibilă doar pentru serviciile FedEx Ground, FedEx Express și pentru colete/adrese rezidențiale și comerciale.
- Imaginea PPODA poate fi:
- Fotografie PPODA cu biletul de notificare (Doortag) atașat pe ușă.
- Fotografie cu obstacolul care împiedică livrarea la punctul de destinație (de exemplu, o poartă încuiată).
- Imagine PPOD cu coletele livrate la locația de destinație.
- PPODA acceptă imagini cu dimensiuni de la 14.000 la 33.000 de octeți (aplicabil pentru imagini cu rezoluția de 320 x 240)
- Semnătură de confirmare de primire (SPOD): SPOD le permite clienților să primească o imagine a semnăturii destinatarului, precum și numele acestuia, data, ora și locația livrării. Informațiile SPOD (legate de semnătura care atestă confirmarea primirii expedierii) vor fi prezentate sub forma unui șir de octeți, și nu a unei imagini. Șirul de octeți este un șir codificat în bază 64, care trebuie decodificat pentru a obține imaginea finală a semnăturii, în format PNG
- SPOD nu este disponibil pentru Abonarea pe baza numărului de monitorizare la Integrated Visibility.
- Dimensiunea imaginii SPOD trebuie să fie între 4.000 și 6.000 de octeți (aplicabil pentru imagini cu rezoluția de 400 x 95).
- Dimensiunea imaginii SPOD trebuie să fie între 5.000 și 8.000 de octeți (aplicabil pentru imagini cu rezoluția de 230 x 150).
- Dovadă de livrare prin GPS (GPSPOD):
- GPSPOD permite clienților să primească coordonatele geografice ale locației de livrare.
Notă: GPSPOD nu este disponibil pentru Abonarea pe baza numărului de cont la Integrated Visibility
- GPSPOD permite clienților să primească coordonatele geografice ale locației de livrare.
Data de livrare estimată și evenimentele din cadrul intervalului de timp de livrare
Această funcție ajută destinatarii expedierilor să-și planifice programul, furnizând un interval de date și/sau de ore pentru livrările de expedieri. Aceasta include:
- Data de livrare estimată (EDD): această opțiune furnizează o dată de livrare estimată a expedierii către destinatar. Exemplu: 20 noiembrie 20XX.
- Intervalul de timp pentru livrare estimat (EDTW): această opțiune oferă destinatarului un interval de timp estimat pentru livrarea expedierii în ziua livrării efective. Exemplu: între orele 14:00 și 18:00.
Filtrare bazată pe evenimente
Această funcție permite clienților să-și organizeze proiectele de webhook pe baza metodelor de facturare pentru expedieri. Opțiunile sunt:
- Import: selectați această opțiune pentru expedierile care vor fi livrate către dumneavoastră și pe care le veți plăti în calitate de destinatar.
- Export: selectați această opțiune pentru expedierile care vor fi expediate de dumneavoastră și pe care le veți plăti în calitate de expeditor.
- Terță parte: selectați această opțiune pentru expedieri de import sau export care sunt facturate către dumneavoastră în calitate de plătitor terț.
Notă: numărul dvs. de cont FedEx va fi utilizat pentru facturarea sau plata expedierilor. În cazul unui plătitor terț, este posibil să nu fiți expeditorul sau destinatarul, dar taxele vor fi facturate către numărul dvs. de cont FedEx.
Politica de reîncercare
Această funcție nu permite FedEx să trimită date privind evenimentele de monitorizare în cazul în care apare o problemă la nivelul clientului. FedEx va reține datele și va încerca să le retrimită prin 3 reîncercări la intervale de 5 minute.
Dacă FedEx nu primește un răspuns corect în intervalul de timp definit, FedEx va opri retransmiterea pentru evenimentul respectiv. Totuși, clientul poate solicita evenimente ratate în ultimele 7 zile prin intermediul unui buton „REÎNCERCARE” manual din pagina Detalii proiect bazat pe webhookul Advanced Integrated Visibility.
Pentru mai multe informații despre politicile de reîncercare, consultați Mecanismul de reîncercare (secțiune).
