Johdanto
Noutopyyntö-APIn avulla voit tarkistaa noutopalvelun saatavuuden, sopia kuriirin tekemän noudon ja peruuttaa noutopyynnön.
Noutopyyntö-APIa voi käyttää uusiin tai aiemmin käsiteltyihin paketteihin kaikilla FedEx Express- ja FedEx Ground -lähetysten alueilla (palautukset ja lähtevät). Tämän yksityiskohtaisen oppaan avulla pääset ajan tasalle ja opit kaiken tarvittavan noutopyyntö-APIsta.
Noutopyyntö-APIn tiedot
Seuraavassa on tärkeimmät noutopyyntö-APIin liittyvät ominaisuudet:
Noudon saatavuus
Noudon saatavuudella voit tarkistaa noutopalvelun saatavuuden syötetyn pyynnön perusteella. Noudon saatavuus riippuu kahdesta tekijästä: noutoajan päättymisajasta ja siirtymisajasta.
Noutoajan päättymisaika - Myöhäisin sallittu ajankohta, johon noudon voi sopia. Aika on noutopaikan postinumeroalueen mukainen.
Siirtymisaika - Aika, joka kuluu noutovalmiudesta (ajankohta, jolloin paketti on valmis noudettavaksi) siihen, kun kuljettaja on valmis noutamaan paketin.
Luo nouto
Tämän vaihtoehdon avulla voit sopia noudon. Se koskee kotimaisia ja kansainvälisiä FedEx Express®- ja FedEx Ground® -lähetyksiä. FedEx Groundin ja Expressin noutopyyntö-API palauttaa noudon vahvistusnumeron sekä paikkakoodin sovitulle Express-noutopyynnölle. Voit myös sopia noudon palautuslähetykselle tämän APIn avulla.
Ylimääräisen vastaanottajan osoiterivin (osoiterivi 3) avulla voit antaa täydellisemmät ja tarkat paikkatiedot, minkä ansiosta FedEx Express® -lähetykset voidaan toimittaa nopeammin. Voit säästää aikaa ja vaivaa sopimalla FedExin kuriirin kanssa lähetysten noudosta luotasi tai jostain muusta kohteesta lisämaksua vastaan.
Peruuta nouto
Tämän vaihtoehdon avulla voit peruuttaa aiemmin sovitun noudon. Tämä vaihtoehto on käytettävissä kotimaisissa ja kansainvälisissä FedEx Express- ja FedEx Ground -lähetyksissä. Kotimaiset ja kansainväliset FedEx Express -noudot voidaan peruuttaa samana päivänä. Kotimaiset ja kansainväliset FedEx Ground -lähetykset voidaan peruuttaa 24 tuntia noutopyynnön lähettämisen jälkeen. Jos lähetyksesi on jo noudettu, soita FedExin asiakaspalveluun numerossa 800 3339 tehdäksesi peruutuksen.
Noutopyynnön tiedot
FedEx Express -noutopyynnöt
- Ajankohta, jona pakettisi ovat valmiina noudettaviksi, ei saa olla myöhäisempi kuin postinumeroalueesi noutoajan päättymisaika. Noutoajan päättymisajan voi hakea käyttämällä noudon saatavuus -pyyntöä.
- Aika siitä kun pakettisi ovat valmiina siihen kun kuriiri ei enää pääse sisään noutamaan paketit ei saa olla pienempi kuin "siirtymisaika", jonka voit myös hakea noudon saatavuus -pyynnöllä.
- FedEx Express -noudot voidaan sopia kuluvalle tai seuraavalle arkipäivälle.
- Paketteja voi olla yhdessä noutopyynnössä enintään 99 kpl.
- Jos sinulla on jo säännöllinen sovittu nouto, ei ole tarpeen sopia kertaluontoista noutoa tai lisätä uutta säännöllistä sovittua noutoa.
- Noutopyyntöä ei voi muuttaa. Jos haluat muuttaa pyyntöä, sinun on peruutettava alkuperäinen pyyntö ja syötettävä uusi pyyntö.
- FedExin järjestelmät tukevat nyt Yhdistyneen kuningaskunnan sisäistä noutotoiminnallisuutta.
Esimerkki: 'PT4H0M' ilmoittaa, että noutoaika on 4 tuntia ja 0 minuuttia.
FedEx Ground -noutopyynnöt
- Noudon voi sopia seuraavalle arkipäivälle tai mille tahansa arkipäivälle enintään kaksi viikkoa etukäteen.
- Paketteja voi olla yhdessä noutopyynnössä enintään 99 kpl.
- Jos sinulla on jo säännöllinen sovittu nouto, ei ole tarpeen sopia kertaluontoista noutoa tai lisätä uutta säännöllistä sovittua noutoa.
- Nouto asunto-osoitteesta on saatavilla lisämaksua vastaan.
- Noutopyyntöä ei voi muuttaa. Jos haluat muuttaa pyyntöä, sinun on peruutettava alkuperäinen pyyntö ja syötettävä uusi pyyntö.
Noutopyyntö-APIn palvelutyypit
FedEx Express -nouto
Veloitamme FedEx Express -noutopyynnöistä kuriirin noutomaksun. Tämä koskee sekä fedex.com-sivuston että FedExin asiakaspalvelun kautta tehtyjä pyyntöjä.
FedEx Ground -nouto
FedEx Ground tarjoaa noutopalvelun pyynnöstä lisämaksua vastaan. Määritämme säännölliset noudot sopineille asiakkaille viikoittaisen noutomaksun sovittuun säännölliseen noutoon liittyvälle asiakasnumerolle.
- Määritämme pakettikohtaisen noutomaksun asiakkaille, joilla ei ole sovittua vakionoutoa. Noutomaksua ei veloiteta, jos jätät pakettisi FedExin lähetystoimipisteeseen. Noutomaksut eivät myöskään koske FedEx Ground® Economy (ennen FedEx SmartPost®) Print Return Label-, FedEx Ground® Economy (ennen FedEx SmartPost®) Email Return Label- ja FedEx Ground® Package Returns Program -palveluiden noutoja.
- FedEx Ground tarjoaa säännöllisen noudon sopineille asiakkaille noutopalvelun pyynnöstä FedEx Ground -asiakasnumeron lähetyspaikasta eroavasta osoitteesta. Tähän palveluun sisältyy lisämaksu noudoista vaihtoehtoisista osoitteista jokaista eri osoitetta kohti viikossa.
FedEx Extra Hours
FedEx Extra Hours -palvelut ovat saatavilla noutoihin yhden päivän yön yli -kuljetuksiin maanantaista perjantaihin, minkä ansiosta kauppiaat voivat täyttää illalla tehdyt tilaukset FedEx Expressin seuraavan päivän paikallistoimituksilla.
Lisätietoja saatavilla olevista palveluista saat fedex.com-verkkosivustolta.
Noutopyyntö-APIn toiminta
Noutopyyntö-APIssa ovat käytettävissä seuraavat noutovaihtoehdot:
Tarkista noudon saatavuus
Käytä tätä päätepistettä saatavilla olevien noutojen aikataulutietojen pyytämiseen.
Tähän pyyntöön liittyvät tärkeimmät syöttötiedot ovat:
- Nouto-osoite-/postiosoitetiedot.
- Noutopyynnön tyyppi (esim. sama päivä / päivä tulevaisuudessa).
- FedExin kuljetusliike noutoa varten (esim. Express/Ground).
- Onko kyseessä kotimaisen vai kansainvälisen lähetyksen nouto.
Tämän pyynnön onnistunut vastaus palauttaa saatavilla olevan noudon aikataulutiedot, kuten noudon päättymisajan, noudon päivämäärän, noudon siirtymisajan, oletusvalmiusajan ja muut noudon saatavuuden aikataulutiedot. Se palauttaa myös virheet ja niiden kuvaukset, jos jotain menee vikaan.
Luo nouto
Käytä tätä päätepistettä noudettavan paketin noutopyynnön luomiseen.
Tähän pyyntöön liittyvät tärkeimmät syöttötiedot ovat:
- FedEx-asiakasnumero, jota laskutetaan noudosta.
- Alkuperätiedot (osoite, sijainti ja nouto-osoitetyyppi, kuten asiakasnumero/lähettäjä/muu).
- FedExin kuljetusliike noutoa varten (Express/Ground).
- Liittyvät asiakasnumeron osoitetiedot.
Onnistunut noutopyyntö määrittää ajastettavalle noudolle noudon vahvistusnumeron, noutoilmoituksen ja paikkakoodin. Se palauttaa myös tiedot virheistä ja kuvaukset epäonnistumisista.
Peruuta nouto
Käytä tätä pyyntöä paketille jo sovitun noudon peruuttamiseen.
Tähän pyyntöön liittyvät tärkeimmät syöttötiedot ovat:
- Noudon vahvistuskoodi (saadaan noutopyynnön lähettämisen yhteydessä).
- FedExin kuljetusliike noutoa varten (Express/Ground)
- Ajastuspäivä (päivä, jolloin nouto tapahtuu).
- Sijainti (FedEx Express -sijainti, joka on vastuussa noutopyynnön käsittelystä).
Onnistunut noudon peruutus määrittää tapahtuman vahvistusnumeron ja peruutuksen vahvistusviestin. Se palauttaa myös tiedot virheistä ja kuvaukset epäonnistumisista.
Huomautus: Anna noudon vahvistusnumero ja sitä vastaava toimipistekoodi (koskee vain FDXE:tä) peruuttaaksesi jo varatun noudon. Noudon vahvistusnumero ja sitä vastaava sijaintikoodi (koskee vain FDXE:tä) saadaan samalla, kun lähetetään noutopyyntö. Saat ilmoituksen epäonnistumisesta, jos yrität peruuttaa noudon sen jälkeen, kun FedEx-kuriiri on lähtenyt noutopaikalle
Liiketoimintasäännöt
- Jos haluat pyytää noutoa eri maasta, anna maaelementti asianmukaisella maakoodilla ilmoittaaksesi mistä haluaisit FedExin noutavan lähetyksesi.
- FedEx palauttaa jakelun vahvistusnumeron onnistuneelle jakelupyynnölle. Jakelupyynnöt tulee rajoittaa yhteen pyyntöön päivässä paitsi jos lisäät paketteja, joiden koko tai paino ylittää alkuperäisessä pyynnössä ilmoitetut.
- Jakelupyyntö voi epäonnistua, jos syöttämäsi paketin valmistumisen ja virka-ajan päättymisen välinen aika on liian lyhyt. Jos sinulla on kysyttävää noutoajoista, ota yhteyttä alueelliseen FedExin puhelintukeen.
- Pickup Request API tukee painotyyppejä ″LB″ ja ″KG″. Paketin ja hyödykkeen painoyksikön pitää olla sama, muuten pyyntö on virheellinen.
- Jos sinun tarvitsee sopia nouto sekä FedEx Express- (ml. Meksikon sisäiset lähetykset) ja FedEx Ground -paketeille, sinun on sovittava noudot erikseen molemmille kuljetuspalveluille.
- Jos noutopaikkasi on syrjäseudulta, varmista, että pakettisi ovat valmiit aikaisemmin etänoutoaikataulujen huomioon ottamiseksi.
- Ilmoita aina myös myöhäisin aika, jolloin pakettisi voidaan noutaa (tai yrityksesi sulkemisaika).
- Lauantainoutopalvelu on saatavilla FedEx Express -paketeille tietyissä paikoissa eri puolilla maailmaa. Useisiin FedExin toimipisteisiin voi myös tuoda lähetyksiä lauantaisin. Sijainnit-palvelusta saat luettelon toimipisteistä, joihin voi tuoda lähetyksiä lauantaisin.
- Voit pyytää FedEx Ground- ja FedEx Express -noutoa osoitteesta, joka eroaa FedEx-asiakasnumeroosi liitetystä lähetyspaikasta.
- Jos haluat tilata säännöllisen FedEx Express- tai FedEx Ground -noutopalvelun, ota yhteyttä FedExin Account Executive -myyntiedustajaan.
- Voit peruuttaa FedEx Express- tai FedEx Ground -noudon vain, jos:
- Pyynnössä ilmoitettu paketin valmiinaoloaikaa ei ole vielä ohitettu, ja
- Kuriiri ei ole lähtenyt matkaan.
JSON API -kokoelma
Response