Postal Code Validation API

Rozhraní API pro ověřování poštovních směrovacích čísel FedEx umožňuje zákazníkům společnosti FedEx ověřovat poštovní směrovací čísla a zjišťovat dostupnosti služeb. Podporuje vyhledávání a ověřování podle města, PSČ, země a místa určení. Jako odpověď vrátí ověřené poštovní údaje a údaje o poloze.

Rozhraní pro ověření PSČ ověřuje PSČ zemí a měst a jako odpověď poskytuje správné poštovní směrovací číslo. PSČ musí mít pro účely zpracování zásilky nebo vytvoření přepravních štítků správný formát.

Toto rozhraní API používá zadané vstupní informace, jako je datum odeslání, PSČ, kód země a další informace, a kontroluje případný nesoulad mezi hodnotami státu a města. Pokud je nalezen nesoulad a pokud je země USA nebo Kanada (CA), nastaví se město a stát. Například: FDXE – FedEx Express^®, FDXG – FedEx Ground^® a FXSP – FedEx Ground^® Economy (dříve pod názvem Fedex SmartPost ^®). Rozhraní API ověří zadaný vstup a poskytne údaje o poloze a správné poštovní směrovací číslo.

Společnost FedEx poskytuje služby jak do zemí používajících PSČ, tak do zemí, které PSČ nepoužívají.

Země používající PSČ

Zásilky do těchto zemí by měly na leteckých nákladních listech a dalších dokumentech obsahovat poštovní směrovací čísla, aby se snížilo zpoždění a zvýšila efektivita. Zákazníci společnosti FedEx Express by měli v adresách příjemců z níže uvedených zemí uvádět platná poštovní směrovací čísla.

Další informace o zemích používajících PSČ naleznete v části Země používající PSČ.

Země, které PSČ nepoužívají

Jak již nadpis napovídá, existují země, které PSČ nepoužívají PSČ, a společnost FedEx do nich služby poskytuje. U těchto zemí se u poštovních zásilek poštovní směrovací čísla nepoužívají. Pokud zákazník odesílá zboží do země, která nepoužívá PSČ, stačí zadat kód státu nebo jméno města. Pokud dojde při ověřování této země k chybě, zkuste vynutit adresu tak, že místo PSČ zadáte \„00000\“. Vzhledem k tomu, že toto PSČ neexistuje, nemělo by se po vložení nic stát.

Níže jsou uvedeny výhody používání rozhraní API pro ověřování PSČ společnosti FedEx:

• Snižuje zpoždění přepravy a zvyšuje efektivitu.
• Zvyšuje počet včasných a kompletních dodávek.
• Zlepšuje služby společnosti FedEx v městech a nabízí flexibilitu v časech odjezdu a plánu vyzvednutí.

Služba FedEx pro ověření PSČ používá níže uvedenou funkci k ověření poštovních směrovacích čísel měst, zemí a míst původu a určení. V následující části jsou popsány klíčové vstupní údaje a reakce této funkce:

Ověření PSČ

Tento požadavek slouží k vrácení poštovních údajů, správného PSČ a popisu místa na základě zadaných údajů. Klíčové vstupní údaje pro tento požadavek jsou následující:

• carrierCode
• countryCode
• stateOrProvinceCode
• postalCode
• shipDate

Po úspěšném dokončení tohoto požadavku jsou pro zadaný vstup poskytnuty údaje locationdetails a cleanedpostalcode. Požadavek selže, například pokud není pro PSČ zadána platná kombinace kódu země, státu/oblasti a kódu PSČ.

Vysvětlení častých omylů

• Nelze vzájemně porovnávat zadané území a zadané PSČ, protože se na základě zadaných údajů jedná o zcela oddělené výstupy.
• Na světě existují místa, která nemají své poštovní směrovací číslo.

Další informace o seznamu služeb pro jednotlivé regiony naleznete v části Seznam služeb pro jednotlivé regiony.

• Kombinace čísla, názvu ulice atd. Pro platnou fyzickou adresu je vyžadován alespoň jeden řádek; prázdné řádky v adrese nejsou povoleny.
• Pokud je zemí příjemce USA nebo Kanada, nebo pokud se použije EEI a zemí je Mexiko {MX}, je vyžadován dvoupísmenný kód země nebo provincie.
• Popisné údaje pro fyzické umístění lze použít jako skutečnou fyzickou adresu (veřejně přístupné místo) nebo jako \„část adresy\“, která představuje jednotku (například kombinace město, stát, PSČ v USA).
• Formát a přítomnost pole pro PSČ se liší v závislosti na zemi.