Shopify PTT Kargo Entegrasyonu: Kurulum ve Gonderi Yonetimi Rehberi 2026

Shopify PTT Kargo Entegrasyonu Nedir?
Shopify PTT Kargo entegrasyonu, Shopify mağazasındaki siparişleri PTT’nin e-ticaret kargo altyapısına bağlayan, barkod etiketini otomatik oluşturan ve müşteriye takip numarasını ileten bir lojistik bağlantı sistemidir.

PTT Kargo, Türkiye’nin en geniş dağıtım ağına sahip kargo firmasıdır: 4.200’ü aşkın şube ve 81 ilin tamamına ulaşan lojistik kapasitesiyle özellikle kırsal ve küçük yerleşim birimlerine teslimat konusunda rakiplerinden ayrışır. (PTT, 2025) Shopify mağazaları için PTT entegrasyonu, diğer kargo firmalarının yetersiz kaldığı coğrafyalara erişim ve rekabetçi kurumsal fiyatlar nedeniyle tercih edilen bir seçenektir. Bu rehber, Shopify ile PTT Kargo entegrasyonunu adım adım kurmayı ve yönetmeyi açıklar.

PTT Kargo’nun Shopify Mağazaları İçin Avantajları

PTT Kargo, e-ticaret mağazaları için özel olarak geliştirdiği “e-Posta Kargo” ve kurumsal kargo hizmetleriyle Shopify entegrasyonuna uygun bir altyapı sunar.

Türkiye’nin en büyük kargo ağını işleten PTT, 2025 itibarıyla yurt içi kargo pazarında yaklaşık yüzde 18 paya sahiptir. (Statista, 2024)

PTT Kargo’nun e-ticaret avantajları:

• En geniş ulusal teslimat ağı: 4.200+ şube, tüm ilçelere erişim
• Yurt dışı gönderim: Aynı entegrasyon üzerinden uluslararası kargo
• Kapıda ödeme desteği: Nakit ve kart ile tahsilat
• Hafta sonu teslimat: Bazı bölgelerde Cumartesi teslimatı aktif
• Düsuk agirlik dilimi: 500 gram altı gonderiler icin avantajli fiyat

PTT Kargo’nun sınırlılıkları:

• Kurumsal API entegrasyonu bireysel kullanıcılara kapalıdır; kurumsal hesap gerektirir
• Uygulama ekosistemi Aras veya MNG kadar gelişmemiştir
• Gerçek zamanlı takip güncellemeleri bazı bölgelerde gecikmeli olabilir

PTT Kargo Entegrasyonu İçin Önkoşullar

Entegrasyonu kurmadan önce iki tarafın da hazır olması gerekir.

PTT Kargo tarafında gerekenler:

• Aktif PTT Kurumsal Kargo hesabı (PTT Kurumsal Müşteri Hizmetleri: 444 1 788)
• e-Posta Kargo veya kurumsal kargo sözleşmesi
• API kullanıcı adı ve şifresi (kurumsal müşteri temsilcinizden talep edin)
• Gönderici adres ve şube ataması

Shopify tarafında gerekenler:

• Shopify admin erişimi
• Üçüncü taraf uygulama yükleme yetkisi
• Settings > Shipping and delivery altında en az bir kargo bölgesi tanımlı

PTT API erişimi standart bireysel hesaplarda açık değildir. Kurumsal sözleşme imzalamadan API bilgisi talep etmek süreci geciktirir. Entegrasyon planınızı PTT kurumsal ekibiyle önceden paylaşın.

Shopify PTT Kargo Entegrasyon Yöntemleri

PTT Kargo’yu Shopify’a bağlamanın üç yolu vardır. Her yöntemin avantajları mağaza hacmine ve teknik kapasiteye göre değişir.

Yöntem	Uygun Profil	Teknik Gereksinim	Maliyet
Cok-tasiyicili uygulama	Gunluk 10+ siparis	Dusuk	Aylik abonelik
PTT ozel uygulama	Gunluk 1-10 siparis	Dusuk	Ucretsiz veya dusuk
Dogrudan API entegrasyonu	Ozel is akisi	Gelistirici gerekir	Gelistirici maliyeti

Yöntem 1: Çok-Taşıyıcılı Uygulama ile Kurulum

Türkiye’ye özgü çok-taşıyıcılı uygulamalar (Kolisi, Shipentegra, Commeta gibi) PTT dahil birden fazla kargo firmasını tek panelden yönetmeye olanak tanır. Bu yöntem, PTT’nin yanı sıra Aras veya MNG de kullanan mağazalar için en verimli seçenektir.

Adım adım kurulum:

1. Shopify Admin > Apps > App Store’a gidin
2. “Türkiye kargo entegrasyon” veya “PTT kargo” arayın
3. Seçtiğiniz uygulamayı yükleyin ve izinleri onaylayın
4. Uygulama ayarlarından “Kargo Firması Ekle” bölümüne gidin
5. PTT Kargo’yu seçin; API kullanıcı adı, şifresi ve müşteri kodunu girin
6. “Bağlantıyı Test Et” veya “Doğrula” butonuyla API erişimini onaylayın
7. Gönderici adresini ve PTT şube atamasını tanımlayın
8. Etiket formatını seçin: A4 veya termal (100×150 mm)
9. Sipariş durumu eşlemesini yapılandırın
10. Test siparişiyle kargo etiketini doğrulayın

Cok-tasiyicili kargo uygulamalari, PTT dahil birden fazla firma kullanilan Shopify magazalarinda etiket basim surecini yuzde 80 otomatiklestirerek gunluk operasyon yukunu onemli olcude azaltir.

Yöntem 2: PTT’ye Özel Shopify Uygulaması

PTT, e-ticaret entegrasyonları için lisanslı partner uygulamaları üzerinden Shopify desteği sunar. Bu uygulamalar genellikle yalnızca PTT Kargo’yu destekler ve daha basit bir kurulum süreci sunar.

Kurulum adımları:

1. Shopify App Store’da “PTT Kargo” arayın veya PTT kurumsal temsilcinizden uygulama linkini alın
2. Uygulamayı yükleyin
3. PTT kurumsal hesap bilgilerinizi (API bilgileri, müşteri kodu) girin
4. Gönderici adresini kaydedin
5. Kargo ücret kuralını ayarlayın: sabit, agirlik bazli veya ucretsiz kargo esigi
6. Sipariş durum eslemesini yapin: Shopify “Fulfilled” = PTT’de hangi durum?
7. Test siparisiyle etiketi olusturun ve barkod tarayiciyla dogrulayin

PTT’ye özel bazı uygulamalar yalnızca standart yurt içi gonderi destekler. Yurt disi veya kargo odeme secenekleri icin uygulama aciklamalarini dikkatlice okuyun; gerekirse cok-tasiyicili bir platforma gecisin.

Yöntem 3: PTT API ile Doğrudan Entegrasyon

PTT Kargo’nun REST API’si, Shopify’ın Webhook sistemiyle birleştirilerek sipariş-kargo akışı otomatikleştirilebilir. Bu yöntem bir geliştirici gerektirmekle birlikte tam özelleştirme imkânı sunar.

Temel entegrasyon akışı:

1. Shopify’da orders/create ve orders/fulfilled webhook’larini tanimla
2. Siparis olusturuldugunda PTT API’sine gonderi talebi gonder
3. PTT’den donen barkod numarasini Shopify siparisine kaydet
4. Etiket PDF’ini otomatik olustur ve yaziciya yonlendir
5. Musteri bildirimini tetikle: tracking numarasini iceren e-posta veya SMS

PTT API belgeleri, kurumsal entegrasyon talebi sonrasinda iletilir. Belgeye erisim icin PTT Kurumsal Destek: 444 1 788.

PTT Kargo Fiyatlandırması: E-Ticaret Tarifeleri

PTT Kargo’nun e-ticaret tarifesi, gonderim hacmine ve sozlesme kosullarına gore degisir. Asagidaki tablo 2025 yili yayin tarihi itibarıyla PTT’nin standart kurumsal tarifesini yansitmaktadir; guncel fiyat icin PTT kurumsal ekibiyle gorüsün.

Agirlik Dilimi	Standart Tarife	Kurumsal (500+ gonderi/ay)	Kapida Odeme Ek Ucreti
0-500 gram	45-55 TL	30-40 TL	+8-12 TL
500g – 1 kg	55-65 TL	38-48 TL	+8-12 TL
1-3 kg	65-80 TL	48-60 TL	+8-12 TL
3-5 kg	80-100 TL	60-75 TL	+8-12 TL
5-10 kg	100-130 TL	75-95 TL	+10-15 TL

Bu fiyatlar KDV haric olup PTT kurumsal hesap sozlesmesine gore degisebilir. Aylik 500 uzerinde gonderi yapan magazalar icin ozel indirim muzakeresi mumkundur.

PTT Kargo ile Yurt Dışı Gonderi

PTT Kargo’nun en belirgin avantajlari ndan biri, aynı kurumsal hesap uzerinden uluslararasi gonderi yapilabilmesidir. EMS (Express Mail Service) ve standart uluslararasi posta hizmetleriyle 220’den fazla ulkeye erisim saglanir.

PTT uluslararasi kargo secenekleri:

• EMS: 3-7 is gunu teslim, takip numarali, sigorta dahil
• Kayitli Posta: 7-21 is gunu, takip numarali, dusuk maliyet
• APS (Ayristirilmis Posta Sistemi): Yuksek hacimli e-ihracat icin ozel tarife

Türkiye’den yurt dişi e-ticaret satisi yapan magazalar icin PTT’nin mikro ihracat kolayligi onemlidir. 300 Euro altindaki gonderiler gsümrük ön bildirimi olmadan gönderilebilir. Yurt dışı Shopify satislari hakkinda ayrintili bilgi icin Türkiye’den Yurt Dışına Shopify ile İhracat Rehberi’ne bakin.

PTT Kargo Takip ve Müşteri Bildirimleri

PTT Kargo takip sistemi, barkod numarasiyla ptt.gov.tr/kargo-takip adresinden sorgulanilebilir. Shopify entegrasyonunda bu takip linkini musteri bildirim e-postasina otomatik eklemek mumkundur.

Bildirim kanalları ve kurulum:

Kanal	Yontem	Kurulum
E-posta	Shopify Notifications sablonu	Settings > Notifications
SMS	Entegrasyon uygulamasi + SMS servisi	Uygulama ayarlari
PTT web	Otomatik (barkod ile)	Ek kurulum gerekmez

Shopify bildirim sablonunda PTT takip linkini eklemek icin {{ fulfillment.tracking_url }} degiskenini kullanin ya da PTT’nin takip URL yapisini manuel ekleyin: https://gonderitakip.ptt.gov.tr/Track/Verify?q={{ fulfillment.tracking_number }}.

PTT ile Diger Kargo Firmalarinin Karsilastirilmasi

PTT Kargo’yu diger Türkiye kargo firmalariyla karsilastirarak hangi durumlarda onceliklendirmeniz gerektigini anlayabilirsiniz.

Kriter	PTT Kargo	Aras Kargo	Yurtici Kargo	MNG Kargo
Sube agi	4.200+	1.200+	2.400+	3.600+
Kucuk yerlesim teslimati	Guclu	Sinirli	Orta	Orta
Yurt disi gonderi	Evet (EMS)	Hayir (dogrudan)	Hayir	Hayir
API olgunlugu	Kurumsal talep	Kurumsal talep	Kurumsal talep	Kurumsal talep
Kapida odeme	Evet	Evet	Evet	Evet
Hafta sonu teslim	Bazi bolgeler	Buyuk sehirler	Buyuk sehirler	Buyuk sehirler

Kucuk yerlesim birimlerine satış yapan ya da uluslararası gonderi gerektiren Shopify magazalari icin PTT Kargo, tek operatorde her iki ihtiyaci karsilayan en kapsamli secenektir.

Diger kargo entegrasyonlari icin Shopify Aras Kargo Entegrasyonu, Shopify Yurtiçi Kargo Entegrasyonu ve Shopify MNG Kargo Entegrasyonu rehberlerimize bakin.

PTT Kargo ile Kapida Odeme Kurulumu

Kapida odeme, Türkiye e-ticaretinde musteri guveni acisından kritik bir odeme secenegi olmaya devam etmektedir. Shopify verilerine gore Türkiye’de her uc siparisten biri kapida odeme ile tamamlanmaktadir. PTT Kargo, nakit ve POS cihazi ile kapida tahsilati destekler.

Kapida odeme entegrasyonu icin adimlar:

1. PTT kurumsal hesabinizda kapida odeme servisinin aktif oldugunu dogrulayin
2. Shopify Admin > Settings > Payments > Manual payment methods bolumunden “Kapida Odeme” secenegini ekleyin
3. Kargo entegrasyon uygulamanizda PTT’nin kapida odeme servis kodunu tanimlayin
4. Tahsilat tutarinin etiket olusturma sirasinda otomatik aktarildigini test edin
5. Kapida odeme siparisleri icin ayrı bir fulfillment akisi varsa uygulamanin bu siparisleri dogru tanidigini dogrulayin

Kapida odeme etiketi uzerinde bulunmasi zorunlu bilgiler:

• Gonderen firma adi ve adresi
• Alici adi, adresi (ilce + sehir + posta kodu) ve telefonu
• PTT barkod numarasi
• Servis turu: Kapida Odeme
• Tahsilat tutari (TL cinsinden, acik rakamla)

Kapida odeme tutari etikette eksik veya hataliysa PTT teslimatci tahsilat yapamaz; siparis iade olarak geri doner. Entegrasyonu devreye almadan once mutlaka test siparisi ile dogrulayin.

PTT kapida odeme tarafinda toplanan tutarlarin magazaniza aktarima suresi ve odeme yontemi icin PTT kurumsal temsilcinizle anlasmani yenileyin; bu surec kargo sozlesmesinin bir parcasidir.

PTT Kargo Entegrasyonunun Maliyet Analizi

PTT Kargo entegrasyonunu degerlendirilirken yalnizca kargo birim fiyati degil, toplam operasyon maliyeti ve ulasim kapasitesi birlikte ele alinmalidir.

Maliyet kalemleri:

Kalem	Aciklama	Tahmini Tutar
Kargo birim ucreti	Agirlik ve mesafeye gore	30-130 TL/gonderi
Shopify uygulamasi	Entegrasyon uygulamasi aboneligi	0-500 TL/ay
Kargo sigortasi	Deger uzerinden yuzdelik	0,3-0,5%
Kapida odeme komisyonu	Tahsilat basi ek ucret	8-15 TL/gonderi
Iade kargo	Muzteri red durumunda	Anlasmaya gore

Kargo maliyetini optimize etmek icin:

1. Aylik gonderi hacmini artirarak kurumsal indirim dilimlerine gecin; PTT’de bu esik genellikle 500 gonderi/ay’dir
2. Ortalama paket agirligini dusurmeye calisin; ambalaj malzemesi secimi maliyeti dogrudan etkiler
3. Kargo sigortasini yalnizca deger esigini asan urunlerde etkinlestirin
4. Birden fazla kargo firmasiyla calisarak musteri bolgesine gore en ucuz secenegi otomatik atayan bir sistem kurun

Shopify’da kargo maliyeti stratejisi hakkinda daha fazla bilgi icin Shopify Kapida Odeme Kurulum Rehberi’ne bakin.

Sik Karsilasilan PTT Entegrasyon Sorunlari

Sorun 1: API baglantisi “authentication failed” hatasi veriyor
API kullanici adi ve sifresi kucuk/buyuk harfe duyarlidir. Bilgileri kopyalarken basta veya sonda bosluk olmadigini kontrol edin. PTT kurumsal hesabinizin API erisiminin aktif oldugunu temsilcinizle dogrulayin.

Sorun 2: Etiket olusturuluyor ancak barkod okunamiyor
Termal yazici ayarlarini kontrol edin: yogunluk orta-yuksek olmali, etiket boyutu (100×150 mm) yazici ayariyla uyusmali. PDF baskisinda cozunurluk minimum 300 DPI olmali.

Sorun 3: Takip numarasi sisteme girildikten saatler sonra guncelleniyor
PTT’nin takip guncelleme sikligi Aras veya Yurtici’ye kiyasla daha yavastir. Bu beklenen bir davranis olup teknik sorun degildir. Musteri bildirimlerinizde “48 saat icinde guncellenecek” notu ekleyin.

Sorun 4: Yurt disi gonderi etiket bilgileri eksik gorunuyor
Uluslararasi gonderi icin alici ulke, posta kodu ve telefon bilgilerinin tam olarak girilmesi zorunludur. Shopify musteri adres formunu bu alanlari zorunlu olacak sekilde guncelleyin.

SSS

Shopify PTT Kargo entegrasyonu ucretsiz mi?
PTT Kargo API erisimi kurumsal sozlesme kapsaminda saglanir ve ek ucret alinmaz. Entegrasyon icin kullanilan Shopify uygulamasi ise aylik 0-500 TL arasinda ucret alabilir. Dogrudan API gelistirme yolunda yalnizca gelistirici maliyeti olusur.

PTT Kargo API bilgilerini nasil alabilirim?
PTT Kurumsal Musteri Hizmetleri’ni arayin: 444 1 788. Kurumsal kargo sozlesmesi imzalandiginda API kullanici bilgileri iletilir. Bireysel PTT hesaplariyla API erisimi mumkun degildir.

Shopify ile PTT uzerinden yurt disi gonderi yapabilir miyim?
Evet. PTT’nin EMS ve APS hizmetleriyle 220’den fazla ulkeye gonderi yapilabilir. Shopify’da uluslararasi gonderi icin ilgili kargo bolgesini ve dogrudan PTT yurt disi tarifesini tanimlamaniz gerekir.

PTT Kargo kapida odeme destekliyor mu?
Evet. PTT’nin kapida odeme hizmeti hem nakit hem de POS cihazi ile tahsilati kapsar. Entegrasyon uygulamasinda kapida odeme servis kodunun tanimlanmasi gerekir; tahsilat tutari etikete otomatik yazilir.

Shopify’da PTT ile birlikte baska kargo firmasi kullanabilir miyim?
Evet. Cok-tasiyicili bir Shopify uygulamasi kurarsaniz PTT, Aras, MNG veya Yurtici’yi ayni panelden yonetebilirsiniz. Siparis agirligina veya musteri bolgesine gore otomatik kargo firmasi atamasi yapilabilir.

PTT Kargo entegrasyonu hangi Shopify planinda calisir?
Ucuncu taraf uygulama bazli entegrasyon tum Shopify planlarinda (Basic dahil) calisir. Gercek zamanli kargo ucreti hesaplama ozelligi ise yalnizca Advanced ve Plus planlarda yerlesik olarak gelir.

PTT ile kargo etiketi basiminda hangi yazici kullanilmali?
Termal yazici (100×150 mm etiket) veya A4 lazer/inkjet yazici kullanilabilir. Gunluk 20’nin uzerinde gonderi yapan magazalar icin termal yazici tercih edilmeli; etiket basimi hizlanir ve kagit israfı onlenir.

Sonuc: Bir Sonraki Adim

PTT Kargo entegrasyonu, ozellikle kucuk yerlesim birimleri ve yurt disi gonderi gerektiren Shopify magazalari icin kargo cluster’ını tamamlayan kritik bir adimdir. Kurulum once bir cok-tasiyicili uygulama veya PTT’ye ozel uygulama ile baslayarak test edin; hacim arttikca dogrudan API entegrasyonunu degerlendirin.

Kargo entegrasyon cluster’ini tamamlamak icin Shopify Aras Kargo, Yurtici Kargo ve MNG Kargo rehberlerimize bakin. Kargo maliyetlerini optimize etmek icin Shopify Taksitli Odeme ve kapida odeme kombinasyonunu degerlendirin.