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

Sendcloud entegrasyonu nedir, hangi satıcının işine yarar?

Sendcloud entegrasyonu, siparişin kargo tarafını Sendcloud hesabınıza devretmenin yoludur: sipariş Yox İş Ortağım'da toplanır, gönderi kaydı Sendcloud'da açılır, takip numarası siparişe geri döner. Şirket 2012'de kuruldu ve bugün Eindhoven, Münih ve Floransa'daki ofisleriyle çalışıyor. Fiyat sayfasındaki karşılaştırmaya göre ücretli planlarda 170'ten fazla taşıyıcıya, ücretsiz planda ise 70'ten fazlasına erişim veriliyor.

Kargo firması değil, taşıyıcılara açılan bir kapı

Sendcloud ile oluşturduğunuz koliyi DHL, UPS, GLS ya da PostNL gibi bir taşıyıcı teslim eder. Sendcloud'un rolü etiketi üretmek, gönderiyi taşıyıcıya bildirmek ve farklı firmaların takip mesajlarını tek biçime çevirmektir. Bu yüzden teslim süresi, hasar ve kayıp gibi konularda belirleyici olan seçtiğiniz taşıyıcının hizmet koşullarıdır. Yox İş Ortağım da kargo firması değildir; kargo bedeli almaz, anlaşmalı fiyat vermez.

Türkiye'deki ekip, Avrupa'daki depo: tipik kullanım senaryoları

• Hollanda, Almanya ya da Fransa'da şirketiniz ve stoğunuz var; Avrupa'daki müşterilere oradan gönderiyorsunuz, siparişleri ise İstanbul'daki ekibiniz yönetiyor.
• Ürünleriniz desteklenen bir ülkedeki fulfillment deposunda duruyor ve depo, gönderileri sizin adınıza açılmış Sendcloud hesabından çıkarıyor.
• bol.com, Amazon'un Avrupa mağazaları, Etsy ya da Zalando gibi kanallarda satıyorsunuz ve Avrupa çıkışlı siparişlerin etiketini tek bir akıştan almak istiyorsunuz.
• Türkiye içindeki siparişler için başka bir kargo bağlantısı kullanıyor, Sendcloud'u yalnız Avrupa stoğu için ikinci kargo hesabı olarak ekliyorsunuz.

Sendcloud hangi ülkelerden gönderi çıkarır, Türkiye çıkışı neden kısıtlı?

Sendcloud, fiyat sayfasındaki sık sorulan sorularda belirttiği üzere sekiz Avrupa ülkesinden çıkışı tam olarak destekliyor ve bu ülkelerden dünyanın her yerine gönderi yapılabiliyor. Beş ülke daha ek koşullarla açılıyor. Ekim 2026 itibarıyla Türkiye bu listelerin hiçbirinde yer almıyor.

Fatura ülkesi hesabın kimliğidir

Sendcloud yardım merkezindeki Portekiz çıkışlı gönderi makalesine göre fatura ülkesi kayıt sırasında seçilir ve sonradan değiştirilemez; ülke değişecekse yeni hesap açmak gerekir. Bu kural, Türkiye'deki bir şirketin Sendcloud'a doğrudan kaydolup İstanbul'daki depodan etiket basmasının önünde resmî bir engel oluşturur. Sendcloud'un blogundaki Türkiye rehberi de Türkiye'yi çıkış değil, Avrupa'dan gelen paketler için varış ülkesi olarak ele alır.

Sendcloud planları ve etiket ücretleri: neye ne kadar ödersiniz?

Sendcloud kullanımının maliyeti üç katmandan oluşur: aylık plan ücreti, her etiket için alınan işlem ücreti ve taşıyıcıya ödenen navlun. Fiyat sayfası etiket işlem ücretinin kargo bedeli olmadığını, plan ücretinin üzerine eklendiğini açıkça yazar. Aşağıdaki rakamlar Ekim 2026'da sayfada görünen başlangıç fiyatlarıdır; sayfada aylık ve %20 indirimli yıllık seçimi bulunduğu için faturalandırma dönemine göre tutar değişebilir.

Aylık sınır aşıldığında her etikete €0,15 ek ücret biner; Lite planda sınır sonrası bir etiket €0,25'e çıkar. Free planda ücretsiz test yöntemi olan ‘Unstamped letter’ için 50 etiket sınırı vardır. Ücretli planlarda kurulum ücreti alınmaz ve 14 günlük deneme kredi kartı istenmeden başlar.

Sendcloud tarifesi mi, kendi taşıyıcı sözleşmeniz mi?

Yox İş Ortağım tarafında iki model aynı biçimde bağlanır; panel Sendcloud hesabınızın anahtarlarını kullanır, hangi tarifenin uygulanacağını Sendcloud hesabınızdaki ayarlar belirler.

Sendcloud entegrasyonu için API anahtarı nasıl oluşturulur?

Panelde Sendcloud için zorunlu iki alan vardır: API Public Key ve Secret Key. Sendcloud'un geliştirici portalında anlatılan oluşturma adımları ve panel tarafındaki devamı şöyledir:

1. Sendcloud hesabınıza giriş yapıp ayarlardaki Integrations sayfasını açın.
2. Entegrasyon listesinde Sendcloud API satırını bulun ve Connect düğmesine tıklayın.
3. Bağlantıya tanınabilir bir ad verin (ör. ‘Yox İş Ortağım’) ve Save ile kaydedin.
4. Sendcloud Public Key ve Secret Key'i kendiliğinden üretir; ikisini Yox İş Ortağım'ın Kargo bölümündeki Sendcloud alanlarına girin.
5. Bağlantıyı test edin, ardından siparişlerin hangi kargo hesabıyla gideceğini birincil kargo olarak seçin.

Anahtarlar nasıl çalışır, nasıl korunur?

Sendcloud API'si Basic Authentication kullanır: Public Key kullanıcı adı, Secret Key parola yerine geçer. İstenirse aynı anahtarlarla OAuth2 erişim jetonu da alınabilir; bu jetonlar bir saat geçerlidir. Sendcloud dokümanı gizli anahtarın herkese açık yerlerde paylaşılmamasını özellikle uyarır. Anahtarı panele kendiniz girin, ekip içinde mesajla dolaştırmayın; bir çalışan ayrıldığında Sendcloud'da yeni anahtar üretip panelde güncelleyin. Bağlantı resmî API anahtarlarıyla kurulur, Sendcloud hesap şifreniz istenmez.

Nisan 2026 API sürüm değişikliği hesabınızı nasıl etkiler?

Sendcloud'un API sürüm rehberine göre API v2, Nisan 2026'dan itibaren bakım moduna giriyor. Şu an v2'de yalnız gönderi (parcel) oluşturma ucu yeni kullanıcılara kapalı; Nisan 2026'dan önce açılmış hesaplarda mevcut entegrasyonlar kesintisiz çalışıyor, anahtar yenilemek ve yeni API entegrasyonu eklemek de mümkün. Yeni kullanıcılara API v3 öneriliyor. Hesabınızın açılış tarihi bu yüzden kurulum planında önemli bir bilgidir.

Kargo yöntemi kimliği ve gönderici adresi: etiketi belirleyen iki ayar

Sendcloud'da her taşıyıcı hizmeti, sayısal bir kimliği olan bir kargo yöntemidir (shipping method). Sendcloud'un v2 dokümanına göre bir gönderinin etiketi oluşturulabilmesi için istekte bir kargo yöntemi kimliği bulunmalıdır. Panelde bu alan isteğe bağlıdır ve etiketin hangi taşıyıcı hizmetiyle oluşacağını sabitler; etiketi panelden basmayı planlıyorsanız bu alanı doldurmanız işinizi kolaylaştırır.

Kimliği neden kendi hesabınızdan almalısınız?

Sendcloud, kargo yöntemi kimliklerinin değişken olduğunu ve bir saatten uzun önbellekte tutulmaması gerektiğini yazar. Listede görünen yöntemler hesabınızda etkin taşıyıcılara, bağladığınız sözleşmelere ve gönderici adresinize göre değişir; varsayılan adresiniz Hollanda'daysa yalnız Fransa'dan çalışan yöntemler listede çıkmaz. Yurt dışı bir varış için yalnız yurt içinde çalışan bir yöntem seçilirse Sendcloud ‘Invalid shipment id’ hatası döndürür. Bu yüzden forumdan ya da başka bir hesaptan kopyalanmış numara yerine kendi hesabınızın listesindeki kimliği kullanın.

Gönderici adresi, marka ve koli bilgileri

Sendcloud'da birden çok gönderici adresi tutulabilir, ama biri her zaman varsayılandır. İstekte adres belirtilmezse etiket varsayılan adresle oluşur ve o adrese bağlı marka (brand) gönderiye atanır. Depo değiştirdiğinizde Sendcloud'daki varsayılan adresi de güncelleyin; aksi hâlde taşıyıcı koliyi yanlış adresten bekler, sorunlu koliler de eski adrese döner.

• Seçtiğiniz kargo yöntemi, satış yaptığınız varış ülkelerini kapsamalı.
• Varsayılan gönderici adresi, koliyi fiilen çıkardığınız depo olmalı.
• Ürün ağırlıkları gerçekçi girilmeli; navlunu ağırlık ve ölçü belirler. Koli ölçüsünü önceden görmek için desi hesaplama aracı işinizi kolaylaştırır, ancak Avrupa taşıyıcılarının hacim ağırlığı kuralı firmaya göre değişir.

Sendcloud entegrasyonunda sipariş, etiket ve takip numarası akışı

Sendcloud birincil kargonuz olduğunda, sipariş hazırlandığında panel Sendcloud'da gönderi kaydı oluşturur ve dönen takip numarası siparişe yazılır; Sendcloud etiketi döndürdüyse etiket panelden basılır. Ardından takip numarası ve kargo firması siparişin geldiği pazaryerine ya da sitenize iletilir. Gönderinin durumu Sendcloud üzerinden sorgulanarak siparişe yansıtılır: kargoya verildi, yolda, teslim edildi.

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

Sendcloud'un etiket dokümanına göre etiketler varsayılan olarak taşıyıcının özgün boyutunda PDF gelir; çoğu taşıyıcıda bu boyut A6'dır. Doküman ayrıca ZPL ve PNG biçimlerini, belge alınırken A4, A5 ve A6 kâğıt boyutlarını tanımlar. ZPL etiketlerde çoğu taşıyıcı 203 DPI kullanır; termal yazıcınızı aynı çözünürlüğe ayarlamak barkodun okunmama riskini azaltır.

Sendcloud takip aşamaları ne anlama gelir?

Sendcloud, farklı taşıyıcıların durum mesajlarını API v3'te standart aşamalara (phase) çevirir. Başlıca aşamalar ve satıcı açısından anlamları:

Bazı olaylar aşama yerine istisna (exception) olarak gelir: alıcı bilgisinin düzeltilmesi gereken address_error ya da etiketin taşıyıcıya bildirilemediği announcement_failed bunlara örnektir. Bu durumda adresi ve kargo yöntemini kontrol edin.

AB dışına giden siparişlerde Sendcloud'un istediği gümrük bilgileri

Sendcloud'un uluslararası gönderi dokümanına göre AB dışındaki varış noktalarına giden kolilerde gümrük belgesi her zaman gerekir: UPS ve DHL gibi ticari taşıyıcılar çoğunlukla ticari fatura, PostNL ve Royal Mail gibi posta taşıyıcıları CN22 ya da CN23 formu ister. Doğru belge türünü Sendcloud gönderi oluşturulurken kendisi üretir, ama ürün bazındaki bilgilerin istekte yer alması şarttır. Fiyat sayfasına göre gümrük belgeleri Lite ve üstü planlarda bulunur. Belgenin oluşması için gereken başlıca alanlar:

• Ürün açıklaması ve adedi
• Tek ürünün ağırlığı ve para birimiyle birlikte birim fiyatı
• Ürünün HS (Armonize Sistem) kodu
• Ürünün üretildiği ülke, iki harfli ISO koduyla (Türkiye için TR)
• Fatura numarası (en fazla 40 karakter) ve ihracat nedeni
• Avustralya, Kanada, İtalya, ABD ve Vietnam adreslerinde ülke önekli eyalet ya da il kodu

Ürün kartlarını AB dışı gönderiye hazırlamak

Birleşik Krallık, İsviçre ya da Norveç gibi AB dışı ülkelere satıyorsanız eksik HS kodu ya da menşe bilgisi gönderinin reddedilmesine yol açar; Sendcloud gümrük bilgisi gereken gönderileri bu bilgi olmadan kabul etmez. Türkiye'de üretilmiş bir ürün Avrupa'daki depodan çıksa bile üretim ülkesi alanına TR yazılır. Ticari ihracatta Sendcloud ayrıca gönderici ya da fatura adresi ülkesine ait KDV numarası ister; kendi taşıyıcı sözleşmenizle gönderdiğinizde bu kontrol uygulanmaz. AB dışı bir varış ülkeniz varsa bunu ön görüşmede belirtin; ilk gönderiyi birlikte doğrularken belgenin oluşup oluşmadığına da bakılması gerekir.

Avrupa pazaryeri siparişlerinde Sendcloud ve takip numarası

Avrupa pazaryerlerinde de iki yol vardır: pazaryerinin kendi gönderim hizmeti ya da satıcının kendi gönderimi. Sendcloud ikinci yolda devreye girer; etiketi siz oluşturur, takip numarasını kanala zamanında bildirirsiniz. Örneğin Amazon siparişini ya da Etsy siparişini Almanya'daki deponuzdan Sendcloud etiketiyle gönderdiğinizde panel takip numarasını ve kargo firmasını siparişin geldiği kanala iletir. Hangi taşıyıcının ve hizmetin kabul edildiği her pazaryerinin kendi kuralına bağlıdır; Zalando gibi diğer kanallarda da kendi gönderiminize izin verilip verilmediğini satıcı panelinizden kontrol edin.

bol.com'da VVB etiketi ayrı bir yoldur

Sendcloud'un bol.com entegrasyon sayfasına göre Verzenden via bol.com (VVB) etiketleri yalnız Hollanda'dan gönderilen siparişleri kapsar ve yalnız Sendcloud'un kendi bol.com bağlantısında işler; genel mağaza bağlantıları VVB'yi işleyemez. VVB kargo bedeli de Sendcloud'a değil, bol.com satıcı hesabınıza yansır. Yox İş Ortağım üzerinden kurulan Sendcloud bağlantısı ise sizin seçtiğiniz kargo yöntemiyle etiket oluşturur; VVB'nin yerine geçmez. bol.com entegrasyonu kurarken siparişlerin hangi yolla gideceğine bu farkı bilerek karar verin; iki yolu aynı sipariş için birlikte kullanmak çift etiket riskini doğurur.

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

Kargo entegrasyonu Başlangıç paketinde yer almaz; orada takip numarası elle girilir. Sendcloud, panelde tanımlı 57 kargo ve lojistik firmasından biri olarak sayılır ve paketinizdeki kargo firması hakkından birini kullanır.

Yıllık ödemede %20 indirim uygulanır ve 3 gün ücretsiz deneme vardır. Avrupa kanallarında satıyorsanız Başlangıç paketindeki tek kanal seçeneğinin yalnız Türkiye pazaryerlerini kapsadığını unutmayın. Ayrıntılı karşılaştırma Yox İş Ortağım paketleri bölümünde; panelde 80 satış kanalı (48'i hazır), 57 kargo ve lojistik, 51 muhasebe/e-Fatura/ERP bağlantısı entegrasyonlar sayfasında listelenir. Sendcloud ücretleri Yox paketinden ayrıdır ve doğrudan Sendcloud'a ödenir.

Sendcloud entegrasyonu öncesi kontrol listesi ve sık yapılan hatalar

Sendcloud bağlantısını canlı siparişe açmadan önce aşağıdaki maddelerin her birine net bir cevabınız olmalı. Maddelerin çoğu Sendcloud hesabınızın kurulumu ile ilgilidir.

• Sendcloud hesabınızın fatura ülkesi desteklenen ülkelerden biri mi ve koliler gerçekten o bölgedeki bir depodan mı çıkıyor?
• Kendi taşıyıcı sözleşmenizi kullanacaksanız planınız Lite ya da üstü mü?
• Kargo yöntemi kimliği kendi hesabınızın listesinden mi alındı ve varış ülkelerinizi kapsıyor mu?
• Varsayılan gönderici adresi doğru depo mu?
• AB dışı varışlar için ürünlerin HS kodu ve üretim ülkesi hazır mı?
• İlk deneme için ücret oluşturmayan ‘Unstamped letter’ seçeneğiyle test etiketi oluşturdunuz mu?

Sık yapılan hatalar

En pahalı hata, Türkiye'deki depodan gönderi yapılabileceğini varsayarak Sendcloud'a kaydolmaktır; fatura ülkesi sonradan değiştirilemediği için yanlış açılan hesabın yerine yenisini açmak gerekir. İkinci hata, testi gerçek bir taşıyıcı yöntemiyle yapıp etiketi iptal edebileceğini düşünmektir; Sendcloud her taşıyıcının iptali kabul etmediğini ve iptal edilemeyen etiketin ücretlendirildiğini yazar. Üçüncüsü, pazaryerinin kendi gönderim kuralını kontrol etmeden takip numarasının kabul edileceğini varsaymaktır. Kurulumu birlikte yapmak için Yox İş Ortağım'a başvurun; sorularınız için iletişim sayfamızdan bize yazabilirsiniz.