Rozhraní API pro ověření adresy je inteligentní řešení, které řeší nepřesné kontaktní údaje a umožňuje rychlejší a přesnější doručování zásilek. Toto rozhraní API vhodně formátuje vstupní informace o adrese příjemce tak, aby se co nejvíce podobaly platné adrese, a vrátí skutečnou adresu, která je pravděpodobně tou zamýšlenou.

Rozhraní API také poskytuje vysvětlivky o nedostatcích ve vstupní adrese nebo o provedených změnách vstupu, abychom došli ke skutečné adrese. Toto rozhraní API můžete použít k ověření a vyřešení informací o adrese příjemce před odesláním balíku.

Poznámka: Nepoužívejte toto API k ověření, zda je na adresu možné doručovat. Společnost FedEx nenabízí doručení na každou platnou adresu. Společnost FedEx nedoručuje do P.O. boxů s výjimkou služby FedEx Ground® Economy (dříve pod názvem FedEx SmartPost®).

Toto rozhraní API umožňuje před odesláním balíčku ověřit a opravit údaje o adrese příjemce. Přesné adresy na přepravním štítku pomohou eliminovat zpoždění při doručování a dodatečné poplatky za opravu adresy (kvůli chybným adresám).

Poznámka:

• Výsledky řešení problémů s adresami se liší podle zemí/oblastí.
• Adresa zadaná v žádosti je porovnána s referenčními údaji v databázi FedEx a je vrácena odpovídající adresa.

Funkce rozhraní API pro ověření adresy

• Poskytuje shody adres na úrovni ulic.
• Dochází k měsíční aktualizaci databáze adres.
• Rozlišuje mezi obchodními a rezidenčními adresami, pokud je nalezena přesná shoda.
• V současné době neověřuje čísla apartmánů nebo bytů.

Možnosti rozhraní API pro ověření adresy

• Doplňuje neúplné adresy příjemců. V některých případech bude rozhraní API pro ověření adresy schopno doplnit chybějící informace v závislosti na ověření poskytnutých informací oproti referenčním údajům. Rozhraní API pro ověření adresy nemůže v současné době přidávat chybějící sekundární informace (např. byt nebo apartmá).
• Dochází k měsíční aktualizaci databáze adres.
• Opravuje neplatné adresy příjemců. Například oprava nesprávného poštovního směrovacího čísla tak, aby souhlasilo se zbytkem adresy.
• Určuje, zda je adresa obchodní nebo rezidenční a zvyšuje tak přesnost stanovení zvláštní ceny. Vztahuje se pouze na adresy v USA a Kanadě.
• Ověřuje platnost a úplnost adres v mnoha zemích těchto regionů: USA, Kanada, Latinská Amerika, Evropa, Střední východ a Asie a Tichomoří. Nyní můžete před odesláním balíku ověřit údaje o vnitrostátní a mezinárodní adrese, díky čemuž předejdete zbytečným zpožděním při doručování a dalším poplatkům za služby.
• Poskytuje shody na úrovni ulic.
• V jednom požadavku na rozhraní API je možné zkontrolovat až 100 adres.

Země/teritoria podporující rozhraní API pro ověření adresy

Rozhraní API pro ověření adresy společnosti FedEx můžete použít v následujících zemích k ověření a opravě adres příjemců pro efektivní doručování.

Poznámka: Informace vrácené požadavkem na ověření adresy jsou určeny pouze pro navrhované použití.

Vyloučení odpovědnosti: Zde uvedené údaje jsou chráněné a důvěrné informace společnosti FedEx, poskytované jako projev laskavosti na základě vaší žádosti. Žádná část těchto údajů nesmí být žádným způsobem distribuována ani zveřejněna žádné třetí osobě bez písemného souhlasu společnosti FedEx. Tyto údaje odrážejí aktuální klasifikaci adres firem a domácností společnosti FedEx v databázi doručovacích adres FedEx a mohou se kdykoli změnit. Společnost FedEx při poskytování těchto informací nezaručuje jejich aktuální nebo budoucí přesnost ani nezaručuje, že balíky odeslané na tyto adresy, budou fakturovány podle zde uvedené klasifikace firem/domácností. Poskytnutí těchto informací nemění podmínky vztahu mezi dotčenými stranami. Viz Průvodce službami FedEx a veškeré další smlouvy o speicálních cenách, kde najdete podmínky týkající se poplatků FedEx za přepravu a příplatků.

Ověření adres

Tento koncový bod použijte k ověření a převedení vstupních adres a k získání skutečných adres. Podrobnosti zadané adresy jsou ověřeny, aby bylo možné adresu dohledat. Adresa je uvedena jako převedená, když se vstupní adresa shoduje se známými referenčními údaji.

Požadované vstupní údaje pro tento požadavek jsou:

• Ulice
• Město (nepovinný údaj)
• Kód státu nebo provincie (volitelné)
• PSČ (volitelné)
• Kód země

Poznámka: Kód země nebo název města postačuje, pokud zákazník odesílá do země, která nemá PSČ.

Rozhraní API pro ověření adresy vrátí skutečnou adresu na základě těchto operací provedených na zadané adrese:

• Jako první krok se rozhraní API pokusí vstupní adresu normalizovat. Mezi tyto operace může patřit nahrazení běžných identifikátorů silnic, jako jsou ulice a dálnice, jejich standardními zkratkami jako jsou ST a PKWY, stejně jako změna pořadí jednotlivých komponent adresy. Jestliže vstupní adresu nelze normalizovat, adresy vrácené jako převedené budou shodné se vstupními adresami. Hodnoty, které netvoří adresu, jsou zahozeny.
• Jako druhý krok se rozhraní API pokusí standardizovat normalizovanou adresu tím, že najde možnou nebo skutečnou adresu odpovídající té, kterou uživatel pravděpodobně zamýšlel. Jestliže se standardizace nezdaří, adresa vrácená jako převedená bude vstupní adresa v normalizovaném tvaru. Vrácené prvky vám pomohou určit problémy s odeslanou adresou.
• Vráceny budou rovněž některé prvky této normalizované adresy. Jestliže se standardizace nezdaří, adresa vrácená jako převedená bude shodná se skutečnou adresou. V takovém případě budou vráceny rovněž různé dodatečné prvky standardizované adresy a také informace o tom, jak byly odvozeny z normalizované adresy.

Návratové hodnoty rozhraní API pro ověření adresy

Jestliže vrácená adresa obsahuje následující hodnoty pro níže uvedené atributy, pak je adresa platná:

• Adresa země je standardizovaná
• Atribut ověření má hodnotu True
• Platné místo doručení (DPV) má hodnotu True
• Interpolovaná adresa má hodnotu False

Jestliže tyto položky uvedeny nejsou, pak k určení možných problémů s hodnotami adresy použijte dodatečné atributy.

Další informace o atributech adresy najdete viz Atributy adresy.

Pokud je vrácená výstupní zpráva pro zákazníka INTERPOLATED.STREET.ADDRESS, je možné, že adresa není platná. Další informace o kódech zpráv pro zákazníka najdete v popisu prvku zprávy pro zákazníka.

Anotace

Rozhraní API pro ověřování adres vrací anotace ke každé ověřené a vrácené adrese. Anotace poskytují informace o případných nedostatcích a změnách provedených ve vstupní adrese, abychom došli ke skutečné adrese.

Rozhraní API pro ověření adresy používá referenční údaje k určení klasifikace dané adresy. Klasifikace funkční adresy se vypočítává nezávisle na procesu ověření adresy a je založena na zpětné vazbě od provozních pracovníků, přičemž komerční zdroje dat se používají pouze pro potvrzení.

Rozhraní API pro ověření adresy má pouze čtyři možné klasifikace adres: neznámé, obchodní, rezidenční a smíšené. Všechny adresy začínají s klasifikací „neznámé“ a zůstávají tak, dokud obchodní pravidla pro ověřování adres neurčí, že by se jejich klasifikace měla změnit. Lokalita je klasifikována jako „smíšená“ pouze v případě, že se jedná o adresu s více nájemníky a obsahuje jak obchodní, tak obytné jednotky.

Poznámka: Služba FedEx Express poskytuje další řádek adresy (řádek 3 adresy) pro adresy příjemců. Tyto dodatečné informace o adrese nabízejí úplnější a přesnější údaje o poloze a zvyšují šanci na získání přesné adresy.

Adresy v reálném světě jsou klasifikovány takto:

Obchodní adresa

Obchodní adresa je adresa, která slouží k označení hlavního místa podnikání. Je to místo, odkud se předpokládá, že firma funguje, ale nemusí to tak být vždy.

Obchodní adresa je oficiální umístění sídla společnosti. Může se jednat o jakékoli místo – od adresy domácnosti až po areál za několik milionů dolarů, který si oblíbily velké technologické společnosti, a všechno mezi tím.

Adresa domácnosti

Poplatek za doručení do domácnosti bude účtován k zásilkám na území Spojených států doručovaných do domácnosti nebo soukromého bytu, včetně případů, kdy je podnikání provozováno z domácnosti. Pro doručení do domácnosti prostřednictvím služby FedEx Ground do 1 pracovního dne použijte službu FedEx Home Delivery, v závislosti na vzdálenosti místa určení.

Příklad:

• Sídlo pastora
• Konvent
• Fara
• Obyvatelé domů s více jednotkami, jako jsou:
  • Apartmánové domy
  • Bytové domy
  • Vysokoškolské koleje

• Sídlo, kde jsou produkty prodávány a/nebo odkud jsou distribuovány

Pár užitečných tipů pro používání rozhraní API pro ověření adresy:

• Správné použití mezer: Ujistěte se, že jsou mezery správně umístěny a vyhněte se nadbytečným mezerám.
• Správný pravopis: yhněte se překlepům a typografickým chybám. Také se ujistěte, že správně používáte číslo nula (0) a písmeno O.
• Vyhněte se speciálním znakům: Nepoužívejte speciální znaky, které nejsou nutné, například tečky za zkratkami (Ave vs. Ave.).
• Zadejte doplňující podrobnosti o adrese a ulici: Poskytnutím doplňujících informací o adrese zvýšíte přesnost výsledků.
  • Číslo budovy nebo domu – 1, 1A, 1½, One
  • Název ulice – Main, George Washington, 42^nd
  • Přípona ulice – Road, Avenue, Rd, Ave
• Zadejte město, stát/provincii a PSČ: Zadáním všech tří informací zvýšíte přesnost výsledků.
• Zadejte název ulice a adresu ve správném pořadí: Prvky adresy ulice mají obvykle formát začínající číslem budovy nebo domu, po kterém následuje předsměrový prvek, název ulice, typ nebo přípona ulice, číslo bytu a/nebo určení a číslo soukromé poštovní schránky.
• Používejte správné zkratky: U.S. Postal Service a Canada Post mají standardní zkratky pro státy/provincie, přípony ulic a určení bytů nebo jednotek.
  • Jiné než standardní zkratky mohou způsobit špatné výsledky vyhledávání.
  • Pokud si zkratkou nejste jisti, nepoužívejte ji.

Příklad:

• Číslo budovy nebo domu – 1, 1A, One
• Název ulice – Main, George Washington, 42nd
• Přípona ulice – Road, Avenue, Rd, Ave
• Zadejte město, stát/provincii a PSČ: Zadáním všech informací o adrese zvýšíte přesnost výsledků. Část ZIP+4 PSČ není pro kontrolu adresy nutná.
• Používejte správné zkratky: United States Postal Service a poštovní úřady v dalších zemích definují standardní zkratky pro státy/provincie, přípony ulic a určení bytů/jednotek. Jiné než standardní zkratky mohou způsobit špatné výsledky vyhledávání. Pokud si zkratkou nejste jisti, nepoužívejte ji.
• Zvažte poskytnutí zpětné vazby ohledně odezvy ověření adresy uživatelům, aby si mohli vybrat si nejvhodnější adresu.

• Poznámka: Nepoužívejte toto API k  ověření, zda je na adresu možné doručovat balíky. Společnost FedEx nenabízí doručení na každou platnou adresu. Společnost FedEx nedoručuje do P.O. boxů (s výjimkou služby FedEx Ground® Economy (dříve pod názvem FedEx SmartPost^®)).
• Informace vrácené při ověřování adresy jsou určeny pouze pro navrhované použití.
• V rámci jednoho požadavku je možné zkontrolovat až 100 adres.
• Minimální povinná pole se v jednotlivých zemích mohou lišit.

  Pro adresy v USA je například vyžadován alespoň jeden řádek adresy a buď PSČ, nebo kód města a státu, ale pro adresy AUS (formát adres v Austrálii) může být kód státu vynechán i bez zadaného PSČ.

• Výsledky řešení problémů s adresami se mohou lišit podle zemí/oblastí.

Poznámka: Rozhraní API pro ověření adresy nemusí být k dispozici pro všechny země. Viz oddíl Země/teritoria podporující rozhraní API pro ověření adresy.