Fedex Logo

Bevezetés

A FedEx irányítószám-hitelesítési API lehetővé teszi a FedEx-ügyfelek számára, hogy hitelesítsék az irányítószámokat, valamint lekérdezzék a szolgáltatási kötelezettségvállalásokat. Támogatja a várossal, postai címmel, országgal és származási országgal, valamint a célállomással kapcsolatos kereséseket és az érvényesítéseket. A válaszban ellenőrzött postai és helymeghatározási adatokat küld vissza.

Az irányítószám-hitelesítési API adatai

Az irányítószám-hitelesítés érvényesíti az országok és városok postai irányítószámait, és válaszként a rendszerben megtisztított postai irányítószámot adja meg. A helyesen formázott postai irányítószámok kötelezőek a küldemény feldolgozásához vagy a fuvarozási címkék létrehozásához.

Ez az API a megadott bemeneti adatokat, például a fuvarozási dátumot, az irányítószámot, az országkódot és más különböző információkat használja, és ellenőrzi az állam és a város értékei közötti eltérést. A város és az állam akkor kerül beállításra, ha nem egyezik, és ha az ország U.S. vagy CA. Például: FDXE – FedEx Express®, FDXG – FedEx Ground® és FXSP – FedEx Ground® Economy (korábbi nevén FedEx SmartPost®). Az API érvényesíti a megadott bemenetet, és megadja a hely adatait és a rendszerben megtisztított irányítószámot.

A FedEx támogatja mind a postai szolgáltatásokat támogató, mind a postai szolgáltatásokat nem támogató országokat is.

Postai szolgáltatásokat támogató országok

Az ezekbe az országokba irányuló küldeményeknek tartalmazniuk kell a postai irányítószámokat a légi fuvarleveleken és egyéb dokumentációkon a késedelmek csökkentése és a hatékonyság maximalizálása érdekében. A FedEx Express ügyfeleinek azt javasoljuk, hogy az alábbi országokban található címzettek esetében érvényes postai irányítószámokat tüntessenek fel a címükben.

További információt a postai szolgáltatásokat támogató országokról a Postai szolgáltatásokat támogató országok című dokumentumban olvashat.

Postai szolgáltatásokat nem támogató országok

Ahogy a nevük is mutatja, vannak olyan, a FedEx által támogatott, postai szolgáltatásokat nem támogató országok, amelyek nem írják elő a postai irányítószámokat a küldemények esetén. Az államkód vagy a város neve elegendő, ha az ügyfél olyan országba szállít, ahol nincs postai irányítószám. Ha olyan ország esetében, ahol nem használnak irányítószámot, érvényesítési hiba lép fel, próbálja meg úgy érvényesíteni a címet, hogy a \"00000\" számsorral helyettesíti az irányítószámot. Ennek a nem valós irányítószámnak a használata nem okozhat problémát, mivel nem létezik.

A következők az előnyei annak, ha a FedEx irányítószám-hitelesítési API-t használja:

  • Csökkenti a fuvarozási késedelmeket és növeli a hatékonyságot.
  • Növeli a valós idejű és teljesített fuvarozások számát.
  • Javítja a FedEx szolgáltatásait a városi területeken, rugalmasságot kínálva a zárási időpontok és az átvételi menetrendek tekintetében.

Hogyan működik az irányítószám-hitelesítési API?

A FedEx irányítószám-hitelesítési API az alábbi végpontot használja az irányítószámok hitelesítéséhez a városok, országok, származási országok és célországok esetében. A következő szakasz a végpont legfontosabb bemeneteit és válaszait ismerteti:

Irányítószám hitelesítése

Ez a kérés a postai adatok, a rendszerben megtisztított irányítószám és a helyleírás visszaküldésére szolgál a megadott adatok alapján. A kérelemhez kapcsolódó legfontosabb bemeneti adatok a következők:

  • carrierCode (fuvarozói kód)
  • countryCode (országkód)
  • stateOrProvinceCode (állam vagy tartomány kódja)
  • postalCode (postai irányítószám)
  • shipDate (fuvarozás dátuma)

A kérés sikeres eredménye a következő: locationdetails és cleanedpostalcode a megadott bemenethez. A kérés sikertelen, ha az irányítószám nem érvényes, például a CountryCode, az állam/tartomány és az irányítószám/postai irányítószám kombinációja nem érvényes.

A gyakori félreértések tisztázása

  • Nem lehetséges a területi- és az irányítószám/postai irányítószám-összehangolás kereszthivatkozása, mivel ezek az összehangolási folyamatok különálló kimenetei.
  • A világon nem minden földrajzi hely rendelkezik postai irányítószámmal vagy irányítószámmal.

A régióspecifikus listára vonatkozó információkért olvassa el a Régispecifikus lista című dokumentumot.

Üzleti szabályok

  • Szám, utcanév stb. kombinációja. Legalább egy sor megadása szükséges az érvényes fizikai címre vonatkozóan; a címen belüli üres sorok nem engedélyezettek.
  • 2 betűs állam- vagy tartománykód szükséges, ha a fogadó ország az Egyesült Államok vagy Kanada, vagy ha EEI-t kell alkalmazni, és az ország Mexikó {MX}.
  • A fizikai hely leíró adatai használhatók tényleges fizikai címként (olyan hely, ahová el lehet menni), vagy a(z) \"address parts\" tárolójaként, amelyeket egységként kell kezelni (például egy város, állam és irányítószám kombinációja az Egyesült Államokban).
  • Az irányítószám mezőformátuma és jelenléte országonként eltérő.

JSON API-gyűjtemény

CLOSE

Response

Copy