Johdanto
FedExin postinumeron vahvistus API:n ansiosta FedExin asiakkaat voivat vahvistaa postinumeronsa ja saada palvelusitoumukset. Se tukee kaupunkiin, postinumeroon, maahan, lähetyspaikkaan ja määränpäähän perustuvia hakuja ja vahvistuksia. Tuloksissa on tarkistettuja postinumero- ja sijaintitietoja.
Postinumeron vahvistus API:n tiedot
Postinumeron vahvistus vahvistaa kaupunkien ja maiden postinumerot sekä palauttaa puhdistetun postinumeron. Oikeassa muodossa oleva postinumero on pakollinen, jotta lähetys voidaan käsitellä tai osoitelaput luoda.
Tämä API käyttää syötettyjä tietoja, kuten lähetyspäivämäärää, postinumeroa ja maakoodia, esimerkiksi osavaltion ja kaupungin tietojen ristiriitaisuuksien tarkistukseen. Kaupunki ja osavaltio asetetaan, jos ristiriita löytyy ja maa on Yhdysvallat tai Kanada. Esimerkiksi: FDXE: FedEx Express®, FDXG: FedEx Ground® ja FXSP: FedEx Ground® Economy (ennen FedEx SmartPost®). API vahvistaa syötetyt tiedot ja antaa sijaintitiedot sekä puhdistetun postinumeron.
FedEx tukee sekä postinumeroita käyttävien että käyttämättömien maiden palveluita.
Postinumeroita käyttävät maat
Näihin maihin lähetettävien lähetysten lentorahtikirjoihin ja muihin asiakirjoihin on sisällytettävä postinumerot, jotta viivästyksiä saadaan vähennettyä ja tehokkuus maksimoitua. FedEx Express -asiakkaita kannustetaan sisällyttämään alla olevissa maissa sijaitsevien vastaanottajien osoitteisiin voimassa oleva postinumero.
Katso lisätietoja postinumeroita käyttävistä maista sivulta Postinumeroita käyttävät maat.
Postinumeroita käyttämättömät maat
Kuten otsikosta voi päätellä, FedEx tukee postinumeroita käyttämättömiä maita, jotka eivät vaadi lähetyksiin postinumeroita. Osavaltiokoodi tai kaupungin nimi riittää, kun asiakas lähettää maahan, jossa ei käytetä postinumeroita. Jos vahvistusvirhe tapahtuu sellaisen maan kohdalla, joka ei käytä postinumeroita, yritä pakottaa osoite järjestelmään syöttämällä \"00000\" postinumeron tilalle. Tämän tekaistun postinumeron käyttämisen ei pitäisi aiheuttaa ongelmia, koska sitä ei ole olemassa.
FedExin postinumeron vahvistus API:n käyttämisen hyödyt:
- Vähentää lähetysviiveitä ja lisää tehokkuutta.
- Kasvattaa ajoissa olevien ja suoritettujen toimitusten määrää.
- Parantaa FedEx-palvelua kaupunkialueilla tarjoamalla joustavuutta palveluaikojen päättymiseen ja noutoaikatauluihin.
Näin postinumeron vahvistus API toimii
FedExin postinumeron vahvistus käyttää alla olevaa päätepistettä kaupunkien, maiden, lähetyspaikan ja määränpään postinumeroiden vahvistukseen. Seuraavassa osiossa kerrotaan päätepisteen tärkeimmät syöttötiedot ja niiden vastaukset:
Vahvista postinumero
Tätä pyyntöä käytetään palauttamaan postinumerotietoja, puhdistettuja postinumeroita ja sijaintikuvauksia syötettyjen tietojen perusteella. Tähän pyyntöön liittyvät tärkeimmät syöttötiedot ovat:
- carrierCode
- countryCode
- stateOrProvinceCode
- postalCode
- shipDate
Pyynnön onnistuneet tulokset syötetyille tiedoille ovat locationdetails ja cleanedpostalcode. Pyyntö epäonnistuu, jos postinumero ei kelpaa, esimerkiksi CountryCode, osavaltio/provinssi ja postinumero ei ole hyväksytty yhdistelmä.
Selvennyksiä yleisiin väärinkäsityksiin
- Hallintoalueita ei voi verrata postinumeroalueisiin, koska ne ovat erillisten aluejakoprosessien tuloksia.
- Kaikilla maailman maantieteellisillä sijainneilla ei ole postinumeroa.
Katso lisätietoja aluekohtaisista luetteloista sivulta Aluekohtainen palveluluettelo.
Yrityssäännöt
- Numeron, kadunnimen jne. yhdistelmä. Hyväksyttävää osoitetta varten vaaditaan ainakin yksi rivi, tyhjät osoiterivit eivät ole sallittuja.
- Kaksikirjaiminen osavaltio- tai provinssikoodi on pakollinen, jos vastaanottajan maa on Yhdysvallat tai Kanada tai jos EEI:tä sovelletaan ja maa on Meksiko {MX}.
- Osoitteen kuvailua voi käyttää todellisena osoitteena (paikka, jonne voi mennä) tai ”osoitteen osien” kokoelmana, jota käsitellään yksikkönä (kuten kaupunki-osavaltio-postinumero-yhdistelmää Yhdysvalloissa).
- Postinumerokentän muoto ja olemassaolo vaihtelee maasta riippuen.
JSON API -kokoelma
Response