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

ShipStation entegrasyonu nedir, hangi satıcı için mantıklıdır?

ShipStation entegrasyonu, siparişi Yox İş Ortağım'da tutup gönderiyi ShipStation'da açtırmak demektir: stok ve sipariş panelde, etiket ve taşıyıcı seçimi ShipStation'da kalır. ShipStation, ABD'li Auctane Inc. çatısı altında çalışan web tabanlı bir gönderi yazılımıdır. Kendi ana sayfasında 400'ü aşkın entegrasyondan, bunların içinde 200'den fazla paket taşıyıcısından ve 50'den fazla parsiyel yük (LTL) taşıyıcısından söz eder. Yani ShipStation'a bağlanmak, tek tek kargo firmalarına bağlanmak yerine onların önündeki bir ara katmana bağlanmaktır.

Üç katman: ShipStation hesabı, mağazalar ve taşıyıcılar

ShipStation'ı doğru kurmanın yolu, içindeki üç katmanı ayrı ayrı düşünmekten geçer. Birinci katman hesabın kendisidir: planınız, kullanıcılarınız, gönderici adresleriniz. İkinci katman siparişin ShipStation'a nereden girdiğini belirleyen mağaza (store) bağlantılarıdır. Üçüncü katman etiketi gerçekten basan taşıyıcı hesaplarıdır; ShipStation, kendi taşıyıcı hesabınızı getirmenize, ShipStation üzerinden sunulan tarifeleri kullanmanıza ya da ikisini birlikte kullanmanıza izin verir. Yox İş Ortağım bu yapının ikinci katmanında durur: siparişi ShipStation'a ileten ve sonucunu geri alan taraftır.

Türkiye'den satan biri için gerçekçi senaryolar

• Ürünlerini toplu olarak ABD'deki bir depoya gönderen ve Amazon siparişlerini satıcı gönderimiyle oradan çıkaran marka
• İngiltere ya da Kanada'da stok tutup Etsy, eBay veya kendi Shopify mağazasından satan üretici
• Depo hizmeti aldığı lojistik ortağı zaten ShipStation kullanan ve siparişlerin oraya düşmesini isteyen satıcı
• Türkiye'deki kanallarını panelden yönetirken yurt dışındaki stoğunu da aynı stok kartından izlemek isteyen işletme

Koli İstanbul'dan çıkıyorsa ShipStation çoğu durumda yanlış araçtır; bunun nedenini bir sonraki bölümde anlatıyoruz.

ShipStation hangi ülkelerde ve hangi taşıyıcılarla çalışır?

ShipStation'ın sitesindeki bölge seçicide yalnız dört pazar vardır: Amerika Birleşik Devletleri, Birleşik Krallık, Kanada ve Avustralya. Entegrasyon listesindeki ülke süzgecinde bunlara ek olarak Fransa, Almanya, İtalya, Meksika, Yeni Zelanda, İspanya ve Hollanda da yer alır; bu süzgeç, ilgili ülkeye özel entegrasyonları (taşıyıcı ya da satış kanalı) göstermek için kullanılır. Ekim 2026 itibarıyla Türkiye ne bölge seçicide ne de ülke süzgecinde bulunuyor.

Resmî listede adı geçen taşıyıcılar ve satış kanalları

ShipStation'ın entegrasyon sayfası taşıyıcı olarak USPS, UPS, FedEx, GlobalPost, DHL, Canada Post, Royal Mail, Australia Post, Amazon, DPD, Evri, Yodel, Purolator ve Canpar adlarını sayar. Satış kanalı tarafında Amazon, eBay, Etsy, Walmart, TikTok Shop, Shein, Temu ve Alibaba pazaryerleri ile Shopify, WooCommerce, BigCommerce, Squarespace, Wix, Big Cartel ve Adobe Commerce gibi site altyapıları listelenir. Listede Türk kargo firması ya da Türk pazaryeri yoktur.

İstanbul'daki depodan çıkan koli için daha uygun yol

Türkiye'den doğrudan yurt dışındaki alıcıya gönderiyorsanız etiketi, koliyi Türkiye'den teslim alan uluslararası firmanın kendi servisiyle basmak daha az katmanlıdır. Bu durumda UPS entegrasyonu gibi doğrudan bağlantılar ya da çok taşıyıcılı başka bir platform olan Shippo entegrasyonu sayfasındaki seçenekler değerlendirilmeli. ShipStation'ın gücü, koli hedef ülkede yola çıktığında ortaya çıkar.

ShipStation planları: API erişimi hangi planda var?

ShipStation entegrasyonu için gereken API erişimi Starter planda yoktur; Standard ve Premium planlarda vardır. Bu bilgi hem ABD hem İngiltere fiyat sayfalarındaki karşılaştırma tablosunda aynı biçimde yer alır. Fiyatlar aylık gönderi sayısına göre kademelenir ve ABD dolarıyla gösterilir; yıllık ödemede %20 tasarruf belirtilir. Aşağıdaki tablo, Ekim 2026'da ABD fiyat sayfasında gördüğümüz başlangıç kademesini (aylık 50 gönderi) ve entegrasyonu ilgilendiren satırları özetler.

Deneme süresinde bağlantıyı denemek

Fiyat sayfası 30 günlük, kredi kartı istemeyen ücretsiz deneme sunar. Deneme hesabının API'ye açık olup olmadığını en kesin biçimde hesabınızdaki API Settings sayfası gösterir; ShipStation'ın geliştirici dokümanı da planın API desteğini bu sayfadan kontrol etmenizi söyler. Fiyatlar ve kademeler değişebildiği için karar vermeden önce kendi bölge sayfanızdaki güncel tabloya bakın.

ShipStation API V1 ve V2: anahtarlar, adresler ve istek sınırları

ShipStation'ın iki API sürümü vardır ve Yox İş Ortağım bağlantısı API Key ile API Secret çiftini, yani V1 kimlik bilgilerini ister. Geliştirici dokümanı V1'i eski (legacy) sürüm olarak adlandırır, ancak mevcut entegrasyonlar için desteklendiğini ve bakımının sürdüğünü belirtir; bir sonlandırma tarihi vermez. V2 ise Standard ve Premium planlarda sunulan, tek anahtarla çalışan yeni sürümdür.

API Key ve API Secret nereden alınır?

V1 dokümanına göre anahtar çifti ShipStation'da Settings altındaki API Settings sayfasındadır (ss.shipstation.com/#/settings/api). V2 anahtarı da aynı sayfadan üretilir ve dokümana göre yalnız üretildiği anda bir kez gösterilir. Anahtarları e-posta ya da mesajla kimseye göndermeyin; pilot kurulumda bile panele kendi ekranınızdan girmenizi öneririz.

Dakikada 40 istek pratikte ne demek?

Sınır anahtar çifti başınadır. Aynı API Key ve Secret'ı hem Yox İş Ortağım'da hem bir muhasebe aracında hem de depo ortağınızın yazılımında kullanırsanız 40 isteği bu uygulamaların hepsi paylaşır. Kampanya günlerinde 429 hatası görmemek için ShipStation'a bağlı uygulamaların listesini çıkarın ve gereksiz olanları kapatın. Pasifik saati kuralı da önemlidir: İstanbul'da gece yarısını geçen bir gönderi, ShipStation kayıtlarında bir önceki günün tarihiyle görünebilir.

Yox İş Ortağım'da ShipStation entegrasyonu nasıl kurulur?

Yox İş Ortağım, ShipStation'ın kullanıcılarına sunduğu entegrasyon servisi üzerinden, sizin ShipStation hesabınızla bağlanır. Yox kargo firması değildir, kargo bedeli almaz, ShipStation planınızın ya da taşıyıcı tarifelerinizin yerine geçmez. ShipStation bağlantısı pilot aşamasındadır: kurulumu sizinle birlikte yapıyor, ilk gönderinizi birlikte doğruluyoruz.

1. ShipStation'da API erişimi olan bir plana geçin ve API Settings sayfasından API Key ile API Secret'ı alın.
2. Yox İş Ortağım'da Kargo bölümüne bu iki bilgiyi girin ve "Bağlantıyı test et" ile doğrulayın.
3. Birden çok kargo hesabı bağlıysa siparişlerin hangisiyle gideceğini belirlemek için ShipStation'ı birincil kargo olarak seçin.
4. Hazır bir siparişten ilk gönderi kaydını birlikte oluşturalım; takip numarasının siparişe yazıldığını ve etiketin panelden basıldığını kontrol edin.
5. Takip numarasının siparişin geldiği kanala ulaştığını kanalın satıcı panelinden doğrulayın; ardından günlük akışa geçin.

ShipStation tarafında önceden hazırlanacaklar

• Gönderici (ship from) adresi: ürünün gerçekten çıktığı deponun adresi olmalı; ABD deposundan çıkan koliye Türkiye adresi yazılmamalı.
• Taşıyıcı hesapları: kullanacağınız USPS, UPS, FedEx ya da Royal Mail gibi hesaplar ShipStation'a bağlanmış olmalı.
• Manual Store: V1 dokümanına göre Create Label ucuyla etiket oluşturmak için hesapta en az bir etkin Manual Store bulunmalı; kurulumda bunu birlikte kontrol ederiz.
• Paket ölçüleri ve ağırlık: taşıyıcı ücreti ölçü ve ağırlıkla değişir; hacimsel ağırlığı desi hesaplama aracı ile önceden görebilirsiniz.

Siparişten takip numarasına: günlük akış nasıl değişir?

Bağlantı kurulduktan sonra sipariş hazır olduğunda gönderi kaydı ShipStation'da açılır, takip numarası siparişe yazılır ve kanala iletilir; depo ekibinin ShipStation ile satış kanalı arasında numara kopyalaması gerekmez. Aşağıdaki tablo, yalnız panelin bu bağlantı için yaptığı işlere göre elle yönetimle farkı gösterir.

Takip numarası kanala hangi kurala göre gider?

Takip numarası ve taşıyıcı adı, siparişin geldiği pazaryerine ya da sitenize iletilir; kanalın kendi kargo kuralları geçerlidir. Etsy entegrasyonu ya da Amazon gibi her kanalın taşıyıcı adı ve takip numarası için kendi kuralı vardır; anlaşma dışı gönderime izin verilip verilmediğini satıcı panelinizden kontrol edin. ShipStation'ın kendi API'sinde de siparişi kargolandı olarak işaretleyip satış kanalına bildirim gönderen bir uç (markasshipped, notifySalesChannel seçeneği) vardır; aynı siparişe iki ayrı yoldan bildirim gitmemesi için hangi tarafın bildirimi yapacağı kurulumda belirlenir.

Açık ve kapalı sipariş durumları

ShipStation V1 dokümanına göre API ile yalnız açık durumdaki siparişler (awaiting_payment, awaiting_shipment, on_hold) güncellenebilir; shipped ve cancelled durumundaki sipariş değiştirilemez. Kanalda iptal edilen bir siparişin etiketi ShipStation'da basılmışsa etiketin iptalini (void) ShipStation tarafında ayrıca yapın; V1 API'de bunun için ayrı bir etiket iptal ucu bulunur.

Aynı kanalı iki yerden bağlamak: çift sipariş riski

ShipStation, Amazon, eBay, Etsy ya da Shopify gibi kanallara kendisi de mağaza olarak bağlanabildiği için en sık kurulum hatası aynı kanalı hem ShipStation'a hem panele bağlamaktır. Bu durumda sipariş ShipStation'a iki yoldan gelir; aynı müşteriye iki etiket basılabilir, kanala iki takip numarası gidebilir. Aşağıdaki tablo, hem ShipStation'ın resmî entegrasyon listesinde hem Yox İş Ortağım'ın hazır kanalları arasında bulunan kanalları gösterir; bu kanallarda siparişin ShipStation'a tek yoldan girmesine karar verin.

Depo ortağının ShipStation hesabı kullanılıyorsa

Lojistik ortağınız kendi ShipStation hesabına sizin kanallarınızı bağlamış olabilir. Böyle bir durumda hangi kanalın ortağın tarafında kalacağını yazılı olarak netleştirin ve paneldeki kanal listesini buna göre düzenleyin. Stok tarafında da tek kaynak ilkesi geçerlidir: stoğu iki yerden düşürmek aynı ürünün iki kez satılmasına yol açar. Panelde tek stok kartı ve kanallar arası stok-fiyat senkronu bulunduğu için stoğu panelde, etiketi ShipStation'da tutmak izlenebilir bir iş bölümüdür.

ShipStation entegrasyonu hangi Yox İş Ortağım paketinde kullanılır?

Kargo entegrasyonu Başlangıç paketinde yoktur; orada takip numarası elle girilir. ShipStation'ı kullanan satıcıların siparişleri çoğunlukla Amazon, Etsy, eBay ya da Walmart gibi yurt dışı kanallardan geldiği için bir noktaya daha dikkat edin: Başlangıç paketindeki tek kanal Trendyol, Hepsiburada, N11, Çiçeksepeti, Pazarama, PTT AVM ve idefix arasından seçilir. Yox İş Ortağım'da 80 satış kanalı (48'i hazır), 57 kargo ve lojistik firması ile 51 muhasebe, e-Fatura ve ERP programı tanımlıdır. Güncel ayrıntılar paket karşılaştırması bölümündedir.

Yıllık ödemede %20 indirim uygulanır ve 3 günlük ücretsiz deneme vardır. Bu ücretler ShipStation aboneliğinden ve taşıyıcı etiket bedellerinden ayrıdır; ShipStation tarafındaki ödemeyi doğrudan ShipStation'a yaparsınız.

ShipStation bağlantısını açmadan önce kontrol listesi ve sık hatalar

ShipStation kurulumlarındaki sorunların çoğu panelden değil, ShipStation hesabındaki eksik bir ayardan kaynaklanır. Aşağıdaki listeyi ilk gönderiden önce gözden geçirin.

İlk gönderiden önce kontrol listesi

• ShipStation planınız Standard ya da Premium mu; API Settings sayfası API'yi destekliyor mu?
• API Key ve API Secret panele girildi ve bağlantı testi geçti mi?
• Gönderici adresi, koliyi gerçekten çıkaran deponun adresi mi?
• Kullanacağınız taşıyıcı hesapları ShipStation'a bağlı mı?
• Aynı kanal hem ShipStation'a mağaza olarak hem panele bağlı değil mi?
• Kanala takip numarası bildirimini hangi tarafın yapacağı belli mi?
• Kanalda iptal edilen siparişin ShipStation etiketini kimin iptal edeceği belli mi?

En sık görülen hatalar

1. Starter planla bağlanmaya çalışmak: bu planda API erişimi olmadığı için bağlantı testi geçmez.
2. Aynı anahtar çiftini çok sayıda uygulamada kullanmak: dakikadaki 40 istek paylaşılır ve yoğun saatlerde 429 hatası görülür.
3. Türkiye'deki depodan çıkan koli için ShipStation kullanmak: ShipStation'ın bölge ve ülke listesinde Türkiye, taşıyıcı listesinde Türk kargo firması yoktur; böyle bir koli için doğrudan uluslararası firma bağlantısı daha az katmanlıdır.
4. Tarih farkını unutmak: V1 Pasifik saatiyle çalıştığı için raporları İstanbul saatiyle karşılaştırırken bir günlük kayma görülebilir.

Hesabınızın uygun olup olmadığından emin değilseniz kısa bir ön görüşme için iletişim sayfasından bize ulaşabilir, kanal ve kargo bağlantılarının tamamını Yox İş Ortağım entegrasyonları sayfasında görebilirsiniz. Hazırsanız Yox İş Ortağım'a başvurun; pilot kurulumu ve ilk gönderinin doğrulamasını birlikte yapalım.