FedEx-feladó
Előfeltétel
A FedEx Developer Portalba való bejelentkezéshez és egy szervezet létrehozásához felhasználói FedEx-azonosítóval kell rendelkeznie.
Csatlakozzon vállalata szervezetéhez, hogy együttműködhessen a csapatával. Ha a vállalatának nincs szervezete, létrehozhat egyet.
Csatlakozás egy meglévő szervezethez
1. Kérjen meghívót
Kérje meg szervezete rendszergazdáját, hogy küldjön Önnek egy meghívót. 24 órája van, hogy elfogadja. Ha a meghívó lejár, kérje meg a rendszergazdát, hogy küldje el újra.
2. Fogadja el a meghívást
Jelentkezzen be a meglévő felhasználói azonosítójával és jelszavával. Ha a felhasználói azonosítója egy másik szervezethez van kötve, hozzon létre egy új azonosítót.
Új szervezet létrehozása
Amikor létrehoz egy szervezetet, rendszergazdává válik. Rendszergazdaként meghívhatja a felhasználókat a szervezethez való csatlakozásra, projekteket és felhasználói szerepköröket rendelhet hozzá, valamint kezelheti a fuvarozási ügyfélszámokat.
A felhasználói szerepkörökről további információt a Szervezetadminisztrációs irányelvek című részben talál.
1. Jelentkezzen be a FedEx Developer Portalra.
2. A menüből válassza ki a Saját projektek, majd a Szervezet létrehozása lehetőséget.
3. Adja meg a következő adatokat:
- Az Olyan vállalatnak dolgozom, amely résznél válassza a FedEx-szel fuvaroztat, és a FedEx API-kat saját alkalmazásaiba kell integrálnia lehetőséget
- Adja meg a vállalat nevét, a vállalat weboldalát és egy olyan szervezetnevet, amelyet a csapata felismer, például a vállalat nevét, osztályát, részlegét vagy régióját.
4. Válassza a Létrehozás lehetőséget.
A részleteket később a Szervezet kezelése menüpont alatt frissítheti vagy adhatja hozzá.
Fuvarozási ügyfélszám hozzáadása
1. Az Ügyfélszámok hozzáadása csempén válassza ki a Fuvarozási ügyfélszámok hozzáadása lehetőséget. Ha még nincs FedEx-ügyfélszáma, válassza az Ügyfélszám létrehozása lehetőséget egy új ügyfélszám létrehozásához, vagy lépjen kapcsolatba a FedEx-ügyfélszolgálattal.
2. Válassza az + Ügyfélszám hozzáadása lehetőséget.
3. Adja meg a FedEx-ügyfélszámot, az ügyfélszám becenevét és a számlázási címet, amit az ügyfélszám beállítása során használt.
4. Fogadja el a Végfelhasználói licencszerződést, vagy továbbítsa azt vállalata egy meghatalmazott képviselőjének.
Számlázási ügyfélszám hozzáadása
1. Válassza a Számlázási ügyfélszámok fület. Ha nincs FedEx számlázási ügyfélszáma, válassza a Számlázási ügyfélszám létrehozása lehetőséget egy új létrehozásához, vagy vegye fel a kapcsolatot a FedEx ügyfélszolgálatával.
2. Válassza a Számlázási ügyfélszám hozzáadása lehetőséget. A számlázási ügyfélszámoknak az Egyesült Államokban kell lenniük.
3. Adja meg FedEx-ügyfélszámát, az ügyfélszám becenevét és az egyesült államokbeli számlázási címet, amelyet az ügyfélszám létrehozása során használt.
4. Olvassa el és fogadja el a Végfelhasználói licencszerződést.
Felhasználók meghívása rendszergazdaként
1. A menüből válassza ki a Szervezet kezelése menüpontot, majd a Felhasználók lapot.
2. Válassza a + Felhasználók hozzáadása lehetőséget.
3. Válasszon ki egy országot vagy területet és egy kívánt nyelvet, majd válasszon felhasználói szerepkört: megtekintő, közreműködő vagy rendszergazda.
4. (Választható) Rendelje hozzá a felhasználót egy projekthez. A felhasználókat bármikor hozzárendelheti a projekt Áttekintés oldaláról.
5. Adja meg a felhasználók e-mail-címét, majd kattintson a Meghívás gombra. Egyszerre legfeljebb 20 felhasználót hívhat meg, az egyes e-mail-címeket vesszővel elválasztva. A meghívók 24 óra elteltével lejárnak.
API-projekt létrehozása
1. A menüből válassza ki a Saját projektek lehetőséget, majd válassza az API-k lapot, és válassza a + API-projekt létrehozása lehetőséget.
2. Erősítse meg API-igényeit.
3. Válassza ki az API-kat, amelyeket integrálni szeretne a projektjébe.
4. Hozzon létre egy projektnevet, és válassza ki azokat az országokat, ahová fuvaroztatni szeretne, hogy egy teszt fuvarozási ügyfélszámot kapjon. Belföldi európai küldeményekhez minden országhoz külön tesztügyfélszámra van szüksége. Később hozzáadhat vagy eltávolíthat országokat.
5. Az Értesítések alatt válassza ki a Beállítások menüpontot az értesítési beállítások megadásához.
6. Olvassa el és fogadja el a használati feltételeket.
Speciális integrált láthatósági projekt létrehozása
Előfeltételek
- Árképzés áttekintése: Az előfizetőknek havi díjat kell fizetniük az alapján, hogy hány fuvarlevélszám van. Az árképzéssel kapcsolatos további információkért tekintse meg az Árképzési útmutatót.
- Ügyfélfiókok létrehozása: A Küldemény láthatósága webhookhoz egy egyesült államokbeli számlázási ügyfélszámra és legalább egy fuvarozási ügyfélszámra van szükség, ez a két ügyfélszámtípus kölcsönösen kizárja egymást. Csak rendszergazdák adhatnak hozzá számlázási és fuvarozási ügyfélszámokat a Szervezet kezelése oldalon.
1. Hozzon létre egy cél URL-címet az alkalmazásban vagy a platformon a visszahívások fogadásához. Az URL-nek a következőknek kell megfelelnie:
- HTTPS használata
- Ne használja az RFC1918 IP-területet, a fedex.com oldalt és annak aldomainjeit, valamint az olyan IP-címeket, mint például localhost vagy 127.0.0.1
2. Biztonsági token létrehozása a hitelesítéshez. A tokennek a következőknek kell megfelelnie:
- 26–100 karakterből álljon, legalább egy nagybetűből, legalább egy kisbetűből és legalább egy számból
3. A menüből válassza a Saját projektek menüpontot, majd válassza a Speciális integrált láthatóság lapot.
4. Válassza a Speciális integrált láthatósági projekt létrehozása lehetőséget.
5. Válassza ki a felhasználó típusát.
- FedEx-szállító: A FedExszel fuvaroztat, és a FedEx API-kat integrálnia kell saját alkalmazásaiba
- FedEx Compatible szolgáltató: Tanúsított FedEx Compatible szolgáltató
- FedEx Integrátor szolgáltató: Olyan szoftvermegoldást értékesít vagy biztosít, amely FedEx-technológiát használ, és hitelesített FedEx Integrátor szolgáltató
6. Válassza ki az előfizetés típusát. Eseményekre feliratkozhat ügyfélszámok vagy fuvarlevélszámok alapján.
7. Erősítse meg a számlázási ügyfélszámot, és válassza ki a kívánt funkciókat, mint például a kézbesítési igazolás, a becsült kézbesítés, a nyomonkövetési események vagy az eseményalapú szűrés.
8. Adja meg a projekt részleteit.
- Adjon meg egy egyedi és felismerhető projektnevet.
- Adja meg a létrehozott cél URL-címét és a biztonsági tokent.
- Adjon meg egy e-mail-címet és egy előnyben részesített nyelvet, amelyen értesítéseket szeretne kapni a Speciális integrált láthatósági frissítésekről és szolgáltatáskimaradásokról.
9. Fogadja el a FedEx Developer Portal licencszerződését és megrendelőlapját, majd válassza a Létrehozás lehetőséget.
Megjegyzés: A választott előfizetési típustól függően további lépések is lehetnek. További információkért tekintse meg a Webhook dokumentációját.
Kövesse az alábbi lépéseket az API-integráció ellenőrzéséhez, és annak megerősítéséhez, hogy az alkalmazás képes tesztadatok küldésére és fogadására.
Teszthitelesítő adatok lekérése
1. A menüből válassza ki a Saját projektek menüpontot, majd válassza ki a Projekt nevét.
2. Az API-kulcsok fülön, a Tesztkulcs alatt találja meg a tesztelési hitelesítő adatait.
3. Jelentkezzen be, és töltse le a JSON API-gyűjteményt a dokumentációs oldal tetején található JSON letöltése sémagomb segítségével. Tekintse át az integrációja által használt végpontokra vonatkozó példakérelmeket.
4. Igényeljen egy OAuth hozzáférési tokent minden API-tranzakcióhoz.
Megjegyzés: A token egy óráig érvényes, és beállíthatja az alkalmazását, hogy frissítse a lejárata előtt. A részletekért tekintse meg az API Authorization dokumentációt.
5. A menüből válassza az API-katalógus lehetőséget, válassza ki azt az API-t, amellyel dolgozni szeretne, majd válassza a Dokumentáció lehetőséget.
6. A menüből válassza ki a végpontot.
7. Küldjön mintakéréseket a tesztelési hitelesítő adataival és a FedEx teszt URL-címével, majd ellenőrizze, hogy a válaszok megegyeznek-e a dokumentációs példákkal. Részletekért tekintse meg a Tesztkörnyezet virtualizációs útmutatóját.
8. Futtasson teszteket a Speciális integrált láthatóság segítségével mintaadatok generálásához, és ellenőrizze, hogy az alkalmazás helyesen dolgozza-e fel a követési információkat.
Megjegyzés: A tesztelés nem hitelesíti a visszahívási URL-címet. A részletekért tekintse meg a Speciális integrált láthatóság dokumentációját.
A projekt áthelyezése éles környezetbe
Állítsa be az élesítési konfigurációt az élesítés előtt. Átnevezheti a kulcsot, hozzáadhat további ügyfélszámokat a projekt élesítése után, és átnézheti a projekt létrehozása során kiválasztott ügyfélszámot. Ez az ügyfélszám a projektet éles környezetbe helyezi.
Megjegyzés: Az ügyfélszám alapú Speciális integrált láthatósági projektekhez nem szükséges az éles környezet aktiválása.
1. A menüből válassza ki a Saját projektek menüpontot, majd válassza ki a Projekt nevét.
2. Válassza ki az Élesítési kulcs lapot.
3. Biztonságosan kérje le és tárolja az éles környezetben használt hitelesítő adatait.
- Másolja az élesítési API-kulcsot és a titkos kulcsot egy biztonságos helyre.
- Amikor élesítési kulcsot igényel, mentse el biztonságos helyre, mivel csak egyszer jelenik meg. Ha elveszíti, később létrehozhat egy újat.
4. Válassza a Tovább gombot a projekt részleteinek megtekintéséhez az Élesítési kulcs lapon.
További fuvarozási ügyfélszámok hozzáadásához válassza ki a Szerkesztés gombot a fuvarozási ügyfélszámok táblázatának tetején.
A hitelesítési lépések régiónként eltérőek
A következő lépések csak az Egyesült Államokban és Kanadában élő ügyfelekre vonatkoznak. Ha ezeken az országokon kívül él, látogasson el az API-hitelesítés oldalra, ahol támogatást talál.
Az API hitelesítése
Néhány FedEx API esetében szükséges a fuvarozási címke érvényesítése, mielőtt éles környezetben használhatók lennének. Mielőtt elkezdené, tekintse át az API-hitelesítési követelményeket.
1. A menüből válassza ki a Saját projektek menüpontot, majd válassza ki a Projekt nevét.
2. Az API-kulcsok fülön, a Tesztkulcs alatt találja meg a tesztelési hitelesítő adatait.
3. A tesztelés befejezése után helyezze át a projektet a FedEx Developer Portal éles környezetébe, hogy megkezdhesse a hitelesítést.
- Amikor élesítési kulcsot igényel, mentse el biztonságos helyre, mivel csak egyszer jelenik meg. Ha elveszíti, később létrehozhat egy újat.
4. Adja meg a szükséges információkat a címke kísérőlapján, beleértve az elérhetőségeket, a tervezett szolgáltatásokat, az ügyfélszámot és az élesítési API-kulcsot.
5. Hozzon létre tesztcímkéket a FedEx tesztelési környezetben, majd küldje be őket a FedEx Vonalkódelemző csoportnak áttekintésre. A címke elbírálására három munkanap áll rendelkezésre.
Legjobb gyakorlatok a késések elkerülésére:
- A címkéket nyomtassa ki és szkennelje be legalább 600 DPI felbontással. Ne küldjön be közvetlenül API-k által generált fájlokat.
- Hőnyomtatók esetén a nyomtatónak megfelelő képtípust kell kérni, például ZPLII a Zebra nyomtatók esetén.
- A mintacímkékhez érvényes szállítói és címzetti címet adjon meg. Csak azokhoz a szolgáltatásokhoz hozzon létre címkéket, amelyeket használni kíván.
- Az utánvétes (C.O.D.) FedEx-küldeményekhez mellékelje a C.O.D. visszárucímkét.
- FedEx International Express® esetén mellékelje a kiegészítő (másodlagos) légi fuvarlevelet (AWB).
- Több darabból álló küldemények (MPS) esetén minden csomaghoz egy címkét küldjön be.
Küldje be az anyagait az alábbi lehetőségek egyikével:
- A PDF-fájlt és a címke kísérőlapját küldje el e-mailben a következő e-mail-címre: label@fedex.com.
- A fizikai címkéket küldje a következő címekre:
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
Megjegyzés: Fizikai címkék esetén győződjön meg arról, hogy nincsenek látható hibák, például tintacsíkok vagy sérülések. Nyomtatás közben ne nagyítsa vagy zsugorítsa a címkéket.
6. A FedEx Vonalkódelemző csoport átnézi a beküldését, jóváhagyja vagy elutasítja a címkéket. Ha a címkéket elutasítják, kezelje a visszajelzést, és küldje be újra.
7. A jóváhagyást követően a FedEx Vonalkódelemző csoport e-mailben értesíti Önt, miután engedélyezte a fuvarozási címke tranzakciókhoz szükséges élesítési hitelesítő adatait.
Megjegyzés: A jóváhagyás projektenként érvényes. Minden új projekthez jóváhagyás szükséges.
8. Cserélje le a tesztelési URL-címeket és hitelesítési adatokat az élesítési URL-címekre és hitelesítési adatokra.
9. Futtasson le egy utolsó éles tesztet mintaadatokkal annak megerősítésére, hogy minden az elvárásoknak megfelelően működik.
