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

ShipEntegra entegrasyonu nedir, hangi satıcı için anlamlıdır?

ShipEntegra entegrasyonu, ShipEntegra'daki e-ihracat hesabınızı API bilgileriyle Yox İş Ortağım'a bağlayarak yurt dışına giden siparişlerin gönderi kaydını, etiketini ve takip numarasını sipariş ekranından yönetmenizi sağlar. ShipEntegra kendini Türkiye'den yurt dışına gönderi yapan herkesin kullanabileceği bir kargo ve yazılım hizmeti olarak tanımlar; sıkça sorulan sorular sayfasında FedEx, UPS, TNT ve DHL gibi taşıyıcılarla anlaşmaları olduğunu yazar. Yani ShipEntegra koliyi kendi aracıyla taşıyan bir kargo firması değil, ekspres taşıyıcılara tek hesaptan erişim veren aracı bir platformdur. Yox İş Ortağım bu platforma, ShipEntegra'nın satıcılarına açtığı herkese açık API üzerinden bağlanır.

Yurt içi kargo bağlantısından temel farkı, gönderinin iki ülkenin gümrüğünden geçmesidir: alıcı adresinin yanında ürünün gümrükteki adı, birim fiyatı, para birimi ve ihracat nedeni de doğru olmalıdır. Yurt içinde önemsiz görünen bir adres kısaltması bile yurt dışı etiketinde kaydın reddedilmesine yol açabilir.

Kimin işine yarar, kim için gereksizdir?

• Etsy, eBay, satıcı gönderimli Amazon ya da yurt dışına satan kendi siteniz üzerinden düzenli sipariş alıyorsanız bağlantı, siparişi iki ekran arasında taşıma işini ortadan kaldırır.
• Yurt içinde satıp yılda birkaç koli yurt dışına gönderiyorsanız ShipEntegra'nın kendi paneli yeterli olabilir.
• Amazon'un deposundan gönderilen (FBA) siparişlerde etiketi ve teslimatı Amazon yürütür; bu siparişler ShipEntegra akışına girmez.
• Teslimat adresi Türkiye'de olan siparişler için ShipEntegra'ya gerek yoktur; bunlar pazaryerinin anlaşmalı kargosuyla ya da yurt içi kargo sözleşmenizle gider.

ShipEntegra'nın hizmet modeli: servisler, teslim noktaları ve paket sınırları

ShipEntegra'da bir gönderi, panelde etiket oluşturulduktan sonra kolinin ShipEntegra transfer merkezine ulaştırılması ve oradan ekspres ya da eko servisle yurt dışına çıkarılmasıyla ilerler. Aşağıdaki bilgiler ShipEntegra'nın kendi sitesindeki açıklamalardır; servis kapsamı ve süreleri değişebileceği için güncel koşulları hesabınızdan kontrol edin.

Koliyi transfer merkezine ulaştırmak ve takip numarasının zamanı

Etiketi yapıştırılan koli önce ShipEntegra'nın operasyon merkezlerinden birine gider; iletişim sayfasında İstanbul'un iki yakası, Ankara, İzmir, Bursa, Antalya, Kayseri, Konya, Denizli ve Eskişehir listelenir ve anlaşma kodu şubeye göre değişebilir. Etiket yanıtında bir takip numarası alanı bulunsa da ShipEntegra'nın SSS ve Etsy sayfaları takip numarasının koli operasyon merkezinde kabul edildikten sonra paylaşıldığını anlatır. Numaranın kanala hangi aşamada gittiğini bu yüzden ilk gönderide birlikte kontrol ediyoruz.

5000 böleniyle örnek hacimsel ağırlık hesabı

35 × 25 × 15 cm ölçülerinde, tartıda 1,8 kg gelen bir koli düşünün. Hacimsel ağırlık 13.125 / 5000 = 2,625 kg eder ve tartıdan büyük olduğu için ücrete esas alınır; aynı koli 3000 bölenli bir desi sisteminde 4,375 çıkar. Ölçüleri desi hesaplama aracında kontrol edip ShipEntegra'nın fiyat hesaplama ekranıyla karşılaştırın.

ShipEntegra API'si resmî dokümana göre neleri kapsar?

ShipEntegra'nın herkese açık API dokümanı (docs.shipentegra.com, Ekim 2026'da v4.0.4) gönderinin yolculuğunu ayrı uç noktalara böler. Bağlantı, ShipEntegra'nın verdiği Client Id ve Client Secret ile bir erişim anahtarı (token) alınarak başlar; dokümanda bu iki bilginin ShipEntegra tarafından sağlandığı yazılıdır.

Test sunucusu ile canlı sunucu ayrıdır

Dokümanda iki sunucu tanımlıdır: deneme işlemleri için newfront.shipentegra.com, gerçek gönderiler için publicapi.shipentegra.com. Test ortamı için verilen bilgilerle canlı siparişte etiket alınmaz. Canlıya geçerken canlı hesabınıza ait Client Id ve Client Secret'ı girip bağlantıyı yeniden test edin.

Alıcı adresinde dokümanın koyduğu biçim kuralları

Alan kuralları en sık hatanın nereden çıktığını gösterir: alıcı adı en az iki kelime ve en çok 50 karakter, adres satırı 5 ile 35 karakter arasında olmalı; satırda harf, rakam, boşluk, virgül, kesme işareti ve tire dışında karakter kabul edilmez. Ülke kodu iki büyük harftir (US, DE, GB). Bu yüzden “Apt. 4B” ya da “No:12/3” gibi nokta ve eğik çizgi içeren adresler ikinci satıra bölünmeli ya da sadeleştirilmelidir.

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

ShipEntegra entegrasyonu Yox İş Ortağım'da pilot aşamasındadır: kurulumu sizinle birlikte yapıyor, ilk gönderinizi birlikte doğruluyoruz. Sıra şöyledir:

1. ShipEntegra'da hesabınızı açın; şirket şartı yoktur, bireysel hesapla da başlanabilir.
2. Satış kanallarınızı Yox İş Ortağım'a bağlayın; Etsy, eBay ya da Amazon siparişleri tek sipariş listesine düşer.
3. ShipEntegra'dan API erişimi için Client Id ve Client Secret isteyin.
4. Panelin Kargo bölümünde bu iki bilgiyi girin; dilerseniz gönderici adı, adres, şehir, posta kodu, ülke ve telefonu da ekleyin.
5. Bağlantıyı test et düğmesiyle bilgileri doğrulayın.
6. Birden çok kargo hesabınız varsa yurt dışı siparişlerinin hangi hesapla gideceğini birincil kargo seçimiyle belirleyin.
7. İlk gerçek siparişte gönderi kaydını, etiketi ve kanala giden takip numarasını birlikte kontrol edin.

Client Id ve Client Secret nereden alınır?

API dokümanı bu bilgilerin ShipEntegra tarafından verildiğini söyler ama hesap panelinde hangi menüde durduğunu anlatmaz; bulamazsanız ShipEntegra müşteri hizmetlerine (0 850 550 58 59) ya da temsilcinize yazın. Client Secret bir parola gibi korunmalıdır: e-postada dolaştırmayın, sızdığını düşünürseniz yenisini isteyin. Gönderici adresi dokümanda Türkiye adresi (ülke kodu TR) olarak tanımlıdır ve yalnız bayi ile yetkilendirilmiş kullanıcılar için geçerli olduğu yazar; hesabınızda kullanılıp kullanılmadığını ShipEntegra'ya sorun.

Pilot süreçte ilk gönderiyi birlikte doğrulamak

İlk gerçek siparişte üç şeye bakıyoruz: ShipEntegra'da açılan kaydın alıcı ve ürün bilgileri, panelden basılan etiket ve takip numarasının siparişin geldiği kanala ulaşıp ulaşmadığı. Bir uyumsuzluk çıkarsa ayarı bu ilk siparişte düzeltip sonraki siparişler için sabitliyoruz. Kurulumdan önce ön görüşme isterseniz iletişim sayfasından bize yazabilirsiniz.

Elle yönetim, yalnız ShipEntegra paneli ya da ShipEntegra entegrasyonu: iş yükü karşılaştırması

Yurt dışı siparişini bağlantısız yönetmek, aynı bilgiyi üç ekranda yeniden yazmak demektir: kanalın sipariş sayfası, ShipEntegra paneli ve takip numarasının geri yazılacağı kanal ekranı. ShipEntegra'nın mağaza bağlama özelliği bunun bir kısmını çözer; fark, stok, yurt içi kanallar ve faturayla aynı yerde çalışıp çalışmadığınızda ortaya çıkar.

Mağazayı hem ShipEntegra'ya hem panele bağlarsanız ne olur?

ShipEntegra; Etsy, eBay, Amazon, Shopify ve WooCommerce gibi mağazaları kendi paneline de bağlatır ve takip numarasını kanala kendisi bildirebilir. Aynı mağaza iki tarafa bağlıysa tek sipariş için iki gönderi kaydı oluşabilir ya da kanala iki ayrı takip numarası yazılabilir. Kurulumda her mağaza için bildirim yolunu tek bir tarafa bırakın: o mağazanın yurt dışı siparişleri ya Yox İş Ortağım üzerinden ya da ShipEntegra panelinden gönderilsin, ikisinden birden değil.

Mikro ihracat ve ETGB: 2026'daki sınır değişikliği ShipEntegra gönderisini nasıl etkiler?

Mikro ihracat, posta ya da hızlı kargoyla yapılan küçük ihracatın basitleştirilmiş gümrük beyannamesiyle (uygulamada ETGB ya da BGB diye anılır) beyan edilmesidir; beyanı posta idaresi ya da hızlı kargo operatörü yapar. Ticaret Bakanlığı Gümrükler Genel Müdürlüğü'nün 6 Şubat 2026'da yürürlüğe giren genelge değişikliğiyle bu yolun sınırı brüt 600 kilogram ve 30.000 Avro'ya çıktı.

Fatura neden etiketten önce kesilmeli?

Bir gönderiyi ETGB'li işaretlemek için fatura numarası ve tarihi istendiğinden, mikro ihracat yapacaksanız siparişin faturasını koli yola çıkmadan kesmeniz gerekir. Yox İş Ortağım'da e-Fatura/e-Arşiv bağlantısı Profesyonel paketten itibaren siparişe otomatik fatura keser; örneğin GİB e-Arşiv Portal bağlantısı ya da başka bir e-Fatura programı bağlıysa fatura siparişle birlikte hazır olur. ETGB işaretlemesi ise ShipEntegra tarafındaki bir işlemdir ve bu bağlantının panel yetenekleri arasında yer almaz; ETGB'li gönderilerde ShipEntegra hesabınızdaki adımı atlamayın.

Varış ülkesinde vergi: ABD, AB ve Birleşik Krallık'ta 2026 itibarıyla geçerli kurallar

Türkiye'den çıkış ETGB ile kolaylaşsa da gümrük vergisi ve KDV varış ülkesinde doğar ve ödenmezse sorumluluk göndericiye döner: ShipEntegra'nın SSS'sine göre alıcı vergiyi ödemezse ödeme sorumluluğu size aittir. Ekim 2026 itibarıyla üç büyük pazarda kurallar şöyledir:

Gönderim tipleri ne anlama gelir?

• DDP: vergi ve harçları gönderici öder; alıcı teslimatta ödeme yapmaz, maliyeti fiyata katmanız gerekir.
• DDU: vergi alıcıya yansır; alıcı ödemezse koli bekler ya da geri döner ve bedel size kalır.
• IOSS ve ShipEntegra IOSS: AB satışında KDV'nin satış anında tahsil edildiği düzen; numara pazaryerine, size ya da ShipEntegra'ya ait olabilir.
• HMRC ve VOEC: Birleşik Krallık ve Norveç için kullanılan vergi numaraları; API'de aynı alana yazılır.

Almanya'ya gönderide ambalaj yasası seçeneği

ShipEntegra etiket uç noktasında Almanya'nın ambalaj yasası (Verpackungsgesetz) için ayrı bir seçenek bulunur: yasayı bildiğinizi ve süreci kendiniz yürüteceğinizi beyan edebilir ya da ek ücret karşılığında işlemleri ShipEntegra'ya bırakabilirsiniz. Almanya'ya düzenli satıyorsanız bu kararı ilk gönderiden önce verin.

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

ShipEntegra entegrasyonu Büyüme paketinden itibaren kullanılır; Başlangıç paketinde kargo bağlantısı yoktur ve takip numarası elle girilir. ShipEntegra panelde bir kargo firması bağlantısı olarak sayılır. Yox İş Ortağım'da 80 satış kanalı (48'i kullanıma hazır), 57 kargo ve lojistik firması, 51 muhasebe, e-Fatura ve ERP programı tanımlıdır; tam liste entegrasyon ana sayfasında.

Yıllık ödemede %20 indirim uygulanır. Etsy, eBay ve Amazon'u bağlayıp yalnız ShipEntegra ile gönderecekseniz Büyüme paketi kanal ve kargo sayısı olarak yeter; ama ETGB için faturanın siparişle otomatik kesilmesini istiyorsanız e-Fatura bağlantısı Profesyonel pakette başlar. Paketlerin ayrıntılı karşılaştırması paketler bölümünde; 3 günlük ücretsiz deneme için Yox İş Ortağım'a başvurabilirsiniz.

ShipEntegra gönderilerinde canlıya geçmeden önce kontrol listesi ve sık hatalar

Yurt dışı gönderide hata, yurt içinden pahalıdır: yanlış adres ya da eksik gümrük bilgisi kolinin başka bir ülkede beklemesi ve geri dönüş masrafı demektir. Çoğu hata gönderi açılmadan önce düzeltilebilir.

İlk siparişten önce kontrol listesi

• Canlı hesaba ait Client Id ve Client Secret panele girildi, bağlantı testi geçti.
• Ürünlerin gümrükte kullanılacak kısa ve anlaşılır tanımı ile GTİP kodu hazır.
• Mikro ihracat yapacaksanız fatura sırası belli: önce fatura, sonra ETGB işaretleme, sonra kolinin teslimi.
• Hangi mağazanın siparişinin hangi ekrandan gönderileceği kararlaştırıldı; aynı mağaza için tek bildirim yolu var.
• ABD siparişleri için DDP ya da DDU kararı ve AB'ye satıyorsanız IOSS numarasının kime ait olduğu netleşti.

Sık yapılan hatalar ve önlemleri

• Pazaryeri başlığını gümrük tanımı olarak kullanmak: anahtar kelimeyle dolu uzun başlık yerine “cotton t-shirt” gibi sade bir tanım yazın.
• Adres satırında nokta, eğik çizgi ya da # kullanmak: dokümanın biçim kuralına takılır; adresi iki satıra bölün.
• Paket ölçüsünü girmemek: ücret, ölçüden hesaplanan hacimsel ağırlıkla değişir; tartı ağırlığı tek başına yetmez.
• Eko servisi sigortalı sanmak: eko servis sigortasızdır ve yalnız ABD'ye 0,5 kg/desi altındaki koliler için geçerlidir.
• Müşteriye etiketteki numarayı verip son taşıyıcıyı unutmak: kargo hareketlerinde son teslimatı yapan taşıyıcının numarası ayrıca görünür.