Qando

PTT Kargo Entegrasyonu

Cargo premium modülü ile PTT'ye bağlanma, tek tıkla etiket ve takip kodu.

Cargo modülü gereksinimi

PTT entegrasyonu Cargo premium modülünün açık olmasını gerektirir (₺49/ay). Bkz: Plan ve Modül Yönetimi.

Neden PTT entegrasyonu?

Pazaryeri dışı (manuel, B2B, kendi siteniz) siparişler için kendi kargo şirketinizle çalışıyorsanız:

  • PTT panele tek tek girip etiket oluşturmak yerine Qando'dan tek tık
  • Takip kodu otomatik üretilir
  • Müşteriye otomatik bildirim e-postası

PTT API erişimi

  1. pttkargo.gov.tr kurumsal müşteri portalına giriş.
  2. API Erişim Talebi formunu doldur (kurumsal müşteri olmanız gerekir).
  3. PTT temsilciniz size API Key + Müşteri No verir.

Qando'da bağlama

  1. Sol menü Kargo > PTT > Bağlantı Oluştur.
  2. Formu doldur:
    • Müşteri No
    • API Key
    • Varsayılan gönderici (gönderim adresinin sahibi — şirket adı, adres, telefon)
  3. Test Bağlantı > Kaydet.

Etiket oluşturma

Tekil sipariş

  1. Sipariş detay > Kargo Etiketi > PTT Kargo.
  2. Açılan formda:
    • Desi — paket ağırlığı/hacmi (Qando ürün metadatasından otomatik tahmin)
    • Hizmet türü — Standart, Hızlı, Lojistik
  3. Etiket Oluştur → PTT'den takip kodu döner ve A6 PDF açılır.
  4. Yazdırın.

Toplu

Sipariş listesinden checkbox ile birden fazla seçin → Toplu PTT Etiketi. Her sipariş için ayrı etiket basılır, hepsi tek PDF'te.

Takip kodu yayını

Etiket oluşturulduğunda takip kodu:

  • Qando sipariş kartına yazılır
  • Pazaryerine push edilir (Trendyol/HB/N11 destekler)
  • Müşteriye e-posta ile gönderilir (eğer e-posta varsa)

Desi nasıl hesaplanır?

Desi = (En × Boy × Yükseklik) / 3000 cm

Veya gerçek ağırlık (kg). Kargo firmaları büyük olanı baz alır.

Qando varyant kartında Boyut + Ağırlık alanlarını doldurursanız desi otomatik hesaplanır. Boş bırakırsanız manuel girersiniz.

Tarifeler

PTT tarifeleri anlaşmalı oranlarınıza göre çalışır; Qando bunları PTT API'den çeker. Tahmini referans için: /araclar/kargo-maliyet-hesaplama.

Yaygın sorunlar

  • Etiket oluşturulmuyor → PTT API timeout; 1-2dk bekle, tekrar dene
  • Takip kodu yayınlanmadı → Pazaryeri push'ı başarısız; sipariş detayında manuel ekleyebilirsiniz
  • Müşteri e-postası gönderilmedi → Sipariş kaydında müşteri e-postası yok; pazaryerinden eksik

Sonraki adım