PttAvm Entegrasyonu: API, XML, Fulfillment ve Tek Panelden Mağaza Yönetimi

PttAvm Hakkında: Kuruluş, Sahiplik ve Pazar Konumu

Kuruluş ve Tarihçe (1840 – Bugün)

PTT (Posta ve Telgraf Teşkilatı), 1840 yılında Osmanlı İmparatorluğu döneminde kuruldu ve dünyanın en eski posta teşkilatlarından biridir. Cumhuriyet döneminde modernize edilen PTT, 2013'te Anonim Şirket statüsüne geçti. PttAvm ise PTT'nin dijital dönüşüm projesi kapsamında 2017'de hizmete açıldı; amacı KOBİ, yerel üretici, kadın girişimci ve coğrafi işaretli ürün sahiplerinin devlet güvencesi altında düşük komisyonla e-ticaret yapmasını sağlamaktı.

2020 sonrası pandemiyle e-ticaretin patlamasıyla PttAvm hacmi hızla büyüdü. Bugün PttAvm; pazaryeri (3P), PTT Kargo teslimat ağı, PTT Lojistik fulfillment hizmeti, Yerli Üretici Vitrini, Coğrafi İşaretli Ürünler ve Kadın Girişimci programlarıyla devlet destekli bir e-ticaret ekosistemine dönüşmüştür.

PttAvm Sahiplik Yapısı (2025)

• PTT Anonim Şirketi — Tek hissedar (%100, devlet kuruluşu)
• T.C. Ulaştırma ve Altyapı Bakanlığı — PTT A.Ş.'nin tek hissedarı (%100)
• Türkiye Varlık Fonu — Stratejik kamu varlığı koordinasyonu
• Devlet kuruluşu — KOSGEB, Tarım Kredi ve Türk Patent ile resmi protokol ortaklıkları

Türkiye E-Ticaretindeki Konumu

PttAvm, 2024 itibarıyla Türkiye'nin en güvenilir devlet destekli pazaryeri olarak konumlanır. Trendyol ve Hepsiburada gibi özel sektör pazaryerlerinin aksine; devlet sübvansiyonu, düşük komisyon ve KOBİ koruyucu politikalarla farklılaşır. Özellikle coğrafi işaretli ürünler, yerli üretici, kadın girişimci ve KOSGEB ekosisteminde rakipsiz konumdadır. PTT'nin 17.000+ posta merkezi ağı sayesinde 81 ilin tamamına ulaşım kapasitesi sunar.

PttAvm Satış Hacmi ve Büyüklük (2024–2025 Verileri)

PttAvm, 2017 kuruluşundan bu yana özellikle pandemiyle hızlanan dijital dönüşüm sayesinde her yıl %50–80 büyüme gösterdi. Devlet sübvansiyonu ve düşük komisyon, satıcı sayısını hızla artırdı.

Yıl	GMV (TL)	Sipariş	Aktif Müşteri	Aktif Satıcı
2020	~₺500 milyon	3 milyon	1.5M	5K
2022	~₺2 milyar	12 milyon	3M	12K
2024	~₺4.5 milyar	28 milyon	4M+	20K+
2025 (öngörü)	~₺6.5 milyar	42 milyon	5.5M	28K

Bu büyüme; PTT Kargo'nun 81 il ağı, devlet sübvansiyonlu düşük komisyon ve Yerli Üretici Vitrini, Coğrafi İşaretli Ürün, Kadın Girişimci özel programları sayesinde gerçekleşti. PttAvm pazaryerine satıcı olarak girmek, özellikle KOBİ ve yerel üreticiler için en az komisyonlu, en güvenilir devlet destekli e-ticaret rotasıdır.

PttAvm'de Mağaza Açma Süreci (2026 Güncel Kurallar)

1. Yasal ve Mali Gereksinimler

PttAvm'de satıcı olmak için Türkiye'de aktif vergi mükellefiyetiniz olmalıdır. Şahıs şirketi, limited veya anonim şirket farketmez; ancak e-Fatura mükellefi olmak ve e-Arşiv fatura kesebilmek zorunludur. KOSGEB, Tarım Kredi ve Coğrafi İşaret programlarına dahil işletmeler için özel başvuru kanalları mevcuttur.

• Vergi levhası (güncel yıl)
• Vergi numarası ve TC kimlik no (şahıs şirketi için)
• Ticaret sicil gazetesi (ltd/A.Ş. için)
• İmza sirküleri
• Banka hesap (IBAN) — ödemeler bu hesaba aktarılır
• e-Fatura/e-Arşiv özel entegratörü veya GİB portalı
• Marka tescil belgesi (kozmetik, gıda, oyuncak gibi koruyuculu kategorilerde)
• Coğrafi İşaret Tescili (Antep Fıstığı, Hereke Halısı vb. ürünler için Türk Patent'ten)

2. PttAvm Satıcı Paneline Başvuru

satici.pttavm.com üzerinden başvurunuzu yaparsınız. Onay süresi devlet kurumu süreci nedeniyle 5–7 iş günüdür (özel sektör pazaryerlerinden biraz daha uzun; ancak onay sonrası avantajlar çok daha büyüktür). Onay sonrası size mağaza ID, API anahtarı (apiKey) ve API secret (apiSecret) verilir — bunlar entegrasyon için kritiktir.

📥 Resmi PttAvm Mağaza Başvuru Sayfası satici.pttavm.com — ücretsiz başvuru, 5–7 iş günü onay süresi →

3. Ürün Yükleme ve İçerik Kuralları

PttAvm, ürün listelemelerinde TR e-ticaret standartlarına uygun içerik kuralları uygular:

• Başlık: 50–150 karakter, marka + ürün adı + temel özellik
• Görsel: Beyaz arkaplan, minimum 1000×1000px, maks. 8 fotoğraf, watermark/yazı yasak
• Açıklama: HTML destekli, minimum 200 karakter
• Kategori eşleştirme: PttAvm kategori ID + nitelikler (renk, beden, malzeme, menşei)
• Barkod (GTIN/EAN): Mümkünse, eşleme hızını ciddi artırır
• Yerli Üretici / Coğrafi İşaret etiketi: Hak edilen ürünlerde rozet hakkı, daha düşük komisyon

PttAvm Komisyon Oranları (2026)

PttAvm 2026 komisyon oranları kategoriye göre %3 ile %18 arasında değişir — devlet sübvansiyonu sayesinde Trendyol ve Hepsiburada'nın belirgin altındadır. Komisyona %20 KDV ile hizmet bedeli ve PTT Kargo maliyeti eklenir. KOSGEB, Tarım Kredi, Coğrafi İşaret programlarındaki üreticilere ek komisyon indirimleri uygulanır.

Net kazanç hesabı: Satış fiyatı − Komisyon − KDV − Hizmet bedeli − PTT Kargo bedeli − Ürün maliyeti = Net kâr. Zunapro fiyatlama modülü bu hesabı her ürün ve kategori için otomatik yapar; KOSGEB, Coğrafi İşaret, Yerli Üretici teşvik indirimlerini de hesaba katar.

PttAvm API Entegrasyonu — Teknik Detaylar

PttAvm API, satıcıların ürün, stok, sipariş, fiyat, kargo ve iade verilerini PttAvm sistemiyle programatik olarak senkronize etmesine olanak veren RESTful bir arayüzdür. API base URL: https://ws.pttavm.com/api/v1/

API Yetkilendirme

PttAvm API, API Key + Secret (HMAC SHA-256) imzalama yöntemini kullanır. Her isteğe timestamp + HMAC SHA-256 imzası eklenir, Authorization başlığında gönderilir. Token expiry yoktur; ancak güvenlik için 6–12 ayda bir yenilemek önerilir. Resmi dokümantasyon: ws.pttavm.com/docs.

Ana Endpoint Kategorileri

• Products API — Ürün oluşturma, güncelleme, kategori eşleme, yerli üretici/coğrafi işaret rozet sorgulama
• Stock API — Stok ve fiyat senkronizasyonu (bulk endpoint maks. 100 ürün/istek)
• Orders API — Sipariş listeleme, durum güncelleme, paket oluşturma
• Categories API — PttAvm kategori ağacı, nitelik şablonları, teşvik kategorileri
• Cargo API — PTT Kargo etiketi oluşturma, takip numarası senkron
• Claims API — İade taleplerini sorgulama, kabul/red
• Webhooks — Sipariş ve stok değişikliklerinde anlık callback

Rate Limit ve Hata Yönetimi

PttAvm API hız limiti satıcı başına dakikada 40 istektir. Aşıldığında 429 Too Many Requests döner. Yaygın hata kodları: 400 (geçersiz ürün verisi), 401 (HMAC imza hatası), 404 (kategori/barkod bulunamadı), 500 (PttAvm sistem hatası — yeniden dene). Zunapro entegratörü exponential backoff retry ve dead-letter queue ile bu hataları otomatik yönetir.

PttAvm XML Entegrasyonu — Toplu Ürün Aktarımı

PttAvm XML entegrasyonu, tedarikçi veya kendi e-ticaret sitenizdeki ürün kataloğunu XML formatında otomatik okuyup PttAvm satıcı paneline aktaran sistemdir. PttAvm XML şeması TR e-ticaret standartlarına uyumludur. Manuel ürün eklemenin alternatifi olarak binlerce ürünü dakikalar içinde yüklemenizi sağlar.

XML Şema Yapısı (PttAvm Uyumlu)

PttAvm'ye yüklenecek XML'in temel alanları:

• productMainId — Ana ürün kodu (varyantları gruplar)
• brand, title, productCode, stockCode, barcode
• categoryId (PttAvm kategorisi), attributes (renk, beden, malzeme, menşei)
• quantity (stok), listPrice, salePrice, vatRate
• cargoCompanyId (PTT Kargo varsayılan), shipmentAddressId
• geographicalIndication (coğrafi işaret kodu — varsa)
• domesticProducer (yerli üretici flag), womanEntrepreneur (kadın girişimci flag)
• images (1–8 URL), description (HTML)

Tedarikçi XML'inden PttAvm'ye Aktarım

Türkiye'deki çoğu toptancı/tedarikçi ve yerel üretici (özellikle Anadolu illerindeki KOBİ'ler, coğrafi işaretli ürün üreticileri) ürün kataloglarını XML olarak paylaşır. Zunapro XML modülü:

1. Tedarikçi XML URL'ini okur (saatlik/günlük cron)
2. Kategori eşleştirmesini öğrenir (ilk eşleme manuel, sonra otomatik)
3. Marka, materyal, menşei, beden gibi attribute'ları normalize eder
4. Yerli üretici / coğrafi işaret rozetlerini otomatik atar
5. Fiyata kâr marjı + komisyon ekler (devlet teşvik indirimleri dahil)
6. Stok takibi yapar — tedarikçide kalmayan ürünleri otomatik pasifleştirir
7. PttAvm'ye API ile yükler

PttAvm Fulfillment (PTT Lojistik) — Devlet Altyapılı Lojistik Çözümü

PTT Lojistik Fulfillment, PTT'nin köklü posta + kargo altyapısı üzerine kurulu, satıcıların ürünlerini PTT'nin 17.000+ posta merkezi ağına teslim ettikten sonra depolama, paketleme, PTT Kargo ile teslimat ve iade yönetiminin tamamen PTT tarafından yapıldığı hizmettir. 2024'te genişletilen bu hizmet, PttAvm satıcıları için indirimli depolama + kargolama paketi sunar.

PTT Lojistik Fulfillment Avantajları

• 81 il tam teslimat — PTT Kargo + 17.000+ posta merkezi ağı
• Devlet altyapısı güvencesi — TC posta + telgraf teşkilatı garantisi
• Müşteri hizmetlerini PTT yönetir — iade, değişim, şikayet
• "PTT güvencesiyle teslimat" etiketi — özellikle taşra ve kırsal pazarda dönüşümü artırır
• Operasyon yükü sıfır — paketleme/kargolama yapmazsınız
• İndirimli paket — PttAvm satıcılarına özel devlet sübvansiyonlu fiyat

PTT Lojistik Fulfillment Maliyetleri (2025 yaklaşık)

• Depolama: m³/ay başına 60–120 ₺ (devlet sübvansiyonlu, özel sektörden düşük)
• Sipariş işleme: ürün başına 4–10 ₺
• İade işleme: 6–12 ₺/iade
• Komisyon: Normal PttAvm komisyonu + %0,5–1,5 fulfillment ücreti

PTT Lojistik Fulfillment, aylık 300+ siparişi olan satıcılar için maliyet-verimli olur. Düşük hacimli satıcılar kendi deposundan PTT Kargo ile direkt gönderim yapmayı tercih edebilir.

PttAvm Mağaza Performans Skoru ve İptal Oranları

PttAvm her satıcıya 1–10 arası mağaza puanı verir; bu puan vitrinde görünürlüğü doğrudan etkiler. Ayrıca "Yerli Üretici", "Kadın Girişimci" ve "Coğrafi İşaret" rozetleri ile mağaza prestiji artar. Puanı düşüren ana faktörler:

• İptal oranı — Stoksuz iptaller en büyük cezalandırıcı; %3 üstü uyarı, %6 üstü mağaza kapatma riski
• Geç kargo — Hazırlama süresi içinde PTT Kargo'ya teslim edilmeyen siparişler
• İade oranı — Beklenenin üstündeki iadeler
• Müşteri yorumu — 4.0 yıldız altı kalmamalı
• Yanıt süresi — Mesajlara 24 saat içinde dönülmeli (devlet pazaryeri standardı)

Zunapro otomatik stok senkronizasyonu ile iptal riskinizi %90 azaltırsınız; sitenizde, depoda veya başka pazaryerinde satılan ürünler PttAvm'de anında pasifleşir.

PttAvm Reklam, Devlet Teşvikleri ve Akıllı Fiyatlandırma

PttAvm Reklam Platformları

• PttAvm Sponsorlu Ürünler — Arama sonuçlarında üst sıralar (CPC bazlı, TL/tıklama)
• Yerli Üretici Vitrini — Yerli üretici rozetli ürünler için özel reklam alanı
• Coğrafi İşaret Vitrini — Coğrafi işaretli ürünlere özel sponsorluk
• Kadın Girişimci Mağaza Vitrini — Kadın girişimci sertifikalı satıcılara özel banner

Devlet Teşvikleri ve Programlar

• KOSGEB — KOBİ destek programları PttAvm üzerinden, özel komisyon indirimleri
• Tarım Kredi Kooperatifleri — Çiftçi ve tarım üreticisi indirimli komisyon
• Türk Patent — Coğrafi İşaret — Antep Fıstığı, Erzurum Cağ Kebabı, Çorum Leblebisi gibi resmi coğrafi işaretli ürünlere özel kategori + düşük komisyon
• Kadın Girişimci Sertifikası — KAGİDER veya KOSGEB onaylı kadın girişimcilere özel program
• Yerli Üretici Belgesi — TOBB onaylı yerli üretici rozetli ürünlere komisyon indirimi

Akıllı Fiyatlandırma (Repricer)

PttAvm'de fiyat rekabeti vardır; ancak Trendyol kadar yoğun değildir çünkü satıcı havuzu daha seçicidir. Zunapro repricer modülü fiyatları rakiplerinize göre saniyeler içinde otomatik ayarlar — minimum kâr eşiğinizin altına düşmez, devlet teşvik indirimlerini hesaba katar.

PttAvm E-Fatura ve E-Arşiv Entegrasyonu (GİB Uyumu)

PttAvm'den satış yapan tüm satıcılar, B2C müşterilerine e-Arşiv fatura, B2B müşterilerine e-Fatura kesmek zorundadır (GİB regülasyonu). Manuel fatura kesmek; günde 50+ siparişte mümkün değildir.

Zunapro e-Fatura modülü:

• PttAvm sipariş datası geldiği anda otomatik e-Arşiv/e-Fatura kesme
• GİB onaylı özel entegratörler ile (Logo, Mikro, Uyumsoft, Foriba, Veriban vb.)
• İade durumunda otomatik iade faturası
• Aylık KDV1, KDV2 raporlama
• Müşteriye PDF e-Arşiv otomatik e-posta + SMS

PttAvm Kargo Entegrasyonu — PTT Kargo + Alternatifler

PttAvm siparişleri varsayılan olarak PTT Kargo ile gönderilir (PTT'nin kendi kargosu, Türkiye genelinde 81 il + 17.000+ posta merkezi ile en yaygın kargo ağı). Ek olarak alternatif kargolar entegre edilebilir: Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo.

Zunapro multi-kargo modülü, sipariş ağırlığı, hedef şehir ve müşteri tercihine göre en uygun kargo şirketini otomatik seçer; etiket basar, takip numarasını PttAvm'ye otomatik gönderir. PTT Kargo'nun taşra ve kırsal kapsamı, özellikle 81 il dışında köy ve kasabalara teslimatta rakipsizdir.

PttAvm İade ve Müşteri Hizmetleri Yönetimi

Türkiye e-ticaretinde iade oranı moda kategorisinde %25–35, elektronikte %4–8, ev-yaşamda %8–12, gıdada (özellikle coğrafi işaretli ürünlerde) %2–4'tir. İade süreci doğru yönetilmezse mağaza puanı düşer.

PttAvm Standart İade Süreci:

1. Müşteri PttAvm panelinden iade talebi açar (teslim sonrası 14 gün içinde)
2. PTT Kargo ürünü ücretsiz alır (1–3 iş günü, posta merkezinden de bırakılabilir)
3. PTT deposu inceler, satıcıya yönlendirir veya iade onayı verir
4. Satıcı 1–3 iş günü içinde iade onayı/reddi verir
5. Onay verilirse müşteri parası PttAvm cüzdana iade edilir

Zunapro iade modülü tüm bu adımları otomatik takip eder; satıcıya panel bildirimi atar, müşteri iadeleri için otomatik iade faturası keser.

Zunapro ile PttAvm Entegrasyonu — 4 Adımda Kurulum (10 Dakika)

1. PttAvm Mağaza Bilgilerinizi Girin — Zunapro panelde Marketplace → PttAvm sekmesinden Mağaza ID, API key ve API secret bilgilerini girersiniz.
2. Mevcut Sitenizi Bağlayın — Shopify, WooCommerce, OpenCart, İkas, Ticimax, PrestaShop ve Magento için hazır konnektörler. API URL + access key girilir.
3. Kategori Eşleme Sihirbazı — Sitenizdeki kategorileri PttAvm kategorilerine sürükle-bırak ile eşlersiniz. Yerli üretici / coğrafi işaret rozetleri otomatik atanır.
4. İlk Senkronizasyon — Ürün, stok, fiyat, sipariş, PTT Kargo — hepsi otomatik senkron başlar. 10 dakika içinde PttAvm mağazanız Zunapro panelinden yönetilebilir.

PttAvm Entegrasyonu Hakkında Sıkça Sorulan Sorular (SSS)