FedEx entegrasyonu:
kendi sözleşmenizle, siparişten etikete.

FedEx entegrasyonu nedir ve Türkiye'den satan kimin işine yarar?

FedEx entegrasyonu, Federal Express Corporation'ın geliştiricilere açtığı API'ler üzerinden siparişi FedEx sisteminde gönderiye çeviren bağlantıdır. Ekspres taşımacılıkta her paket bir gümrük beyanına dayanır; alıcı adresi, ürün tanımı, menşe ülke, değer ve para birimi sipariş anında doğru girilmezse paket ya hiç oluşmaz ya da gümrükte bekler.

FedEx'in Türkiye'deki ağı da bu yüzden önemli. Forbes Türkiye'nin 5 Eylül 2025 tarihli haberine göre FedEx, İstanbul Havalimanı'nda 25.300 metrekarelik hava aktarma tesisinin resmî açılışını yaptı; tesis haftada 30 uçuşla Türkiye'yi 45 ülkeye bağlıyor.

Hangi satıcı profilinde FedEx bağlantısı anlamlı?

• Etsy'de el yapımı ya da tasarım ürün satan, siparişlerinin önemli kısmı ABD ve Avrupa'ya giden mağazalar.
• eBay ve Amazon'un yurt dışı mağazalarında siparişi depoya göndermeden kendisi kargolayan satıcılar.
• Kendi e-ticaret sitesinden yurt dışına satan ve hızlı teslimatı fiyatın parçası olarak sunan markalar.
• Numune ya da küçük partili ihracat yapan, gönderilerini mikro ihracat sınırları içinde tutan üreticiler.

Panelde elle yönetim ile Yox İş Ortağım arasındaki fark

Yox İş Ortağım'daki FedEx bağlantısı pilot aşamasında: kurulumu sizinle birlikte yapıyor, ilk gönderinizi birlikte doğruluyoruz. Panelin bu bağlantıda yaptığı işler aşağıdaki tabloda; tüm kargo ve kanal bağlantılarının listesi entegrasyon ana sayfasında.

FedEx Developer Portal'da API projesi açmak ve anahtarları almak

FedEx API'lerine erişim FedEx Developer Portal (developer.fedex.com) üzerinden verilir. Portalın SSS sayfasına göre API'ler, dokümantasyon ve örnek kodlar kullanım şartlarına bağlı olarak ücretsiz sunulur; ödediğiniz bedel gönderinin kendisidir ve FedEx sözleşmenize göre belirlenir. FedEx Shipper başlangıç rehberindeki sıra şöyledir:

1. fedex.com kullanıcı kimliğinizle portala girin; kimliğiniz yoksa Sign Up ile oluşturun.
2. Bir organizasyon kurun ya da şirketinizdeki yöneticinin davetini 24 saat içinde kabul edin; organizasyonu kuran kişi yönetici olur.
3. My Projects altında gönderi hesabınızı FedEx hesap numarası, bir takma ad ve hesap açılışında kullanılan fatura adresiyle ekleyin; her hesap için son kullanıcı lisans sözleşmesini onaylayın.
4. Create API Project ile proje açın; gönderi oluşturma ve takip API'lerini seçin, gönderi yapacağınız ülkeleri işaretleyin. Bu seçim test ortamında size atanacak deneme hesaplarını belirler.
5. Projenin API keys sekmesindeki Test Key ile deneme isteği gönderin; ardından Production key sekmesinden canlı API Key ve Secret Key'i alın.

Hesap numarası eklenirken kimlik doğrulaması

FedEx'in hesap kaydı dokümanında anlatılan düzende hesap numarası ile adresin FedEx kayıtlarıyla birebir eşleşmesi gerekir. Ardından son 90 gün içindeki bir faturanın numarası, tarihi, tutarı ve para birimiyle ya da hesaba kayıtlı telefona veya e-postaya gelen 6 haneli PIN ile doğrulama yapılabilir. Art arda başarısız denemeler o yöntemi 24 saat kilitler. Portala girmeden önce FedEx hesabınızdaki adresi kontrol edin.

Eski Web Services bilgileri yeni bağlantıda kullanılmaz

FedEx'in geliştirici duyurusuna göre eski FedEx Web Services altyapısı 1 Temmuz 2026'dan itibaren yalnız bakım desteğinde; yeni geliştirme ve destek FedEx API'lerine yönelik. Yıllar önce başka bir yazılım için alınmış bilgiler yerine Developer Portal'da açacağınız projenin OAuth anahtarlarını kullanın.

FedEx API'nin çalışma kuralları: belirteç süresi, istek kotası ve takip süresi

FedEx API, OAuth 2.0 ile korunur: bağlantı API Key ve Secret Key ile bir saat geçerli bir erişim belirteci alır, gönderi ve takip isteklerini bu belirteçle yapar. Aşağıdaki sınırların bir kısmı doğrudan sizin kararlarınızı etkiler.

Test ve canlı ortam ayrıdır. FedEx'in SSS'ine göre test sunucusu bazı alanlarda sabit değer döndürebilir; test ortamında üretilen etiket ve numara gerçek bir gönderi değildir. Başlangıç rehberindeki etiket doğrulama (Bar Code Analysis) adımı ise yalnız ABD ve Kanada'daki müşteriler için geçerlidir; Türkiye'den açılan projede bu adım beklenmez.

Etiket, adres ve ölçü: FedEx gönderisinin verisi nasıl hazırlanır?

Bir FedEx gönderisinin hatasız oluşması üç veriye bağlıdır: etiket biçimi, ASCII uyumlu adres ve doğru koli ölçüsü.

Etiket biçimi ve yazıcı seçimi

• Lazer ya da düz kâğıt yazıcı için PDF ve PNG biçimi; 4x6, 4x8, 4x9 inç etiket ya da Letter sayfanın üst veya alt yarısı.
• Termal etiket yazıcı için ZPLII (Zebra) ve EPL2 (Eltron) biçimi; 4x6 inç rulo.
• Çok parçalı gönderide her koliye ayrı etiket basılır; ana takip numarası bütün kolileri bağlar.

Türkçe karakterler etikete aktarılmaz

FedEx'in Ship API dokümanı, gönderi oluşturma isteğine ASCII dışı karakter gönderilmemesini ister; bu karakterler etikette ve FedEx sistemlerinde bozuk veri oluşturabilir. Yani ı, ğ, ş, ç, ö, ü harfleri gönderici ve alıcı bilgisinde Latin karşılığıyla yazılmalıdır: "Kadıköy" yerine "Kadikoy", "Gülşen Çelik" yerine "Gulsen Celik". Gönderici adresinizi FedEx hesabınızda da bu biçimde tutmanız tutarlılık sağlar.

Hacimsel ağırlık ve 5.000 böleni

FedEx Türkiye tarifesinde uluslararası gönderinin hacimsel ağırlığı uzunluk x genişlik x yükseklik (cm) / 5.000 ile bulunur; FedEx Regional Economy hizmetlerinde bölen 4.000'dir. Ücret, gerçek ağırlıkla hacimsel ağırlıktan büyük olan üzerinden alınır. FedEx'in örneğinde 36 x 25 x 16 cm'lik kutu 14.400 cm³ eder, 5.000'e bölününce 2,88 kg çıkar ve yukarı yuvarlanarak 3 kg sayılır. Yurt içi kargodaki desi alışkanlığıyla aynı böleni varsaymayın; koli seçimini desi hesaplama aracında 5.000 bölenle deneyin.

Ticari fatura ve mikro ihracat: FedEx gönderisi gümrükte nasıl ilerler?

FedEx'in Ship API dokümanına göre belge dışındaki bütün uluslararası gönderilerde ticari fatura gerekir. Faturada her kalem için Armonize Sistem kodu (Türkiye'de GTİP), üretildiği ülke, fiyat ve para birimi yer almalıdır. Faturada aksi belirtilmedikçe alıcı otomatik olarak ithalatçı (Importer of Record) sayılır; bu da vergiyi kimin ödeyeceği sorusunu doğrudan etkiler.

Elektronik Ticaret Belgeleri (ETD) ile kâğıtsız gönderi

FedEx'in ETD hizmetinde ticari fatura gönderiyle birlikte elektronik olarak iletilir; belge gönderiden önce ya da sonra yüklenebilir. FedEx, her ülkenin FedEx'in ürettiği belgeyi kabul etmediğini belirtir. Kabul etmeyen ülkelerde belgenin basılı kopyası paketle gitmelidir; sık gönderdiğiniz ülkeleri FedEx temsilcinizle bir kez netleştirin.

Basitleştirilmiş gümrük beyannamesinde 2026 sınırları

Hızlı kargoyla gönderilen ihracat eşyası belirli sınırlar içinde basitleştirilmiş gümrük beyannamesiyle (eski adıyla ETGB) beyan edilir. Ticaret Bakanlığı, 2022/9 sayılı Genelgede 6 Şubat 2026'dan geçerli değişiklik yaptı:

FedEx Türkiye'nin ihracatçılar sayfasına göre bu sınırlar içindeki bedelli gönderilerde beyanı vekaletname olmadan sizin adınıza yapabiliyor; sınırı aşan gönderiler yetkilendirdiğiniz gümrük müşaviri üzerinden yürüyor. İhracat faturasının türünü ve istisna kodunu mali müşavirinizle netleştirin.

Gümrük vergisini kim öder? ABD ve AB'ye FedEx gönderisinde 2026 kuralları

FedEx'in Ship API dokümanına göre vergi ve harçlar varsayılan olarak alıcıya faturalanır. Bu yüzden gönderiye alıcının e-posta adresi mutlaka eklenmelidir: FedEx alıcıya ulaşamazsa tahsilatı yapamaz ve bedel göndericiye yansıyabilir.

AB'deki sabit verginin kendi gönderinize nasıl uygulanacağı (ör. IOSS kaydınızın olup olmaması) satış modelinize bağlıdır; bunu FedEx ve mali müşavirinizle teyit edin. Gümrükte bekleme riskini azaltan alışkanlıklar şunlardır:

• Ürün tanımını malzeme ve kullanım amacıyla yazın: "gift" ya da "accessory" yerine "cotton women's t-shirt" gibi. FedEx'in ABD ithalatı duyurusu belirsiz ticari eşya açıklamalarının kabul edilmediğini belirtir.
• Faturadaki değer ile siparişteki satış tutarı aynı olsun; para birimini açıkça seçin.
• Vergiyi alıcının ödeyeceğini ürün sayfasında ve sipariş sonrası mesajda belirtin; teslim edilemeyen ve geri dönen gönderiler çoğu zaman bu bilgi eksikliğinden doğar.

Etsy, eBay ve Amazon siparişlerinde FedEx entegrasyonu nasıl çalışır?

Türkiye'den satan biri için FedEx, satış kanalının sunduğu bir anlaşmalı kargo değil, kendi hesabınızla kullandığınız bir taşıyıcıdır. Etsy'nin yardım sayfasına göre Etsy üzerinden FedEx etiketi almak yalnız ABD'de yerleşik ve Etsy Payments kullanan satıcılara açık. Etsy mağazanızın siparişini kendi FedEx hesabınızla gönderir, takip numarasını siparişe bildirirsiniz.

eBay ve Amazon siparişlerinde de akış aynıdır: gönderi FedEx'te açılır, takip numarası taşıyıcı adıyla birlikte siparişin geldiği kanala gider. Hangi taşıyıcıların kabul edildiği ve takip numarasının ne kadar sürede girilmesi gerektiği kanala ve pazara göre değişir; güncel kuralı satıcı panelinizden kontrol edin. Türkiye'deki pazaryerlerinin anlaşmalı kargo listesinde FedEx yer almaz.

Siparişten teslime FedEx gönderisinin panel akışı

1. Yurt dışı sipariş tek sipariş listesine düşer; alıcı adı ve adresi ASCII karşılığıyla kontrol edilir.
2. Ürün toplanır, koli tartılır ve ölçülür; hacimsel ağırlık 5.000 bölenle hesaplanır.
3. FedEx birincil kargo ise gönderi kaydı açılır, takip numarası siparişe yazılır ve etiket panelden basılır.
4. Ticari fatura ETD ile iletilir ya da varış ülkesi kabul etmiyorsa basılı kopya pakete eklenir.
5. Takip numarası ve kargo firması siparişin geldiği kanala gönderilir.
6. FedEx'ten gelen durumlar siparişe yansır; teslimle birlikte sipariş kapanır.

Etiketi koliyi FedEx'e teslim edeceğiniz gün basın. Etiket erken basılıp paket bekletilirse takip numarası kanala gitmiş ama gönderi hareket etmemiş olur ve alıcı günlerce aynı durumu görür.

Yox İş Ortağım paketleri: FedEx bağlantısı hangi planda açılır?

Kargo entegrasyonu Başlangıç paketinde yoktur; o pakette takip numarası elle girilir. FedEx, bağladığınız kargo firmalarından biri olarak sayılır ve Büyüme paketinden itibaren kullanılır. Panelde 80 satış kanalı (48'i kullanıma hazır), 57 kargo ve lojistik firması ve 51 muhasebe, e-Fatura ve ERP programı tanımlıdır.

Yıllık ödemede %20 indirim uygulanır. Yurt içi siparişlerinizi bir yurt içi kargo firmasıyla, yurt dışı siparişlerinizi FedEx ile göndermek istiyorsanız en az iki kargo firması bağlayan Profesyonel paket gerekir. Paketlerin ayrıntısı paketler bölümünde.

Başlamadan önce kısa bir ön görüşme yapıyoruz; 3 günlük ücretsiz denemede FedEx bağlantısını kendi siparişlerinizle kuruyor, ilk gönderiyi birlikte doğruluyoruz. Bunun için Yox İş Ortağım'a başvurun.

FedEx bağlantısını canlıya almadan önce kontrol listesi ve sık hatalar

Canlıya geçiş kontrol listesi

• Panele test anahtarı değil, Production key sekmesindeki canlı API Key ve Secret Key girildi mi?
• Girilen hesap numarası Developer Portal'daki projeye bağlı hesapla aynı mı?
• Gönderici adresi FedEx hesabınızdaki adresle ve ASCII yazımıyla birebir uyuşuyor mu?
• Ürün kartlarında İngilizce tanım, menşe ülke ve 12'li GTİP hazır mı?
• Etiket yazıcınız seçtiğiniz biçimle (PDF, PNG ya da ZPLII) uyumlu mu?
• İlk gönderide takip numarasının kanala ulaştığı ve alıcının bilgilendirildiği kontrol edildi mi?

FedEx gönderilerinde sık yapılan hatalar

• Test ortamında denenen bağlantıyı canlıya alırken test anahtarlarını panelde bırakmak.
• Secret Key'i portalda yeniledikten sonra paneli güncellememek; bu durumda gönderi kaydı açılmaz.
• Adreste Türkçe karakter bırakmak ve etikette okunamayan isimlerle karşılaşmak.
• Hacimsel ağırlığı yurt içi alışkanlıkla hesaplayıp FedEx faturasında farkla karşılaşmak.
• Aynı gün aynı alıcıya giden gönderilerin değerlerinin toplandığını unutup mikro ihracat sınırını aşmak.

Hangi ekspres firmanın size uyduğunu karşılaştırmak isterseniz UPS entegrasyonu ve DHL Express entegrasyonu sayfalarına da bakabilirsiniz. Kurulum sırasında takıldığınız bir adım olursa bize ulaşın; ilk gönderiyi birlikte doğrulamak pilot sürecin bir parçasıdır.