Laajennettu integroitu näkyvyys ‑webhookien tyypit
Laajennettu integroitu näkyvyys ‑webhookin avulla FedEx voi lähettää suojattuja seurantatapahtumatietoja lähes reaaliajassa määränpään URL-osoitteeseen lähetyksistä, jotka liittyvät tiettyyn FedEx-asiakasnumeroon (tiettyihin FedEx-asiakasnumeroihin).
Voit luoda Laajennettu integroitu näkyvyys ‑webhookprojektin FedEx Developer Portalissa ja sen jälkeen liittää sen yhteen tai useampaan FedEx-asiakasnumeroon tai FedEx-seurantanumeroon valitsemasi tilaustyypin perusteella.
Siirry kohtaan:
LAAJENNETTU INTEGROITU NÄKYVYYS ‑ASIAKASNUMEROTILAUS tai LAAJENNETTU INTEGROITU NÄKYVYYS -SEURANTANUMEROTILAUS, niin näet kyseisen Laajennettu integroitu näkyvyys ‑webhookin luontivaiheet.
FedExin Laajennettu integroitu näkyvyys ‑webhookien yleiskatsaus
FedExin asiakkaat voivat tilata asiakasnumeron tai seurantanumeron perusteella lähetettäviä päivityksiä matkalla olevan lähetyksen tapahtumista aina osoitelapun luomisesta pakettien toimitukseen asti (mukaan lukien kuvallinen toimitustodistus).
Tilaustyypit
FedExin asiakkaat voivat tilata Laajennetun integroidun näkyvyyden seuraavilla tavoilla:
- Asiakasnumero – tilaa FedEx-asiakasnumerolle päivityksiä asiakasnumeroa vastaavista lähetyksistä.
- Seurantanumero – tilaa FedEx-seurantanumeron päivitykset ja vastaanota päivityksiä määritettyihin seurantanumeroihin liitetyistä lähetyksistä API-päätepisteiden kautta.
Huomaa: Tilaukset edellyttävät tällä hetkellä yhdysvaltalaista FedExin 9-numeroista asiakasnumeroa laskutusta varten. Asiakkailta veloitetaan myös kuukausittainen maksu seurantanumeroiden määrän mukaan. Jos haluat lukea lisää Laajennetun integroidun näkyvyyden hinnoittelusta, tutustu Laajennettu integroitu näkyvyys -yleiskatsauksen hinnoitteluoppaaseen–.
Jos tilauksessa käytetään asiakasnumeroa, tällä hetkellä tilaukseen vaaditaan FedExin 9-numeroinen yhdysvaltalainen lähetysasiakasnumero.
Alla olevassa taulukossa on tietoja asiakasnumerotilauksen ja Laajennettu integroitu näkyvyys ‑seurantanumerotilauksen ominaisuuksista
| Toiminnot | Asiakasnumerotilaus | Seurantanumerotilaus |
|---|---|---|
| Vastaus | Suojatut tiedot = henkilöllisyyden määrittämistä koskevat tiedot, lähettäjän ja vastaanottajan tiedot (allekirjoitettu toimitustodistus, kätevät toimitusvaihtoehdot / vastaus) | Anonyymi tieto = lähetys, lähetyksen aikaiset päivitykset pois lukien henkilöllisyyden määrittämistä koskevat tiedot / vastaus |
| Yhteys | Liitetty yhteen asiakasnumeroon = koskee kaikkia yhdistettyjä seurantanumeroita | Liitetty seurantanumeroihin |
| Omistajuus | Käyttäjien on omistettavat omat asiakasnumeronsa | Käyttäjien ei tarvitse omistaa seurantanumeroita |
| Suodatus | Tapahtumia voi suodattaa saapuvien, lähtevien tai kolmannen osapuolen lähetysten mukaan |
Tapahtumia ei voi suodattaa |
| Integrointi | Asiakasnumeroilla on yhteys käyttöliittymän kautta | Seurantanumeroilla on yhteys API-päätepisteen kautta |
| Rajoitus | Voi lisätä enintään 100 asiakasnumeroa | Voi lisätä enintään 1 000 seurantanumeroa pyyntöä kohden |
| Soveltuva käyttötapaus | Ensimmäisen osapuolen asiakkaat – jos asiakas omistaa asiakasnumerot | Kolmannen osapuolen asiakkaat – jos asiakkaalla on seurantanumeroita, jotka kuuluvat ensimmäisen osapuolen asiakkaille |
FedExin integroitu näkyvyys – toiminnon vertailu tilaustyypin mukaan
| Toiminto/tietoelementti | Seurantanumerotilaus | Asiakasnumerotilaus | Huomautuksia |
|---|---|---|---|
| SPOD (Allekirjoitettu toimitustodistus) | Ei saatavilla | Käytettävissä (määritys on pakollinen) | Allekirjoituskuva TIFF-tiedostomuodossa, toimitetaan hyötykuormassa |
| PPOD (kuvallinen toimitustodistus) | Käytettävissä (määritys on pakollinen) | Käytettävissä (määritys on pakollinen) | Toimitusosoitteen JPEG-kuva, base64-koodattu |
| PPODA (kuvallinen toimitusyritystodistus) | Käytettävissä (määritys on pakollinen) | Käytettävissä (määritys on pakollinen) | Toimitusyrityksiä varten toimitetaan JPEG-kuva |
| GPS-koordinaatit (gpsPodCoordinates) | Ei saatavilla | Käytettävissä | Peitetty seurantaan perustuvissa tilauksissa |
| Yhteystiedot (nimi, puhelinnumero, yritys) | Peitetty | Käytettävissä | Lähettäjä, vastaanottaja, lähetyspaikka, määränpää, huolitsija jne. |
| Katuosoite ja postinumero | Peitetty | Käytettävissä | streetLines ja postalCode peitetään seurantaan perustuvissa hyötykuormissa |
| Asiakasnumerot | Peitetty | Käytettävissä | Sisältää billTo:n, lähettäjän ja vastaanottajan asiakasnumeron arvot |
| Lähetyksen taloudellisiin seikkoihin liittyvät tiedot (esim. declaredValue, codAmount) | Peitetty | Käytettävissä | Tulli, käteismaksu toimituksen yhteydessä ja ilmoitetut arvot ovat peitettyinä |
| Kysely ja palautuslähetyksen tiedot (kyselykoodit, palautuksen syyt) | Peitetty | Käytettävissä | Kaikki tiedot ovat näkyvissä vain tilaajille, joilla on asiakasnumero |
| Hyödykettä ja sisältöä koskevat tiedot | Peitetty | Käytettävissä | Sisältää osakoodit, kuvaukset, määrät |
| Työntekijätunnus (esim. tapahtuman henkilöstö) | Peitetty | Ei saatavilla | Kummassakin tapauksessa peitetty yksityisyyden suojaamiseksi |
| Tapahtumailmoitukset ja EDD/EDTW | Käytettävissä | Käytettävissä | Arvioitua toimituspäivää/-aikaa tuetaan molemmissa |
| Monesta paketista koostuva lähetys (MPS) | Käytettävissä | Käytettävissä | Sisältää ylimääräiset seurantatiedot |
| Arvioitu toimituksen luotettavuus- ja riskipisteet | Käytettävissä | Käytettävissä | Kuuluu vain Premium-tasolle |
Laajennetun integroidun näkyvyyden seurantanumerotilauksen peitetyt tiedot
Yhteenveto
Kun asiakkaat tilaavat lähetysten seurantapäivitykset käyttämällä Laajennetun integroidun näkyvyyden seurantanumerotilausta Laajennetun integroidun näkyvyyden asiakasnumerotilauksen sijaan, tietyt tietokentät peitetään asiakkaiden yksityisyyden suojaamiseksi ja suojauskäytäntöjen noudattamiseksi.
Tämä peittäminen varmistaa, että arkaluontoiset tiedot, kuten henkilökohtaiset yhteystiedot, osoitteet ja taloudellisia seikkoja koskevat arvot, ovat vain valtuutettujen tahojen saatavilla. Asiakkaat, jotka käyttävät Laajennetun integroidun näkyvyyden seurantanumerotilausta, näkevät alla luetelluissa peitetyissä kentissä tekstin ”XXXXX”, mutta nämä tiedot saattavat olla saatavilla Laajennetun integroidun näkyvyyden seurantanumerotilauksen kautta.
Peittäminen aiheuttaa seuraavat asiat:
- Lähetyspaikan/määränpään tiedot ja lähetystapahtuman osapuolet näkyvät rajoitetusti.
- Yksilöivät henkilötiedot (esim. nimet ja puhelinnumerot) ja taloudelliset tai tulliin liittyvät tiedot eivät ole näkyvissä.
- Luottamukselliset ja arkaluontoiset lähetystiedot ovat suojattuina turvallisuuden ja säädösten noudattamisen takaamiseksi.
Asiakkaita, joiden on nähtävä nämä peitetyt kentät operatiivisten tai liiketoimintaan liittyvien syiden takia, kehotetaan tekemään tilaus käyttämällä asiakasnumeroa.
Laajennettu integroitu näkyvyys -seurantanumerotilauksen PEITETYT datapisteet:
Skannaustapahtumat
- 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
Lähettäjän tiedot
- 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
Vastaanottajan tiedot
- 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
Lähetyspaikka ja määränpää
- 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
Toimitukseen ja osoitteenmuutokseen liittyvät tiedot
- 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
Huolitsijan tiedot
- 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
Lähetykseen ja taloudellisiin seikkoihin liittyvät tiedot
- trackResult/packageDetail/customsValue/value
- trackResult/packageDetail/declaredValue/value
- trackResult/packageDetail/originalTransportationCharge/value
- trackResult/codDetail/codAmount/value
Kyselyyn ja hyödykkeeseen liittyvät tiedot
- trackResult/inquiries/[Array]/categoryCode
- trackResult/inquiries/[Array]/code
- trackResult/inquiries/[Array]/createTime
- trackResult/inquiries/[Array]/statusCode
- trackResult/commodityInfo/[Array]/description
- trackResult/commodityInfo/[Array]/code
Lähetyksen sisältö ja palautuksen syy
- trackResult/contents/[Array]/partNumber
- trackResult/contents/[Array]/partCode
- trackResult/contents/[Array]/description
- trackResult/contents/[Array]/quantity
- trackResult/returnReason/[Array]/code
- trackResult/returnReason/[Array]/description
Laskutustiedot
- trackResult/billToParties/[Array]/billToParty/accountNumber
Asiakkaan edut:
- Vastaanottajat saavat lisävarmuutta, kun heille lähetetään ennakkoilmoituksia matkan aikaisista muutoksista arvioituun toimituspäivään ja toimituspäivän aikaväliin.
- Pienennä WISMO (missä tilaukseni on) -puheluista aiheutuvia asiakaspalvelukustannuksia sekä vähennä kiistoja tarjoamalla FedExin kuvallinen toimitustodistus.
- Paranna asiakaskokemusta tarjoamalla lähes reaaliaikaisia ilmoituksia lähetyksen tilasta.
- Lisää toiminnallista tehokkuutta reaaliaikaisilla pikailmoituksilla lähetyksistä, jotta jokaisesta lähetyksestä ei tarvitse tehdä kyselyitä päivitysten saamiseksi.
Ominaisuudet ja seurantatapahtumat
Seurantatapahtumat
Tämän ominaisuuden avulla lähetysten tilaa voi seurata ja asiakkaille voi ilmoittaa ennakkoon erilaisista lähetyksen aikaisista päivityksistä. Asiakkailla on mahdollisuus valita lähetysprosessin/-tapahtumien tietty vaihe, josta he haluavat saada ilmoituksen tai hälytyksen. Seuraavat lähetystapahtumat ovat saatavilla:
- Lähetys: Tämä vaihtoehto ilmoittaa, kun valittu lähetystapahtuma tapahtuu. Esimerkki: osoitelappu luotu, nouto jne.
- Kuljetettavana: Tämä vaihtoehto ilmoittaa lähetyksen kuljetustapahtumista. Esimerkki: kuljetettavana, tavaraa säilytetään toimitustoimistossa jne.
- Toimitus: Tämä vaihtoehto ilmoittaa lähetyksen toimitustapahtumista. Esimerkki: matkalla toimitettavaksi, toimitettu jne.
- Poikkeamat: Tämä vaihtoehto ilmoittaa toimituspoikkeamista. Esimerkki: tullausselvityksen viiveet jne.
- Kätevät toimitusvaihtoehdot: Valitsemalla tämän vaihtoehdon saat ilmoituksen mukautetuista seurantatapahtumista. Esimerkiksi: toimipisteessä säilytyksen pyyntö hyväksytty.
Laajennetun integroidun näkyvyyden seurantatapahtumien tilakoodien ja tilojen taulukossa on lisätietoa saatavilla olevista lähetystapahtumavaihtoehdoista.
Toimitustodistus
Tällä ominaisuudella kuitataan, että tilaus on saapunut aiottuun määränpäähänsä. Se sisältää seuraavat:
- Kuvallinen toimitustodistus (PPOD): PPOD:n avulla asiakas voi saada kuvan, jossa näkyy toimitetun lähetyksen tarkka sijainti.
Laajennettu integroitu näkyvyys toimittaa PPOD-kuvat JSON-hyötykuormassa base64-muodossa. Kuvat voidaan sen jälkeen muuntaa JPEG-muotoon.
Huomautus:
- PPOD on käytettävissä Yhdysvalloissa, Kanadassa, Puerto Ricossa, Hongkongissa, Uudessa-Seelannissa, Yhdistyneessä kuningaskunnassa ja Irlannissa.
- PPOD-palvelu on saatavilla vain FedEx Ground- ja FedEx Express -lähetyksille sekä yksityisosoitteisiin toimitettaville lähetyksille.
- PPOD-palvelu on saatavilla ehdot täyttäville toimituksille silloin, kun SPOD:tä ei vaadita. PPOD ja SPOD eivät ole saatavilla yhtä aikaa.
- PPOD on saatavilla lähetyksille, joille ei vaadita allekirjoitusta (NSR) ja joita ei anneta suoraan asiakkaalle (esim. luovuteta suoraan asiakkaalle toimituksen yhteydessä).
- PPOD tukee 14 000 – 33 000 tavun kuvakokoja (soveltuu kuville, joiden resoluutio on 320 x 240).
- Kuvallisen toimitustodistuksen yritys (PPODA): Tämän avulla asiakkaat voivat vastaanottaa kuvan, jossa näkyy paketin tarkka toimituspaikka, jos toimitusta ei voida saattaa loppuun. Laajennettu integroitu näkyvyys toimittaa base64-muodossa olevat PPODA-kuvat JSON-hyötykuormassa. Kuvat voidaan sen jälkeen muuntaa JPEG-muotoon.
- PPODA on saatavana Yhdysvalloissa ja Puerto Ricossa.
- PPODA on saatavana vain FedEx Ground- ja FedEx Express -lähetyksille sekä yksityis- ja yritysosoitteisiin toimitettaville lähetyksille.
- PPODA-kuva voi olla
- oven ovimerkinnästä otettu PPODA-kuva
- toimituksen esteestä (esim. lukittu portti) otettu kuva
- esteen luo toimitetuista paketeista otettu PPOD-kuva.
- PPODA tukee 14 000 – 33 000 tavun kuvakokoja (soveltuu kuville, joiden resoluutio on 320 x 240)
- Allekirjoitettu toimitustodistus (SPOD): SPOD:n avulla asiakas voi saada valokuvan vastaanottajan allekirjoituksesta sekä allekirjoittajan nimen, toimituspäivän, ajan ja sijainnin. Allekirjoitetun toimitustodistuksen tiedot esitetään tavutaulukkona kuvan sijaan. Tavutaulukko on base64-koodattu merkkijono, joka on purettava, jotta lopullinen allekirjoituskuva saadaan PNG-muodossa
- SPOD ei ole käytettävissä Laajennetun integroidun näkyvyyden seurantanumerotilausta varten.
- SPOD-kuvakoko on 4 000 – 6 000 tavua (soveltuu kuville, joiden resoluutio on 400 x 95).
- SPOD-kuvakoko on 5 000 – 8 000 tavua (soveltuu kuville, joiden resoluutio on 230 x 150).
- GPS-toimitustodistus (GPSPOD):
- GPSPOD:n avulla asiakkaat voivat vastaanottaa toimituspaikan maantieteellisiä koordinaatteja.
Huomaa: GPSPOD on saatavana oletuksena asiakasnumeroon perustuvan Laajennetun integroidun näkyvyyden asiakasnumerotilausta varten.
- GPSPOD:n avulla asiakkaat voivat vastaanottaa toimituspaikan maantieteellisiä koordinaatteja.
Arvioidun toimituspäivän ja toimitusaikavälin tapahtumat
Tämä ominaisuus auttaa lähetysten vastaanottajia suunnittelemaan aikataulujaan tarjoamalla lähetysten toimituspäivät ja/tai toimitusaikavälit. Se sisältää seuraavat:
- Arvioitu toimituspäivä (EDD): Tämä vaihtoehto tarjoaa arvioidun päivämäärän, jolloin lähetys toimitetaan vastaanottajalle. Esimerkiksi: 20.11.20XX.
- Arvioitu toimitusaikaväli (EDTW): Tämä vaihtoehto tarjoaa vastaanottajalle arvioidun aikavälin, jolloin lähetys toimitetaan todellisena toimituspäivänä. Esimerkki: klo 14–18.
Tapahtumapohjainen suodatus
Tällä ominaisuudella asiakkaat voivat järjestää webhook-projektinsa lähetysten laskutustapojen mukaan. Vaihtoehdot ovat seuraavat:
- Saapuvat: Valitse tämä vaihtoehto lähetyksille, jotka toimitetaan sinulle ja jotka maksat vastaanottajana.
- Lähtevät: Valitse tämä vaihtoehto lähetyksille, jotka sinä lähetät ja maksat lähettäjänä.
- Kolmas osapuoli: Valitse tämä vaihtoehto saapuville ja lähteville lähetyksille, jotka laskutetaan sinulta kolmannen osapuolen maksajana.
Huomaa: FedEx-asiakasnumeroasi käytetään lähetysten laskuttamiseen tai maksamiseen. Kolmannen osapuolen maksajana et ole välttämättä lähettäjä etkä vastaanottaja, mutta maksut laskutetaan FedEx-asiakasnumeroltasi.
Uudelleenyrityskäytäntö
Tämä ominaisuus estää FedExiä lähettämästä seurantatapahtuman tietoja, jos asiakaspuolella on ongelma. FedEx säilyttää tietoja ja yrittää lähettää ne uudelleen kolme kertaa viiden minuutin välein.
Jos FedEx ei saa onnistunutta vastausta määritetyllä aikavälillä, FedEx lopettaa kyseisen tapahtuman toimittamisen uudelleen. Asiakas voi kuitenkin pyytää ohi menneitä tapahtumia viimeisten seitsemän päivän ajalta painamalla Laajennettu integroitu näkyvyys ‑webhookprojektin Tiedot-sivulla olevaa YRITÄ UUDELLEEN ‑painiketta.
Katso lisätietoja uudelleenyrityskäytännöistä kohdasta Uudelleenyritys.
