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

PTT Kargo entegrasyonu ne yapar, kimin işine yarar?

PTT Kargo entegrasyonu, sipariş bilgisini PTT sistemine yeniden yazma ve barkodu siparişe, oradan da pazaryerine kopyalama işini yazılıma devreder. Alıcının adı, adresi ve telefonu siparişten gönderi kaydına geçer; PTT'nin verdiği barkod numarası siparişe geri yazılır. Ulaştırma ve Altyapı Bakanı'nın 11 Ağustos 2026'daki açıklamasına göre PTT, 2026'nın ilk yarısında 210 milyon posta ve kargo gönderisi taşıdı, kargo hacmi geçen yılın aynı dönemine göre yaklaşık %17 arttı ve kargo gönderilerinde teslimat oranı %95'e yaklaştı. Bu büyüklükte bir ağla çalışırken asıl risk sizin tarafınızdaki kopyalama hatalarıdır: yanlış barkod alıcıya yanlış bilgi, pazaryerinde ise geciken sipariş anlamına gelir.

PTT bağlantısından en çok kimler fayda görür?

• Kendi e-ticaret sitesinden sipariş alan ve PTT ile kendi adına sözleşmesi olan işletmeler.
• Köy ve belde adreslerine sık gönderi yapan satıcılar: PTT, köy dağıtımına tabi yerlere 30 kg ve 150 desiye kadar kargo kabul eder.
• Birden çok kanalın siparişini tek depodan çıkaran satıcılar: takip numarasını her kanala ayrı ayrı girme işi ortadan kalkar.
• Yalnız pazaryerinin anlaşmalı PTT koduyla gönderen satıcılar ise ayrıca PTT hesabı bağlamaya çoğu durumda ihtiyaç duymaz.

PTT Kargo ile PttAVM'yi karıştırmayın

PttAVM, PTT'nin pazaryeridir; orada ürün listeler ve sipariş alırsınız. Bu bağlantıyı PttAVM entegrasyonu rehberimizde ayrıca anlattık. PTT Kargo bağlantısı ise siparişin hangi kanaldan geldiğine bakmadan paketi PTT'nin taşıma ağına teslim etmekle ilgilidir. İkisi aynı panelde birlikte de kurulabilir, ayrı ayrı da.

PTT'de gönderi türleri, ağırlık ve teslim sınırları

PTT, yurt içi eşya gönderilerini ağırlık ve hacme göre iki gruba ayırır; teslimin adreste mi PTT iş yerinde mi yapılacağını da ağırlık, desi ve varış adresine göre belirler. Bu sınırlar entegrasyonu doğrudan ilgilendirir, çünkü gönderi kaydına yazılan ağırlık ve ölçü, paketin kapıya mı şubeye mi gideceğini etkiler. Aşağıdaki tablo PTT'nin kendi tanımlarından ve sıkça sorulan sorular sayfasından derlendi.

PTT'de teslim süresi nasıl okunur?

PTT, il merkezinden il merkezine öngörülen süreleri sitesindeki Gönderi Süresi Sorgulama ekranında ve PttKargo uygulamasının Tahmini Süre menüsünde gösterir. PTT'nin kendi açıklamasına göre bu ekrandaki değer il merkezleri arasındaki en kısa süredir; teslim süresinin önemli olduğu gönderilerde sürenin en az iki katına uzayabileceği öngörülmelidir. Pazaryerinde taahhüt ettiğiniz kargoya veriliş ve teslim süresini bu bilgiye göre ayarlamak, gecikme şikâyetlerini baştan azaltır.

PTT ile sözleşme: Müşteri ID, kullanıcı adı ve şifre nasıl alınır?

PTT entegrasyon bilgileri sözleşmeli (anlaşmalı) müşteriye verilir; şubeden bireysel gönderi yaptığınızda yazılıma bağlanabilecek bir hesap oluşmaz. Yox İş Ortağım'ın PTT bağlantısında istenen üç alan Müşteri ID, kullanıcı adı ve şifredir. Bunları anlaşma yaptığınız PTT başmüdürlüğünden (il müdürlüğü) ya da size atanan PTT yetkilisinden istersiniz. Süreç çoğunlukla şu sırayla ilerler:

1. Gönderilerinizi hazırladığınız depoya en yakın PTT başmüdürlüğüyle görüşün; istenecek şirket belgelerini başvurudan önce telefonla sorun.
2. Gönderi tipinizi, aylık tahmini adedi, ortalama desi ve yoğun gönderdiğiniz bölgeleri anlatın; fiyat bu bilgilere göre sözleşmeye yazılır.
3. Sözleşmeyi imzalarken bilgileri bir sipariş yönetim yazılımında kullanacağınızı belirtip entegrasyon için Müşteri ID, kullanıcı adı ve şifre isteyin; PTT ayrıca bir gizlilik taahhütnamesi isterse aynı gün imzalayın.
4. Verilen bilgilerin test ortamı için mi canlı ortam için mi olduğunu yazılı olarak teyit edin.
5. Bilgileri Yox İş Ortağım'ın Kargo bölümüne girip “Bağlantıyı test et” ile doğrulayın.

Sözleşme masasında netleştirmeniz gereken konular

• Gönderi ücretinin ödenme şekli: her gönderide peşin mi, PTT'nin dönemsel kestiği faturayla (mahsup) mı?
• Ücretin desiye mi ağırlığa mı göre hesaplanacağı ve yuvarlama kuralı; kolilerinizi desi hesaplama aracıyla önceden ölçün.
• Adresten alım: PTT'nin 1 Ekim 2026 tarihli ücret tarifesine göre sözleşmeli müşterilerden adresten alım ücreti alınmaz; alım saatini ve sıklığını sözleşmede açıkça yazdırın.
• Ambalaj: aynı tarifeye göre sözleşmeli müşteriler talep ederse 4A numaralı plastik kargo zarfı ücretsiz verilir; diğer ambalaj malzemelerinde sözleşme hükümleri uygulanır.
• Gönderici adresi: birden çok depodan çıkış yapacaksanız her adres için ayrı tanım gerekip gerekmediği.
• Kullanacağınız özel hizmetler: ücreti alıcıdan tahsil, ödeme şartlı gönderi, kontrollü teslim (bir sonraki bölümde).

Entegrasyon şifresi ile diğer PTT şifreleri aynı değildir

PttBank, internet bankacılığı ya da e-Devlet üzerinden kullandığınız bilgiler, kargo entegrasyonu için verilen kullanıcı adı ve şifreyle aynı değildir. Bağlantı testi başarısız olduğunda ilk kontrol, girilen bilginin entegrasyon için verilip verilmediğidir; emin değilseniz PTT yetkilinizden yazılı teyit isteyin.

PTT'nin özel hizmetleri e-ticaret gönderisini nasıl etkiler?

PTT'de bir gönderiye eklenen özel hizmetler, kapıda ödemeden teslim noktasına kadar e-ticaret operasyonunu belirler ve bazıları birbiriyle birlikte istenemez. PTT'nin yurt içi özel hizmet tanımlarına, Kargomat ve Kargom Güvende sayfalarına ve 1 Ekim 2026 tarihli ücret tarifesine göre öne çıkan kurallar şunlardır:

Kapıda ödeme düşünüyorsanız faturanın koliye girme zorunluluğu iş akışınızı değiştirir: e-Arşiv faturanın koli kapanmadan kesilmiş ve basılmış olması gerekir. Ayrıca ödeme şartlı gönderi ile ücreti alıcıdan tahsil aynı pakette birleştirilemez; alıcıdan hem ürün bedelini hem kargo ücretini kapıda almak istiyorsanız fiyatlamayı buna göre kurun.

Pazaryeri siparişlerinde PTT: anlaşmalı kod mu, kendi sözleşmeniz mi?

PTT bir pazaryeri siparişinde iki ayrı rolde karşınıza çıkar: pazaryerinin anlaşmalı taşıyıcısı olarak ya da sizin kendi sözleşmenizle çalıştığınız kargo firması olarak. Hangisinin geçerli olduğu, barkodu kimin ürettiğini ve kargo bedelinin nereden düşeceğini belirler. Trendyol'un geliştirici dokümanındaki kargo firmaları listesinde PTT, 19 numaralı kimlik ve PTTMP koduyla “PTT Kargo Marketplace” adıyla yer alır.

Trendyol'da PTT ile gönderimde geçerli kural

Trendyol'un takip kodu dokümanındaki tabloya göre PTT Kargo, hem “kendi kargo fiyatlarımla çalışacağım” hem de “Trendyol anlaşmalı kargo fiyatlarıyla çalışacağım” seçeneğinde Trendyol kargo kodunun kullanılması gereken firmalar arasındadır. Aynı dokümana göre ürününüzde belirttiğiniz kargo firması Trendyol sözleşmenizde onaylanan firmayla aynı olmalıdır. Pratik sonuç: Trendyol siparişi için kendi PTT hesabınızdan ikinci bir gönderi açmayın, paketi Trendyol'un verdiği kodla teslim edin. Kanal tarafındaki ayarları Trendyol entegrasyonu sayfamızda bulabilirsiniz.

Hepsiburada, n11 ve PttAVM'de durum

Hepsiburada'nın 5 Ekim 2026'dan itibaren geçerli anlaşmalı kargo desi tablosunda PTT Kargo ayrı bir sütun olarak yer alır; KDV hariç bedel 0–2 desi için ₺93,95, 5 desi için ₺119,79, 10 desi için ₺183,21'dir. Kendi PTT tarifenizi bu rakamlarla karşılaştırmak hangi yolun daha kârlı olduğunu gösterir; ayrıntılar Hepsiburada entegrasyonu rehberimizde. n11 mağazanızda kendi anlaşmanızla gönderime izin verilip verilmediği mağaza ayarınıza ve n11'in kuralına bağlıdır. PttAVM siparişlerinde ise barkod ve kargo süreçleri PttAVM satıcı paneli üzerinden yürür.

PTT Kargo entegrasyonu kurulumu: Yox İş Ortağım'da adım adım

PTT Kargo entegrasyonunun Yox İş Ortağım tarafı, PTT'den gelen üç bilginin panele girilmesi ve küçük bir deneme gönderisiyle tamamlanır; zaman alan kısım genellikle PTT ile sözleşme aşamasıdır. Kurulumu kendiniz yapabilir ya da isterseniz birlikte yapabiliriz.

1. Yox İş Ortağım'da Kargo bölümünü açın ve PTT Kargo'yu seçin.
2. PTT'nin verdiği Müşteri ID, kullanıcı adı ve şifreyi ilgili alanlara yazın.
3. “Bağlantıyı test et” ile bilgileri doğrulayın; hata alırsanız aşağıdaki listeye bakın.
4. Birden çok kargo hesabınız varsa PTT'yi birincil kargo olarak seçin ya da siparişlerin hangi hesapla gideceğini belirleyin.
5. Gerçek bir siparişte gönderi kaydı oluşturun, etiketi basın ve takip numarasının siparişe ve satış kanalına yazıldığını kontrol edin.
6. Koli PTT'ye teslim edildikten sonra kargo durumunun siparişe yansıdığını görün; ardından diğer siparişlere geçin.

Bağlantı testi başarısız olursa nereye bakılır?

• Girilen bilgi gerçekten kargo entegrasyonu için mi verildi, yoksa başka bir PTT hizmetinin şifresi mi?
• Bilgiler test ortamı için mi verildi? Test bilgisiyle açılan kayıt gerçek gönderi oluşturmaz.
• Müşteri ID'nin başında ya da sonunda boşluk kalmış olabilir; kopyalayıp yapıştırırken bu sık olur.
• Bilgiler sözleşme aktifleşmeden verildiyse PTT yetkilinizden hesabın açıldığını teyit edin.

Test başarılı olduktan sonra ilk gün yalnız birkaç siparişi PTT ile göndermek, adres ve ölçü verisindeki aksaklıkları toplu gönderime geçmeden önce görmenizi sağlar.

Gönderi yola çıktıktan sonra: barkod, takip ve iade süreci

PTT'de kayıtlı yurt içi gönderiler, kabulde pakete yapıştırılan 13 haneli barkod numarasıyla izlenir; alıcı bu numarayı ptt.gov.tr'deki Gönderi Takibi sayfasında ya da PttKargo uygulamasında sorgular. Entegrasyonda aynı numara siparişe ve pazaryerine yazılır; numaranın önüne ek ya da arasına boşluk girmesi, kanalın numarayı tanımamasına yol açabilir.

Teslim edilemeyen PTT gönderisinde ne olur?

PTT'nin açıklamasına göre adreste alıcı bulunamazsa gönderi en yakın PTT iş yerine ya da Kargomat'a bırakılır ve adrese haber kâğıdı bırakılır; takip ekranında bu durum “Haber kağıdı/ihbarname bırakıldı” olarak görünür. Bekleme süresi içinde alınmayan gönderi göndericiye iade edilir. PTT'nin 1 Ekim 2026 tarifesine göre iade ve tekrar yollamada kabul ücretinin %30'u alınır (2 kg/desiye kadar haberleşme gönderileri hariç); sözleşmeli müşteride bu oran sözleşmeye göre farklı olabilir. PTT'nin 2026'da yaygınlaştırdığı SMS ile talimat hizmetinde alıcı, gönderinin komşuya, kapıya, bina görevlisine, Kargomat'a ya da PTT iş yerine bırakılmasını seçebiliyor; bunu alıcıya sipariş notunda hatırlatmak, teslim edilemeyen gönderi sayısını azaltmaya yardımcı olur.

Alıcı “kargom nerede” diye sorduğunda

• Önce siparişteki kargo durumuna bakın: kayıt açıldı ama hareket yoksa koli PTT'ye teslim edilmemiş olabilir.
• Hareket varsa barkodu alıcıyla paylaşın; PTT'nin müşteri hizmetlerine 444 1 788 numarasından ulaşılır.
• Haber kâğıdı bırakıldıysa alıcıya bekleme süresi dolmadan PTT iş yerine gitmesini hatırlatın; iade olan paket hem kargo ücretini hem satışı kaybettirir.

PTT Kargo entegrasyonu hangi Yox İş Ortağım paketinde var?

PTT Kargo entegrasyonu Yox İş Ortağım'da Büyüme paketinden itibaren kullanılır; Başlangıç paketinde kargo entegrasyonu yoktur ve takip numarası elle girilir. PTT, paketinizdeki kargo firması hakkından birini kullanır. Yox kargo firması değildir ve kargo bedeli almaz; gönderi ücretini PTT ile yaptığınız sözleşme belirler.

Yıllık ödemede %20 indirim uygulanır ve her paket 3 gün ücretsiz denenebilir. PTT'nin yanında Yurtiçi Kargo gibi ikinci bir hesap bağlayacaksanız Profesyonel paket iki firmayı kapsar. Paket ayrıntıları paketler bölümünde; panelde tanımlı 80 satış kanalı (48'i hazır), 57 kargo ve lojistik firması ve 51 muhasebe, e-Fatura ve ERP programının listesi entegrasyonlar ana sayfasında.

PTT bağlantısını canlıya almadan önce kontrol listesi ve sık hatalar

PTT kurulumunda sorunların çoğu yazılımdan değil, sözleşme bilgisi ile sipariş verisinin birbirine uymamasından çıkar. Aşağıdaki liste, ilk haftada en sık karşılaşılan durumları önceden yakalamak için hazırlandı.

Canlıya geçiş kontrol listesi

• Müşteri ID, kullanıcı adı ve şifrenin canlı ortam bilgileri olduğu PTT'den yazılı olarak teyit edildi.
• Gönderici adresi PTT sözleşmesindeki adresle aynı.
• Her pazaryeri için siparişin PTT sözleşmenizle mi pazaryerinin koduyla mı gideceği belirlendi; Trendyol siparişleri Trendyol kargo koduyla gidiyor.
• Etiket yazıcısının kâğıt boyutu PTT'nin döndürdüğü etiketle uyumlu.
• Bir deneme siparişinde takip numarası pazaryerinin sipariş ekranında görüldü.

PTT gönderilerinde sık yapılan hatalar

• Aynı sipariş için iki kez kayıt açmak: her kayıt yeni bir barkod demektir ve alıcı yanlış numarayı izleyebilir.
• İlçe alanı boş ya da semt adıyla gelen adresleri düzeltmeden göndermek.
• Kapıda ödemeli gönderide faturayı koliye koymayı unutmak.
• Ödeme şartlı gönderiyi ve ücreti alıcıdan tahsili aynı pakette istemek; PTT ikisini birlikte kabul etmez.
• Köy adresine 30 kg ya da 150 desiyi aşan koli göndermek; paket adreste değil PTT iş yerinde teslim edilir.

Kendi siparişlerinizle denemek için Yox İş Ortağım'a başvurun; PTT sözleşmenizin panelde nasıl çalışacağını önce konuşmak isterseniz iletişim sayfasından ön görüşme isteyebilirsiniz.