FedEx Göndericisi
Ön gereksinim
FedEx Developer Portal'a giriş yapabilmek ve bir kuruluş oluşturabilmek için bir FedEx kullanıcı kimliğinizin olması gerekmektedir.
Ekibinizle iş birliği yapmak için şirketinizin organizasyonuna katılın. Şirketinizin bir organizasyonu yoksa bir tane oluşturabilirsiniz.
Mevcut bir organizasyona katılma
1. Davet isteyin
Organizasyonunuzun yöneticisinden size bir davetiye göndermesini rica edin. Kabul etmek için 24 saatiniz vardır. Davetiyenin süresi dolarsa yöneticiden yeniden göndermesini isteyin.
2. Daveti kabul edin
Mevcut kullanıcı kodunuzu ve şifrenizi kullanarak oturum açın. Kullanıcı kodunuz başka bir organizasyonla ilişkilendiriliyorsa yeni bir kimlik oluşturun.
Yeni bir organizasyon oluşturma
Bir organzasyon oluşturduğunuzda yönetici olursunuz. Yönetici olarak kullanıcıları organizasyona davet edebilir, projeleri ve kullanıcı rollerini atayabilir ve gönderim hesaplarını yönetebilirsiniz.
Kullanıcı rolleri hakkında daha fazla bilgi edinmek için Organizasyon Yönetimi İlkeleri sayfasını inceleyin.
1. FedEx Developer Portal'da oturum açın.
2. Menüden Projelerim öğesini ve ardından Organizasyon oluştur öğesini seçin.
3. Aşağıdaki bilgileri girin:
- FedEx ile gönderim yapan ve FedEx API'lerini kendi uygulamalarına entegre etmesi gereken bir şirkette çalışıyorum
- Şirket adınızı, şirket web sitenizi ve şirket adınız, departmanınız, bölümünüz veya bölgeniz gibi ekibinizin tanıyacağı bir organizasyon adı girin.
4. Oluştur'u seçin.
Daha sonra menüdeki "Organizasyonu Yönet"bölümünden bilgileri güncelleyebilir veya ekleyebilirsiniz.
Gönderi hesabı ekleme
1. Hesap ekle kutucuğunda Gönderi hesapları ekle 'yi seçin. FedEx hesabınız yoksa yeni bir hesap oluşturmak için Hesap oluştur seçeneğini belirleyin veya FedEx Desteği ile iletişime geçin.
2. + Hesap Ekle'yi seçin.
3. FedEx hesap numaranızı, hesap takma adınızı ve hesap kurulumu sırasında kullandığınız fatura adresini girin.
4. Son Kullanıcı Lisans Sözleşmesini kabul edin veya şirketinizde yetkili temsilciye iletin.
Faturalama hesabı ekleme
1. Faturalama Hesapları sekmesini seçin. Eğer bir FedEx fatura hesabınız yoksa yeni bir hesap açmak için Fatura hesabı aç seçeneğini kullanın veya FedEx Destek ile iletişime geçin.
2. Fatura Hesabı Ekle seçeneğini seçin. Faturalama hesaplarının Amerika Birleşik Devletleri merkezli olması gerekmektedir.
3. FedEx hesap numaranızı, hesap takma adınızı ve hesap kurulumu sırasında kullandığınız Amerika Birleşik Devletleri fatura adresinizi girin.
4. Son Kullanıcı Lisans Sözleşmesini okuyup kabul edin.
Yönetici olarak kullanıcıları davet etme
1. Menüden Organizasyonu Yönet seçeneğini ve ardından Kullanıcılar sekmesini seçin.
2. + Kullanıcı Ekle seçeneğini seçin.
3. Bir ülke veya bölge ve tercih ettiğiniz dili seçin, ardından bir kullanıcı rolü belirleyin: izleyici, katkıda bulunan veya yönetici.
4. (İsteğe bağlı) Kullanıcıyı bir projeye atayın. Kullanıcı atamalarını projenin Genel Bakış sayfasından istediğiniz zaman yapabilirsiniz.
5. Kullanıcıların e-posta adreslerini girin ve Davet Et düğmesine tıklayın. Her seferinde en fazla 20 kullanıcıyı davet edebilirsiniz; her kullanıcının e-posta adresinin virgülle ayrılması gerekir. Davetiyeler 24 saat sonra geçerliliğini yitirir.
Bir API projesi oluşturma
1. Menüden Projelerim sekmesini, ardından API'ler sekmesini seçin ve + API Projesi Oluştur öğesini seçin.
2. API ihtiyaçlarınızı onaylayın.
3. Projenize dahil etmek istediğiniz API'leri seçin.
4. Bir proje adı oluşturun ve test gönderi hesabı almak için göndermeyi planladığınız ülkeleri seçin. Avrupa içi yerel gönderiler için, her ülke için ayrı bir test hesabına ihtiyacınız vardır. Ülkeleri daha sonra ekleyip çıkarabilirsiniz.
5. Bildirim tercihlerinizi ayarlamak için Bildirimler altından Ayarlar sekmesini seçin.
6. Şartlar ve Koşulları okuyun ve kabul edin.
Gelişmiş Entegre Görünürlük Projesi Oluşturma
Ön gereksinimler
- Fiyatlandırmayı inceleyin: Parça numaralarının sayısına göre abonelerden aylık bir ücret tahsil edilir. Fiyatlandırma hakkında daha fazla bilgi edinmek için Fiyatlandırma Kılavuzu'na bakın.
- Hesapları ayarlayın: Gönderi Görünürlüğü Web kancası, ABD merkezli bir faturalama hesabı ve en az bir gönderi hesabı gerektirir; bu iki hesap türü birbirinden bağımsızdır. Organizasyonu Yönet sayfasında faturalama ve gönderim hesaplarını yalnızca yöneticiler ekleyebilir.
1. Geri bildirimleri almak için uygulamanızda veya platformunuzda bir hedef URL oluşturun. URL şu şartları taşımalıdır:
- HTTPS kullanmalıdır
- RFC1918 IP alanını, fedex.com ve alt alan adlarını ve localhost veya 127.0.0.1 gibi IP adreslerini hariç tutun.
2. Kimlik doğrulama için bir güvenlik belirteci oluşturun. Belirteç şu şartları taşımalıdır:
- 26 ila 100 karakter arasında olmalıdır, en az bir büyük harf, en az bir küçük harf ve en az bir rakam içermelidir.
3. Menüden Projelerim'i ve ardından Gelişmiş Entegre Görünürlük sekmesini seçin.
4. Gelişmiş Entegre Görünürlük Projesi Oluştur öğesini seçin.
5. Kullanıcı tipini seçin:
- FedEx Göndericisi: FedEx ile birlikte gönderim yapar ve FedEx API'lerini kendi uygulamalarına entegre etmesi gerekir
- FedEx Uyum Sağlayıcı: Sertifikalı bir FedEx Uyum Sağlayıcıdır.
- FedEx Sistem Entegratörü Sağlayıcısı: FedEx teknolojisini kullanan ve onaylı bir FedEx Sistem Entegratörü Sağlayıcısı olan bir yazılım çözümü satan veya sağlayan firmadır.
6. Abonelik türünü seçin. Etkinliklere hesap numaraları veya gönderi takip numaraları ile abone olabilirsiniz.
7. Faturalama hesabını onaylayın ve Teslimat Kanıtı, tahmini teslimat, takip etkinlikleri veya etkinlik bazlı filtreleme gibi istediğiniz özellikleri seçin.
8. Proje ayrıntılarını girin.
- Benzersiz ve kolay tanınabilir bir proje adı girin.
- Oluşturduğunuz varış yeri URL'yi ve güvenlik belirtecini girin.
- Gelişmiş Entegre Görünürlük güncellemeleri ve kesintileri hakkında bildirim almak için bir e-posta adresi ve tercih ettiğiniz dili girin.
9. FedEx Developer Portal Lisans Sözleşmesini ve Sipariş Formunu kabul edin ve Oluştur öğesini seçin.
Not: Seçmiş olduğunuz abonelik türüne bağlı olarak ek adımlar gerekebilir. Daha fazla bilgi için Web Kancası belgelerimizi inceleyebilirsiniz.
API entegrasyonunuzu doğrulamak ve uygulamanızın test verisini gönderip alabileceğini doğrulamak için bu adımları kullanın.
Test kimlik bilgilerini alma
1. Menüden Projelerim öğesini ve ardından Proje Adını seçin.
2. API anahtarları sekmesinde, Test Key altında test kimlik bilgilerinizi bulabilirsiniz.
3. Giriş yapın ve belgeler sayfasının üst kısmındaki JSON İndir şema düğmesini kullanarak JSON API koleksiyonunu indirin. Entegrasyonunuzun kullandığı uç noktalar için örnek istekleri inceleyin.
4. Her API işlemi için kullanılacak bir OAuth erişim belirteci talep edin.
Not: Bu belirteç bir saat süreyle geçerlidir ve uygulamanızı süresi dolmadan önce yenileyecek şekilde yapılandırabilirsiniz. Ayrıntılar için API Authorization belgelerine bakın.
5. Menüden API Kataloğu öğesini seçin, çalışmak istediğiniz API'yi seçin ve Belgeler öğesini seçin.
6. Menüden uç noktayı seçin.
7. Test kimlik bilgileriniz ve FedEx test URL'sini kullanarak örnek istekler gönderin ve yanıtların dokümantasyondaki örneklerle eşleştiğini doğrulayın. Ayrıntılar için Sandbox Sanallaştırma Kılavuzu'na bakın.
8. Örnek veri oluşturmak ve uygulamanızın takip bilgilerini doğru şekilde işlediğini doğrulamak için Gelişmiş Entegre Görünürlük ile testler gerçekleştirin.
Not: Test işlemi, geri çağırma URL'nizin kimliğini doğrulamaz. Ayrıntılar için Gelişmiş Entegre Görünürlük belgelerine bakın.
Projenizi üretime taşıma
Canlı yayına geçmeden önce üretim yapılandırmanızı ayarlayın. Proje yayına girdikten sonra anahtarı yeniden adlandırabilir, ek hesaplar ekleyebilir ve proje oluşturma sırasında seçilen hesap numarasını inceleyebilirsiniz. Bu hesap numarası projenizi üretime geçirir.
Not: Hesap numarasına dayalı Gelişmiş Entegre Görünürlük projeleri üretim ortamında etkinleştirme gerektirmez.
1. Menüden Projelerim öğesini ve ardından Proje Adını seçin.
2. Üretim anahtarı sekmesini seçin.
3. Üretim kimlik bilgilerinizi güvenli bir şekilde alın ve saklayın.
- Üretim API anahtarını ve gizli anahtarını güvenli bir yere kopyalayın.
- Bir üretim anahtarı talep ettiğinizde yalnızca bir kez görüneceği için güvenli bir yere kaydedin. Kaybederseniz daha sonra yenisini yeniden oluşturabilirsiniz.
4. Üretim anahtarı sekmesinde proje ayrıntılarınızı görüntülemek için İleri öğesini seçin.
Daha fazla gönderim hesabı eklemek için, gönderim hesapları tablosunun üst kısmındaki Düzenle seçeneğini belirleyin.
Doğrulama adımları bölgeye göre değişir
Aşağıdaki adımlar yalnızca ABD ve Kanada'daki müşteriler için geçerlidir. Bu ülkelerin dışında yaşıyorsanız destek bulmak için API Doğrulama sayfasını ziyaret edin.
API'nizi doğrulama
Bazı FedEx API'leri, üretim ortamında kullanılmadan önce gönderi etiketi doğrulamasını gerektirir. Başlamadan önce API doğrulama gereksinimlerini inceleyin.
1. Menüden Projelerim öğesini ve ardından Proje Adını seçin.
2. API anahtarları sekmesinde, Test Anahtarı bölümünde test kimlik bilgilerinizi bulabilirsiniz.
3. Testler tamamlandıktan sonra, doğrulama işlemine başlamak için projenizi FedEx Developer Portal'da üretim ortamına taşıyın.
- Bir üretim anahtarı talep ettiğinizde yalnızca bir kez görüneceği için güvenli bir yere kaydedin. Kaybederseniz daha sonra yenisini yeniden oluşturabilirsiniz.
4. Etiket Kapak Sayfasına iletişim bilgileri, uygulamayı planladığınız hizmetler, hesap numarası ve üretim API anahtarı dahil olmak üzere gerekli bilgileri girin.
5. FedEx test ortamında test etiketleri oluşturun, ardından inceleme için FedEx Barkod Analiz Grubuna gönderin. Etiket değerlendirmesi için üç iş günü süre tanıyın.
Gecikmeleri önlemek için en iyi uygulamalar:
- Etiketleri en az 600 DPI çözünürlükte yazdırmalı ve taramalısınız. API'lerden doğrudan oluşturulan dosyaları göndermemelisiniz.
- Termal yazıcılar için, yazıcınızla uyumlu görüntü türünü isteyin; örneğin, Zebra yazıcılar için ZPLII.
- Örnek etiketler için geçerli gönderici ve alıcı adresleri kullanın. Yalnızca kullanmayı planladığınız hizmetler için etiket oluşturun.
- FedEx teslimatta nakit ödeme (C.O.D.) için C.O.D. iade etiketini ekleyin.
- FedEx International Express® için, yardımcı (ikincil) hava yolu konşimentosu (AWB) dahil edilmelidir.
- Çok Parçalı Gönderilerde (MPS) her paket için ayrı bir etiket gönderin.
Lütfen aşağıdaki seçeneklerden birini kullanarak belgelerinizi gönderin:
- PDF ve etiket kapak sayfasının label@fedex.com'ye e-posta ile gönderimi.
- Fiziksel etiketlerin şu adrese postalanması:
FedEx Hizmetleri
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
Not: Fiziksel etiketler için, mürekkep çizgileri veya hasar gibi görünür kusurların olmadığından emin olun. Etiketleri yazdırırken büyütmeyin veya küçültmeyin.
6. FedEx Barkod Analiz Grubu, gönderinizi inceler ve etiketleri onaylar veya reddeder. Etiketler reddedilirse geri bildirimi ele alın ve tekrar gönderin.
7. Onaydan sonra, FedEx Barkod Analiz Grubu, gönderi etiketi işlemleri için üretim kimlik bilgilerinizin onaylanmasının ardından size bir e-posta gönderir.
Not:Onay, proje bazında geçerlidir. Her yeni proje onay gerektirir.
8. Test URL'lerini ve kimlik bilgilerini üretim URL'leriniz ve kimlik bilgilerinizle değiştirin.
9. Her şeyin beklendiği gibi çalıştığını doğrulamak için örnek verilerle son bir üretim testi gerçekleştirin.
