FedEx integrátori szolgáltató
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 számlázá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. Válassza a navigációs sávban a Szervezet létrehozása vagy csatlakozás egy szervezethez lehetőséget.
2. Adja meg a következő adatokat:
- Az Egy olyan vállalatnál dolgozom, amely: lehetőségnél válassza a „FedEx technológiát használó szoftvermegoldást értékesít vagy biztosít és szeretne hitelesített FedEx integrátori szolgáltatóként regisztrálni 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.
- Adjon meg egy hivatalos e-mail-címet, amely tartalmazza a cég domainjét, az országot vagy területet, ahol a céget bejegyezték, valamint azokat az országokat és területeket, ahol a szoftvermegoldását értékesíti vagy forgalmazza.
3. Válassza a Tovább gombot.
A részleteket később a Szervezet kezelése menüpont alatt frissítheti vagy adhatja hozzá.
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.
Megjegyzés: Használja a saját ügyfélszámát; az nem lehet egy ügyfél FedEx-ügyfélszáma.
2. Válassza a Számlázási ügyfélszám hozzáadása lehetőséget.
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.
Megjegyzés: A számlázási címnek meg kell egyeznie az ügyfélszám létrehozásakor használt címmel. Ez az ügyfélfiók lesz a szervezete alapértelmezett számlázási ügyfélszáma.
4. Válasszon egy hitelesítési lehetőséget.
- A telefonhívás csak az Egyesült Államokban és Kanadában érhető el az integrátorok számára.
5. Adja meg a kapott hitelesítési kódot, és válassza a Beküldés lehetőséget.
6. Olvassa el és fogadja el a FedEx Integrátori megállapodást.
Felhasználók meghívása rendszergazdaként
1. Lépjen a Szervezet kezelése menüpontra, majd válassza a Felhasználók lapot.
2. Válassza a + Felhasználók hozzáadása lehetőséget.
3. Adja meg a következő adatokat:
- Az ország vagy terület
- Az előnyben részesített nyelv
4. Válasszon ki egy felhasználói szerepet (Megtekintő, Közreműködő vagy Rendszergazda).
5. (Választható) Rendelje hozzá a felhasználót egy projekthez.
- A felhasználót bármikor hozzárendelheti a projekt Áttekintés oldaláról.
6. Adja meg a felhasználók e-mail-címét, majd kattintson a Meghívás lehetőségre.
- Egyszerre legfeljebb 20 felhasználót hívhat meg, az egyes e-mail-címeket vesszővel elválasztva. A meghívó 24 órán át érvényes.
Projekt létrehozása
1. Lépjen a menüből a Saját projektek menüpontba, és válassza a + Projekt létrehozása lehetőséget.
2. Adja meg a Projekt nevét.
- A javasolt névformátum Projektnév_alkalmazásnév. Ha kész, válassza a Tovább lehetőséget.
3. Válassza ki az API-kat és a Speciális integrált láthatóság termékeket a projektjéhez.
- A Speciális integrált láthatóság termékek kizárólag az egyesült államokbeli FedEx integrátori szolgáltatók számára érhetők el.
- Ha fizetős termékeket választ, a rendszer kérni fogja, hogy rendeljen hozzá egy számlázási ügyfélszámot a projekthez, és fogadja el a szükséges feltételeket.
Számlázási ügyfélszám hozzárendelése
Megjegyzés: Erre csak akkor van szükség, ha fizetős terméket választ.
1. Rendeljen hozzá egy számlázási ügyfélszámot a szervezethez hozzáadott ügyfélszámok listájából. A számlázási ügyfélszámoknak az Egyesült Államokban kell lenniük.
2. Fogadja el a FedEx Developer Portal licencszerződését és megrendelőlapját, majd válassza a Létrehozás lehetőséget.
Speciális integrált láthatóság konfigurálása egy projektben
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 árakról további információkat a Megrendelőlapon talál.
- Ü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élfiókokat 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 FedEx-szel 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 részleteké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.
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. 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 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-k éles környezetbe való áthelyezéséhez hitelesíteni kell azokat. A hitelesítés szintje API-nként változhat. 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. Azonosítsa a teszteseteket azokhoz a régiókhoz vagy területekhez, ahol a megoldás telepítését tervezi. További részletekért tekintse meg az Alapértelmezett integrátori tesztesetek részt.
4. Fejezze be a regisztrációs tranzakciókat a megadott teszt ügyfélszámokkal, mielőtt teszteseteket futtatna.
5. Fejezze be az összes szükséges tesztesetet.
6. Töltse ki a Termékinformációs munkalapot (PIW) az elérhetőségi adataival és a kívánt FedEx-szolgáltatásokkal.
7. Töltse ki az Integrátori hitelesítési kísérőlapot.
Küldje be az anyagokat
Küldjön el minden szükséges anyagot a validationmtp@fedex.com címre.
1. Készítse elő a következő dokumentumokat:
- Kitöltött PIW (PDF)
- Kitöltött hitelesítési kísérőlap (PDF)
- Végfelhasználói regisztrációs tranzakciók többtényezős hitelesítéssel (JSON)
- Szkennelt fuvarozási címkék az összes vonatkozó tesztesethez (PDF vagy PNG)
- Fuvarozási tranzakciók három címkeformátumhoz (PDF, PNG és ZPL (JSON)), a vonatkozó fuvarozási és díjszabási API-khoz
- Képernyőképek (PDF), amelyeken a következők láthatók:
- Ügyféloldali megoldás, amely a FedEx-szolgáltatásokat és a különleges kezelést jeleníti meg
- Felelősségkizáró nyilatkozat
- Végfelhasználói licencszerződés (EULA)
- Végfelhasználói regisztrációs folyamat
2. Tömörítse be az összes fájlt egyetlen .zip fájlba az e-mail-szolgáltatókra vonatkozó korlátozások elkerülése érdekében.
3. Küldje el a .zip fájlt e-mailben a hitelesítési csapatnak.
Legjobb gyakorlatok a késések elkerülésére
Kövesse az alábbi iránymutatásokat a felülvizsgálati idő csökkentése érdekében:
- 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.
- FedEx International Express® esetén mellékelje a kiegészítő (másodlagos) légi fuvarlevelet (AWB).
- A több darabból álló küldemények (MPS) minden egyes csomagjához mellékeljen címkét.
Címke értékelése
A Hitelesítési csapat áttekinti a beadványát.
- Ha elutasítják, kezelje a visszajelzést, és küldje be újra a dokumentumokat.
- Ha jóváhagyják, kap egy megerősítő e-mailt. Jóváhagyás után engedélyezzük az élesítési hitelesítő adatait a fuvarozási címke tranzakciókhoz.
1. A menüből válassza ki a Saját projektek menüpontot, majd válassza ki a Projekt nevét.
2. Másolja és tárolja biztonságosan az élesítési API-kulcsot és a titkos kulcsot az API-k szakaszban.
Megjegyzés: Mentse el a titkos kulcsot biztonságos helyre, mivel csak egyszer jelenik meg. Ha elveszíti, később létrehozhat egy újat.
