API-ul de validare a adreselor este o soluție inteligentă pentru a rezolva detaliile de contact inexacte și pentru a permite livrarea mai rapidă și precisă a coletelor. Acest API formatează în mod corespunzător informațiile introduse pentru adresa destinatarului care seamănă foarte mult cu o adresă validă și returnează o adresă din lumea reală care este probabil să fie cea intenționată.

API-ul furnizează, de asemenea, adnotări cu privire la deficiențele din adresa introdusă sau la modificările care au fost făcute introducerii pentru a ajunge la acea adresă din lumea reală. Puteți utiliza acest API pentru a valida și rezolva informațiile privind adresa destinatarului înainte de a expedia un colet.

Notă: Nu utilizați acest API pentru a determina posibilitatea de livrare la o adresă. FedEx nu oferă servicii de livrare la toate adresele valide. FedEx nu livrează la căsuțe poștale (decât prin FedEx Ground® Economy, cunoscut anterior ca FedEx SmartPost®).

Acest API permite validarea și corectarea informațiilor privind adresa destinatarului înainte de expedierea unui colet. Adresele exacte de pe eticheta de expediere vor ajuta la eliminarea întârzierilor de livrare și a taxelor suplimentare de corectare a adresei (din cauza adreselor cu forme greșite).

Notă:

• Rezultatele validării adresei variază în funcție de țară/teritoriu.
• Adresa introdusă în solicitare este comparată cu datele de referință din baza de date FedEx și se returnează adresa care corespunde.

Funcționalitățile API-ului de validare a adreselor

• Furnizează potriviri de adrese la nivel de stradă.
• Primește actualizări lunare ale bazei de date cu adrese.
• Face distincție între adresele comerciale și cele rezidențiale dacă se găsește o potrivire exactă.
• Nu verifică în prezent numerele apartamentelor sau al suitelor.

Capacitățile API-ului de validare a adreselor

• Completează adresele incomplete ale destinatarilor. În unele cazuri, API-ul de validare a adreselor va putea adăuga informații lipsă, în funcție de verificarea informațiilor furnizate în raport cu datele de referință. În acest moment, API-ul de validare a adreselor nu poate adăuga informații secundare lipsă (de exemplu, apartamentul sau suita).
• Primește actualizări lunare ale bazei de date cu adrese.
• Corectează adresele nevalide ale destinatarilor. De exemplu, corectează un cod poștal incorect pentru a se potrivi cu restul datelor introduse.
• Determină dacă o adresă este comercială sau rezidențială pentru a crește acuratețea calculării tarifului. Se aplică numai adreselor din SUA și Canada.
• Confirmați validitatea și completitudinea adreselor în multe țări din aceste regiuni: SUA, Canada, America Latină, Europa, Orientul Mijlociu și Asia-Pacific. Acum puteți valida informațiile privind adresele naționale și internaționale înainte de a expedia un colet, eliminând astfel întârzierile de livrare inutile și taxele de servicii suplimentare.
• Oferă potriviri la nivel de stradă.
• Pot fi verificate până la 100 de adrese într-o singură solicitare în API.

Țări/Teritorii care acceptă API-ul de validare a adreselor

Puteți utiliza API-ul de validare a adreselor FedEx în următoarele țări pentru a valida și a corecta adresele destinatarilor pentru livrări eficiente.

Notă: Informațiile returnate de solicitarea de validare a adreselor sunt doar pentru utilizare sugerată.

Mențiune legală: Datele furnizate în acest document sunt informații confidențiale și de proprietate FedEx, furnizate din curtoazie la cererea dvs. Nicio parte a acestor date nu poate fi distribuită sau dezvăluită sub nicio formă unei terțe părți fără permisiunea scrisă a FedEx. Acestea reflectă clasificarea actuală a adreselor FedEx la nivel de adresă comercială/rezidențială din baza de date FedEx cu adrese de livrare și pot fi modificate. Prin furnizarea acestor informații, FedEx nu garantează acuratețea prezentă sau viitoare a acestora și nu garantează că coletele expediate la aceste adrese vor fi facturate în conformitate cu clasificarea comercială/rezidențială furnizată în acest document. Furnizarea acestor informații nu va fi considerată că modifică termenii relației dintre părți. Consultați Ghidul de servicii FedEx și orice acord de tarifare a contului aplicabil pentru termenii și condițiile care reglementează expedierile și taxele FedEx.

Validare adresă

Utilizați acest punct final pentru a valida și a rezolva adresele introduse și pentru a returna adresele din lumea reală. Detaliile adresei sunt furnizate și validate pentru a rezolva o adresă. O adresă este declarată ca fiind rezolvată atunci când adresa introdusă coincide cu datele de referință cunoscute.

Informațiile de intrare necesare asociate cu această solicitare sunt:

• Rândurile pentru stradă
• Orașul (opțional)
• Codul statului sau provinciei (opțional)
• Codul poștal (opțional)
• Cod țară

Notă: Codul statului sau numele orașului este suficient în cazul în care clientul expediază către o țară care nu are un cod poștal.

API-ul de validare a adreselor returnează o adresă din lumea reală prin efectuarea următoarelor operații asupra adresei introduse:

• Ca prim pas, API încearcă să normalizeze adresa introdusă. Aceasta poate include înlocuirea identificatorilor de drumuri obișnuite, cum ar fi street (stradă) și parkway (alee), cu abrevierile lor standard, cum ar fi ST și PKWY, precum și reordonarea componentelor adresei. În cazul în care o adresă introdusă nu poate fi normalizată, adresele rezolvate returnate vor fi cele introduse. Valorile non-adresă sunt eliminate.
• În cel de-al doilea pas, API-ul încearcă să standardizeze adresa normalizată prin găsirea unei adrese posibile sau reale care este probabil cea intenționată de utilizator. Dacă această standardizare eșuează, adresele rezolvate returnate vor fi forma normalizată a adresei introduse. Consultați elementele returnate pentru a determina problemele legate de adresa trimisă.
• Vor fi returnate, de asemenea, anumite elemente ale acestei adrese normalizate. Dacă standardizarea reușește, adresele rezolvate returnate vor fi cele din lumea reală. În acest caz, sunt returnate, de asemenea, diverse elemente suplimentare ale adresei standardizate și informații privind modul în care aceasta a fost derivată din adresa normalizată.

Valorile returnate de API-ul de validare a adreselor

Dacă adresa returnată include următoarele valori pentru atributele de mai jos, atunci adresa este validă:

• Starea adresei este Standardizată
• Atributele adresei rezolvate sunt Adevărat
• Punct de livrare valid (DPV) este Adevărat
• Adresă interpolată este Fals

Dacă acestea nu sunt enumerate, utilizați atributele suplimentare pentru a determina posibilele probleme legate de valorile adresei.

Pentru mai multe informații despre atributele adreselor, consultați Atributele adreselor.

Dacă mesajul de ieșire returnat clientului este INTERPOLATED.STREET.ADDRESS, atunci există posibilitatea ca adresa să nu fie validă. Pentru mai multe informații cu privire la codul mesajului pentru client, consultați descrierea elementului mesajului pentru client.

Urbanizare (numai în Puerto Rico): Acest descriptor, utilizat în mod obișnuit în zonele urbane din Puerto Rico, este o parte importantă a formatului adresei, deoarece descrie locația unei anumite străzi. În Puerto Rico, în cadrul aceluiași cod poștal se pot găsi nume de străzi și intervale de numere de adrese repetate. Aceste străzi pot avea aceleași intervale de numere de casă. În aceste cazuri, numele de urbanizare este necesar pentru a identifica corect locația unei anumite adrese.

Exemplu: Sr Pedro Rivera Urb Hermosillo 123 Calle 1 Bayamon, PR 00961-1212.

Adnotări

API-ul de validare a adreselor returnează adnotări cu fiecare adresă validată și returnată. Adnotările vă oferă informații cu privire la eventualele deficiențe și la modificările aduse adresei introduse pentru a ajunge la această adresă din lumea reală.

API-ul de validare a adreselor utilizează date de referință pentru a determina clasificarea unei anumite adrese. Clasificarea unei adrese funcționale se calculează independent de procesul de validare a adresei și se bazează pe feedbackul personalului operațional, iar sursele de date comerciale sunt utilizate doar pentru confirmare.

API-ul de validare a adreselor are doar patru clasificări posibile pentru adrese: necunoscută, comercială, rezidențială și mixtă. Toate adresele încep cu o clasificare „necunoscută” și rămân așa până când regulile comerciale de validare a adreselor stabilesc că clasificarea lor ar trebui să se schimbe. O locație primește o clasificare „mixtă” numai dacă este o adresă cu mai mulți chiriași și conține atât unități comerciale, cât și unități rezidențiale.

Notă: Serviciul FedEx Express furnizează o linie de adresă suplimentară (linia de adresă 3) pentru adresele destinatarilor. Aceste informații de adresă suplimentare furnizează detalii mai complete și mai precise despre locație, sporind șansele de obținere a unei adrese exacte.

Adresele din lumea reală sunt clasificate după cum urmează:

Adresă comercială

O adresă comercială este o adresă utilizată pentru a desemna sediul principal al afacerii dvs. Acesta este locul de unde se presupune că funcționează afacerea dvs., dar s-ar putea să nu fie întotdeauna așa.

O adresă comercială este locația oficială a sediului unei companii. Poate fi orice, de la adresa de domiciliu a unei persoane până la un campus de mai multe milioane de dolari, cum ar fi cel al marilor companii de tehnologie, și orice altceva între acestea.

Adresă de domiciliu

Se va aplica o taxă de livrare la domiciliu pentru expedierile efectuate în SUA către o locuință sau o reședință privată, inclusiv locațiile în care o afacere este operată de la domiciliu. Utilizați FedEx Home Delivery pentru livrare la domiciliu prin FedEx Ground în 1 zi lucrătoare, în funcție de distanța până la destinație.

Exemplu:

• Rectorat
• Mânăstire
• Casă parohială
• Rezidenți de locuințe cu mai multe unități de locuit, cum ar fi:
  • Clădiri de apartamente
  • Imobil în coproprietate
  • Cămine studențești

• O reședință în care se vând și/sau se distribuie produse

În continuare sunt prezentate câteva sfaturi utile pentru utilizarea API-ului de validare a adreselor:

• Utilizați spațiere corectă: Asigurați-vă că spațiile sunt plasate corect și evitați spațiile inutile.
• Folosiți ortografie corectă: Evitați orice greșeli ortografice și tipografice. De asemenea, asigurați-vă că folosiți corect cifra zero (0) și litera O.
• Evitați caractere speciale: Nu folosiți caractere speciale care nu sunt necesare pentru adresă, cum ar fi punctele după abrevieri (Bd vs. Bd.).
• Furnizați informații suplimentare privind adresa și strada: Furnizând informații suplimentare privind adresa, puteți crește acuratețea rezultatelor privind adresa.
  • Număr de clădire sau casă - 1, 1A, 1½, Unu
  • Nume de stradă - Principală, George Enescu, 42
  • Sufix de stradă - Calea, Bulevardul, Bd
• Introduceți orașul, statul/provincia și codul ZIP sau codul poștal: Dacă le furnizați pe toate trei, veți obține rezultate mai exacte.
• Introduceți strada și adresa, în ordine: Elementele de adresă stradală urmează, de obicei, un format care începe cu numărul clădirii sau al casei, urmat de un element pre-direcțional, numele străzii, tipul sau sufixul străzii, un element post-direcțional, denumirea apartamentului, numărul apartamentului și/sau denumirea și numărul cutiei poștale private.
• Folosiți abrevieri corecte: Serviciu Poștal al SUA și Canada Post au abrevieri standard pentru stat/provincie, sufixul străzii și denumirile apartamentelor sau unităților.
  • O abreviere non-standard poate cauza rezultate slabe la căutare.
  • Dacă nu sunteți sigur de o abreviere, nu o folosiți.
• Urbanizare - Un nume de urbanizare desemnează o zonă, un sector sau o dezvoltare rezidențială în cadrul unei zone geografice.

De exemplu:

• Număr de clădire sau casă: 1, 1A, Unu
• Nume de stradă: Principală, George Enescu, 42
• Sufix de stradă: Calea, Bulevardul, Bd
• Introduceți orașul, statul/provincia și codul ZIP sau codul poștal: Furnizarea tuturor informațiilor privind adresa va crește acuratețea rezultatelor. Porțiunea ZIP+4 a codului poștal nu este necesară pentru a verifica o adresă.
• Folosiți abrevieri corecte: Serviciu Poștal al SUA și autoritățile poștale din alte țări definesc abrevieri standard pentru stat/provincie, sufixul străzii și denumirile apartamentelor/unităților. O abreviere nestandard poate cauza rezultate slabe la căutare. Dacă nu sunteți sigur de o abreviere, nu o folosiți.
• Luați în considerare posibilitatea de a returna feedback-ul de răspuns la validarea adresei către utilizator pentru a-i oferi acestuia opțiunea de a alege cea mai corectă adresă pentru el.

• Nu utilizați acest API pentru a determina posibilitatea de livrare a coletelor la o adresă. FedEx nu oferă servicii de livrare la toate adresele valide. FedEx nu livrează la căsuțe poștale (decât prin FedEx Ground® Economy, cunoscut anterior ca FedEx SmartPost^®).
• Informațiile returnate adresa rezolvată sunt doar pentru utilizare sugerată.
• Pot fi verificate până la 100 de adrese într-o singură solicitare.
• Câmpurile obligatorii variază de la o țară la alta.

  De exemplu, pentru adresele din SUA, sunt necesare cel puțin o linie de adresă și fie un cod poștal, fie un oraș și un cod de stat, însă pentru adresele AUS (formatul de adresă pentru Australia), codul de stat poate fi omis chiar și fără un cod poștal.

• Rezultatul validării adresei variază în funcție de țară/teritoriu.

Notă: Este posibil ca API-ul de validare a adreselor să nu fie aplicabil pentru toate țările. Consultați secțiunea Țări/Teritorii care acceptă API-ul de validare a adreselor.