FedEx Sistem Entegratörü Sağlayıcısı
Ö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 kuruluşa 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 katılmaya davet edebilir, projeler ve kullanıcı rolleri atayabilir ve faturalama hesaplarını yönetebilirsiniz.
Kullanıcı rolleri hakkında daha fazla bilgi edinmek için Organizasyon Yönetimi İlkeleri sayfasını inceleyin.
1. Gezinme çubuğunda Organizasyon oluştur veya katıl seçeneğini seçin.
2. Lütfen aşağıdaki bilgileri girin:
- Çalıştığım şirket için FedEx teknolojisini kullanan bir yazılım çözümü satan veya sağlayan ve onaylı bir FedEx Sistem Entegratörü Sağlayıcısı olarak kaydolmak istiyorum seçeneğini seçin.
- Şirketinizin adını, web sitesini ve ekibinizin tanıyacağı bir kuruluş adını (örneğin şirket adınız, departmanınız, bölümünüz veya bölgeniz) girin.
- Şirketinizin alan adını, şirketinizin kurulduğu ülke veya bölgeyi ve yazılım çözümünüzü sattığınız veya dağıttığınız ülke ve bölgeleri içeren resmi bir e-posta adresi girin.
3. İleri'yi seçin.
Daha sonra menüdeki "Organizasyonu Yönet"bölümünden bilgileri güncelleyebilir veya ekleyebilirsiniz.
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 Faturalama hesabı aç seçeneğini kullanın veya FedEx Destek ile iletişime geçin</a>.
Not: Kendi hesap numaranızı kullanın; bir müşterinin FedEx hesap numarası olamaz.
2. Fatura Hesabı Ekle seçeneğini seçin.
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.
Not: Fatura adresi, hesap kurulumu sırasında kullandığınız adresle aynı olmalıdır. Bu hesap, organizasyonunuzun varsayılan faturalama hesabı olur.
4. Bir kimlik doğrulama seçeneği belirleyin.
- Telefon görüşmesi yalnızca Amerika Birleşik Devletleri ve Kanada'daki sistem entegratörleri için mümkündür.
5. Aldığınız doğrulama kodunu girin ve Gönder'i seçin.
6. FedEx sistem entegratörü Sözleşmesini okuyun ve kabul edin.
Yönetici olarak kullanıcıları davet etme
1. Organizasyonu Yönet bölümüne gidin ve Kullanıcılar sekmesini seçin.
2. + Kullanıcı Ekle seçeneğini seçin.
3. Aşağıdaki bilgileri girin:
- Ülke veya bölge
- Tercih edilen dil
4. Bir kullanıcı rolü seçin (Görüntüleyici, Katılımcı veya Yönetici).
5. (İsteğe bağlı) Kullanıcıyı bir projeye atayın.
- Kullanıcı atama işlemini projenin Genel Bakış sayfasından istediğiniz zaman gerçekleştirebilirsiniz.
6. Kullanıcıların e-posta adreslerini girin ve Davet Et seçeneğine 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. Davetiye 24 saat süresince geçerlidir.
Proje oluşturma
1. Menüden Projelerim bölümüne gidin ve + Proje Oluştur seçeneğini seçin.
2. Bir Proje Adı girin.
- Önerilen ad biçimi şu şekildedir: Projectname_applicationname. Proje adını girdikten sonra İleri'yi seçin.
3. Projenize dahil etmek istediğiniz API'leri ve Gelişmiş Entegre Görünürlük ürünlerini seçin.
- Gelişmiş Entegre Görünürlük ürünleri yalnızca ABD FedEx Sistem Entegratörü Sağlayıcıları için mevcuttur.
- Ücretli ürünlerden herhangi birini seçerseniz, projeye bir faturalama hesabı atamanız ve gerekli şartları kabul etmeniz istenecektir.
Bir faturalama hesabı atama
Not: Bu yalnızca ücretli bir ürün seçtiğiniz durumda gereklidir.
Organizasyona eklenen hesaplar listesinden bir faturalama hesabı atayın. Faturalama hesaplarının Amerika Birleşik Devletleri merkezli olması gerekmektedir.
2. FedEx Developer PortalLisans Sözleşmesini ve Sipariş Formunu kabul ediniz ve Oluştur seçeneğini seçin.
Bir projedeki Gelişmiş Entegre Görünürlüğü'nü yapılandırı
Ö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 için Sipariş Formu'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 alanlarını, fedex.com ve alt alan adlarını ve localhost veya 127.0.0.1 gibi IP adreslerini hariç tutmalıdır.
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çtiğiniz abonelik türüne bağlı olarak ek adımlar gerekebilir. Ayrıntılar için Web Kancası belgelerimize bakın.
API entegrasyonunuzu doğrulamak ve uygulamanızın test verisini gönderip alabileceğini doğrulamak için bu adımları kullanın.
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. 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 Yetkilendirme 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 izleme 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.
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'lerinizi üretim ortamına taşımak için doğrulanmaları gerekmektedir. Doğrulama düzeyi API'ye göre değişir. Başlamadan önce API doğrulama gereksinimlerini gözden geçirin.
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. Çözümünüzü uygulamayı planladığınız bölgeler veya alanlar için test senaryolarını belirleyiniz. Ayrıntılar için bkz. Sistem entegratörü test senaryosu taban çizgisi.
4. Test vakalarını çalıştırmadan önce verilen test hesap numaralarını kullanarak kayıt işlemlerinizi tamamlayın.
5. Tüm gerekli test vakalarını tamamlayın.
6. İletişim bilgileriniz ve tercih ettiğiniz FedEx hizmetleriyle ilgili bilgileri Ürün Bilgi Formu'na (PIW) girin.
7. Sistem Entegratörü Doğrulama Kapak Sayfasını doldurun.
Çıktıları Gönderme
Gerekli tüm materyalleri validationmtp@fedex.com adresine gönderin.
1. Aşağıdaki teslim edilecek belgeleri hazırlayın:
- Tamamlanmış PIW (PDF).
- Tamamlanmış Doğrulama Kapak Sayfası (PDF)
- Çok Faktörlü Kimlik Doğrulaması (JSON) ile son müşteri kayıt işlemleri
- Uygulanabilir tüm test durumları için taranmış gönderi etiketleri (PDF veya PNG)
- İşlemleri üç etiket biçimiyle gönderin: PDF, PNG ve ZPL (JSON) (geçerli Gönderi ve Derecelendirme API'leri için)
- Şunları gösteren ekran görüntüleri (PDF):
- FedEx hizmetlerini ve özel hizmetleri gösteren müşteriye yönelik çözüm
- Feragatname beyanı
- Son Kullanıcı Lisans Sözleşmesi (EULA)
- Son müşteri kayıt akışı
2. E-posta sağlayıcınızın kısıtlamalarından kaçınmak için tüm dosyaları tek bir .zip dosyasına sıkıştırın.
3. .zip dosyasını doğrulama ekibine e-posta ile gönderin.
Gecikmeleri önlemek için en iyi uygulamalar
İnceleme süresini kısaltmak için şu yönergeleri izleyin:
- 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.
- 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 bir etiket ekleyin.
Etiket değerlendirmesi
Doğrulama ekibi başvurunuzu inceler.
- Reddedilmesi durumunda, geri bildirimi dikkate alarak teslim edilecek belgeleri yeniden gönderin.
- Onaylandığı takdirde bir onay e-postası alırsınız. Onaylandıktan sonra üretim kimlik bilgileriniz gönderi etiketi işlemleri için yetkilendirilir.
1. Menüden Projelerim öğesini ve ardından Proje Adını seçin.
2. API'ler bölümünde, üretim API anahtarınızı ve gizli anahtarınızı kopyalayın ve güvenli bir şekilde saklayın.
Not: Gizli anahtarınızı güvenli bir yerde saklayın, çünkü yalnızca bir kez görünecektir. Kaybederseniz daha sonra yenisini oluşturabilirsiniz.
