KuantoKusta Entegrasyonu: Marketplace API, Karşılaştırıcı ve Tek Panelden Satış Yönetimi

KuantoKusta Hakkında: Tarihçe, Sahiplik ve Pazar Konumu

Kuruluş ve Zaman Çizelgesi (2003 – Bugün)

KuantoKusta, 2003 yılında Porto'da Paulo Pimenta tarafından küçük bir kurucu ortak grubuyla birlikte kuruldu. Orijinal ürün, bir fiyat karşılaştırma motoruydu — Portekiz'deki türünün ilk örneği — elektronik ve IT perakendecilerinden SKU bazlı fiyatları toplayan ve alışveriş yapanların en ucuz satıcıyı tek tıkla belirlemesine olanak tanıyan bir araçtı. 2000'ler ve 2010'ların başında, Portekizli alıcıların bir dizüstü bilgisayar, akıllı telefon, TV veya beyaz eşya satın almadan önce kullandığı varsayılan araç haline geldi.

2018'de KuantoKusta, karşılaştırmanın ötesine geçerek tam B2C pazaryeri'ne dönüştü; üçüncü taraf satıcıları dahil etti, ödemeyi uçtan uca yönetti ve satıcı puanlama, anlaşmazlık çözümü ile merkezi müşteri hizmetlerini devreye aldı. Şirket, KuantoKusta SA tarafından Porto'daki bir teknoloji kampüsünden işletiliyor ve karşılaştırıcı DNA'sını terk etmeden — KK Cash cashback, Minimum Fiyat düşük fiyat garantisi, mobil uygulamalar ve KuantoKusta Pro B2B programı gibi — yeni ürünleri kademeli olarak ekledi.

Sahiplik Yapısı (2025)

• KuantoKusta SA — Porto merkezli işletme şirketi
• Paulo Pimenta — Kurucu ortak, stratejik liderlik rolü
• Portekizli kurumsal yatırımcılar — Birden fazla yatırım turunda edinilen azınlık payları
• Kurucu ortaklar — Operasyonel ve yönetim kurulu katılımını sürdürüyor

Portekiz E-ticaretindeki Konum

KuantoKusta, Portekiz'deki #1 fiyat karşılaştırma platformudur ve yerli GMV açısından — Worten Marketplace, Fnac, El Corte Inglés ve Amazon.es (PT'ye sınır ötesi hizmet veren) ile birlikte — ilk 5 pazaryerleri arasında yer alır. Gücü, çevrimiçi kategori talebinin rutin olarak çift haneli payını yakaladığı elektronik, IT ve beyaz eşya alanında yoğunlaşmıştır. Satın almadan önce fiyat araştıran Portekizli tüketicileri hedefleyen satıcılar için KuantoKusta, ölçülebilir dönüşüm hızıyla yüksek niyetli trafik sunar.

KuantoKusta Pazar Büyüklüğü ve Trafik (2024–2025 Verileri)

KuantoKusta, pan-Avrupa platformlarından daha odaklı olsa da Portekiz'deki trafik ve dönüşüm yoğunluğu istisnaidir. Alıcılar satın almaya hazır şekilde gelir — platformdaki tüm satıcıların fiyatlarını zaten karşılaştırmışlardır.

Yıl	GMV (EUR)	Aylık Ziyaretçi	3P Satıcı	Temel Kategoriler
2020	~€90M	2,5M	~400	Elektronik, IT
2022	~€140M	3,4M	~620	+ Ev, Beyaz Eşya
2024	~€180M	4M+	800+	+ Güzellik, Moda, Pet, DIY, Otomotiv
2025 (tahmin)	~€215M	4,6M	950+	Tam çeşitli pazaryeri

Bu yörünge; platformun elektronik aramalarındaki hakimiyeti, KK Cash cashback'in yaygınlaşması, giderek olgunlaşan mobil uygulama ve 3P pazaryeri operasyonlarının olgunluğuyla şekilleniyor. IT, beyaz eşya veya tüketici elektroniğinde rekabetçi fiyatlı envantere sahip satıcılar için KuantoKusta, Portekiz'in en yüksek ROI sunan pazaryeri kanallarından biridir.

KuantoKusta Satıcı Hesabı Nasıl Açılır (2026 Süreci)

1. Hukuki ve Mali Gereksinimler (Portekiz)

KuantoKusta'da satış yapmak için Autoridade Tributária (AT)'ya kayıtlı aktif bir Portekiz işletme yapısına ihtiyacınız var. Şahıs şirketleri (ENI), LDA ve SA — uyumlu e-Fatura faturaları düzenleyip SAF-T PT dosyaları dışa aktarabildiğiniz sürece — uygundur.

• NIPC (Tüzel kişiler için Portekiz vergi numarası)
• Certidão Permanente (ticari sicil belgesi)
• Banka IBAN — ödemeler buraya yönlendirilir
• AT sertifikalı fatura yazılımı e-Fatura / SAF-T PT için (örn. Moloni, InvoiceXpress, PHC, Primavera)
• GDPR / CNPD müşteri verisi işleme uyumluluğu
• Marka yetki belgeleri korumalı kategoriler için (elektronik garantileri, kozmetik, bebek ürünleri)
• CE, WEEE ve REACH uyumluluk belgeleri uygulanabilir olduğunda

2. KuantoKusta Satıcı Portalı Üzerinden Başvuru

Başvurunuzu kuantokusta.pt/vender adresindeki Resmi KuantoKusta Satıcı Başvurusu üzerinden yaparsınız. KK satıcı ekibi mali belgelerinizi, ürün yelpazenizi ve fiyat duruşunuzu inceler — onay genellikle 7–14 iş günü sürer. Onaylandıktan sonra bir Satıcı ID, OAuth 2.0 client kimlik bilgileri (client ID + client secret) ve API dokümantasyonu için developers.kuantokusta.pt'ye erişim alırsınız.

📥 Resmi KuantoKusta Satıcı Başvurusu kuantokusta.pt/vender — ücretsiz başvuru, 7–14 iş günü onay →

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

KuantoKusta karşılaştırıcı UX'i miras aldığı için ürün eşleştirmesi alışılmadık derecede katıdır — temiz bir GTIN/EAN ile bağlanan listelemeler daha hızlı dönüşür ve daha yüksek sıralanır:

• Başlık: Marka + ürün hattı + temel özellik, 60–140 karakter
• Görseller: Beyaz arka plan, min 1000×1000px, 8'e kadar görsel, filigran veya bindirme metin yok
• Açıklama: HTML uyumlu, Portekizce minimum 250 karakter (IT/teknoloji için İngilizce kabul edilir)
• Kategori eşleme: KuantoKusta taksonomi ID'si + kategoriye özgü öznitelikler
• GTIN/EAN barkod: Pratik olarak zorunludur — bu olmadan karşılaştırıcı, teklifinizi kanonik ürün kartıyla hizalayamaz
• Garanti koşulları: Portekiz tüketici hukuku çoğu ürün için 3 yıl garanti gerektirir — beyan edilmelidir

KuantoKusta Komisyon Oranları (2026)

KuantoKusta komisyonları 2026'da kategoriye bağlı olarak %4 ile %18 arasında değişir; üstüne ayrıca satıcının brüt fiyatına Portekiz KDV'si (standart %23, ara %13, indirimli %6) uygulanır. Kargo ücretleri, isteğe bağlı KK Cash cashback katkısı (%1–5) ve Minimum Fiyat öncelikli yerleşim maliyetleri ek olarak gelir. Aşağıda, her Portekizli satıcının bir SKU'yu fiyatlandırmadan önce içselleştirmesi gereken üç komisyon bandı yer alıyor:

Net marj formülü: Satış fiyatı − Komisyon − KDV − KK Cash katkısı − Kargo − COGS = Net kâr. Zunapro'nun fiyatlandırma modülü, bu hesaplamayı her senkronda SKU ve kategori bazında çalıştırır; minimum marj eşiğinizin altına düşen fiyatları yayınlamayı reddeder.

KuantoKusta API Entegrasyonu — Teknik Detaylar

KuantoKusta Marketplace API, satıcıların ürün, stok, sipariş, fiyat, kargo ve iadeleri KuantoKusta arka ucu ile programatik olarak senkronize etmesine olanak tanıyan RESTful bir arayüzdür. Temel URL: https://api.kuantokusta.pt/marketplace/ — dokümantasyon developers.kuantokusta.pt'de yer alır.

API Kimlik Doğrulaması (OAuth 2.0)

Bazı eski PT platformlarının kullandığı HTTP Basic şemalarının aksine KuantoKusta, OAuth 2.0 client_credentials grant kullanır. Client ID ve client secret, /oauth/token üzerinden bearer access token ile değiştirilir; token daha sonra her istekte Authorization: Bearer <token> başlığında gönderilir. Tokenlar sona erer (genellikle 1 saat) ve yenilenmesi gerekir — Zunapro yenileme, yeniden deneme ve rotasyonu otomatik olarak yönetir.

Ana Endpoint Kategorileri

• Products API — Listelemeleri oluşturma, güncelleme, devre dışı bırakma; kategori ve öznitelik eşleme; EAN tabanlı ürün eşleştirme
• Inventory API — Stok ve fiyat senkronizasyonu (toplu endpoint, istek başına 100 SKU'ya kadar)
• Orders API — Sipariş listeleme, durum geçişleri, kargo onayı, paket eşleştirme
• Shipment API — Taşıyıcı etiketleri (CTT, DPD Portugal, MRW Portugal, Chronopost Portugal) ve takip numarası senkronizasyonu
• Returns / Claims API — İade taleplerini yönetme, kabul/red, iade işleme
• Settlements API — Ödemeler, ücretler, mutabakat raporları
• Webhooks — Sipariş oluşturma, durum değişiklikleri ve fiyat/stok güncellemelerinde gerçek zamanlı geri çağrılar

Rate Limit ve Hata Yönetimi

Standart rate limitler satıcı başına yaklaşık saniyede 10 istek civarındadır. Limit aşıldığında Retry-After başlığıyla birlikte 429 Too Many Requests döner. Yaygın hata kodları: 400 (geçersiz ürün payload'u, eksik EAN), 401 (süresi dolmuş token), 403 (hesabınız için kategori yetkili değil), 404 (kaynak bulunamadı), 500 (platform hatası — üstel geri çekilmeyle yeniden deneyin). Zunapro'nun konektörü idempotent yeniden denemeler, dead-letter kuyrukları ve circuit-breaker'lar uygular; bu sayede geçici hatalar asla yinelenen siparişler veya kayıp stok güncellemeleri üretmez.

KuantoKusta Toplu Katalog Senkronizasyonu — XML ve CSV Feed'leri

Toplu katalog senkronizasyonu, tedarikçi veya mağaza katalogunuzu tek bir işlemle KuantoKusta'ya göndermenize olanak tanır. API artımlı güncellemeler için en iyisiyken, XML/CSV feed'leri ilk kurulum ve envanterini elektronik tablolarda tutan yüksek hacimli Portekizli distribütörler için idealdir.

Feed Şeması (KuantoKusta Uyumlu)

KuantoKusta'nın beklediği temel alanlar:

• seller_sku — Dahili SKU'nuz (stok ve fiyat idempotency için kullanılır)
• ean — GTIN-13/EAN-13 — kanonik ürün eşleşmesi için gerekli
• brand, title, description (Portekizce tercih edilir)
• category_id + attributes (renk, beden, kapasite vb.)
• stock_quantity, list_price, sale_price, vat_rate (23/13/6)
• warranty_months (DL 84/2021 kapsamında varsayılan 36)
• shipping_profile_id, handling_days
• images[] (1–8 URL), energy_label (AB kuralları kapsamındaki beyaz eşyalar için)

Tedarikçi Feed'inden KuantoKusta'ya

Portekizli distribütörlerin çoğu (özellikle IT, beyaz eşya ve elektronikte) XML veya CSV katalogları sunar. Zunapro'nun feed modülü:

1. Tedarikçi feed URL'sini okur saatlik veya günlük cron üzerinden
2. Kategori eşlemesini öğrenir — ilk çalıştırmada manuel, sonrasında otomatik
3. Öznitelikleri normalize eder (marka, kapasite, enerji sınıfı, renk)
4. Marj kurallarını uygular — markup, komisyon bandı, KK Cash katkısı
5. Stoku izler — tedarikçi feed'inden kaybolan SKU'ları otomatik devre dışı bırakır
6. KuantoKusta'ya gönderir Marketplace API üzerinden

KuantoKusta Lojistik — Yalnızca 3PL Modeli

Amazon'un FBA'sının veya Trendyol'un TGF'sinin aksine, KuantoKusta satıcı fulfillment merkezi işletmez. Platform tamamen 3PL (üçüncü taraf lojistik) üzerinedir — satıcılar kendi depolarından gönderir veya bir Portekizli 3PL sağlayıcıyla anlaşır. Bu yaklaşım genel giderleri düşük tutar ancak operasyonel kalite çıtasını size yükler.

Desteklenen Taşıyıcılar

• CTT — Portekiz'in ulusal posta operatörü, ana karadan Azor/Madeira'ya en geniş kapsama
• DPD Portugal — Ertesi gün şehir içi teslimat için en iyisi, güçlü B2C takip
• MRW Portugal — İber ekspres uzmanı, İspanya'ya hızlı sınır ötesi
• Chronopost Portugal — Premium ekspres, yüksek değerli elektronikler için ideal

Lojistik Performans Hedefleri

• İşlem süresi: "Hızlı Gönderim" rozeti için sipariş onayından sonra 24 saat içinde gönder
• Zamanında teslimat: Üst satıcı statüsü için ≥%95
• Takip numarası senkronu: Aynı iş günü içinde KuantoKusta'ya iletilmeli
• İade kabulü: Teslim alındıktan sonra 3 iş günü içinde işlenmeli

3PL modeli kargo sorumluluğunu satıcıya yüklediği için çoklu taşıyıcı orkestrasyonu kritik öneme sahiptir. Zunapro'nun kargo modülü, paket başına optimal taşıyıcıyı ağırlık, hedef posta kodu ve müşteri tercihine göre seçer; etiketi basar ve takip numarasını otomatik olarak KuantoKusta'ya gönderir.

KuantoKusta Satıcı Puanı, İptal Oranı ve Buy Box

KuantoKusta her satıcıya alıcılara görünen halka açık 1–10 arası puan verir — ve bu puan, birden çok teklif içeren ürün kartında Buy Box'ı kimin kazanacağını doğrudan belirler. Puan etkenleri:

• İptal oranı — Stoksuzluk iptalleri en büyük cezadır; %2'nin üzeri uyarı tetikler, %5'in üzeri askıya alma riski oluşturur
• Geç gönderim oranı — Beyan edilen işlem süresi içinde gönderilmeyen siparişler
• İade oranı — Kategori temel düzeyinin üstü (elektronik %5–10, ev %10–15, moda %25+)
• Müşteri yorumları — 4,0 yıldızın üstünde kalmalı; 3,8'in altı alıcılara uyarı rozeti gösterir
• Yanıt süresi — Alıcı mesajları 24 saat içinde yanıtlanmalıdır
• Minimum Fiyat uyumluluğu — Düşük fiyat garantisine uyan satıcılar yerleşim önceliği kazanır

Zunapro'nun gerçek zamanlı stok senkronu iptalleri ~%90 azaltır — mağazanızda veya bağlı herhangi bir pazaryerinde gerçekleşen her satış, KuantoKusta envanterini 3–5 saniyede düşer ve satıcı puanlarını mahveden aşırı satış senaryosunu ortadan kaldırır.

KuantoKusta Reklamcılık, KK Cash ve Repricer

Reklam Yüzeyleri

• Sponsorlu Listelemeler — Karşılaştırma sayfalarında ve arama sonuçlarında üst yerleşim (CPC tabanlı, EUR/tıklama)
• KK Cash cashback katkısı — Satıcı tarafından %1–5 ortak finansman, fiyata duyarlı alışverişçilerde dönüşümü dramatik şekilde artırır
• Minimum Fiyat yerleşimi — Düşük fiyat garantisini onurlandıran satıcılar için premium rozet
• Kategori bazlı banner'lar — Köklü tüccarlar için display ve marka mağazası reklamcılığı
• KuantoKusta Pro — Toplu fiyat kademeleriyle Portekiz KOBİ'lerini hedefleyen özel B2B program

Repricer — Karşılaştırıcıyı Kazanmak

KuantoKusta temelde bir fiyat karşılaştırıcısı olduğu için Buy Box savaşı acımasızdır: 10+ satıcı aynı EAN'ı listelediğinde, en düşük nitelikli fiyat (satıcı puanıyla birlikte) kazanır. Zunapro'nun repricer modülü, fiyatınızı saniyeler içinde rakiplere karşı yeniden konumlandırır — her zaman minimum marj eşiğinizin üzerinde. Bileşik dönüşüm artışı için KK Cash ve Minimum Fiyat ile birleştirin.

KuantoKusta e-Fatura ve SAF-T PT Uyumluluğu

Portekizli B2C veya B2B alıcılara fatura kesen her satıcı, AT sertifikalı fatura yazılımı üzerinden uyumlu e-Fatura faturaları düzenlemeli ve aylık SAF-T PT dışa aktarmalarını Autoridade Tributária'ya göndermelidir. Manuel faturalama günde 100 siparişi geçtikten sonra çöker.

Zunapro'nun e-Fatura modülü:

• KuantoKusta siparişi onaylandığı anda otomatik fatura düzenleme
• AT sertifikalı sağlayıcılarla entegrasyonlar (Moloni, InvoiceXpress, PHC, Primavera, Vendus)
• İade ve geri ödemelerde otomatik alacak dekontu düzenleme
• AT'ye gönderim için hazır aylık SAF-T PT dışa aktarımı
• PDF fatura otomatik olarak müşteriye e-posta ile gönderilir; opsiyonel SMS bildirimi
• Alıcı kayıtları için GDPR / CNPD uyumlu veri yönetimi

KuantoKusta Kargo — CTT, DPD Portugal, MRW Portugal, Chronopost

KuantoKusta yalnızca 3PL olduğu için kargo karışımınız operasyonel kalenizdir. Zunapro ile entegre dört üretim seviyesi Portekizli taşıyıcı:

• CTT — Azor ve Madeira dahil ulusal kapsama, en geniş teslim alma noktası ağıyla
• DPD Portugal — Hızlı şehir içi ertesi gün, güçlü B2C takip UX
• MRW Portugal — İber ekspres, sınır ötesi PT↔ES için en hızlı seçenek
• Chronopost Portugal — Yüksek değerli veya kırılgan elektronik için premium ekspres

Zunapro'nun çoklu taşıyıcı modülü, paket ağırlığına, hedef posta koduna ve müşteri tercihine göre sipariş başına optimal taşıyıcıyı fiyat karşılaştırır; etiketleri basar, takip numaralarını KuantoKusta'ya gönderir ve satıcı puanını gerçek zamanlı günceller.

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

Portekiz tüketici hukuku (DL 24/2014) kapsamında alıcılar, herhangi bir mesafeli sözleşmede 14 günlük cayma hakkına sahiptir — gerekçe gerekmez. Ek olarak, DL 84/2021 çoğu tüketici malı için 3 yıllık yasal garanti zorunlu kılar. İadeler rutindir; yanlış yönetimi satıcı puanını yok eder.

Standart KuantoKusta iade akışı:

1. Alıcı, teslimattan sonraki 14 gün içinde KuantoKusta portalı üzerinden iade talebi açar
2. Satıcı ters lojistiği organize eder (CTT, DPD Portugal, MRW Portugal veya Chronopost Portugal)
3. Alıcı ürünü geri gönderir; satıcı gelince inceler
4. Satıcı iadeyi 3 iş günü içinde onaylar/reddeder
5. Onaylandığında iade, alıcının orijinal ödeme yöntemine veya KK Cash cüzdanına yapılır
6. Zunapro otomatik olarak e-Fatura alacak dekontunu düzenler ve envanteri günceller

Zunapro'nun iade modülü her adımı orkestre eder — satıcı bildirimleri, ters lojistik etiketleri, otomatik alacak dekontu düzenleme ve SLA takibi.

Zunapro × KuantoKusta — 4 Adımlı Kurulum (10 Dakika)

1. KuantoKusta kimlik bilgilerinizi girin — Zunapro panelinde Pazaryeri → KuantoKusta'yı açın ve satıcı portalından Satıcı ID, OAuth client ID ve client secret'ı yapıştırın.
2. Mağazanızı bağlayın — Shopify, WooCommerce, Magento, PrestaShop, OpenCart ve özel REST API'leri için hazır konektörler. Tek URL + erişim anahtarı.
3. Kategori eşleme sihirbazı — Mağaza kategorilerinizi KuantoKusta taksonomisine sürükleyip bırakın; AI öneri motoru gerisini önerir. EAN tabanlı ürün eşleştirme otomatik çalışır.
4. İlk senkronizasyon — Ürünler, stok, fiyatlar, siparişler ve kargo otomatik senkronize olur. 10 dakika içinde KuantoKusta mağazanız Zunapro panelinden uçtan uca çalışır.

KuantoKusta Entegrasyonu — Sık Sorulan Sorular