Kısa cevap
PTT Kargo Shopify entegrasyonu, Shopify’a düşen siparişlerin PTT’nin web servislerine otomatik gönderilip barkod ve etiket oluşturulması, gönderi PTT şubesine kabul edildikten sonra takip numarasının Shopify’daki fulfillment kaydına yazılması ve müşteriye bildirim gitmesidir. Bağlantı; App Store’daki hazır bir uygulama, bir kargo toplayıcı (aggregator) platform veya PTT’nin web servislerine doğrudan bağlanan özel bir ara katmanla kurulur.
PTT’yi diğer kargo firmalarından ayıran şey, şube ağının kırsal bölgelere kadar uzanması ve kapıda ödemenin “ödeme şartlı gönderi” olarak çalışmasıdır. Hazır uygulamayla 2–5 iş gününde, ödeme şartlı gönderi ve ERP bağlantısı içeren özel geliştirmeyle 3–5 haftada canlıya geçilir. Her durumda önce PTT ile kurumsal sözleşme imzalanması ve müşteri numarası alınması gerekir.
Bu rehber, 2020’den bu yana Shopify markalarına hizmet veren Shopify Plus Partner’ı Byte Digital ekibinin saha deneyimiyle hazırlanmıştır.
PTT Kargo Shopify entegrasyonu ne yapar?
Entegrasyon, sipariş ile kargo arasındaki elle yapılan dört işi ortadan kaldırır: gönderi kaydı açmak, barkod basmak, takip numarasını siparişe yazmak ve teslim durumunu kontrol etmek. Genel kurgu için Shopify kargo entegrasyonu rehberimize bakabilirsiniz; PTT tarafında akış şöyledir:
Adım | Yön | Shopify tarafı | PTT tarafı |
|---|---|---|---|
Gönderi kaydı | Shopify → PTT | Order, FulfillmentOrder (alıcı adresi, ürünler, ağırlık) | Gönderi kaydı (kabul öncesi) |
Barkod ve etiket | PTT → Shopify | Uygulama veya ara katman etiketi basar | PTT’nin tanımladığı barkod aralığından barkod |
Takip numarası | PTT → Shopify | Fulfillment, trackingInfo (company, number, url) | Şubede fiziksel kabul sonrası sorgulanabilir |
Teslim durumu | PTT → Shopify | FulfillmentEvent (IN_TRANSIT, DELIVERED vb.) | Gönderi sorgulama servisi |
Ödeme şartlı tutar | Shopify → PTT | Kapıda ödeme siparişinin toplamı | Ödeme şartlı gönderi bedeli |
İade | İki yönlü | İade kaydı | İade barkodu veya iade gönderisi |
PTT’nin web servisleri uzun süredir SOAP (XML) tabanlıdır; gönderi kaydı, gönderi sorgulama ve kabul edilmemiş kaydın silinmesi gibi işlemler ayrı metotlarla yapılır. Erişim için PTT’nin verdiği müşteri numarası ve şifre kullanılır.
PTT’ye özgü kurallar: entegrasyonda nelere dikkat edilmeli?
PTT entegrasyonunu özel bir proje yapan şey, gönderi kaydı ile fiziksel kabulün ayrı iki aşama olmasıdır. Shopify tarafındaki otomasyon bu iki aşamaya göre kurgulanmalıdır.
Takip bilgisi kabulden sonra oluşur: Barkod siparişte hemen üretilir, ancak gönderi PTT şubesinde ya da toplama noktasında fiziksel olarak kabul edilmeden sorgulama servisinden anlamlı bir durum dönmez. Müşteriye “kargoya verildi” bildirimini barkod anında değil, kabul sonrası göndermek şikâyetleri azaltır.
Barkod aralığı: Kurumsal müşterilere PTT tarafından bir barkod aralığı tanımlanır. Ara katman bu aralıktan sıradaki barkodu üretir; aynı barkodun iki siparişe verilmemesi için sayaç tek bir yerde tutulmalıdır.
Ödeme şartlı gönderi (kapıda ödeme): PTT’de kapıda ödeme, tahsil edilecek tutarın gönderi kaydına “ödeme şartlı” olarak eklenmesiyle çalışır. Tutar Shopify sipariş toplamından alınmalı, kısmi iade veya indirim sonrası değişirse kayıt güncellenmelidir.
Desi ve ağırlık: Ücret, ağırlık ile hacimsel ağırlığın (desi) büyüğüne göre hesaplanır. Shopify’da varyant ağırlıkları boşsa ara katman sabit bir varsayılan desi gönderir ve faturalar sürpriz çıkar.
Adres yapısı: PTT il, ilçe ve mahalle düzeyinde çalışır. Shopify checkout’unda serbest metin olarak girilen ilçe ve mahalle bilgisinin PTT’nin referans listesine eşlenmesi gerekir; eşleşmeyen adresler kabul aşamasında takılır.
Shopify’da tanınan firma: “PTT”, Shopify’ın Türkiye için desteklediği takip firmaları arasında yer alır (Shopify FulfillmentTrackingInfo). Yine de takip URL’sinin açıkça gönderilmesi önerilir.
PTT Kargo Shopify entegrasyon yöntemleri
Düşük hacim ve standart akış için App Store’daki hazır uygulama, birden fazla kargo firmasıyla çalışan markalar için toplayıcı platform, ödeme şartlı gönderi ve ERP bağlantısı olan yapılar için özel ara katman doğru seçimdir.
Yöntem | Ne zaman seçilir | Kurulum süresi | Esneklik | Sürekli maliyet |
|---|---|---|---|---|
Shopify uygulaması (App Store’daki PTT Kargo uygulamaları) | Tek kargo firması, günde birkaç düzine sipariş | 2–5 iş günü | Düşük–orta | Aylık abonelik |
Toplayıcı platform (ör. Navlungo) | PTT’yi başka firmalarla birlikte kullanmak, tek panel | 1–2 hafta | Orta | Gönderi başı veya aylık |
Özel ara katman (PTT web servisleri) | ERP, depo yazılımı, ödeme şartlı gönderi kuralları | 3–5 hafta | En yüksek | Barındırma + bakım |
App Store’da PTT Kargo için geliştirilmiş, barkod, takip numarası ve ödeme şartlı gönderi desteği sunan uygulamalar bulunur; hepsi PTT ile yapılmış bir sözleşme ve müşteri numarası ister. Toplayıcı platformlar ise kendi anlaşmalarıyla veya sizin anlaşmanızla PTT’ye gönderi açar. Pek çok marka PTT’yi tek başına değil, şehir merkezlerinde Aras Kargo gibi bir firmayla, kırsal teslimatlarda PTT ile çalışacak şekilde kurgular. Bu durumda kargo firması seçimini sipariş bazında kurala bağlayan bir ara katman, iki ayrı uygulamadan daha temiz sonuç verir.
PTT Kargo Shopify entegrasyonu adım adım: süre ve maliyet
Hazır uygulamayla 2–5 iş günü, özel geliştirmeyle 3–5 hafta sürer; sürenin büyük kısmı PTT sözleşme sürecine ve adres eşleştirmesine gider.
Sözleşme ve erişim (1–2 hafta): PTT ile kurumsal sözleşme imzalanır, müşteri numarası, web servis şifresi ve barkod aralığı alınır. Ödeme şartlı gönderi kullanılacaksa sözleşmeye eklenir.
Shopify hazırlığı (1–3 gün): Varyant ağırlıkları doldurulur, gönderim lokasyonu (Location) netleştirilir, kapıda ödeme Shopify’da manuel ödeme yöntemi olarak tanımlanır.
Kurulum veya geliştirme (1 gün – 3 hafta): Uygulama kurulur ya da ara katman geliştirilir: FulfillmentOrder okuma, gönderi kaydı, barkod, fulfillment oluşturma ve durum senkronu.
Test (2–5 gün): Gerçek adreslere düşük tutarlı test gönderileri, ödeme şartlı bir gönderi ve bir iade senaryosu denenir.
Canlıya geçiş ve izleme (1 hafta): İlk hafta kabul edilmeyen gönderiler, adres hataları ve bildirim zamanlaması günlük kontrol edilir.
Maliyeti belirleyen başlıca faktörler: günlük sipariş adedi, ödeme şartlı gönderi oranı, ERP veya depo yazılımının sürece dahil olup olmadığı, birden fazla kargo firması arasında kurallı seçim yapılıp yapılmayacağı ve iade akışının otomatikleştirilmesi. Kargo ücretleri PTT ile yapılan anlaşmaya göre değişir.
Kapıda ödeme ve iade: PTT’de nasıl yönetilir?
Kapıda ödemeli bir siparişte Shopify tarafında ödeme “beklemede” kalır; PTT tahsilatı yapıp teslim ettiğinde sipariş ödenmiş olarak işaretlenmelidir. Bunu elle yapmak, muhasebe ile Shopify arasında açık bırakır.
Byte Digital’in 100 Türk Shopify mağazası analizinde mağazaların %31’inde kapıda ödeme açıktı. Bu mağazalarda en sık gördüğümüz sorun, teslim edilen ödeme şartlı gönderilerin Shopify’da aylarca “ödeme bekleniyor” görünmesidir. Doğru kurguda ara katman teslim durumunu aldığında siparişi ödendi olarak işaretler, iade edilen (teslim alınmayan) gönderide ise siparişi iptal veya iade akışına sokar. Kartla ödeme tarafında sanal POS kurulumunuzu netleştirmek, kapıda ödeme oranını zamanla düşürmenin en kolay yoludur.
İadelerde iki yol vardır: müşteriye PTT üzerinden iade barkodu üretmek veya müşterinin anlaşmalı iade koduyla şubeye teslim etmesi. Hangisi seçilirse seçilsin, iade gönderisinin takip numarası Shopify’daki iade kaydına bağlanmalıdır.
PTT Kargo Shopify entegrasyonunda en sık yapılan 6 hata
Sorunların çoğu entegrasyon ilk kurulduğunda değil, sipariş hacmi arttığında ve kampanya dönemlerinde ortaya çıkar.
Barkod oluşur oluşmaz müşteriye bildirim göndermek: Gönderi henüz şubeye kabul edilmediği için takip sayfası boş görünür ve müşteri hizmetlerine soru yağar.
Ödeme şartlı tutarı sabit göndermek: İndirim, kargo ücreti veya kısmi iade sonrası tutar değişir; yanlış tahsilat hem müşteriyi hem muhasebeyi etkiler.
Ağırlık girmeden canlıya çıkmak: Varsayılan desi gerçek desiden düşükse PTT faturası beklenenden yüksek gelir.
Adres eşleştirmesini atlamak: İlçe ve mahalle referans listesiyle eşlenmezse gönderiler kabulde bekler.
Takip URL’si göndermemek: Firma adı doğru olsa bile URL’nin açıkça yazılması, müşterinin sipariş durumu sayfasında çalışan bir bağlantı görmesini garanti eder.
Sipariş otomasyonunu kargodan ayrı düşünmek: Etiketleme, stok düşümü ve faturalama birlikte kurgulanmazsa her biri ayrı manuel adım olarak kalır. Otomatik sipariş işleme ile kargo entegrasyonunu tek akışta tasarlayın.
Byte Digital ile PTT Kargo Shopify entegrasyonu
Byte Digital, İstanbul merkezli bir Shopify Plus Partner’ıdır ve 2020’den bu yana Türkiye’nin önde gelen markalarına Shopify kurulumu, entegrasyon ve Shopify teknik destek hizmeti verir. PTT’yi tek başına veya diğer kargo firmalarıyla birlikte kullanan markalar için ödeme şartlı gönderi, iade ve ERP akışını Shopify merkezli tek bir yapıda kuruyoruz.
Günlük sipariş adedinizi, kapıda ödeme oranınızı ve kullandığınız diğer kargo firmalarını paylaşın; size uygun yöntemi, süreyi ve tahmini bütçeyi içeren ücretsiz bir ön değerlendirme hazırlayalım.
Ücretsiz PTT Kargo Shopify ön değerlendirmesi talep edin →
Sık sorulan sorular
Shopify ile PTT Kargo entegre edilebilir mi?
Evet. App Store’daki PTT Kargo uygulamaları, PTT’yi destekleyen toplayıcı platformlar veya PTT’nin web servislerine bağlanan özel bir ara katmanla entegre edilebilir. Her yöntemde PTT ile kurumsal sözleşme ve müşteri numarası gerekir.
PTT Kargo API’sine nasıl erişilir?
PTT ile kurumsal müşteri sözleşmesi imzalandıktan sonra müşteri numarası, web servis şifresi ve barkod aralığı PTT’nin kurumsal müşteri temsilcisi üzerinden talep edilir. Teknik dokümanlar da bu süreçte paylaşılır.
PTT Kargo’da kapıda ödeme Shopify ile çalışır mı?
Çalışır. Kapıda ödeme PTT’de ödeme şartlı gönderi olarak tanımlanır; tutar Shopify siparişinden alınıp gönderi kaydına eklenir. Teslim sonrası siparişin Shopify’da ödendi olarak işaretlenmesi de otomatikleştirilebilir.
Takip numarası neden hemen görünmüyor?
PTT’de gönderi kaydı ve barkod hemen oluşur, ancak sorgulama servisi gönderi şubede fiziksel olarak kabul edildikten sonra durum döndürür. Bildirim zamanlamasını kabul anına göre ayarlamak bu sorunu çözer.
PTT’yi başka bir kargo firmasıyla birlikte kullanabilir miyim?
Evet. Sık görülen kurgu, büyükşehirlerde başka bir firmayla, kırsal adreslerde PTT ile gönderim yapmaktır. Bu seçimi sipariş bazında kurala bağlayan bir toplayıcı platform veya özel ara katman gerekir.
Desi hesabı Shopify’da nasıl yapılır?
Shopify varyant düzeyinde yalnızca ağırlık tutar. Hacimsel ağırlık için ürün veya paket ölçüleri metafield’da saklanır ve ara katman desiyi bu ölçülerden hesaplayıp PTT’ye gönderir.





