FedEx
A FedEx bekötése API Key, Secret Key és FedEx-ügyfélszám megadásával, International Priority, Economy és Regional Economy szolgáltatások, elektronikus kereskedelmi számla (ETD) és kárigény.
Szerződés és API-hozzáférés igénylése
A FedEx API-ját FedEx-ügyfélszámmal rendelkező feladók használhatják. A hozzáférést a FedEx fejlesztői portálján (developer.fedex.com) magad hozod létre. A portál és az API díjmentes, a szállítási díjat a FedEx a szerződésed szerint számlázza. A korábbi TNT-ügyfelek is FedEx-ügyfélszámmal és a FedEx API-val adnak fel.
1. FedEx-fiók nyitása Magyarországon
- Nyisd meg a fedex.com magyar oldalát (fedex.com/hu-hu), és válaszd a Fiók nyitása (Open an Account) lehetőséget.
- Hozz létre fedex.com felhasználót, majd add meg a céged adatait: cégnév, adószám vagy közösségi adószám, székhely, kapcsolattartó és számlázási cím.
- A fiók megnyitása után megkapod a 9 jegyű FedEx-ügyfélszámot (account number).
- Rendszeres feladáshoz és kedvezőbb piaci árhoz igényelj ajánlatot a FedEx magyarországi értékesítésétől. Ilyenkor egyeztesd azt is, hogy a fiókodon engedélyezve legyen az elektronikus kereskedelmi dokumentum (ETD), és rendszeres felvétel vagy alkalmankénti futárhívás illik-e hozzád.
2. API-hozzáférés létrehozása
- Lépj be a developer.fedex.com oldalra a fedex.com felhasználóddal.
- A My Projects menüben hozz létre szervezetet (Create an organization): válaszd, hogy a FedEx-szel szállítasz, és a saját rendszeredbe kötöd be az API-t.
- Add hozzá a szállítói fiókot (Add shipping account): a 9 jegyű ügyfélszámot és pontosan azt a számlázási címet, amelyet a fióknyitáskor megadtál.
- Az APIs fülön kattints a Create API Project gombra, és válaszd ki a Ship API, a Track API és a Trade Documents Upload API szolgáltatást. Add meg a célországokat, a portál pedig tesztfiókot rendel a projekthez.
- A projekt Test Key fülén látod a teszt API Key és Secret Key értéket.
- Éles használathoz a Production Key fülön hozd létre az éles kulcspárt. A Secret Key csak egyszer látszik: azonnal másold ki (ha kell, újragenerálhatod).
Megjegyzés: A FedEx a Ship API éles használata előtt címkeellenőrzést (label validation) írhat elő. A fejlesztői portál API Validation oldalán vagy a FedEx kapcsolattartódnál tudod meg, a te fiókodnál szükséges-e, és milyen tesztcímkéket kell beküldeni.
3. Amit kapsz
| A FedEx-től kapott adat | Rackoon-mező |
|---|---|
| API Key (Test Key vagy Production Key fül) | API Key |
| Secret Key | Secret Key |
| 9 jegyű ügyfélszám | FedEx-ügyfélszám (9 számjegy) |
4. Tesztkörnyezet
A FedEx-nek van tesztkörnyezete (sandbox), saját Test Key kulcspárral. Az éles kulcs ott nem működik, és fordítva. A sandbox előre rögzített válaszokat ad, a tesztcímkék nem érvényesek.
Megadás a Rackoonban
- Nyisd meg a Szolgáltatók menüt, és válaszd a FedEx szolgáltatót.
- A Kapcsolat fülön a Környezet résznél válaszd a Teszt (sandbox) vagy az Éles lehetőséget.
- Töltsd ki az API Key, Secret Key és FedEx-ügyfélszám (9 számjegy) mezőt a környezetnek megfelelő kulcspárral.
- Kattints a Mentés, majd a Kapcsolat tesztelése gombra. Ha az ellenőrzés sikeres, a kapcsolat állapota Csatlakoztatva lesz.
Részletek: Szolgáltató bekötése, összehasonlítás: Szolgáltatói szerződés és API-kulcsok.
Teszt és éles környezet
A Teszt (sandbox) környezethez a Test Key, az Éles környezethez a Production Key kulcspár tartozik. Éles indulás előtt cseréld a kulcsokat, és állítsd a Környezet mezőt Éles értékre.
Szolgáltatások
| Szolgáltatás | Típus | Súlyhatár |
|---|---|---|
| FedEx International Priority | Nemzetközi expressz | 68 kg |
| FedEx International Priority Express | Nemzetközi expressz (délelőtti kézbesítés) | 68 kg |
| FedEx International Economy | Nemzetközi gazdaságos | 68 kg |
| FedEx International Connect Plus | Nemzetközi webshopos (szerződés szerint) | 30 kg |
| FedEx International First | Nemzetközi, kora reggeli kézbesítés | 68 kg |
| FedEx Regional Economy | Európa (EU-országok) | 68 kg |
| FedEx Priority | Belföld, munkanap végéig | 68 kg |
| FedEx Priority Express | Belföld, délig | 68 kg |
| FedEx First | Belföld, kora reggel | 68 kg |
Kiegészítő szolgáltatások: Értéknyilvánítás, Aláírás a kézbesítéskor, Felnőtt aláírása, Szombati kézbesítés (nemzetközi expressz szolgáltatásoknál).
Címkeformátumok: A6 (PDF, 4×6 hüvelyk), A4 (PDF, a lap felső felén), ZPL (hőnyomtató).
Csomagpontok
A FedEx-szolgáltatásokhoz a Rackoonban nem tartozik csomagpontlista: a FedEx a csomagokat házhoz kézbesíti.
Különleges szabályok
- Nincs napzárás. A címke azonnal érvényes.
- A címkét utólag nem lehet újra letölteni a FedEx-től. A FedEx a címkét csak a címke generálásakor adja ki. Ezt eltároljuk, és a csomag oldaláról bármikor újranyomtathatod.
- Elektronikus kereskedelmi számla (ETD): EU-n kívüli csomagnál a FedEx a vámadataidból maga készíti el a kereskedelmi számlát, és elektronikusan továbbítja, így nem kell papírszámla. A számla másolatát a címke PDF-jének végére fűzzük. Ha az útvonalon vagy a fiókodon az ETD nem engedélyezett, ETD nélkül adjuk fel a csomagot: ilyenkor a mellékelt számlát nyomtasd ki, írd alá, és tedd a csomagra.
- Vám fizetése: DAP-nál a címzett, DDP-nél te fizeted (a FedEx az ügyfélszámodra terheli).
- EU-n belüli nemzetközi csomag: a FedEx itt is árutételt vár. Ilyenkor az Értéknyilvánítás összegét adjuk át áruértékként, ezért EU-n belüli FedEx-csomagnál add meg a csomag értékét.
- Utánvét: magyarországi FedEx-feladásnál nem választható.
- Telefonszám: a feladó és a címzett telefonszáma is kötelező. USA-beli és kanadai címnél az állam kódját az irányítószámból számoljuk ki.
- Visszáru: FedEx-visszárucímkét egyelőre a FedEx Ship Managerben készíthetsz.
- Státuszszinkron: időszakos lekérdezés, legfeljebb 30 csomag lekérdezésenként. A vámeseményeket (vámkezelés, vámkésés, vámkezelve) is jelezzük.
Kárigény és reklamáció
| Bejelentés | Online a fedex.com/hu-hu oldalon: Ügyfélszolgálat → Kárigény bejelentése (nyomkövetési számmal) |
| Sérülés | A kézbesítés után a lehető leghamarabb, nemzetközi légi szállításnál a Montreali Egyezmény szerint legkésőbb 14 napon belül |
| Késés | Nemzetközi légi szállításnál legkésőbb 21 napon belül |
| Elveszés | A FedEx szállítási feltételeiben megadott határidőn belül |
Felelősség: a FedEx szállítási feltételei és a nemzetközi egyezmények (Montreali Egyezmény, CMR) szerinti, súlyalapú korlátig. Magasabb értéknél használd az Értéknyilvánítás kiegészítőt.
Szükséges dokumentumok: nyomkövetési szám, a tartalom értékét igazoló számla, fényképek a csomagolásról és a tartalomról. A csomagot a csomagolással együtt őrizd meg.
Megjegyzés: A pontos határidőket és összeghatárokat a FedEx aktuális szállítási feltételei és az egyedi szerződésed rögzítik.
A panelen a csomag oldalán a Műveletek → Reklamáció, kárigény ponttal indíthatsz reklamációt.