Osoitteen vahvistus -API on älykäs ratkaisu epätarkkojen yhteystietojen korjaamiseen ja mahdollistaa pakettien nopeammat ja tarkemmat toimitukset. Tämä API muotoilee asianmukaisesti syötetyn vastaanottajan osoitteen, joka muistuttaa kelvollista osoitetta läheisesti, ja palauttaa olemassa olevan osoitteen, jota todennäköisesti tarkoitettiin.

API antaa myös kommentteja syötetyn osoitteen puutteista sekä muutoksista, jotka tehtiin syötteeseen kyseisen olemassa olevan osoitteen saamiseksi. Tätä APIa voidaan käyttää vastaanottajan osoitetietojen tarkistamiseen ja korjaamiseen ennen paketin lähettämistä.

Huom.: Älä käytä tätä APIa tarkistaaksesi, voiko osoitteeseen toimittaa. FedEx ei tarjoa toimituspalveluita kaikkiin olemassa oleviin osoitteisiin. FedEx ei toimita postilokeroihin (FedEx Ground® Economy -palvelua (aiemmalta nimeltä FedEx SmartPost®) lukuun ottamatta).

Tätä APIa voidaan käyttää vastaanottajan osoitetietojen tarkistamiseen ja korjaamiseen ennen paketin lähettämistä. Tarkat osoitetiedot osoitelapussa auttavat välttämään toimitusviiveitä ja ylimääräisiä osoitteen korjauskustannuksia (jotka aiheutuvat väärin muotoilluista osoitteista).

Huomaa:

• Osoitteen tarkistuksen tulokset vaihtelevat maittain/alueittain.
• Pyyntöön syötettyä osoitetta verrataan FedExin tietokannassa oleviin vertailutietoihin, minkä jälkeen palautetaan osoite, jota syötetty osoite vastaa.

Osoitteen vahvistus -APIn toiminnallisuudet

• Tarjoaa katuosoitetason vastineita.
• Osoitetietokanta päivittyy kuukausittain.
• Pystyy tekemään eron yritysten ja yksityisten osoitteiden välillä, jos löytyy täydellinen vastine.
• Ei tällä hetkellä vahvista huoneistonumeroita.

Osoitteen vahvistus -APIn kyvyt

• Täydentää puutteelliset vastaanottajan osoitteet. Joissakin tapauksissa osoitteen vahvistus -API pystyy täydentämään puuttuvat tiedot riippuen syötettyjen tietojen vahvistamisesta vertailutietoihin nähden. Osoitteen vahvistus -API ei pysty tällä hetkellä täydentämään puuttuvia toissijaisia tietoja (esim. huoneiston numeroa).
• Osoitetietokanta päivittyy kuukausittain.
• Korjaa virheelliset vastaanottajien osoitteet. Esimerkiksi väärän postinumeron korjaaminen vastaamaan muuta syötettä.
• Määrittää, onko osoite yrityksen vai yksityishenkilön, mikä lisää hinta-arvioiden tarkkuutta. Pätee vain yhdysvaltalaisiin ja kanadalaisiin osoitteisiin.
• Vahvistaa useiden seuraavilla alueilla olevien valtioiden osoitteiden kelvollisuuden ja täydellisyyden: Yhdysvallat, Kanada, Latinalainen Amerikka, Eurooppa, Lähi-itä ja Tyynenmeren Aasia. Voit nyt vahvistaa kotimaiset ja kansainväliset osoitetiedot ennen paketin lähettämistä, minkä ansiosta vältytään turhilta lähetysviiveiltä ja ylimääräisiltä palvelumaksuilta.
• Tarjoaa katuosoitetason vastineita.
• Yhdellä API-pyynnöllä voidaan tarkistaa jopa 100 osoitetta.

Osoitteen vahvistus -APIa tukevat maat/alueet

Voit käyttää FedExin Osoitteen vahvistus- APIa seuraavissa maissa vastaanottajien osoitteiden vahvistamiseen ja korjaamiseen ja varmistaa näin tehokkaat toimitukset.

Huom.: Osoitteen vahvistus -APIn palauttamat tiedot ovat vain ehdotuksia.

Oikeudellinen vastuuvapauslauseke: Tässä tarjotut tiedot ovat FedExin yksityisiä ja luottamuksellisia tietoja, jotka tarjotaan pyynnöstä. Mitään osaa näistä tiedoista ei saa jakaa tai ilmoittaa missään muodossa millekään kolmannelle osapuolelle ilman FedExin kirjallista lupaa. Tiedot ovat FedExin toimitusosoitetietokannassa käytössä olevan tämänhetkisen FedExin osoitetason yritys/yksityishenkilö-luokittelun mukaisia ja voivat muuttua. Tarjotessaan nämä tiedot FedEx ei takaa tietojen nykyistä tai tulevaa paikkansapitävyyttä eikä takaa, että näihin osoitteisiin toimitetut paketit laskutetaan näiden tietojen yritys-/yksityishenkilöluokituksen mukaisesti. Näiden tietojen tarjoamista ei pidetä osapuolien välisen suhteen ehtojen muutoksena. Katso FedExin palveluoppaasta ja mahdollisista sovellettavista tilihinnoittelusopimuksista FedExin lähetyksiä ja veloituksia koskevat ehdot.

Vahvista osoite

Tällä päätepisteellä voidaan vahvistaa ja korjata syötettyjä osoitteita ja palauttaa olemassa olevia osoitteita. Osoitetiedot annetaan ja vahvistetaan, jotta osoite voidaan korjata. Osoite katsotaan korjatuksi, kun syötetty osoite vastaa tunnettuja vertailutietoja.

Seuraavat tähän pyyntöön liittyvät tiedot ovat pakollisia:

• Katuosoiterivit
• Kaupunki (valinnainen)
• Osavaltion/provinssin koodi (valinnainen)
• Postinumero (valinnainen)
• Maakoodi

Huom.: Osavaltion koodi tai kaupungin nimi riittää, kun tehdään lähetys maahan, jossa ei ole postinumeroita.

Osoitteen vahvistus -API palauttaa olemassa olevan osoitteen suorittamalla syötetylle osoitteelle seuraavat toimenpiteet:

• Ensimmäiseksi API yrittää normalisoida syötetyn osoitteen. Tämä voi käsittää tavanomaisten tienimikkeiden kuten "street" ja "parkway" korvaamisen niiden vakiolyhenteillä kuten ST ja PKWY sekä osoitteen osien uudelleenjärjestelyn. Jos syötetyn osoitteen normalisointi ei onnistu, syötetty osoite palautetaan määritettynä osoitteena. Arvot, jotka eivät ole osoitteita, hylätään.
• Toisessa vaiheessa API yrittää vakioida normalisoidun osoitteen löytämällä mahdollisen tai todellisen osoitteen, joka todennäköisesti on käyttäjän tarkoittama. Jos syötetyn osoitteen vakiointi ei onnistu, syötetyn osoitteen normalisoitu muoto palautetaan korjattuna osoitteena. Voit tarkastella palautettuja elementtejä syötetyn osoitteen ongelmien määrittämiseksi.
• Myös kyseisen normalisoidun osoitteen tietyt osat palautetaan. Jos syötetyn osoitteen vakiointi onnistuu, olemassa oleva osoite palautetaan korjattuna osoitteena. Tässä tapauksessa palautetaan myös tiettyjä vakioidun osoitteen lisäelementtejä sekä tietoa siitä, miten se saatiin normalisoidusta osoitteesta.

Osoitteen vahvistus -APIn palautusarvot

Jos palautettu osoite sisältää seuraavat arvot alla luetelluille määreille, osoite on kelvollinen:

• Osoitteen tila on vakioitu
• Määritetyn osoitteen määreiden arvot ovat "tosi"
• Toimituspiste kelvollinen (DPV) -arvo on "tosi"
• Interpoloitu osoite -arvo on "epätosi"

Jos näitä ei ole lueteltu, voit käyttää lisämääreitä määrittääksesi osoitteen arvojen mahdolliset ongelmat.

Lisätietoja osoitemääreistä löytyy kohdasta Osoitemääreet.

Jos palautetussa osoitteessa on asiakasviesti INTERPOLOITU.KATUOSOITE (INTERPOLATED.STREET.ADDRESS), on mahdollista, että osoite ei ole kelvollinen. Lisätietoja asiakasviestien koodeista löytyy asiakasviestin elementtikuvauksesta.

Urbanisaatio (vain Puerto Rico): Tämä deskriptori, jota käytetään yleisesti Puerto Ricon kaupunkialueilla, on tärkeä osa osoitemuotoa, sillä se kuvailee tietyn kadun sijainnin. Puerto Ricossa voi samalta postinumeroalueelta löytyä useampia samannimisiä kadunnimiä ja numerovälejä. Näillä kaduilla voi olla sama rakennusnumerointi. Näissä tapauksissa tarvitaan urbanisaationimi, jotta tietyn osoitteen sijainti voidaan tunnistaa oikein.

Esimerkki: Sr Pedro Rivera Urb Hermosillo 123 Calle 1 Bayamon, PR 00961-1212.

Kommentit

Osoitteen vahvistus -API palauttaa kommentteja jokaisen vahvistetun ja palautetun osoitteen mukana. Kommentit antavat tietoa mahdollisista puutteista ja muutoksista, jotka tehtiin syötteeseen kyseisen olemassa olevan osoitteen saamiseksi.

Osoitteen vahvistus -API käyttää vertailutietoja määrittääkseen tietyn osoitteen luokituksen. Toimivan osoitteen luokitus lasketaan erillään osoitteen vahvistusprosessista, ja se perustuu operatiivisen henkilöstön palautteeseen. Kaupallisia tietolähteitä käytetään ainoastaan vahvistamistarkoitukseen.

Osoitteen vahvistus -APIssa on vain neljä mahdollista osoiteluokitusta: tuntematon, yritys, yksityishenkilö ja sekoitus. Kaikkien osoitteiden luokitus on aluksi "tuntematon", ja se muuttuu vasta, kun osoitteen vahvistuksen säännöt määrittävät, että niiden luokitusta pitää muuttaa. Sijainti saa "sekoitus"-luokituksen ainoastaan, jos osoitteessa asuu useita henkilöitä ja siinä on sekä liikehuoneistoja että asuntoja.

Huom.: FedEx Express -palvelussa on käytössä ylimääräinen osoiterivi (osoiterivi 3) vastaanottajan osoitteessa. Tämä täydentävä osoitetieto tarjoaa täydellisemmät ja tarkemmat sijaintitiedot, mikä parantaa mahdollisuuksia saada tarkka osoite.

Olemassa olevat osoitteet luokitellaan seuraavasti:

Yritysosoite

Yritysosoite on osoite, jota käytetään pääasiallisen toimipaikan osoitteena. Yrityksen oletetaan toimivan kyseisessä osoitteessa, mutta asia ei aina ole näin.

Yritysosoite on yrityksen toimipaikan virallinen sijainti. Se voi olla mitä hyvänsä jonkun kotiosoitteesta aina miljoonien arvoiseen kampukseen, joita suuret teknologiayritykset suosivat, ja kaikkea siltä väliltä.

Asunto-osoite

Toimituksesta asunto- tai yksityisosoitteeseen Yhdysvaltojen sisällä peritään toimitusmaksu. Maksu koskee myös yrityksiä, jotka toimivat asunto-osoitteessa. Käytä FedEx Home Delivery ‑palvelua yksityisosoitteisiin toimitettaviin lähetyksiin FedEx Groundin kautta yhdessä arkipäivässä määränpään etäisyyden mukaan.

Esimerkki:

• Koulukoti
• Luostari
• Pappila
• Monen yksikön asuinrakennusten asukkaat, kuten:
  • Kerrostalot
  • Asunto-osakeyhtiöt
  • Yliopistoasuntolat

• Asunto, jossa tuotteita myydään ja/tai josta niitä jaellaan

Vinkkejä Osoitteen vahvistus -APIn käyttöön:

• Käytä oikea määrä välilyöntejä: Varmista, että välilyönnit ovat oikeissa paikoissa, ja vältä ylimääräisiä välilyöntejä.
• Varmista oikeinkirjoitus: Vältä kirjoitusvirheitä. Varmista myös, että valitset oikein nollan (0) ja O-kirjaimen välillä.
• Vältä erikoismerkkejä: Älä käytä erikoismerkkejä, joita ei tarvita osoitteessa, kuten pistettä lyhenteiden jälkeen (Ave vs. Ave.).
• Anna lisätietoja osoitteeseen ja katutietoihin: Kun annat lisää osoitetietoja, voit kasvattaa osoitetuloksien tarkkuutta.
  • Rakennuksen tai talon numero: 1, 1A, 1½, Yksi
  • Kadun nimi: Main, George Washington, 42^nd
  • Kadun pääte: Road, Avenue, Rd, Ave
• Syötä kaupunki, osavaltio/provinssi ja postinumero: Kun annat nämä kaikki, kasvatat osoitetuloksien tarkkuutta.
• Syötä katu ja osoite oikeassa järjestyksessä: Katuosoite noudattaa yleensä muotoa, joka alkaa rakennuksen tai talon numerolla, jota seuraa esiopastava elementti, kadun nimi, kadun tyyppi tai pääte, jälkiopastava elementti, asunnon tunniste, asunnon numero ja/tai yksityisen postilaatikon tunniste ja numero.
• Käytä oikeita lyhenteitä: Yhdysvaltain ja Kanadan postilaitoksilla on vakiolyhenteet osavaltioille/provinsseille, katupäätteet sekä asunnon tai rapun tunnisteet.
  • Epävakio lyhenne voi aiheuttaa huonoja hakutuloksia.
  • Älä käytä lyhennettä, ellet ole varma siitä.
• Urbanisaatio - Urbanisaationimi ilmaisee alueen, vyöhykkeen tai asuntoalueen maantieteellisellä alueella.

Esimerkki:

• Rakennuksen tai talon numero, kuten 1, 1A, Yksi.
• Kadun nimi, kuten Main, George Washington, 42nd.
• Kadun pääte, kuten Road, Avenue, Rd, Ave.
• Syötä kaupunki, osavaltio/provinssi ja postinumero: Kun annat kaikki osoitetiedot, kasvatat tuloksien tarkkuutta. Postinumeron ZIP+4-osio ei ole tarpeen osoitteen tarkistamiseksi.
• Käytä oikeita lyhenteitä: Yhdysvaltain ja Kanadan postilaitoksilla on vakiolyhenteet osavaltioille/provinsseille, katupäätteet sekä asunnon tai rapun tunnisteet. Epävakio lyhenne voi aiheuttaa huonoja hakutuloksia. Älä käytä lyhennettä, ellet ole varma siitä.
• Voit myös palauttaa osoitteen vahvistuksen palautteen käyttäjälle tarjotaksesi hänelle mahdollisuuden valita hänelle paras osoite.

• Älä käytä tätä APIa tarkistaaksesi, voiko osoitteeseen toimittaa. FedEx ei tarjoa toimituspalveluita kaikkiin olemassa oleviin osoitteisiin. FedEx ei toimita postilokeroihin (FedEx Ground® Economy -palvelua (aiemmalta nimeltä FedEx SmartPost^®) lukuun ottamatta).
• Korjatusta osoitteesta palautetut tiedot ovat vain ehdotuksia.
• Yhdellä pyynnöllä voidaan tarkistaa jopa 100 osoitetta.
• Maiden välillä on eroja siinä, mikä on pienin määrä vaadittuja kenttiä.

  Esimerkiksi yhdysvaltalaisissa osoitteissa vaaditaan ainakin yksi osoiterivi ja joko postinumero tai kaupunki ja osavaltion koodi, mutta australialaisissa osoitteissa osavaltion koodi voidaan jättää pois jopa ilman postinumeroa.

• Osoitteen tarkistuksen tulokset saattavat vaihdella maittain/alueittain.

Huom.: Osoitteen vahvistus -API ei välttämättä sovellu kaikkiin maihin. Katso osio Osoitteen vahvistus -APIa tukevat maat/alueet.