Shopify PTT Kargo ve Sürat Kargo Entegrasyonu Nasıl Yapılır?

Shopify PTT Kargo Entegrasyonu Nedir? Shopify PTT Kargo entegrasyonu, PTT Kargo’nun kurumsal API’sini bir yazılım katmanı üzerinden Shopify mağazasına bağlayarak, özellikle kırsal ve köy bölgelerine yapılan gönderilerde otomatik kargo kaydı ve takip numarası oluşturulmasını sağlayan teknik süreçtir.

PTT Kargo, Türkiye Cumhuriyeti’nin resmi posta idaresi olarak köy ve kırsal bölgede diğer özel kargo firmalarının şubesi bulunmayan noktalara teslimat yapabilen tek büyük ölçekli ağa sahiptir (PTT Kurumsal, 2025). Bu kapsama avantajı, rakip içeriklerin çoğunlukla atladığı bir noktadır çünkü büyükşehir odaklı mağazalar için PTT Kargo öncelikli tercih değildir. Kırsal bölgeye satış yapan bir mağaza için ise bu kapsama alanı, teslimat başarısızlığını doğrudan azaltan tek fark olabilir.

Sürat Kargo ise farklı bir konumda durur büyükşehir ve orta ölçekli şehirlerde e-ticaret odaklı hızlı teslimat sunar ama Shopify bağlantısı için mutlaka bir entegratör firma gerektirir. Bu rehber iki firmanın entegrasyon sürecini ve büyük kargo firmalarına göre farkını derinlemesine ele alır.

PTT Kargo’nun Kurumsal API’si Nasıl Kurulur?

PTT Kargo kurumsal API’si, PTT’nin e-ticaret kurumsal müşteri portalı üzerinden anlaşma yapıldıktan sonra API kullanıcı bilgileri talep edilerek etkinleştirilir; bu süreç özel kargo firmalarına kıyasla daha fazla evrak ve onay adımı içerir.

PTT, kamu kurumu statüsünde olduğu için kurumsal anlaşma süreci özel şirketlere göre daha standardize ama daha yavaş ilerler. Buna karşın API’nin sunduğu kapsama alanı, diğer hiçbir firmanın ulaşmadığı kırsal noktalara erişim sağlar.

1. PTT Kargo Kurumsal E-ticaret başvuru formu doldurulur ve şirket evrakları yüklenir.
2. Anlaşma onayı sonrası PTT API kullanıcı kodu ve şifre bilgisi kurumsal e-posta üzerinden iletilir.
3. Shopify tarafında özel bir API entegrasyonu geliştirilir (doğrudan Shopify App’i sınırlı olduğu için genelde webhook tabanlı özel yazılım gerekir).
4. Sandbox ortamında örnek gönderi kaydı oluşturularak API bağlantısı doğrulanır.
5. Canlı ortama geçiş sonrası ilk gerçek gönderi barkodunun şubede okunabilirliği fiziksel olarak test edilir.

İpucu: PTT Kargo anlaşma başvurusunda “e-ticaret kurumsal” kategorisi seçilmelidir; genel bireysel gönderi hesabı API erişimine açılmaz. Kategori yanlış seçildiğinde başvuru süreci baştan başlatılır.

Sürat Kargo Neden Entegratör Firma Gerektirir?

Sürat Kargo, PTT Kargo gibi kurumsal API’sini doğrudan üçüncü taraf yazılımlara açık bir dokümantasyonla sunmaz; Shopify bağlantısı bu yüzden bir entegratör firma üzerinden kurulur ve doğrudan özel geliştirme seçeneği sınırlıdır.

Bu yapı, Sürat Kargo’yu kullanmak isteyen mağazaları entegratör firma seçimine yönlendirir. Entegratör firmalar Sürat Kargo API’sine kendi anlaşmaları üzerinden erişip mağazaya bir arayüz sunar; mağaza sahibi doğrudan Sürat Kargo ile teknik entegrasyon detaylarıyla uğraşmaz.

Peki bu fark pratikte ne anlama geliyor? Sürat Kargo kullanmak isteyen bir mağaza sahibi, kendi geliştiricisiyle özel entegrasyon kurmak yerine mutlaka bir entegratör uygulama aboneliği almak zorunda kalır bu da aylık maliyet kalemini PTT Kargo’ya kıyasla farklı bir yapıya sokar.

Kritik Not: Sürat Kargo için entegratör firma seçilirken firmanın Sürat Kargo ile aktif bir API ortaklığı olduğu mutlaka teyit edilmelidir. Bazı entegratörler Sürat Kargo’yu listelerinde gösterse de gerçek zamanlı durum güncellemesini desteklemez, sadece etiket oluşturma sunar.

PTT Kargo ve Sürat Kargo Büyük Kargo Firmalarından Nasıl Ayrışır?

PTT Kargo ve Sürat Kargo, Yurtiçi Kargo, Aras Kargo ve MNG Kargo’ya kıyasla üç noktada ayrışır: kapsama alanı, entegrasyon yöntemi ve maliyet yapısı. PTT Kargo kırsal bölgede kapsama üstünlüğü sunarken, Sürat Kargo şehir içi hızlı teslimatta rekabetçi konumdadır.

Bu farklar, mağaza sahibinin tek bir kargo firmasıyla sınırlı kalmaması gerektiğini gösterir. Kırsal bölgeye yoğun satış yapan bir mağaza, büyükşehir siparişleri için Aras Kargo veya Yurtiçi Kargo kullanırken, köy bölgesi siparişleri için PTT Kargo’ya yönlendirme yapabilir.

Uzak Durulması Gereken Risk: PTT Kargo’yu yalnızca maliyet avantajı için büyükşehir siparişlerinde kullanmak, 1-2 iş günü kazanılabilecek teslimat süresini 2-4 güne uzatabilir. PTT Kargo, kapsama alanı diğer firmaların ulaşmadığı bölgeler için tercih edilmelidir genel amaçlı ana kargo firması olarak değil.

Maliyet ve Kapsama Dengesi Nasıl Kurulur?

Maliyet ve kapsama dengesi, mağazanın sipariş coğrafyasının analiz edilip hangi bölgelerde hangi firmanın avantajlı olduğunun belirlenmesiyle kurulur; tek firma yerine bölgeye göre çoklu kargo stratejisi toplam teslimat başarısızlığını düşürür.

Bir mağaza siparişlerinin yüzde 15’i kırsal bölgeden geliyorsa ve bu bölgelerde büyük kargo firmalarının şubesi yoksa, bu siparişlerin özel kargo firmasıyla gönderilmesi teslim edilemeyen paket oranını yükseltir. PTT Kargo’nun devreye alınması bu segmentte doğrudan çözüm sunar.

Bu tür bölgesel kargo stratejisi, genel kargo entegrasyon yöntemleri ve karşılaştırma kriterleri kapsamında Shopify kargo entegrasyonu rehberinde daha geniş ele alınır. Büyükşehir odaklı siparişler için Yurtiçi Kargo’nun kurulum adımları Shopify yurtiçi kargo entegrasyonu rehberinde, Aras Kargo süreci ise Shopify Aras Kargo entegrasyonu rehberinde anlatılır.

PTT Kargo ve Sürat Kargo İçin Takip Bildirimi Nasıl Kurulur?

PTT Kargo ve Sürat Kargo için takip bildirimi, kargo firmasından gelen durum güncellemesinin Shopify sipariş kaydına yazılıp otomatik müşteri bildirimini tetiklemesiyle kurulur; bu süreç diğer kargo firmalarıyla aynı Fulfillment API mantığını kullanır.

PTT Kargo’nun API’si durum güncellemelerini daha seyrek aralıklarla gönderebilir çünkü kırsal bölgede tarama noktası yoğunluğu düşüktür. Bu, müşteriye “dağıtıma çıktı” bildiriminin diğer firmalara göre biraz daha geç ulaşmasına neden olabilir.

Fulfillment API’nin çalışma mantığı, webhook yapılandırması ve Shopify Flow ile otomatik bildirim kurulumunun adım adım anlatımı kargo takip numarası otomatik oluşturma rehberinde yer alır.

PTT Kargo ve Sürat Kargo Fiyatlandırma Yapısı Nasıl Karşılaştırılır?

PTT Kargo ve Sürat Kargo arasındaki fiyatlandırma farkı, ağırlık/desi tarifesinden çok anlaşma yapısından kaynaklanır; PTT Kargo kamu tarifesine yakın sabit bir yapı sunarken Sürat Kargo entegratör firma üzerinden pazarlığa açık bir hacim indirimi modeli işletir.

PTT Kargo’nun kurumsal e-ticaret tarifesi, gönderi hacmine göre kademeli indirim sunar ama bu indirim oranları özel kargo firmalarına kıyasla daha az esnek bir bant içinde kalır. Sürat Kargo’da ise fiyat, mağazanın çalıştığı entegratör firmanın kendi Sürat Kargo ile yaptığı toplu anlaşmadan pay alma şeklinde belirlenir; bu yüzden aynı hacimdeki iki mağaza farklı entegratörler üzerinden farklı birim fiyat alabilir.

İpucu: Sürat Kargo kullanmayı planlayan bir mağaza, tek bir entegratör firmadan teklif almak yerine en az iki entegratörden fiyat karşılaştırması yapmalıdır. Aynı Sürat Kargo hizmeti, farklı entegratörler üzerinden farklı birim fiyatla sunulabilir çünkü fiyat entegratörün kendi toplu anlaşmasından türetilir.

Kırsal Bölgeye Satış Yapan Mağazalar İçin Operasyonel Öneri

Kırsal bölgeye satış yapan bir mağaza için en pratik yaklaşım, tek bir kargo firmasına bağlı kalmak yerine sipariş adresine göre otomatik firma seçimi yapan bir kural tanımlamaktır; bu kural büyükşehir siparişlerini hızlı firmalara, kırsal siparişleri PTT Kargo’ya yönlendirir.

Sipariş adresindeki il/ilçe bilgisi, entegrasyon aracında önceden tanımlanmış bir “kırsal bölge listesi” ile karşılaştırılabilir. Adres bu listede yer alıyorsa sipariş otomatik PTT Kargo’ya, yer almıyorsa varsayılan hızlı kargo firmasına yönlendirilir. Bu kural, mağaza sahibinin her siparişte manuel karar vermesini ortadan kaldırır.

Sahada gözlemlenen bir örnek, kırsal bölge siparişlerinin yüzde 20’sini oluşturduğu bir mağazada, bu siparişlerin özel kargo firmasıyla gönderilmeye devam edilmesi teslim edilemeyen paket oranını yükseltmiş; adrese göre otomatik PTT Kargo yönlendirmesi kurulduktan sonra bu segmentteki teslim edilemeyen paket oranı gözle görülür şekilde düşmüştür.

Kritik Not: Kırsal bölge listesi statik tutulmamalı, zaman içinde hangi bölgelerde teslimat sorunu yaşandığı verisiyle güncellenmelidir. Bir bölgede özel kargo firması başarılı teslimat yapıyorsa o bölgeyi PTT Kargo’ya yönlendirmek gereksiz bir teslimat süresi uzaması yaratır.

PTT Kargo API Dokümantasyonuna Nasıl Erişilir ve Neler İçerir?

PTT Kargo API dokümantasyonuna, kurumsal e-ticaret anlaşması onaylandıktan sonra PTT’nin kurumsal müşteri portalı üzerinden erişilir; dokümantasyon gönderi oluşturma, barkod üretme ve durum sorgulama olmak üzere temel üç uç noktayı tanımlar ama özel kargo firmalarına kıyasla daha az sayıda ara durum bildirimi sunar.

PTT’nin kamu kurumu yapısı, API’nin güncellenme sıklığını da etkiler; özel kargo firmaları API’lerini yılda birkaç kez güncelleyip yeni özellik eklerken PTT Kargo API’si daha durağan bir yapıda kalır. Bu durağanlık, entegrasyon aracının PTT tarafında sık değişiklik riskiyle uğraşmaması açısından avantajlı görülebilir, ama yeni özellik taleplerinin (örneğin daha sık durum güncellemesi) karşılanması daha uzun sürebilir.

İpucu: PTT Kargo API’sine yeni entegrasyon kuran ekipler, dokümantasyonun İngilizce değil yalnızca Türkçe sunulduğunu ve örnek kod parçalarının sınırlı olduğunu göz önünde bulundurmalıdır. Entegrasyon süresi tahmini yapılırken bu dokümantasyon eksikliği ek zaman payı olarak hesaba katılmalıdır.

Sürat Kargo Entegratör Firma Seçerken Nelere Dikkat Edilmeli?

Sürat Kargo için entegratör firma seçerken üç kriter öncelikli değerlendirilmelidir: API ortaklığının güncelliği, durum güncelleme sıklığı ve destek yanıt süresi; bu üç kriter, günlük operasyonda entegratörün gerçek performansını belirler.

API ortaklığının güncelliği, entegratörün Sürat Kargo ile doğrudan ve aktif bir teknik anlaşması olup olmadığını gösterir. Bazı entegratörler, Sürat Kargo’yu yalnızca listede göstermek için eski bir anlaşmaya dayanır ve gerçek zamanlı durum güncellemesi yerine günde birkaç kez toplu senkronizasyon yapar bu, müşteri bildirimlerinin saatlerce gecikmesine yol açabilir.

1. Entegratörün Sürat Kargo ile aktif API ortaklığı olduğu, referans mağaza örnekleriyle teyit edilir.
2. Durum güncelleme sıklığı (gerçek zamanlı mı, periyodik mi) sözleşme öncesi netleştirilir.
3. Destek ekibinin ortalama yanıt süresi, özellikle kargo kesintisi yaşanan günlerde sorgulanır.
4. Aylık abonelik ücretine ek olarak işlem başına ücret olup olmadığı yazılı teklif üzerinden karşılaştırılır.

Uzak Durulması Gereken Risk: Yalnızca aylık abonelik ücretine bakarak entegratör seçmek, işlem başına gizli ücretlerin toplam maliyeti kurulum sonrası önemli ölçüde yükseltmesine yol açabilir. Teklif karşılaştırmasında aylık sipariş hacmine göre projekte edilmiş toplam maliyet esas alınmalıdır.

PTT Kargo ve Sürat Kargo Entegrasyonunda İade Süreci Nasıl İşler?

PTT Kargo iade süreci, müşterinin ürünü en yakın PTT şubesine teslim etmesiyle başlar ve bu iade gönderisi orijinal sipariş takip numarasından bağımsız yeni bir gönderi numarası alır; Sürat Kargo’da ise iade süreci genelde kullanılan entegratör firmanın kendi iade modülü üzerinden yönetilir.

PTT Kargo’nun kırsal bölgedeki geniş şube ağı, iade sürecinde de bir avantaj sağlar müşteri, özel kargo firmasının şubesi bulunmayan bir bölgede yaşıyorsa iade paketini yine de en yakın PTT şubesine teslim edebilir. Bu, kırsal bölgeden alışveriş yapan müşteriler için iade sürecini fiilen daha erişilebilir kılar.

İpucu: Kırsal bölgeye satış yapan mağazalar, iade politikasında “PTT Kargo şubesinden iade kabul edilir” ibaresini açıkça belirtmelidir. Bu, özel kargo şubesi bulunmayan bölgedeki müşterinin iade sürecini nereden başlatacağını bilmemesi nedeniyle iade talebinden vazgeçmesini önler.

PTT Kargo ve Sürat Kargo Takip Bildirim Sıklığı Neden Farklı?

PTT Kargo ve Sürat Kargo arasındaki takip bildirim sıklığı farkı, iki firmanın tarama noktası altyapısının yoğunluğundan kaynaklanır; PTT Kargo kırsal bölgede az sayıda tarama noktasına sahipken Sürat Kargo şehir içi yoğun tarama ağı sayesinde daha sık durum güncellemesi üretir.

Bir gönderi, tarama noktasından geçtiğinde sistemde bir durum güncellemesi oluşturur. Sürat Kargo’nun şehir merkezinde daha sık aralıklarla konumlanan tarama noktaları, gönderinin “dağıtıma çıktı” veya “yolda” gibi ara durumlarını daha sık yakalar. PTT Kargo’da kırsal güzergahta tarama noktası seyrek olduğu için gönderi, iki tarama arasında uzun bir süre “yolda” durumunda görünmeye devam edebilir.

Peki bu fark müşteri beklentisini nasıl etkiler? Sürat Kargo ile gönderim yapan bir müşteri sık aralıklarla durum güncellemesi görmeye alışkın olduğu için, PTT Kargo ile kırsal bölgeye giden bir gönderide durum güncellemesinin seyrek gelmesini “sorun var” şeklinde yorumlayabilir; bu algı farkı, sipariş onay e-postasında PTT Kargo için ayrı bir açıklama notu eklenerek yönetilebilir.

İpucu: PTT Kargo ile gönderim yapılan siparişlerin bildirim e-postasına “kırsal bölge teslimatlarında durum güncellemeleri daha seyrek aralıklarla gelebilir” notunun eklenmesi, gereksiz destek talebini azaltan düşük maliyetli bir önlemdir.

Sık Sorulan Sorular

PTT Kargo’nun resmi Shopify uygulaması var mı? Hayır, doğrudan Shopify App Store’da resmi PTT Kargo uygulaması sınırlıdır. Entegrasyon kurumsal API üzerinden özel yazılım geliştirmesiyle kurulur.

Sürat Kargo Shopify’a doğrudan API ile bağlanabilir mi? Hayır, Sürat Kargo bağlantısı yalnızca entegratör firma üzerinden kurulur. Doğrudan özel API geliştirmesi seçeneği yaygın olarak sunulmaz.

PTT Kargo hangi bölgelerde tercih edilmeli? Kırsal, köy ve diğer kargo firmalarının şubesi olmayan bölgelerde tercih edilmelidir. Büyükşehir siparişlerinde teslimat süresi diğer firmalara göre daha uzundur.

PTT Kargo ve Sürat Kargo aynı mağazada birlikte kullanılabilir mi? Evet, bölgeye göre otomatik kargo firması seçimi yapan bir entegrasyon kurulursa iki firma birlikte kullanılabilir. Bu, kapsama alanı ile hız avantajını aynı anda değerlendirmeyi sağlar.

PTT Kargo kurumsal anlaşma süreci neden daha uzun sürüyor? PTT kamu kurumu statüsünde olduğu için evrak ve onay süreci özel şirketlere göre daha fazla adım içerir. Ortalama süreç özel kargo firmalarına kıyasla birkaç iş günü daha uzayabilir.

Küçük bir mağaza için PTT Kargo entegrasyonuna değer mi? Sipariş coğrafyasının önemli bir kısmı kırsal bölgeden geliyorsa evet, değer. Siparişler büyükşehir merkezli ise PTT Kargo yerine Yurtiçi Kargo veya Aras Kargo daha hızlı teslimat sağlar.

Sürat Kargo fiyatı neden entegratöre göre değişiyor? Fiyat, entegratör firmanın Sürat Kargo ile yaptığı toplu hacim anlaşmasından türetilir. Farklı entegratörler farklı hacim kademesinde anlaşma yapmış olabileceği için aynı hizmet farklı birim fiyatla sunulabilir.

PTT Kargo’dan iade kabul edilir mi? Evet, müşteri iade paketini en yakın PTT şubesine teslim edebilir ve bu gönderi ayrı bir takip numarasıyla izlenir. Kırsal bölgede özel kargo şubesi olmayan müşteriler için bu, iade sürecini kolaylaştıran bir seçenektir.

Sonraki Adım

PTT Kargo veya Sürat Kargo entegrasyonu tamamlandıktan sonra kargo takip bilgisinin müşteriye otomatik ulaştırılması gerekir. Bu bildirim akışının Fulfillment API ve Shopify Flow ile nasıl kurulacağı kargo takip numarası otomatik oluşturma rehberinde adım adım anlatılır.