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

Shippo entegrasyonu nedir, Yox İş Ortağım ile birlikte ne yapar?

Shippo entegrasyonu, siparişin gönderi kaydını Shippo'nun API'si üzerinden açıp etiketi ve takip numarasını siparişe geri yazan bağlantıdır. Shippo kendi başına bir kargo firması değildir; USPS, UPS, FedEx ve DHL Express gibi taşıyıcılara tek hesap ve tek API ile ulaşmanızı sağlayan aracı bir gönderi platformudur. Şirketin kendi tanıtım sayfasına göre Shippo 2013'te Laura Behrens Wu ve Simon Kreuz tarafından kuruldu ve ekibini dünyanın farklı yerlerinden uzaktan çalışan bir yapıyla yürütüyor.

Panelin Shippo hesabınızla yaptığı dört iş

• Pazaryerinden ya da sitenizden gelen sipariş hazır olduğunda Shippo'da gönderi kaydı açılır, takip numarası siparişe yazılır.
• Shippo etiketi döndürdüğünde barkodlu etiket panelden basılır.
• Gönderinin durumu Shippo'dan sorgulanır ve siparişe kargoya verildi, yolda, teslim edildi gibi yansır.
• Takip numarası ve taşıyıcı adı siparişin geldiği kanala iletilir; kanalın kendi kargo kuralları geçerlidir.

Yox İş Ortağım bir kargo firması değildir: kargo bedeli almaz, anlaşmalı tarife vermez. Etiket ücreti sizinle Shippo ya da Shippo'ya eklediğiniz taşıyıcı hesabı arasındadır. Bağlantı, Shippo'nun geliştiricilere sunduğu herkese açık API üzerinden hazırlanmıştır. Shippo bağlantısı pilot aşamasındadır; kurulumu sizinle birlikte yapıyor, ilk gönderinizi birlikte doğruluyoruz. Panelde tanımlı 80 satış kanalını, 57 kargo ve lojistik firmasını ve 51 muhasebe programını entegrasyon ana sayfasında görebilirsiniz.

Shippo hangi ülkelerden gönderim yapar? Türkiye çıkışındaki sınır

Shippo'nun taşıyıcı yetenekleri dokümanı desteklenen firmaları paketin çıktığı ülkeye göre gruplar ve Ekim 2026 itibarıyla bu listede Türkiye bulunmaz. Aşağıdaki tablo dokümandaki çıkış ülkelerini ve hesap notlarını özetler.

DHL Express, FedEx ve UPS'in küresel görünmesi ne anlama gelir?

Dokümanda bu üç firmanın hizmet bölgesi Global olarak yazılır, fakat çıkış ülkesi ayrıca belirtilmez. DHL Express için Shippo'nun indirimli hesabı yalnız ABD'den çıkan uluslararası gönderilere uygulanır; başka bir ülkede kendi DHL Express hesabınızı kullanmak için hesap temsilcinizin hesabınızı Shippo kullanımı için izin listesine alması gerekir. Türkiye'den çıkan bir paketin Shippo üzerinden etiketlenebildiğini gösteren resmî bir kaynağa ulaşamadık; Shippo destek merkezindeki ülke makaleleri herkese açık erişimde açılmadı. İstanbul'daki deponuzdan yurt dışına gönderiyorsanız taşıyıcıya doğrudan bağlanmak daha net bir yoldur; UPS entegrasyonu bu akışı kendi sözleşmenizle kurar.

Shippo ücretleri: uygulama planları ve API tarifesi (Ekim 2026)

Shippo kullanmanın maliyeti üç kalemden oluşur: etiketin taşıma bedeli, Shippo'nun plan ya da etiket başı ücreti ve etikete bağlı olmayan API çağrılarının ücreti. Shippo'nun iki fiyat sayfası Ekim 2026'da şu rakamları gösteriyor (ABD doları):

Uygulama fiyat sayfası, Shippo etiketine bağlı olmayan takip, fiyat sorgusu ve adres doğrulama çağrılarının API Starter tarifesinden ayrıca faturalandığını belirtir. Ödeme kredi ya da banka kartıyla, ABD bankaları için ACH ile alınır. Rakamlar değişebilir; hesabınıza hangi tarifenin uygulandığını Shippo'daki faturalama ekranından kontrol edin.

Shippo'nun taşıyıcı hesabı mı, kendi taşıyıcı hesabınız mı?

Shippo API token nasıl oluşturulur, test modunda nasıl denenir?

Panelin Shippo için istediği temel bilgi, Shippo hesabınızda ürettiğiniz API token'dır; Shippo bu anahtarı istek başlığında ShippoToken önekiyle kabul eder, Shippo giriş parolanız hiçbir aşamada istenmez. Anahtarlar test ve canlı olmak üzere iki moda ayrılır.

1. Shippo hesabınızla API portalına giriş yapın.
2. API Configuration menüsünü açıp Developer keys bölümüne geçin.
3. Create new test key ile bir deneme anahtarı oluşturun; bu anahtar shippo_test_ önekiyle başlar.
4. Anahtarı oluşturduğunuz anda güvenli bir yere kaydedin; Shippo tam anahtarı yalnız bir kez gösterir, kaybolursa yenisini üretmeniz gerekir.
5. Deneme akışı doğrulandıktan sonra Create new live key ile shippo_live_ önekli canlı anahtarı oluşturup panele bunu girin.

Test modunda neler farklıdır?

• Test anahtarıyla Shippo servisleri ücret alınmadan kullanılır; dönen fiyatlar canlı fiyatlardan farklı olabilir.
• Test ve canlı hesabın verileri paylaşılmaz; test modunda açılan gönderi canlı modda görünmez.
• Takip akışını denemek için taşıyıcı değeri shippo ile SHIPPO_TRANSIT, SHIPPO_DELIVERED, SHIPPO_RETURNED gibi örnek takip numaraları kullanılır.
• Silinmiş ya da süresi dolmuş bir anahtarla yapılan isteğe Shippo 401 Unauthorized yanıtı verir.

Shippo entegrasyonu kurulumu: panel alanları ve ilk gönderinin doğrulanması

Panelin Kargo bölümünde Shippo bağlantısı için yalnız API token zorunludur; gönderici bilgileri ve takip için taşıyıcı kodu isteğe bağlı alanlardır. Alanları doldurduktan sonra Bağlantıyı test et ile anahtarın geçerliliği doğrulanır.

Pilot kurulumda izlediğimiz sıra

1. Kısa ön görüşmede siparişlerinizin hangi depodan çıktığını ve hangi kanallardan geldiğini konuşuyoruz.
2. Test anahtarını panele girip bağlantıyı test ediyor, deneme siparişinde gönderi kaydının açıldığını görüyoruz.
3. Birden çok kargo hesabınız varsa siparişlerin hangi hesapla gideceğini birincil kargo olarak siz seçiyorsunuz.
4. Canlı anahtara geçip ilk gerçek siparişte etiketi, takip numarasını ve numaranın kanala ulaştığını birlikte kontrol ediyoruz.

Gönderici adresini boş bırakmak yerine ABD'deki depo adresini girmeniz, fiyatın ve etiketin doğru çıkış noktasına göre oluşmasını kolaylaştırır. Kurulumun herhangi bir adımında takılırsanız bize ulaşın; pilot süreçte ilk gönderiyi sizinle birlikte izliyoruz.

Shippo'ya giden gönderi verisi: ölçü birimi, etiket biçimi ve gümrük beyanı

Shippo'da etiket üç adımlı bir zincirle oluşur: gönderici, alıcı ve koli bilgisiyle açılan gönderi (shipment), bu gönderiye dönen fiyat seçenekleri (rate) ve seçilen fiyatın satın alındığı işlem (transaction). Verinin bu zincirde doğru gitmesi, etiketin hatasız oluşmasının ön koşuludur.

Koli ölçüsü ve ağırlık birimleri

Shippo koli için uzunluk, genişlik, yükseklik ve ağırlığı birimiyle birlikte zorunlu tutar. Uzunlukta cm, in, ft, m, mm ve yd, ağırlıkta g, kg, lb ve oz kabul edilir; yani ölçüleri inç ve libreye çevirmek zorunda değilsiniz, ama birimin doğru yazılması şarttır. Kilogramı libre olarak göndermek fiyatı da etiketi de bozar. Koli hacmini önceden görmek için desi hesaplama aracını kullanabilirsiniz; ücretlendirmede taşıyıcının kendi hacim kuralı geçerlidir.

Desteklenen etiket biçimleri

Biçim istekte belirtilmezse Shippo hesabındaki Settings > Labels altında seçili varsayılan kullanılır; her taşıyıcı her boyutu desteklemez.

ABD dışına giden pakette gümrük beyanı

Uluslararası gönderide Shippo bir gümrük beyanı ister; taşıyıcıların çoğu certify, certify_signer, contents_type, eel_pfc ve incoterm alanlarını zorunlu tutar. Ürün kalemlerinin (tanım, adet, net ağırlık, değer, menşe ülke) eklenmesi her taşıyıcıda zorunlu olmasa da gümrükte bekleme riskini belirgin biçimde azaltır. Gönderici ve alıcının telefon numarası zorunludur; ticari fatura Shippo tarafından otomatik oluşturulur.

Shippo takip durumları siparişe nasıl yansır, etiket nasıl iade edilir?

Shippo her gönderiyi altı ana durumdan biriyle raporlar ve panel bu durumları siparişe kargoya verildi, yolda, teslim edildi olarak yansıtır. Ana durumların yanında Shippo, out_for_delivery ya da delivery_attempted gibi alt durumlar da döndürür.

• PRE_TRANSIT: etiket oluştu, paket taşıyıcıya teslim edilmeyi bekliyor.
• TRANSIT: paket yolda; adres sorunu, gecikme, teslim denemesi gibi alt durumlar bu başlık altında gelir.
• DELIVERED: paket alıcıya teslim edildi.
• RETURNED: paket göndericiye dönüyor ya da alıcı teslim almadı.
• FAILURE: paket teslim edilemez, kayıp ya da imha edildi olarak bildirildi.
• UNKNOWN: taşıyıcının sisteminde kayıt bulunamadı.

Shippo dokümanı address_issue, delivery_attempted, pickup_available ve package_lost gibi alt durumları gönderici ya da alıcının harekete geçmesi gereken durumlar olarak işaretler. Shippo üzerinden satın alınan etiketlerin takip olayları kendiliğinden bildirilir; Shippo dışında oluşturulmuş bir numarayı izletmek ise numara başına ücretlidir.

Kullanılmayan etiketin ücret iadesi

Siparişi iptal ettiyseniz ve etiket taşıyıcıda taranmadıysa iade talebini Shippo hesabınızdan yapabilirsiniz. Shippo'nun faturalama dokümanına göre talep satın alma tarihinden itibaren 90 gün içinde verilmeli; talepler 14 iş günü içinde sonuçlanır. Etiket bedeli, varsa sigorta ve Shippo etiket ücreti iade edilir, tutar bir sonraki faturada eksi kalem olarak görünür. Kullanılmış ya da taranmış etiketin iadesi reddedilir.

Etsy, eBay, Amazon ve Walmart siparişlerinde Shippo entegrasyonu

Shippo'nun entegrasyon sayfası pazaryeri olarak TikTok, Walmart, eBay, Etsy ve Amazon'u, site altyapısı olarak Shopify, Square, WooCommerce, Wix, BigCommerce, Magento 2, Squarespace ve Webflow'u listeler. Bu bağlantılar satıcının kendi Shippo hesabıyla kurulur; hiçbiri pazaryerinin anlaşmalı kargo programı değildir. Yox İş Ortağım üzerinden gelen siparişler ise tek sipariş listesinde toplanır ve Shippo'ya panelden gider.

• Aynı mağazayı hem Shippo'ya doğrudan hem panele bağlarsanız sipariş iki yerde görünür; iki ayrı etiket satın alınırsa iki kez ücret ödersiniz.
• Takip numarası kanala tek kaynaktan gitmelidir; iki sistem aynı siparişe farklı numara yazarsa alıcı yanlış hareket görür.
• Kanalın kendi gönderdiğiniz siparişlerde hangi taşıyıcıyı ve takip numarasını kabul ettiği pazaryerinin kuralına bağlıdır; bunu satıcı panelinizden teyit edin.

ABD'deki stoktan Etsy siparişi gönderen satıcılar için kanal tarafındaki sipariş ve ilan kurallarını Etsy entegrasyonu sayfasında ayrıca anlattık. Türkiye'deki pazaryerleriniz de panele bağlıysa ABD siparişleriyle aynı listede görünür; farklı depo için ayrı ekran açmanız gerekmez.

Yox İş Ortağım paketleri: Shippo bağlantısı hangi planda kullanılır?

Kargo entegrasyonu Başlangıç paketinde bulunmaz; o pakette takip numarası elle girilir. Shippo, bağladığınız kargo firmalarından biri sayılır ve Büyüme paketinden itibaren kullanılabilir.

Yıllık ödemede %20 indirim uygulanır. Türkiye'deki siparişleri yerli bir kargo firmasıyla, ABD siparişlerini Shippo ile gönderecekseniz en az iki kargo bağlantısı olan Profesyonel paket gerekir. Stoğunuz birden çok depoda duruyorsa depo yönetiminin (WMS, 5 depo) Kurumsal paketle geldiğini hesaba katın. Bütün limitler paketler bölümünde yer alır; Shippo'nun kendi plan ve etiket ücretleri bunlardan ayrıdır.

Başlamadan önce kısa bir ön görüşme yapıyoruz; 3 günlük ücretsiz denemede Shippo'yu test anahtarıyla kendi siparişlerinizde deneyebilirsiniz. Bunun için Yox İş Ortağım'a başvurun.

Canlıya almadan önce kontrol listesi ve Shippo bağlantısında sık hatalar

Canlıya geçiş kontrol listesi

• Panelde shippo_live_ önekli canlı anahtar mı duruyor, yoksa deneme anahtarı mı?
• Kullanacağınız taşıyıcılar Shippo hesabınızda etkin mi; UPS için koşullar Carriers ayarlarında onaylandı mı?
• Gönderici adresi paketin gerçekten çıktığı depo adresiyle aynı mı?
• Uluslararası gönderide alıcı ve gönderici telefonu ile ürün kalemlerinin menşe ülkesi siparişte var mı?
• Etiket yazıcınız Shippo'da seçili varsayılan biçimle uyumlu mu?
• İlk gerçek siparişte takip numarasının kanala ulaştığını gördünüz mü?

Shippo kullanan satıcıların sık yaptığı hatalar

• Türkiye'deki depodan çıkan paketi Shippo ile göndermeye çalışıp çıkış ülkesi kapsamını sonradan fark etmek.
• İptal edilen siparişin etiketini 90 günlük süre içinde iade etmeyi unutmak.
• Ağırlık birimini yanlış seçip fiyatı ve etiketi hatalı oluşturmak.
• Shippo'nun API'ye dakikada istek sınırı koyduğunu bilmeden yoğun dönemde toplu gönderi açmaya çalışmak; sınır aşılınca 429 hatası döner.

Aynı türdeki diğer platformları karşılaştırmak isterseniz Easyship entegrasyonu ve ShipStation entegrasyonu sayfalarına da bakabilirsiniz. Hangisini seçerseniz seçin ilk gönderiyi birlikte doğrulamak pilot sürecin parçasıdır.