PTT Kargo entegrasyonu, gönderilerinizi PTT sistemine yazılımdan yüklemek, etiket almak, ölçü güncellemek, adresten alım siparişi vermek ve gönderi hareketlerini sorgulamaktır. PTT'nin veri yükleme ve gönderi hareketi servisleri SOAP yapısındadır; test ortamı da yayındadır.
İlgili içerikler: Kargo entegrasyonu rehberi · Yurtiçi Kargo entegrasyonu · Aras Kargo entegrasyonu
Servisler ve Ortamlar
| Servis | Adres |
|---|---|
| Veri yükleme (canlı) | https://pttws.ptt.gov.tr/PttVeriYukleme/services/Sorgu?wsdl |
| Veri yükleme (test) | https://pttws.ptt.gov.tr/PttVeriYuklemeTest/services/Sorgu?wsdl |
| Gönderi hareketi | https://pttws.ptt.gov.tr/GonderiHareketV2/services/Sorgu?wsdl |
PTT'nin sitesinde kargo web servisi için ayrı bir başvuru sayfası bulunamadı (sitedeki entegrasyon başvurusu e-tebligat içindir). Entegratör kaynaklarına göre müşteri numarası ve şifre PTT iş yerinden veya il müdürlüğünden alınıyor; gönderiler için PTT'nin verdiği barkod aralığı kullanılıyor.
Veri Yükleme İşlemleri
| İşlem | Ne için |
|---|---|
kabulEkle, kabulEkle2 | Gönderi kabul kaydı yükleme |
kabulEkleParcaliBarkod, kabulEkle_altmusteri | Parçalı barkodlu gönderi ve alt müşteri adına kayıt |
etiketGetir | Barkoda göre EPL formatında etiket |
olcumGuncelle | Ağırlık, desi ve ölçü güncelleme |
barkodVeriSil, referansVeriSil | Barkoda veya referansa göre kayıt silme |
siparisIstekEkle, siparisIstekEkle2 | Adresten alım siparişi (randevu aralığıyla) |
kabulEkle2 Alanları
İstek; kullanıcı, müşteri numarası, şifre, dosya adı, gönderi tipi ve türü ile bir dongu (gönderi listesi) taşır. Her gönderide:
| Grup | Alanlar |
|---|---|
| Alıcı | aliciAdi, aAdres, aliciIlAdi, aliciIlceAdi, aliciTel, aliciEmail |
| Ölçü | agirlik, desi, en, boy, yukseklik |
| Gönderi | barkodNo, musteriReferansNo, deger_ucreti, odeme_sart_ucreti, odemesekli, ekhizmet |
| Gönderici | gondericibilgi altında ad, adres, il, ilçe, telefon ve e-posta |
| İade adresi | iadeAliciAdi, iadeAAdres ve iade il-ilçe bilgileri |
Yanıtta genel hata kodu ve her gönderi için barkod, sonuç ve açıklama döner.
Gönderi Hareketi Sorgulama
barkodSorgu: Barkoda göre teslim alan kişi, teslim tarihi, son işlem, iade nedeni ve kabul tarihi gibi bilgileri döndürür.gonderiHareketBarkodSorgu: Barkod aralığına göre hareketleri listeler.gonderiHareketIslemTarihiSorgu,gonderiKabulSorgula,gonderiTalimatSorgula: Tarihe göre hareket, kabul ve talimat sorguları.
PTT'nin SSS'sine göre kayıtlı gönderiye kabulde 13 haneli barkod yapıştırılır ve takip bu numarayla ptt.gov.tr'deki gönderi takibi sayfasından veya PTT Kargo uygulamasından yapılır.
Kapıda Ödeme ve Özel Hizmetler
PTT'de kapıda ödemenin resmî adı Ödeme Şartlı hizmettir: gönderi alıcıya belli bir bedel karşılığı teslim edilir ve tahsil edilen para göndericiye iletilir. Entegrasyonda tutar odeme_sart_ucreti alanıyla gönderilir. Aynı sayfada Ücreti Alıcıdan Tahsil (ödeme şartlıyla birlikte istenemez), Kontrollü Teslim, Gidiş Dönüş ve Değer Konulmuş hizmetleri de sayılıyor.
Teslim Sınırları
| Teslim yeri | Adreste teslim sınırı |
|---|---|
| İl merkezi | 50 kg ve 200 desiye kadar |
| İlçe, belde ve köy | 30 kg ve 150 desiye kadar |
Bu sınırları aşan gönderiler PTT iş yerinde teslim edilir.
Sık Sorulan Sorular
PTT'ye gönderi nasıl yüklenir?
kabulEkle2 işlemine gönderi listesini (dongu) göndererek.
PTT kapıda ödeme alanı hangisi?
Ödeme şartlı hizmetin tutarı odeme_sart_ucreti alanıyla gönderilir.
PTT etiketi nasıl alınır?
etiketGetir işlemiyle, barkod numarasına göre EPL formatında.
Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.