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

Easyship entegrasyonu nedir, Türkiye'den gönderen satıcı için ne anlama gelir?

Easyship, Easyship Inc. tarafından işletilen ve plan sayfasına göre 550'yi aşkın kurye hizmetini tek hesapta toplayan bir gönderi yazılımı ve API platformudur. Satıcı Easyship'te hesap açar; fiyat sorgulama, gönderi oluşturma, etiket ve takip bu hesap üzerinden yürür. Yox İş Ortağım bu hesaba Easyship'in herkese açık API'si üzerinden bağlanır. Hangi taşıyıcının hangi koşulla kullanılabileceğini ise gönderinin çıktığı ülke belirler.

İndirimli tarife ülkeleri ile kendi kuryesini bağlayan ülkeler

Easyship yardım merkezi çıkış ülkelerini iki gruba ayırır. Önceden pazarlığı yapılmış indirimli tarifeler 11 ülkeden sunulur: ABD, Birleşik Krallık, Kanada, Avustralya, Yeni Zelanda, Almanya, Fransa, Hollanda, Belçika, Hong Kong ve Singapur. Türkiye ikinci gruptadır: bu 43 ülkeden hesap açılabilir, ancak etiket üretmek için kendi kurye hesabınızı bağlamanız gerekir. Easyship'in Türkiye kurye sayfasında da Türkiye için indirimli tarifeler “Coming soon” notuyla görünür; liste değişebileceği için hesap açmadan önce güncel sayfayı kontrol edin.

Türkiye'den çalışıyorsanız Easyship size taşıyıcı fiyatı sağlamaz, kurye hesaplarınızı tek panelde toplayan bir katman olur. En çok, birden çok ekspres kurye hesabıyla yurt dışına satan satıcının işine yarar.

Easyship planları ve Türkiye fiyatları: hangi plan gerekir?

Türkiye'den Easyship ile etiket üretmek için en az Plus planı gerekir, çünkü Ücretsiz planda kendi kurye hesabı bağlama hakkı yoktur. Easyship plan sayfası fiyatları ülkeye göre gösterir; Şubat 2026 tarihli plan verisinde Türkiye için fiyatlar Türk lirasıyla şöyledir:

Kaç kurye hesabı bağlayacağınıza göre plan seçimi

• Yalnız bir ekspres kurye hesabınız varsa (örneğin yalnız UPS) Plus planı yeterlidir; aylık 500 gönderi sınırını aşmadığınız sürece.
• UPS ile DHL Express'i birlikte kullanacaksanız iki bağlantı gerekir; bu Premier planından başlar.
• Üç kurye hesabını aynı anda bağlamak Scale planını gerektirir; Scale içindeki üç kademe gönderi adedine göre ayrılır.
• Ücretli planlarda 14 günlük ücretsiz deneme vardır.

Plan sayfası gelişmiş API çağrılarına da kota koyar: fiyat sorgulamada Plus'a 2.000, Premier'e 10.000 çağrı dahildir; Easyship gönderilerinin takip çağrıları bütün planlarda ücretsizdir. Kotayı aşan çağrılar çağrı başına ücretlendirilir; yüksek hacimde bu satırı da hesaba katın.

Kendi UPS, FedEx veya DHL Express hesabınızı Easyship'e bağlamak (LYOC)

Easyship'te kendi kurye hesabınızı bağlamanın adı LYOC'tur (Link Your Own Courier). Yardım merkezinde UPS, FedEx, DHL Express, Royal Mail, Australia Post, Canada Post ve Sendle için bağlantı rehberi bulunur; Türkiye'den gönderen satıcı için uygulanabilir olanlar UPS, FedEx ve DHL Express'tir. Bağlantı her üçünde de Easyship panelinin Couriers bölümünde “Add new courier” ile, hesabın kayıtlı olduğu ülke seçilerek başlar.

DHL Express için MyDHL API anahtarını almak

Anahtarları DHL verdiği için bu en uzun adımdır. Easyship'in rehberine göre DHL Developer Portal'a kayıt olup DHL'in başvuru formunda üçüncü taraf platform için MyDHL API erişimi seçeneğini işaretler, talep eden platform adına Easyship yazarsınız. Formda listelenen bütün hizmetleri (fiyat, gönderi, takip, toplama vb.) seçin. DHL önce test erişimini onaylar; ardından portaldaki uygulamanızdan canlı erişim (Production Access) istersiniz ve canlı anahtarlar onaydan sonra kullanılabilir. Easyship olmadan doğrudan DHL bağlantısını DHL Express entegrasyonu rehberinde anlattık.

Toplama ve DDP işlem ücretlerini neden kendiniz girmelisiniz?

Easyship, kuryeyle yaptığınız sözleşmenin koşullarını bilmez. DHL Express rehberinde açıkça yazıldığı gibi, toplama ücretini girmezseniz sıfır, DDP işlem ücretini girmezseniz hesap ülkesine göre varsayılan bir tutar (örneğin 10 ABD doları) kabul edilir. Bu alanlar boş kalırsa Easyship'te gördüğünüz maliyet gerçek faturanızdan sapar. Bağlantıdan sonra Couriers bölümünde hesabınızı açıp sözleşmenizdeki tutarları girin.

Easyship API Access Token: oluşturma, kapsamlar ve test ortamı

Easyship API'si Bearer kimlik doğrulaması kullanır; Yox İş Ortağım'ın sizden istediği temel bilgi bu erişim anahtarıdır. Her API bağlantısı biri canlı, biri test ortamı için iki anahtar üretir. Anahtar hesabınıza erişim verdiği için parola gibi saklanmalı, yalnız panelin Kargo bölümündeki Easyship alanına girilmelidir.

1. app.easyship.com adresinden Easyship hesabınıza giriş yapın.
2. Sol menüde Connect altındaki New Integration'a girip sayfanın altındaki API Integration seçeneğini açın (geliştirici dokümanında bu bölüm APIs & Webhooks olarak geçer).
3. Bağlantıya tanınır bir ad verin, örneğin “Yox İş Ortağım”, ve önerilen güncel sürüm olan 2024-09'u seçin.
4. Connect'e tıklayın; Production ve Sandbox anahtarlarından canlı olanı (prod_ ile başlayan) kopyalayın.
5. Anahtarın kapsamlarını kontrol edin: gönderi, etiket ve takip izinleri açık olmalı.
6. Anahtarı Yox İş Ortağım'da Kargo bölümündeki Easyship formuna yapıştırın, isterseniz gönderici bilgilerini ekleyin ve “Bağlantıyı test et” ile doğrulayın.

2024-09 sürümünde kapsamlar nasıl okunur?

Easyship'in 2024-09 ve sonrası sürümlerinde kapsamlar public.shipment:write gibi “kaynak:işlem” biçimindedir; read yalnız okuma, write ise oluşturma, değiştirme ve silme izni verir. Easyship'in referansına göre gönderi oluşturmak için public.shipment:write, etiket satın almak için public.label:write, gönderinin takip geçmişini okumak için public.track:read gerekir. Kapsamları sonradan bağlantının sayfasında Edit ile değiştirebilirsiniz.

Easyship entegrasyonu Yox İş Ortağım'da siparişi nasıl işler?

Easyship entegrasyonu Yox İş Ortağım'da pilot aşamasındadır: kurulumu sizinle birlikte yapıyor, ilk gönderinizi birlikte doğruluyoruz. Bağlantıdan sonra akış dört işten oluşur:

• Sipariş hazır olduğunda Easyship'te gönderi kaydı oluşturulur, takip numarası siparişe yazılır.
• Easyship etiketi döndürdüğünde barkodlu etiket panelden basılır.
• Gönderinin durumu Easyship üzerinden sorgulanır; kargoya verildi, yolda, teslim edildi gibi aşamalar siparişe yansır.
• Takip numarası ve kargo firması siparişin geldiği pazaryerine ya da sitenize iletilir.

Birden çok kargo hesabı bağladıysanız birincil kargo seçimiyle hangi siparişin Easyship'le gideceğini siz belirlersiniz. Yurt dışı siparişleri Easyship'e, yurt içini yerli firmanıza ayırmak yaygın düzendir.

Easyship'in döndürdüğü etiket ve belgeler

Easyship'in gönderi şemasında etiket sayfa boyutu 4x6 inç, A4 ya da A5; dosya biçimi PNG, PDF, URL ya da termal yazıcılar için ZPL olabilir. Varsayılan etiket boyutu 4x6'dır. Uluslararası gönderide ticari fatura (commercial invoice) varsayılan olarak A4 hazırlanır ve fatura notu alanı 70 karakterle sınırlıdır. Yazıcınızın hangi boyuta uygun olduğunu ilk test siparişinde görün.

Gönderi iptali: ne zaman mümkün, ne zaman değil?

Easyship iki ayrı işlem tanımlar. Etiket istenmeden önce gönderi silinebilir; etiket istendikten sonra ise gönderi kurye tarafından taşınmaya başlamadıkça iptal edilebilir. Etiket o an üretiliyorsa iptal beklemelidir; koli yola çıktıysa ya da önceden ödenmiş etiket 6 aydan eskiyse iptal edilemez. İptali Easyship hesabınızdan yapın ve aynı sipariş için yeni gönderi açmadan önce eskisinin iptal edildiğini görün; yoksa iki etiket ücreti doğabilir.

Pazaryeri siparişlerinde Easyship: Etsy, eBay, Amazon ve yurt içi kanallar

Easyship pazaryerlerinin anlaşmalı kargosu değildir; sizin hesabınız ve sizin kurye sözleşmenizle çalışan bir gönderi platformudur. Bu yüzden pazaryeri siparişini Easyship'le göndermenin ilk şartı, kanalın kendi kargo anlaşması dışındaki gönderiye izin vermesidir. Bu kural kanala göre değişir; güncel durumu satıcı panelinizden kontrol edin.

• Etsy entegrasyonu ve eBay entegrasyonu üzerinden gelen yurt dışı siparişlerde takip numarası panelden kanala iletilir; kanalın kabul ettiği kargo firması adını ve takip biçimini satıcı panelinizden doğrulayın.
• Amazon'da Easyship yalnız satıcının kendi gönderdiği siparişlerde anlamlıdır; Amazon'un kendi lojistiğindeki siparişlerde devreye girmez.
• Trendyol, Hepsiburada gibi yurt içi pazaryeri siparişleri için Easyship'i birincil kargo yapmayın.
• Kendi sitenizin yurt dışı siparişinde kanal kuralı yoktur; takip numarası doğrudan sitenize yazılır.

Aynı siparişin iki yerden etiketlenmesini önlemek

Easyship'in Plus ve üstü planlarında satış platformlarından siparişleri otomatik çekme (Auto-Sync Orders) özelliği vardır. Mağazanızı hem Easyship'e hem Yox İş Ortağım'a bağlayıp iki tarafta da gönderi açarsanız aynı sipariş için iki etiket satın alma riski doğar. Siparişleri Yox İş Ortağım'dan yönetiyorsanız gönderiyi tek yerden açın; Easyship tarafındaki mağaza senkronunu ya kapatın ya da yalnız takip için kullanın.

Gümrük ve e-ihracat: Easyship gönderisinde hangi bilgiler eksiksiz olmalı?

Yurt dışı gönderide etiketin üretilip üretilmeyeceğini çoğu zaman ürün kartınızdaki gümrük bilgileri belirler. Easyship'in gönderi oluşturma şemasına göre her kalem için HS kodu ya da Easyship ürün kategorisi zorunludur; ikisinden biri olmadan kalem kabul edilmez.

Easyship'in kalem ve adres alanları

• Gümrük beyan değeri birim başına girilir ve belge gönderileri dışında sıfırdan büyük olmalıdır; para birimi USD, EUR gibi üç harfli kodla belirtilir.
• Ürün açıklaması en fazla 200 karakterdir; “hediye” ya da “ürün” gibi genel ifadeler yerine malın ne olduğunu yazın.
• Incoterms alanı vergiyi kimin ödeyeceğini belirler: DDU'da alıcı, DDP'de satıcı öder; alan boşsa DDU kabul edilir.
• Satıcı için EORI, IOSS ve KDV numarası alanları vardır; Çin ve Brezilya gibi ülkelerde alıcının vergi numarası da gerekir.
• Gönderi adresinde adres satırı 35, firma adı 27, kişi adı 22 karakteri aşmamalıdır; uzun Türkçe adresleri ikinci satıra bölün.
• Koli ölçüsünü gerçek paketlemeye göre girin; hacimsel ağırlığı desi hesaplama aracıyla önceden kontrol edin.

Türkiye tarafı: BGB, ET kodu ve 2026 sınırı

Easyship'in yardım sayfalarında Türkiye'ye özgü bir ihracat beyanı süreci anlatılmaz; bu taraf bağladığınız kuryeyle yürür. Ticaret Bakanlığı'nın 2026/4 sayılı Genelgesiyle, hızlı kargoyla gönderilen eşyada basitleştirilmiş gümrük beyannamesi (BGB) sınırı 6 Şubat 2026'dan itibaren brüt 600 kilogram ve 30.000 Avro oldu; önceki sınır 300 kilogram ve 15.000 Avro idi. Bakanlığın E-ihracat Beyan Kılavuzu, BGB'de e-ticaret işlemlerinin “ET” olarak işaretlenmesini ve vergi numarasının mutlaka beyan edilmesini ister. Bu adımı UPS, FedEx ya da DHL Express temsilcinizle ve gümrük müşavirinizle netleştirin; UPS tarafındaki ayrıntılar UPS entegrasyonu rehberinde.

Yox İş Ortağım paketlerinde Easyship entegrasyonu

Easyship, Yox İş Ortağım'da bir kargo firması bağlantısı olarak sayılır. Kargo entegrasyonu Başlangıç paketinde yoktur; orada takip numarası siparişe elle girilir. Panelde tanımlı 57 kargo ve lojistik firmasının, 80 satış kanalının ve 51 muhasebe programının tamamını Yox İş Ortağım entegrasyonları sayfasında görebilirsiniz.

Yıllık ödemede bütün paketlerde %20 indirim uygulanır ve 3 gün ücretsiz deneme vardır. Yurt dışı ve yurt içi siparişleri farklı kargolarla göndermeyi düşünüyorsanız en az Profesyonel paket gerekir. Paketlerin ayrıntılı karşılaştırması paketler bölümünde; ön görüşme için Yox İş Ortağım'a başvurun.

Easyship entegrasyonunu canlıya almadan önce kontrol listesi ve sık hatalar

İlk gerçek siparişten önce aşağıdaki maddeleri işaretleyin. Pilot aşamasında ilk gönderiyi sizinle birlikte doğruladığımız için bu listeyi kurulum görüşmesinde de birlikte gözden geçiriyoruz.

Kurulumdan önce kontrol listesi

• Easyship hesabı Plus ya da üstü bir planda ve ödeme yöntemi tanımlı.
• En az bir kurye hesabı (UPS, FedEx ya da DHL Express) Easyship'e bağlı ve bağlantı aktif.
• Toplama ve DDP işlem ücretleri sözleşmenize göre girilmiş.
• API bağlantısı 2024-09 sürümünde açılmış, prod_ ile başlayan anahtar kopyalanmış, gönderi, etiket ve takip kapsamları açık.
• Ürün kartlarında HS kodu, açıklama, ağırlık ve ölçü dolu.
• Birincil kargo seçimiyle yurt dışı ve yurt içi siparişlerin hangi hesapla gideceği belli.

En sık karşılaşılan hatalar

• Ücretsiz planla başlamak: Türkiye çıkışında kurye bağlanamadığı için etiket oluşmaz.
• Test anahtarını canlıda kullanmak: sand_ anahtarı örnek veri döndürür, gerçek takip numarası vermez.
• FedEx adres farkı: fatura adresindeki küçük bir yazım farkı bağlantıyı düşürür; özel karakterleri (/, -, *) kaldırın.
• DHL hesap numarası: 9 haneden farklı girilen numara geçersiz sayılır.
• Çift senkron: mağazayı Easyship'e de bağlayıp iki yerden gönderi açmak çift etiket ücreti doğurur.

Token ya da kurye bağlantısında takılırsanız iletişim sayfasından bize ulaşın; kurulumu birlikte yaparız.