Bevezetés
A Küldeményfelvételi kérés API lehetővé teszi, hogy ellenőrizze a küldeményfelvétel lehetőségét, küldeményfelvételi időpontot egyeztessen a futárral, valamint küldeményfelvételi kérést töröljön.
A Küldeményfelvételi kérés API új vagy korábban feldolgozott csomagok esetén használható minden régióban a FedEx Express és FedEx Ground (visszáru és kimenő) szolgáltatás esetén. Ebben a részletes útmutatóban mindent megtalál, amit a Küldeményfelvételi kérés API-ról tudni kell.
A Küldeményfelvételi kérés API részletes adatai
A Küldeményfelvételi kérés API legfontosabb funkciói a következők:
Küldeményfelvétel lehetősége
A küldeményfelvétel lehetőségének ellenőrzésével megtudhatja, hogy elérhető-e a küldeményfelvételi szolgáltatás a megadott adatok alapján. A küldeményfelvétel lehetősége két tényezőtől függ: a munkaidő vége és a hozzáférési időszak.
Munkaidő vége - A legkésőbbi lehetséges küldeményfelvételi időpont. A küldeményfelvétel helyét jelölő irányítószám esetén érvényes helyi idő szerint értendő.
Hozzáférési időszak - Azt az időszakot jelöli, amely a küldeménynek a felvételre való készen állása és a sofőrnek a küldemény felvételére való készen állása között telik el.
Küldeményfelvétel létrehozása
Ez a funkció lehetővé teszi küldeményfelvétel ütemezését, és FedEx Express® and FedEx Ground® szolgáltatással feladott belföldi és nemzetközi küldemények esetén vehető igénybe. A FedEx Ground és Express szolgáltatások Küldeményfelvételi kérelem API-ja a kérésre válaszul megjelenít egy küldeményfelvételi megerősítő számot, az Express esetén pedig egy kirendeltségkód is megjelenik az ütemezett küldeményfelvételhez. Az API segítségével visszaküldött küldemény esetén is ütemezhet küldeményfelvételt.
A címzett címének beírásához extra címsor (3. címsor) áll rendelkezésére, így részletesebb és pontosabb helyadatokat adhat meg, ami a FedEx Express® szolgáltatással feladott küldemények gyorsabb kézbesítését tesz lehetővé. Időt és fáradságot takaríthat meg, ha beütemezi, hogy a FedEx futárja mikor vegye fel a küldeményeket az Ön tartózkodási helyén vagy egy másik helyszínen, felár ellenében.
Küldeményfelvétel törlése
Ezzel a lehetőséggel lemondhatja a korábban beütemezett küldeményfelvételt. A lehetőség a FedEx Express és FedEx Ground szolgáltatással feladott belföldi és nemzetközi küldemények esetén vehető igénybe. A FedEx Express szolgáltatással feladott belföldi és nemzetközi küldemények felvételét a küldeményfelvétel napján is le lehet mondani. A FedEx Ground szolgáltatással feladott belföldi és nemzetközi küldemények esetében a küldeményfelvételi kérés beküldését követő 24 órán belül lehet lemondani a küldeményfelvételt. Ha már felvették a küldeményét, kérjük, vegye fel a kapcsolatot a FedEx ügyfélszolgálatával a 800 FedEx (800 3339) számon a lemondás kéréséhez.
Küldeményfelvételi kérelem részletes adatai
FedEx Express szolgáltatással feladott küldemény felvételi kérelme
- A csomagok felvételre való készen állásának időpontja nem lehet későbbi a tartózkodás helyén érvényes, postai irányítószám szerinti küldeményfelvételi határidőnél. A küldeményfelvételi határidő lekérhető a Küldeményfelvétel lehetősége funkcióval küldött kérés beküldésével.
- A csomagok készenlététől addig az időpontig eltelt idő, amikor a futár már nem tudja átvenni a csomagokat a helyszínen, nem lehet kevesebb, mint a „hozzáférési időszak”, amely szintén lekérdezhető a Küldeményfelvétel lehetősége funkcióval küldött kérés beküldésével.
- A FedEx Express szolgáltatással küldött küldemények felvételét aznapra vagy a következő munkanapra lehet ütemezni.
- Az egyszerre felvehető küldemények maximális száma 99.
- Ha rendszeres küldeményfelvétel van beállítva Önnél, nem szükséges egyszeri küldeményfelvételt ütemeznie vagy még egy rendszeres küldeményfelvételt létrehoznia.
- Nem változtathatja meg a küldeményfelvételi kérést. Kérés megváltoztatásához le kell mondania az eredeti kérést, és új kérést kell beküldenie.
- A FedEx rendszerei már támogatják az egyesült királyságbeli belföldi küldeményfelvétel funkciót.
Példa: A „PT4H0M“ rövidítés azt jelenti, hogy a küldeményfelvételi időszak 4 óra 0 perc hosszúságú.
FedEx Ground szolgáltatással küldött küldemények felvételének kérése
- A küldeményfelvételt a következő munkanapra vagy két héten belül bármelyik másik munkanapra lehet ütemezni.
- Az egyszerre felvehető küldemények maximális száma 99.
- Ha rendszeres küldeményfelvétel van beállítva Önnél, nem szükséges egyszeri küldeményfelvételt ütemeznie vagy még egy rendszeres küldeményfelvételt létrehoznia.
- Pótdíj ellenében lehetőség van a küldemény lakcímen történő felvételére is.
- Nem változtathatja meg a küldeményfelvételi kérést. Kérés megváltoztatásához le kell mondania az eredeti kérést, és új kérést kell beküldenie.
A Küldeményfelvételi kérés API szolgáltatástípusai
FedEx Express csomagfelvétel
Ha a FedEx Express szolgáltatáson belül küldeményfelvételt kér, futár általi felvételért járó pótdíjat kell fizetni; ez vonatkozik a fedex.com webhelyen és a FedEx ügyfélszolgálaton leadott kérésekre is.
FedEx Ground csomagfelvétel
A FedEx Ground keretében igénybe vehető küldeményfelvételi szolgáltatás pótdíj ellenében. A rendszeres, ütemezett küldeményfelvételt beállító ügyfelek esetén heti küldeményfelvételi díjat terhelünk a megfelelő ügyfélszámlára.
- A rendszeres, ütemezett küldeményfelvétellel nem rendelkező ügyfelek esetén csomagonkénti küldeményfelvételi díjat számolunk fel a kiszállásért. A kiszállásért felszámolt díjat nem kell megfizetni, amennyiben a FedEx egyik szállítási kirendeltségén adja le a csomagját. Továbbá, a telefonon egyeztetett csomagfelvételi díjak nem vonatkoznak a FedEx Ground® Economy (korábban FedEx SmartPost®) nyomtatott visszárucímkéjére, a FedEx Ground® Economy (korábban FedEx SmartPost®) e-mailes visszárucímkéjére, valamint a FedEx Ground® csomagvisszaküldési programjának felvételeire.
- A rendszeres, ütemezett küldeményfelvételt igénybe vevő ügyfelek kérhetik a FedEx Ground szolgáltatásban a FedEx Ground ügyfélazonosítóhoz tartozó szállítási helyszíntől eltérő címről történő csomagfelvételt. Az alternatív küldeményfelvételi cím igényléséért címenként és heti bontásban szolgáltatási díjat számítunk fel.
FedEx Extra Hours
A FedEx Extra Hours szolgáltatásokkal a küldeményfelvétel után egynapos éjszakai szállítást vállalunk hétfőtől péntekig, így a kiskereskedők az esti rendeléseket FedEx Express másnapi helyi kiszállítással teljesíthetik.
A rendelkezésre álló szolgáltatásokkal kapcsolatos további információkért tekintse meg a fedex.com webhelyet.
A Küldeményfelvételi kérés API működése
A Küldeményfelvételi kérés API keretén belül a következő küldeményfelvételi lehetőségek állnak rendelkezésre:
Küldeményfelvétel lehetőségének ellenőrzése
Ezzel a végponttal kérheti le a rendelkezésre álló csomagfelvételi ütemezés részleteit.
A kérelemhez kapcsolódó legfontosabb beviteli adatok a következők:
- Küldeményfelvételi cím/postai adatok.
- Küldeményfelvételi kérés típusa (pl. aznapi/későbbi).
- A küldeményfelvételt kezelő FedEx-szolgáltatás (pl. Express/Ground).
- Belföldi vagy nemzetközi küldeményfelvétel.
Az erre a kérésre jövő sikeres válasz visszaküldi a rendelkezésre álló csomagfelvételi ütemezés részleteit, például a felvétel határidejét, dátumát, elérési idejét, az alapértelmezett készenléti időt és a felvétel rendelkezésre állásának egyéb ütemezett részleteit. Hibák esetén hibaüzenetet is küld, és leírást nyújt a hibákról.
Küldeményfelvétel létrehozása
Ezzel a végponttal hozhat létre felvételi kérelmet egy csomag felvételére.
A kérelemhez kapcsolódó legfontosabb beviteli adatok a következők:
- FedEx ügyfélazonosító, amelyre a küldeményfelvétel költségét lehet terhelni.
- Kiindulási hely adatai (cím, kirendeltség és küldeményfelvételi cím típusa, pl. ügyfélszámla/feladó/egyéb).
- A küldeményfelvételt kezelő FedEx-szolgáltatás (Express/Ground).
- A megfelelő ügyfélszámla címadatai.
Sikeres küldeményfelvételi kérés esetén a rendszer megjelenít egy küldeményfelvételt megerősítő számot, egy küldeményfelvételi értesítést és egy kirendeltségkódot a beütemezett küldeményfelvételhez. Hibák esetén hibaüzenetet is küld, és leírást nyújt a hibákról.
Küldeményfelvétel törlése
Ezzel a kérelemmel lemondhat már beütemezett küldeményfelvételi kéréseket.
A kérelemhez kapcsolódó legfontosabb beviteli adatok a következők:
- Küldeményfelvételt megerősítő kód (küldeményfelvételi kérés benyújtásakor kapott szám)
- A küldeményfelvételt kezelő FedEx-szolgáltatás (Express/Ground).
- Beütemezett dátum (a küldeményfelvétel napja)
- Kirendeltség (a küldeményfelvételi kérést feldolgozó FedEx Express kirendeltség)
A küldemény sikeres lemondása esetén a rendszer megerősítő számot és a küldeményfelvétel lemondásáról szóló megerősítő üzenetet jelenít meg. Hibák esetén hibaüzenetet is küld, és leírást nyújt a hibákról.
Megjegyzés: Beütemezett küldeményfelvétel lemondásához adja meg a küldeményfelvételt megerősítő számot és a megfelelő kirendeltségkódot (csak FDXE-re vonatkozik). A küldeményfelvételt megerősítő kódot és a megfelelő kirendeltségkódot (csak FDXE-re vonatkozik) a küldeményfelvételi kérés beküldésekor kapja meg. A rendszer üzenetet küld a kérés elutasításáról, ha a küldeményfelvételt azután próbálja meg lemondani, hogy a FedEx futárja már elindult a küldeményfelvétel helyszínére.
Üzleti szabályok
- Ha egy másik országban kíván küldeményfelvételt kérni, adja meg azt az országot is a megfelelő országkóddal együtt, ahol szeretné, hogy a FedEx felvegye a küldeményét.
- A FedEx futárindítási megerősítő számot küld sikeres futárkérés esetén. Egy nap legfeljebb egy futárkérést lehet beküldeni, hacsak nem ad hozzá a kéréséhez olyan csomagokat, amelyek meghaladják az eredeti kérésben megadott méreteket és súlyt.
- A futárkéréseket elutasíthatja a rendszer, amennyiben a csomag elkészültéhez megadott idő és a munkaidő vége közötti időszak túl rövid. A küldeményfelvételi időkkel kapcsolatos kérdés esetén hívja fel a FedEx helyi ügyfélszolgálatának telefonszámát.
- A Küldeményfelvételi kérelem API a tömeg mértékegységeként csak „LB“-ot (font) és „KG“-ot (kilogramm) fogad el. A csomag és az árucikk esetén azonosnak kell lennie a tömeg mértékegységének, különben hibaüzenet érkezik a kérésre.
- Ha FedEx Express (beleértve a Mexikón belüli szállítást is) és FedEx Ground szolgáltatással küldött csomagok felvételét is szeretné beütemezni, akkor mindkét fuvarozó számára külön-külön kell beütemeznie egy-egy küldeményfelvételt.
- Ha az Ön küldeményfelvételi helyszíne távoli területen van, gondoskodjon arról, hogy csomagjai időben elkészüljenek, hogy megfeleljenek a távol eső területekre vonatkozó csomagfelvételi rendnek.
- Mindig adja meg a legkésőbbi időpontot, amikor a csomagját fel lehet venni (vagy a vállalata zárási idejét).
- Világszerte egyes kirendeltségeken igénybe vehető szombati küldeményfelvételi szolgáltatás a FedEx Express csomagokhoz. Szombati csomagleadásra is van lehetőség több FedEx kirendeltségen. A Kirendeltségszolgáltatások végponttal kilistázhatja azokat a kirendeltségeket, ahol szombaton is leadhatók csomagok.
- A FedEx Ground és FedEx Express szolgáltatással küldendő csomagok esetében kérheti a FedEx ügyfélazonosítójához tartozó szállítási helyszíntől eltérő küldeményfelvételi címről történő felvételt.
- Ha rendszeres FedEx Express vagy FedEx Ground küldeményfelvételi szolgáltatást szeretne igényelni, vegye fel a kapcsolatot a FedEx kereskedelmi képviselőjével.
- Csak a következő esetekben mondhatja le FedEx Express vagy FedEx Ground szolgáltatással szállítandó küldemény felvételét:
- a kérésben szereplő csomagkészenléti idő még nem érkezett el, és
- a futár még nem indult el.
JSON API-gyűjtemény
Response