E-Ticarette Kargo Entegrasyonu ve Takip Sistemi Kurulumu

Kargo entegrasyonu, e-ticaret sitenizdeki sipariş bilgilerini kargo firmasının sistemine otomatik aktaran bağlantıdır. Kurulduğunda gönderiyi elle yazmadan oluşturursunuz, barkodu panelden yazdırırsınız, takip numarası siparişe kendiliğinden işlenir ve teslim durumu geri gelir. Kurmak için önce kargo firmasıyla kurumsal sözleşme yapar, firmadan entegrasyon (web servis) erişimi alır, ardından bu bilgileri mağaza altyapınıza tanımlarsınız.

Bu yazıda anlaşma aşamasında neleri netleştirmeniz gerektiğini, entegrasyonun teknik olarak ne yaptığını, doğrudan bağlantı ile kargo entegratörü arasındaki farkı, müşteriye takip bilgisini nasıl ileteceğinizi ve iade kargosunun yasal çerçevesini bulacaksınız.

Kargo entegrasyonu ne sağlar?

İş	Entegrasyon yoksa	Entegrasyon varsa
Gönderi kaydı	Alıcı adı, adres ve telefon şubede veya firmanın web panelinde tek tek girilir	Sipariş bilgileri (alıcı, adres, telefon, parça sayısı, desi, kapıda ödeme tutarı) otomatik aktarılır
Barkod ve etiket	Her gönderi için ayrı işlem	Seçilen siparişler için toplu yazdırma
Takip numarası	Elle kopyalanıp müşteriye gönderilir	Siparişe işlenir, müşteri bildirimine eklenir
Teslim durumu	Firmanın sitesinden tek tek sorgulanır	Durumlar düzenli olarak çekilir; teslim edildi, teslim edilemedi, iade gibi
Mutabakat	Fatura gelince elle kontrol	Kapıda ödeme tahsilatları ve iadeler raporlanır

Kargo firmalarının kendi dokümanları da bu kapsamı tarif ediyor. Yurtiçi Kargo'nun entegrasyon portalında gönderi oluşturma (createShipment), sipariş numarasıyla teslim bilgisi sorgulama (queryShipment) ve giden/gelen gönderi, tahsilatlı gönderi ve iade raporları için ayrı web servisler anlatılır. DHL eCommerce Türkiye de kargo sipariş web servisleri ile gönderi talebi oluşturmayı, raporlama web servisleri ile gönderi durumunu kendi sitenizde göstermeyi sunar.

Adım 1: Kargo firmasıyla kurumsal anlaşma nasıl yapılır?

Entegrasyon erişimi genellikle sözleşmeli müşterilere verilir. Bu yüzden ilk adım anlaşmadır.

Hacminizi çıkarın. Aylık tahmini gönderi adedi, ortalama desi, kapıda ödeme oranı ve teslimat yaptığınız bölgeler teklif için gereken temel bilgilerdir. Desi hesaplamak için desi hesaplama aracını kullanabilirsiniz.
Birden fazla firmadan teklif isteyin. Teklifler bölge şubesi veya kurumsal satış ekibi üzerinden gelir.
Teklifte şunları yazılı olarak netleştirin:

- desi baremli fiyat listesi ve KDV'nin dahil olup olmadığı,

- adresten alım (kurye) olup olmadığı ve saatleri,

- kapıda ödeme hizmet bedeli ve tahsil edilen paranın hesabınıza geçiş süresi,

- iade gönderilerinin fiyatı ve anlaşmalı iade kodu,

- ağır gönderi ve uzak bölge ek ücretleri,

- hasar ve kayıpta tazmin şartları,

- faturalama dönemi,

- entegrasyon dokümanı, test ortamı ve teknik destek.

Sözleşmeyi imzalayın ve entegrasyon bilgilerinizi isteyin. Müşteri numaranız ile web servis kullanıcı bilgileri bu aşamada verilir. Yurtiçi Kargo'da süreç, web servis erişim yetkilendirmesiyle başlar ve dokümanlar satış temsilcisi tarafından paylaşılır.

Not: MNG Kargo, Mayıs 2025'ten bu yana DHL eCommerce adıyla hizmet veriyor. Eski sözleşmeniz veya entegrasyonunuz varsa güncel bağlantı bilgilerini firmayla teyit edin.

Adım 2: API entegrasyonu nasıl kurulur?

Test ortamında gönderi oluşturun. Yurtiçi Kargo, gönderi verisinin önce test ortamına gönderilmesini ve kontrol edilmesini ister. Diğer firmalarda da canlıya geçmeden önce birkaç deneme gönderisi oluşturun.
Sipariş numarasıyla eşleştirin. Her gönderi sizin sipariş numaranızla eşleşmeli. Takip ve iade süreçleri bu eşleşmeye dayanır.
Barkod yazıcıyı kurun. Etiket boyutunu ve yazıcı ayarını firmanın teknik desteğiyle doğrulayın.
Durum güncellemesini planlayın. Durumların ne sıklıkla çekileceğini ve hangi durumda müşteriye bildirim gideceğini belirleyin.
Hata durumlarını tanımlayın. Eksik adres, hatalı il-ilçe veya geçersiz telefon gibi nedenlerle gönderi oluşturulamazsa sipariş "bekliyor" durumunda kalmalı ve size uyarı düşmeli.
İade gönderilerini de bağlayın. İade etiketi veya iade kodu, iade talebiyle birlikte oluşturulmalı.

Web servisleri doğrudan kullanmak yazılım geliştirmeyi gerektirir. Yurtiçi Kargo'nun portalı bunu açıkça belirtir ve küçük satıcılar için gönderi hazırlama, etiketleme ve kurye çağırmayı yapan bir web uygulaması da sunar. Hazır bir e-ticaret altyapısı kullanıyorsanız bu bağlantı genellikle bir ayar ekranıyla kurulur: firmanın verdiği bilgileri girip test gönderisi oluşturursunuz.

Doğrudan entegrasyon mu, kargo entegratörü mü?

Kargo entegratörleri, tek bir panel veya API üzerinden birden fazla kargo firmasına bağlanan aracı hizmetlerdir. Bazıları kendi toplu anlaşma fiyatlarını sunar, bazıları sizin mevcut anlaşmanızı bağlar. İki yolun da yeri var.

Konu	Kargo firmasıyla doğrudan	Kargo entegratörü üzerinden
Sözleşme	Kargo firmasıyla siz yaparsınız	Entegratörle yaparsınız; modele göre kargo firmasıyla ayrıca sözleşme gerekebilir
Fiyat	Hacminize göre pazarlık edersiniz	Entegratörün fiyat listesi veya kendi anlaşmanız; düşük hacimde avantajlı olabilir
Birden çok firma	Her firma için ayrı kurulum	Tek bağlantıyla birden fazla firma
Destek	Doğrudan kargo firması	Sorun çıktığında zincir uzar: siz, entegratör, kargo firması
Ek maliyet	Genellikle yok	Hizmet ücreti veya gönderi başı fark olabilir

Hangi modeli seçerseniz seçin üç konuyu yazılı alın: kapıda ödeme tahsilatının kime ve ne zaman yatırıldığı, hasar ve kayıpta tazmini kimin üstlendiği, sözleşme bittiğinde gönderi verilerinize nasıl erişeceğiniz. Firmaları karşılaştırmak için Türkiye'de kargo firmaları karşılaştırması yazımıza bakabilirsiniz.

Müşteriye takip bilgisini nasıl iletmelisiniz?

Kargoya verildiğinde bildirim gönderin. E-posta veya SMS'te kargo firmasının adı, takip numarası ve takip bağlantısı olsun.
Üyelik gerektirmeyen bir sipariş takip sayfası sunun. Misafir olarak alışveriş eden müşteri, sipariş numarası ve e-postasıyla durumu görebilmeli.
Önemli durum değişikliklerini bildirin. Dağıtıma çıktı, teslim edildi ve teslim edilemedi durumları en çok sorulan sorulardır.
Gönderim süresini ürün sayfasında yazın. Mesafeli Sözleşmeler Yönetmeliği'ne göre satıcı, taahhüt ettiği sürede teslim etmek zorundadır ve bu süre mal satışlarında otuz günü geçemez.

Bildirimlerin hukuki tarafı da önemlidir. Ticari İletişim ve Ticari Elektronik İletiler Hakkında Yönetmelik'e göre satın alma ve teslimat bildirimleri için önceden onay aranmaz. Aynı madde, bu iletilerde herhangi bir mal veya hizmetin tanıtımının yapılamayacağını da söyler. Kargo bildiriminize kampanya veya indirim kodu eklemeyin; tanıtım mesajları için ayrı onay gerekir.

Kayıp ve hasar sorumluluğunu da bilin. Yönetmeliğe göre satıcı, mal tüketiciye veya tüketicinin belirlediği (taşıyıcı dışındaki) bir kişiye teslim edilene kadar oluşan kayıp ve hasardan sorumludur. Kargo firmasındaki hasar sizin sorununuzdur; bu yüzden tazmin şartlarını sözleşmede netleştirin.

İade kargosu nasıl yönetilir?

Mesafeli Sözleşmeler Yönetmeliği'nin iade kargosuyla ilgili kuralları 1 Ocak 2026'da değişti. Güncel metne göre temel kurallar şunlardır:

Tüketici, malı teslim aldığı günden itibaren on dört gün içinde gerekçe göstermeden cayma hakkını kullanabilir.
Satıcı malı geri almayı teklif etmediyse tüketici, cayma bildiriminden itibaren on dört gün içinde malı geri gönderir.
Satıcı, iade edilen malın ön bilgilendirmede belirtilen taşıyıcıya teslim edildiği tarihten itibaren on dört gün içinde tahsil ettiği tüm ödemeleri iade eder.
Ürün, satıcının ön bilgilendirmede iade için belirttiği taşıyıcıyla gönderilirse iade masrafı tüketiciye yüklenemez. Taşıyıcı belirtilmemişse tüketiciden iade masrafı istenemez.

Uygulamada bu, ön bilgilendirme formunda ve iade sayfanızda anlaşmalı iade firmanızı ve iade kodunu açıkça yazmanız demektir. Para iadesi için süre, iade paketinin taşıyıcıya teslim edildiği gün başladığından iade gönderisini de entegrasyonla takip etmek önemlidir; böylece paket kargoya verildiği anda süreyi görürsünüz. İade sürecinin tamamı için iade yönetimi rehberine bakabilirsiniz.

Teramerce'de kargo gönderimi

Teramerce'de Yurtiçi, Aras, MNG, PTT ve Sürat Kargo ile kendi anlaşmanız geçerlidir: gönderiyi kargo firmasının sisteminden açar, takip numarasını siparişe girersiniz; müşteri takip bilgisini e-posta ve isterseniz SMS ile alır. Panelden otomatik gönderi ve etiket yakında. Kargo sözleşmesi ve fiyatları mağazanızın kendi hesabındadır. Müşterileriniz siparişlerini üye olmadan da takip edebilir.

Sık Sorulan Sorular

Kargo entegrasyonu için yazılım bilmem gerekir mi?

Kargo firmasının web servislerine doğrudan bağlanacaksanız evet; bu iş yazılım geliştirme gerektirir. Hazır bir e-ticaret altyapısı veya kargo entegratörü kullanıyorsanız genellikle firmanın verdiği müşteri ve kullanıcı bilgilerini bir ayar ekranına girmeniz yeterlidir.

Kargo entegrasyonu ücretli mi?

Kargo firmaları entegrasyon erişimini genellikle sözleşmeli müşterilerine verir. Ayrı bir ücret olup olmadığı firmaya ve anlaşmaya göre değişir. Teklif aşamasında entegrasyon, test ortamı ve teknik destek koşullarını sorun.

Birden fazla kargo firmasıyla çalışabilir miyim?

Evet. Her firmayla ayrı anlaşma yapıp altyapınızda birden fazla firma tanımlayabilir ya da bir kargo entegratörü üzerinden çalışabilirsiniz. Bölgeye veya ürün boyutuna göre firma seçmek maliyeti düşürebilir, ancak operasyonu ve mutabakatı karmaşıklaştırır.

Takip numarası müşteriye ne zaman gönderilmeli?

Gönderi kargo firmasının sistemine kaydedildiğinde gönderin. Paket şubeye teslim edilmeden takip ekranında bilgi görünmeyebilir. Bu yüzden ilk mesajda paketin hangi gün kargoya verileceğini de yazmak müşteri sorularını azaltır.

Kargoda kaybolan veya hasar gören üründen kim sorumlu?

Mesafeli Sözleşmeler Yönetmeliği'ne göre ürün tüketiciye teslim edilene kadar oluşan kayıp ve hasardan satıcı sorumludur. Müşteriye yeni ürün gönderir veya ücreti iade edersiniz; kargo firmasından tazmini ise sözleşmenizdeki şartlarla talep edersiniz.

İade kargo ücretini müşteriye yansıtabilir miyim?

Cayma hakkı kapsamındaki iadelerde, ürün sizin ön bilgilendirmede belirttiğiniz taşıyıcıyla gönderilirse iade masrafını müşteriden isteyemezsiniz. Taşıyıcı belirtmediyseniz de iade masrafı talep edemezsiniz. Bu yüzden anlaşmalı bir iade firması ve kodu belirlemek en sağlıklı yoldur.

Kaynaklar

Bu yazı genel bilgilendirme amaçlıdır; kendi durumunuz için mali müşavirinize veya avukatınıza danışın.

E-Ticarette Kargo Entegrasyonu ve Kargo Takibi Nasıl Kurulur?