Adres Doğrulama API'si, hatalı iletişim bilgilerini çözmeye ve paketlerin hassas bir şekilde daha hızlı teslim edilmesini sağlayan akıllı bir çözümdür. Bu API geçerli bir adrese yakından benzeyen bir girdi alıcı adresi bilgilerini uygun şekilde biçimlendirir ve istenene benzer gerçek bir adresi geri döndürür.

API aynı zamanda girdi adresindeki yetersizlikler hakkında dipnotları veya gerçek adreslere ulaşmak için girdide yapılan değişiklikleri de sağlar. Bir paketi kargoya vermeden önce alıcı adres bilgilerini doğrulamak ve çözmek için bu API'yi kullanabilirsiniz.

Not: Bir adresin paket teslim edilebilirliğini belirlemek için bu API'yi kullanmayın. FedEx geçerli her adrese teslimat hizmeti sunmaz. FedEx Posta Kutularına teslimat yapmaz. FedEx Ground® Economy (eski adıyla FedEx SmartPost®) aracılığıyla olan teslimatlar hariç.

Bu API, bir paket göndermeden önce alıcı adres bilgilerini doğrulamanıza ve düzeltmenize izin verir. Kargo etiketindeki doğru adresler, teslimat gecikmelerinin ve ek adres düzeltme ücretlerinin (yanlış oluşturulmuş adresler nedeniyle) ortadan kaldırılmasına yardım eder.

Not:

• Adres çözüm sonucu ülkeye ve bölgeye göre değişiklik gösterebilir.
• Talepte girilen adres, FedEx veritabanındaki referans verilerle karşılaştırılır ve eşleşen adrese döndürülür.

Adres Doğrulama API'si İşlevleri

• Sokak seviyesi adres eşleşmelerini sağlar.
• Adres veri tabanında aylık güncellemeleri alır.
• Tam bir eşleşme bulunursa iş ve ikamet adresleri arasında ayrım yapar.
• Bina veya daire numaralarını şu anda doğrulamaz.

Adres Doğrulama API'si İşlevleri

• Eksik alıcı adreslerini tamamlar. Bazı durumlarda Adres Doğrulama API'si, sağlanan bilgilerin referans bilgilerle doğrulanmasına bağlı olarak eksik bilgileri ekleyebilecektir. Adres Doğrulama API'si, şu anda eksik ikincil bilgileri ekleyemez (bina veya daire).
• Adres veri tabanında aylık güncellemeleri alır.
• Geçersiz alıcı adreslerini düzeltir. Örneğin, girdinin geri kalanını onaylamak için hatalı bir posta kodunun düzeltmesi.
• Ön fiyat teklifinin doğruluğunu artırmak için adresin iş mi yoksa ev adresi mi olduğunu belirleyin. Sadece ABD ve Kanada adresleri için geçerlidir.
• Bu bölgelerdeki birçok ülkede adreslerin geçerliliğini ve bütünlüğünü onaylayın: ABD, Kanada, Latin Amerika, Avrupa, Orta Doğu ve Asya-Pasifik. Artık bir paket göndermeden önce yerel ve uluslararası adres bilgilerini doğrulayabilir ve gereksiz teslimat gecikmelerini ve ek hizmet bedellerini ortadan kaldırabilirsiniz.
• Sokak seviyesi eşleşmeleri sağlar.
• Bir API isteğinde en fazla 100 adres kontrol edilebilir.

Adres Doğrulama API'sini Destekleyen Ülkeler/Bölgeler

Etkili teslimatlar için alıcı adreslerini doğrulamak ve düzeltmek amacıyla aşağıdaki ülkelerde FedEx Adres Doğrulama API'sini kullanabilirsiniz.

Not: Adres İsteği Doğrulamasından geri dönen bilgiler sadece önerilen kullanım içindir.

Yasal Sorumluluk Reddi:: Burada sağlanan veriler, nezaketen sunulan FedEx'in tescilli ve gizli bilgileridir. Bu verilerin hiçbiri, FedEx'in yazılı izni olmaksızın hiçbir şekilde dağıtılamaz veya ifşa edilemez. FedEx teslimat adres veri tabanında bulunan mevcut FedEx adres seviyesi iş/ev sınıflandırmasını yansıtır ve değişikliğe uğrayabilir. FedEx bu bilgileri sağlarken bilgilerin bugünkü veya gelecekteki doğruluğunu garanti etmez ve bu adreslere gönderilen paketlerin burada belirtilen iş/ev sınıflandırmasına göre faturalandırılacağına dair garanti vermez. Bu bilgilerin verilmesi, taraflar arasındaki ilişkinin koşullarını değiştirdiği şeklinde yorumlanmayacaktır. FedEx kargo ve ücretlerine ilişkin koşullar ve şartlar için FedEx Hizmet Kılavuzu ve geçerli geçerli hesap fiyatlandırma sözleşmesine bakınız.

Adres Doğrulama

Girdi adreslerini doğrulamak ve çözümlemek ve gerçek adresleri almak için bu uç noktayı kullanın. Adres ayrıntıları bir adresi çözümlemek için sağlanır ve doğrulanır. Girdi adresi, bilinen referans veriyle eşleştiğinde bir adres "çözüldü" olarak belirtilir.

Bu istekle ilişkili gerekli girdi bilgileri aşağıdaki gibidir:

• Sokak Satırları
• Şehir (İsteğe bağlı)
• Eyalet veya Şehir Kodu (İsteğe bağlı)
• Posta Kodu (İsteğe bağlı)
• Ülke Kodu

Not: Müşteri posta kodu olmayan bir ülkeye gönderi yaparken eyalet kodu veya şehir adı yeterlidir.

Adres Doğrulama API'si, girdi adresinde aşağıdaki işlemleri yaparak gerçek bir adresi döndürür:

• İlk adım olarak API'si, girdi adresini normalleştirmeye çalışır. Bu, sokak ve bulvar gibi yaygın kara yolu tanımlayıcılarının SK ve BLV gibi standart kısaltmalarla değiştirilmesini ve adres bileşenlerinin yeniden sıralanmasını içerebilir. Bir girdi adresi normalleştirilemiyorsa döndürülen çözülen adresler girdi adresi olacaktır. Adres dışı değerler çıkarılır.
• İkinci adımda API, kullanıcının istediğine benzer olası veya gerçek bir adresi bularak normalleştirilen adresi standardize etmeye çalışır. Bu standardizasyon başarısız olursa döndürülen çözülen adresler, normalleştirilen girdi adresi biçimi olacaktır. Gönderilen adresle ilgili sorunları belirlemeye yardımcı olması için döndürülen ögelere başvurun.
• İlgili normalleştirilen adresin belirli ögeleri de geri döndürülür. Standardizasyon başarılı olursa döndürülen çözülmüş adresler gerçek adres olacaktır. Böyle bir durumda standardize edilen adresin farklı ilave ögeleri ve normalleştirilen adresten nasıl elde edildiğine ilişkin bilgi de geri döndürülür.

Adres Doğrulama API'si Döndürülen Değerleri

Döndürülen adres aşağıdaki özellikler için aşağıdaki değerleri içeriyorsa adres geçerlidir:

• Adres Eyaleti Standarttır
• Çözülen adresin özellikleri Doğrudur
• Teslimat Noktası Geçerli (DPV) Doğrudur
• Ara Değerli Adres Yanlıştır

Bunlar listelenmemişse adres değerleriyle ilgili olası sorunları belirlemek için ek özellikleri kullanın.

Adres Özellikleri hakkında daha fazla bilgi için bkz. Adres Özellikleri.

Döndürülen çıktı müşteri mesajı INTERPOLATED.STREET.ADDRESS ise adresin geçerli olmama ihtimali vardır. Müşteri mesaj kodu hakkında daha fazla bilgi için müşteri mesajının öge açıklamasına başvurun.

Dipnotlar

Adres Doğrulama API'si, doğrulanan ve döndürülen her adresi içeren dipnotları geri döndürür. Dipnotlar, gerçek adresi bulmak için varsa yetersizlikler ve girdi adreslerindeki değişiklikler hakkındaki bilgileri verir.

Adres Doğrulama API'si, belirli bir adresin sınıflandırmasını belirlemek için referans verileri kullanır. İşlevsel bir adresin sınıflandırması, doğrulama adresi sürecinden bağımsız şekilde hesaplanır ve sadece teyit amaçlı kullanılan ticari veri kaynaklarıyla birlikte operasyonel personelin geri bildirimine dayanır.

Adres Doğrulama API'si adresler için sadece dört olası sınıflandırmaya sahiptir: Bilinmeyen, iş, ev ve karma. Tüm adresler "bilinmeyen" sınıflandırması ile başlar ve adres doğrulama iş kuralları, sınıflandırmalarının değişmesi gerektiğini belirleyinceye kadar bu şekilde kalır. Bir konum ancak çok kullanıcı bazlı bir adresse ve hem iş hem de ev birimlerini içeriyorsa bir "karma" sınıflandırmasını alır.

Not: FedEx Express hizmeti alıcı adresleri için bir ek adres satırı (adres satırı 3) sağlar. Bu ek adres bilgisi daha eksiksiz ve doğru konum bilgilerini sağlayarak doğru adres alma şansınızı artırır.

Gerçek adresler aşağıdaki gibi sınıflandırılır:

İş Adresi

İş adresi, ana iş yerinizi tanımlamak için kullanılan adrestir. İşletmenizin faaliyet gösterdiği yerdir fakat her zaman böyle olmayabilir.

Bir iş adresi, şirketin resmi genel merkezidir. Bir kişinin ev adresinden büyük teknoloji şirketleri gibi milyon dolarlık kampüslere kadar her yer olabilir.

Konut Adresi

Ev teslimat ücreti, bir işletmenin evden faaliyet gösterdiği yerler dahil olmak üzere ev veya özel bir ikametgaha yapılan ABD içindeki gönderiler için geçerlidir. Hedefe olan mesafeye göre 1 iş günü içinde FedEx Ground vasıtasıyla yapılan eve teslimatlar için FedEx Eve Teslimat'ı kullanın.

Örnek:

• Papazlık Mekanı
• Manastır
• Papaz Evi
• Birden fazla üniteli konutların sakinleri; örneğin:
  • Apartmanlar
  • Kat mülkiyetleri
  • Üniversite yatakhaneleri

• Ürünlerin satıldığı ve/veya dağıtıldığı konut

Aşağıda Adres Doğrulama API'si kullanımıyla ilgili bazı yararlı ipuçları verilmiştir:

• Boşlukları doğru kullanın: Boşlukların doğru yerleştirildiğinden emin olun ve gereksiz boşluklardan kaçının.
• Doğru imla kullanın: Yazım ve baskı hatalarından kaçının. Ayrıca sıfır (0) sayısını ve O harfini doğru kullandığınızdan emin olun.
• Özel karakterlerden kaçının: Örneğin kısaltmalardan sonra nokta kullanımı gibi adres için gerekli olmayan özel karakterleri kullanmaktan kaçının (Blv ve Blv.).
• Ek adres ve Sokak Bilgisi belirtin: Ek adres bilgilerini belirterek adres sonuçlarının doğruluğunu artırabilirsiniz.
  • Bina veya Kapı numarası - 1, 1A, 1½, Bir
  • Sokak Adı - Güvercin, Atatürk, 42.
  • Sokak Eki - Sokak, Cadde, Sk, Cad
• Şehir, eyalet/il ve ZIP veya posta kodu girin: Tüm üç bilginin verilmesi, adres sonuçlarınızın doğruluğunu artırır.
• Sokak ve adres bilgisini sırayla girin: Sokak adresi bilgilerini genellikle bir ön yönlendirme bilgisi (sokak adı, sokak türü veya eki, yönlendirme sonrası bilgi, apartman tarifi, apartman numarası ve/veya özel posta kutusu bilgisi ve numarası) ve bina veya kapı numarası ile başlayan bir biçim takip eder.
• Doğru kısaltmaları kullanın: ABD Posta Servisi ve Kanada Postası, eyalet/şehir, sokak ek ve apartman veya birim tanımlamaları için standart kısaltmaları kullanır.
  • Standart olmayan bir kısaltma arama sonuçlarının yetersiz olmasına neden olabilir.
  • Emin olmadığınız bir kısaltma varsa kullanmayın.

Örnek:

• 1, 1A, Bir gibi bina veya kapı numarası.
• Güvercin, Atatürk, 42. sokak gibi sokak adı.
• Sokak, Cadde, Sk, Cad gibi sokak eki.
• Şehir, eyalet/il ve posta kodunu girin: Tüm adres bilgilerinin sağlanması sonuçlarınızın doğruluğunu artırır. Bir adresi kontrol etmek için posta kodunun ZIP+4 bölümü gerekli değildir.
• Doğru kısaltmaları kullanın: ABD Posta Servisi ve diğer ülkelerdeki posta kurumları, eyalet/il, sokak ek ve bina/birim tanımlamaları için standart kısaltmaları belirlemiştir. Standart olmayan bir kısaltma arama sonuçlarının yetersiz olmasına neden olabilir. Emin olmadığınız bir kısaltma varsa kullanmayın.
• Kullanıcıya en doğru adres biçimini seçme opsiyonunu sunmak için adres doğrulama yanıt geri bildirimini geri vermeyi düşünün.

• Bir adresin paket teslim edilebilirliğini belirlemek için bu API'yi kullanmayın. FedEx geçerli her adrese teslimat hizmeti sunmaz. FedEx Posta Kutularına teslimat yapmaz. (FedEx Ground® Economy (eski adıyla FedEx SmartPost^®) aracılığıyla olan teslimatlar hariç).
• Çözülen adresten geri döndürülen bilgiler sadece önerilen kullanım içindir.
• Bir istekte en fazla 100 adres kontrol edilebilir.
• Gereken minimum alanlar ülkeden ülkeye farklılık gösterir.

  Örneğin ABD'deki alıcılar için en az bir adres satırı ve bir posta kodu veya şehir ve eyalet kodu gereklidir. Fakat AUS (Avustralya adres biçimi) adresleri için eyalet kodu, posta kodu olmasa da çıkarılabilir.

• Adres çözüm sonucu ülkeye ve bölgeye göre değişiklik gösterebilir.

Not: Adres Doğrulama API'si tüm ülkeler için geçerli olmayabilir. Adres Doğrulama API'sini destekleyen Ülkeler/Bölgeler bölümüne başvurun.