Allegro Entegrasyonu: REST API, Smart!, Allegro Pay ve Tek Panelden Mağaza Yönetimi

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

Kuruluş ve Kronoloji (1999 – Bugün)

Allegro, Aralık 1999'da Poznań'da Hollandalı girişimci Arjan Bakker tarafından çevrimiçi açık artırma platformu olarak — Polonya'nın eBay muadili olarak — kuruldu. 2000'li yılların ortalarına gelindiğinde ülkenin varsayılan pazaryeri haline gelmişti. 2008'de Güney Afrika kökenli medya holdingi Naspers tarafından satın alındı ve yaklaşık on yıl boyunca küresel ilan ve e-ticaret portföyünün bir parçası olarak işletildi.

Ekim 2016'da Permira, Cinven ve Mid Europa Partners'tan oluşan bir özel sermaye konsorsiyumu, Allegro'nun yaklaşık 3,25 milyar dolara satın alındığını duyurdu — o dönemde Orta ve Doğu Avrupa'da kaydedilen en büyük kaldıraçlı satın alma. 12 Ekim 2020'de şirket, yaklaşık 11 milyar € değerleme ile WSE:ALE sembolü altında Varşova Borsası'nda işlem görmeye başladı ve Polonya tarihinin en büyük halka arzı oldu. Bugün Allegro Group; ana pazaryerini, Allegro Smart! aboneliğini, Allegro Pay BNPL hizmetini, One Fulfillment'ı, Allegro Lokalnie'yi (C2C) ve Allegro Ceneo'yu (fiyat karşılaştırma) işletir — merkezi Poznań'da, büyük ofisleri Warsaw'da bulunan dikey entegre bir ticaret ekosistemi.

Allegro Sahiplik Yapısı (2025)

• Halka açık kısım (WSE:ALE) — Hisselerin büyük çoğunluğu 2020 halka arzından bu yana Varşova Borsası'nda işlem görmektedir
• Cinven, Permira, Mid Europa Partners — Orijinal özel sermaye sponsorları; 2021–2024 arası ikincil satışlar yoluyla kademeli çıkış
• Kurumsal yatırımcılar — Polonyalı emeklilik fonları (OFE), BlackRock, Vanguard, Norges Bank
• Allegro.eu S.A. — Lüksemburg merkezli ana holding şirketi
• Yönetim ve çalışanlar — Uzun vadeli teşvik planı (LTI) hisseleri

Polonya E-Ticaretindeki Konumu

2024 itibarıyla Allegro, Polonya'nın online perakende harcamasının yaklaşık %45–50'sini elinde tutuyor — Amazon.pl, Empik ve yükselen Çinli platformların oldukça önünde. Polonyalı online alışverişçilerin tahmini %80'inin bir Allegro hesabı vardır ve Allegro mobil uygulaması Google Play ve App Store'da Polonya'nın #1 alışveriş uygulaması olarak istikrarla yer alır.

Allegro Satış Hacmi ve Ölçeği (2024–2025 Verileri)

Allegro, 2020 halka arzından bu yana istikrarlı bir şekilde büyüdü; GMV'sini bir bütün olarak Polonya e-ticaretinden daha hızlı ölçeklendirdi. Çek Cumhuriyeti, Slovakya ve Macaristan'a uluslararası genişleme (2022 Mall Group satın alımı yoluyla) baskın Polonya çekirdeğinin üzerine ikinci bir büyüme motoru ekledi.

Yıl	Polonya GMV (EUR)	Siparişler	Aktif Alıcılar	Aktif 3P Satıcılar
2020	~8 milyar €	350 milyon	13M	90K
2022	~12 milyar €	540 milyon	18M	110K
2024	~15 milyar €	~680 milyon	22M+	130K+
2025 (tahmin)	~17 milyar €	~750 milyon	24M	150K

Büyüme, Allegro Smart!'ın olgunluğa erişmesi (artık 7 milyonu aşan ödeyen abone), One Fulfillment'ın hızlı ölçeklenmesi ve Polonya'nın eşsiz InPost paket-dolabı ağı tarafından desteklendi — ülke çapında 25.000'in üzerinde dolapla Avrupa'nın en yoğun ağı. Allegro'da satış yapmak, Polonyalı online tüketicilere ulaşmanın en hızlı yoludur ve daha geniş Orta-Doğu Avrupa bölgesi için doğal bir rampa görevi görür.

Allegro Satıcı Hesabı Açma (2026 Gereksinimleri)

1. Yasal ve Vergi Ön Koşulları

Allegro'da satış yapmak için aktif bir AB tüzel kişiliğine ihtiyacınız vardır. Bir Polonyalı sp. z o.o., spółka akcyjna, şahıs şirketi (jednoosobowa działalność gospodarcza) veya herhangi bir AB KDV kayıtlı şirket uygun kabul edilir. Şubat 2026'dan itibaren KSeF (Polonya e-fatura sistemi — Ulusal e-Fatura Sistemi) üzerinden yapılandırılmış fatura B2B ve B2G işlemler için zorunlu hale gelir — uyumsuzluk ciddi cezalar getirir.

• NIP (Polonya KDV numarası) veya OSS kaydı olan AB KDV kimliği
• REGON / KRS (Polonyalı tüzel kişiler için şirket sicil belgesi)
• Banka hesabı PLN veya EUR cinsinden — ödemeler buraya yatar
• KSeF (Polonya e-fatura sistemi) uyumlu e-fatura entegratörü (Comarch, Symfonia, Asseco WAPRO, inFakt vb.)
• BDO atık kayıt girişi (ambalaj, elektronik için WEEE/ZSEE)
• Marka belgeleri korunan kategoriler için (kozmetik, gıda, oyuncak, markalı ürünler)
• RODO/GDPR işleyici sözleşmesi Allegro ile

2. Allegro Satıcı Paneline Başvuru

Satıcılar allegro.pl/sprzedawaj/zostan-sprzedawca üzerinden başvurur. Onay genellikle 3–7 iş günü sürer. Onay alındıktan sonra developer.allegro.pl üzerinde bir OAuth 2.0 uygulaması kaydedebilir ve client_id ile client_secret'inizi alabilirsiniz — her ikisi de REST API entegrasyonu için gereklidir.

📥 Resmi Allegro Satıcı Başvurusu allegro.pl/sprzedawaj — ücretsiz başvuru, 3–7 iş günü onay →

3. Teklif Listeleme ve İçerik Kuralları

Allegro, arama sıralamasını ve Smart! uygunluğunu doğrudan etkileyen sıkı listeleme kalite standartları uygular:

• Başlık: 75 karaktere kadar, marka + ürün adı + temel özellik, BÜYÜK HARF veya promosyon dili yok
• Görseller: beyaz arka plan, minimum 1200×1200px, 16 görsele kadar, filigran veya satıcı logosu yok
• Açıklama: yapılandırılmış içerik blokları (metin/görsel/başlık), minimum 200 karakter
• Kategori eşleme: hassas Allegro kategori ID'si + parametreler (renk, beden, EAN, marka)
• EAN/GTIN: çoğu kategoride zorunludur — katalog eşleştirme ve fiyat karşılaştırmayı yönlendirir
• Uyumluluk belgeleri: düzenlenen kategoriler için CE, REACH, ZSEE/WEEE beyanları

Allegro Komisyon Oranları (2026)

2026 yılı için Allegro komisyon oranları kategoriye göre yaklaşık %5 ile %22 arasında değişir, ayrıca %1'den başlayan küçük bir temel kategori ücreti ve belirli dikeylerde liste başı ücretler eklenir. Ücretlerin üzerine Polonya KDV'si (PTU %23) uygulanır. Komisyon + KDV + tedarik modellemeden fiyat belirlemek, yeni satıcıların yaptığı en yaygın hatadır. Üç temel kademe:

Net marj formülü: Satış fiyatı − Komisyon − Kategori/listeleme ücretleri − KDV (PTU %23) − Kargo maliyeti − Ürün maliyeti = Net kâr. Zunapro fiyatlandırma modülü, bu hesaplamayı SKU başına ve kategori başına yürütür ve tekliflerin minimum kâr eşiğinizin altında yayınlanmasını engeller.

Allegro REST API Entegrasyonu — Teknik Detaylar

Allegro REST API, satıcıların teklifleri, stoğu, fiyatları, siparişleri, sevkiyatları ve iadeleri programatik olarak yönetmesini sağlayan modern RESTful bir arayüzdür. Temel URL: https://api.allegro.pl/ — dokümantasyon developer.allegro.pl adresinde.

OAuth 2.0 Yetkilendirme

Allegro REST API OAuth 2.0 kullanır. apps.developer.allegro.pl üzerinde bir uygulama kaydettikten sonra, client_id ve client_secret'i Authorization Code akışı (satıcıya yönelik uygulamalar için) veya Client Credentials akışı (sunucudan sunucuya görevler için) yoluyla bir bearer erişim belirteci ile değişirsiniz. Erişim belirteçleri kısa ömürlüdür (12 saat); yenileme belirteçleri birkaç ay sürer ve her kullanımda döner.

Temel Endpoint Kategorileri

• Offers API — teklif oluşturma, güncelleme, etkinleştirme/devre dışı bırakma, varyant ve parametre yönetimi
• Sale endpoints — stok ve fiyat güncellemeleri (toplu işlemler desteklenir)
• Orders API — checkout-form'larını (siparişler) listeleme, sevkiyat durumunu güncelleme, kargoları yönetme
• Kargo yönetimi — kurye hesapları, kargo etiketleri, InPost entegrasyonu
• İadeler ve uyuşmazlıklar — Allegro Protect talepleri, iade verme
• Billing API — ücretler, faturalar, uzlaşma mutabakatı
• Allegro Pay — BNPL ödeme durumu, ödeme takibi
• Webhooks / Event Stream — neredeyse gerçek zamanlı sipariş, iade ve teklif olayları

Oran Limitleri ve Hata İşleme

Varsayılan Allegro REST API oran limitleri, uygulama başına yaklaşık dakikada 9.000 istek civarında olup endpoint başına alt limitlere sahiptir. Limit aşımı Retry-After başlığıyla birlikte 429 Too Many Requests döndürür. Sık karşılaşılan hatalar: 400 (doğrulama), 401 (süresi dolmuş belirteç), 403 (yetersiz OAuth kapsamı), 404 (teklif/kategori bulunamadı), 422 (iş kuralı ihlali), 5xx (Allegro altyapısı). Zunapro konnektörü; üstel geri çekilme yeniden deneme, idempotency anahtarları ve dead-letter kuyruğu uygular; böylece geçici arızalar mağazanızı asla durdurmaz.

Allegro Toplu Teklif İçe Aktarımı — Tedarikçi Beslemeleri & XML

Allegro toplu teklif içe aktarımı, tedarikçi beslemesi, ERP dışa aktarımı veya mağaza katalogunuzdan binlerce SKU'yu manuel veri girişi olmadan doğrudan Allegro'ya yüklemenizi sağlar. Allegro, eski XML beslemeleri yerine yapılandırılmış REST yüklerini tercih etse de Zunapro herhangi bir kaynaktan gelen XML, CSV, JSON ve doğrudan veritabanı beslemelerini Allegro uyumlu teklif nesnelerine normalize eder.

Allegro Teklif Şeması (Temel Alanlar)

Her Allegro teklifi aşağıdaki temel alanlara eşlenir:

• name — teklif başlığı (≤75 karakter)
• category.id — Allegro kategori ID'si
• parameters — gerekli özellikler (marka, renk, EAN, durum)
• product.id / ean — katalog eşleştirme
• sellingMode.price — PLN fiyat, format 1 247,50 zł
• stock.available — miktar
• delivery.shippingRates.id — kargo oran kümesi
• images (1–16 URL), description.sections (yapılandırılmış içerik blokları)
• compatibilityList — otomotiv yedek parça için

Distribütör Beslemesi → Allegro Hattı

Birçok Polonyalı toptancı (ve Polonya pazarına hizmet veren pan-Avrupa distribütörü — ABC Data, Action, AB SA, TIM SA ve diğerleri) ürün kataloglarını XML veya REST beslemeleri olarak sunar. Zunapro distribütör modülü:

1. Tedarikçi beslemesini yoklar saatlik veya günlük programda
2. Kategori eşlemesini öğrenir (önce manuel geçiş, ardından AI destekli)
3. Marka, malzeme ve beden parametrelerini normalize eder Allegro'nun kontrollü sözlüklerine
4. Kategori başına marj + komisyon ekler
5. Stok ve fiyat değişikliklerini takip eder — stoğu biten SKU'lar otomatik olarak devre dışı bırakılır
6. Teklifleri REST API üzerinden Allegro'ya gönderir tam doğrulama ile

One Fulfillment (Fulfillment by Allegro) — FBA Muadili

One Fulfillment, Allegro'nun kendi uçtan uca tedarik hizmetidir; Polonya pazarında Amazon FBA'nın en yakın muadilidir. Satıcılar envanteri Warsaw ve Łódź yakınlarındaki Allegro depolarına gönderir; ardından Allegro depolama, toplama, paketleme, son kilometre teslimat (ağırlıklı olarak InPost paket dolapları üzerinden) ve müşteri iadelerini halleder. Hizmet 2023'ten bu yana hızla genişledi ve şimdi Smart! uygunluğu için temel bir kaldıraçtır.

One Fulfillment Avantajları

• Aynı gün / ertesi gün teslimat — öncelikli kabul saatleriyle otomatik Allegro Smart! rozeti
• Daha yüksek Buy Box kazanma oranı — One Fulfillment teklifleri aramada belirgin biçimde daha üst sıralarda yer alır
• Allegro müşteri hizmetlerini yönetir — iadeler, değişimler ve uyuşmazlık aracılığı
• "Bugün sipariş ver, yarın al" rozeti — dönüşümü %15–25 artırdığı kanıtlanmıştır
• Sıfır operasyonel yük — şirket içi toplama, paketleme veya etiket basımı yok
• Yerel InPost entegrasyonu — doğrudan Polonya'nın #1 lojistik ağına bağlanır

One Fulfillment Maliyetleri (2025 yaklaşık)

• Depolama: ayda m³ başına ~12–25 zł
• Sipariş işleme: toplanan birim başına 4–9 zł
• İade işleme: iade edilen ürün başına 6–12 zł
• Komisyon: standart Allegro kategori komisyonu + ~%1–2 One Fulfillment ek ücreti

One Fulfillment, ayda 500+ siparişi olan satıcılar için maliyet açısından verimli hale gelir. Düşük hacimli satıcılar, hacimler ölçeklenene kadar kendi deposundan InPost veya bir kurye entegrasyonu üzerinden gönderim yapmalıdır.

Allegro Smart! ve Allegro Pay — Dönüşüm Çarpanları

Allegro Smart! Aboneliği

Allegro Smart!, Allegro'nun ücretli sadakat programıdır — Polonya'nın Amazon Prime muadili. Yıllık yaklaşık 59 zł ücret karşılığında aboneler, belirli bir sepet tutarının üzerindeki uygun tekliflerde ücretsiz teslimat (InPost dolaplara, kurye veya Allegro One Box'a) ve ücretsiz iade alır. 7+ milyon ödeyen abone ile — aktif alıcıların neredeyse yarısı — Smart! rozeti platformdaki en güçlü dönüşüm sürücülerinden biridir. Uygunluk kazanan teklifler (ücretsiz kargo, uygun kategori ve satıcı puanı yoluyla) çok daha fazla Buy Box gösterimi kazanır.

Allegro Pay — Ödemede BNPL

Allegro Pay, Allegro'nun kendi bünyesindeki Şimdi Al, Sonra Öde hizmetidir. Alıcılar ödemeyi 30 gün erteleyebilir veya ödeme adımında taksitlere bölebilir; kredi riskini Allegro üstlenir. Satıcı tarafında Allegro Pay ödemeleri standart siparişlerle aynı şekilde uzlaştırılır — Allegro Pay'i kabul etmek için ek ücret yoktur ve BNPL'nin mevcudiyeti tipik olarak elektronik, moda ve mobilya dikeylerinde AOV'yi %20–35 artırır.

Allegro Satıcı Puanı, Super Seller Statüsü ve İptal Limitleri

Allegro, satıcıları sürekli olarak değerlendirir ve kalite eşiklerini istikrarla karşılayanlara "Super Seller" (Super Sprzedawca) rozeti sunar. Bu rozet, arama sıralamasında ve Smart! uygunluğunda en güçlü sinyallerden biridir. Temel kaldıraçlar:

• İptal oranı — stoğu biten ürün iptalleri tek başına en büyük cezadır; %2'nin üzeri uyarı tetikler, %5'in üzeri hesap askıya alma riski oluşturur
• Geç sevkiyat — belirtilen işleme süresi içinde gönderilmeyen siparişler
• İade oranı — kategori kıyaslarına göre aşırı iade hacmi (moda için %25+ normaldir)
• Müşteri puanları — Super Seller için 12 ay boyunca %98'in üzerinde olumlu kalmalıdır
• Yanıt süresi — mesajlar 24 saat içinde, ideali 12 saatin altında yanıtlanır

Zunapro otomatik stok senkronizasyonu, iptal riskini yaklaşık %90 azaltır — mağazanızda, deponuzda veya başka bir pazaryerinde bir birim satıldığı an, ilgili Allegro teklifi saniyeler içinde güncellenir.

Allegro Ads, Promosyonlar ve Akıllı Fiyat Ayarlama

Allegro Reklam Yüzeyleri

• Allegro Ads (Sponsorlu Teklifler) — arama sonuçlarında ve kategori sayfalarında CPC tabanlı yerleşimler
• Allegro Ads — Display — Allegro mülklerinde ve Ceneo'da banner ve zengin medya
• Brand Zone — özel markalı resmi marka mağazaları (üreticiler/marka sahipleri)
• Smart! promosyonları — Smart! ekosisteminde ve Allegro Days kampanyalarında öne çıkan slotlar

Akıllı Fiyat Ayarlama

Allegro'da Buy Box rekabeti yoğundur, özellikle düzinelerce satıcının aynı EAN'ı listelediği elektronik, kitap ve gıda gibi katalog eşleştirilmiş kategorilerde. En düşük kapıya teslim fiyat (güçlü bir satıcı puanıyla) kazanır. Zunapro fiyat ayarlayıcı modülü, teklif fiyatlarını saniyeler içinde adlandırılmış rakiplere karşı yeniden dengeler — kategori başına tanımladığınız minimum marj tabanını asla aşmaz.

Allegro Siparişleri için KSeF E-Fatura (Polonya Uyumluluğu)

Polonya'nın Ulusal e-Fatura Sistemi (KSeF / Krajowy System e-Faktur), KAS (Krajowa Administracja Skarbowa) tarafından yönetilir ve Şubat 2026'da B2B ve B2G işlemler için zorunlu hale gelir. Her fatura yapılandırılmış XML (FA(2) şeması) olarak düzenlenmeli, KSeF'ye iletilmeli ve resmi bir makbuz (UPO) atanmalıdır. Anlamlı bir satış hacminde manuel fatura kesimi imkansızdır — ve B2C siparişleri yine de uygun KDV belgelendirmesi artı aylık JPK_VAT raporlaması gerektirir.

Zunapro KSeF modülü:

• Allegro siparişi alındığı anda otomatik yapılandırılmış fatura oluşturma
• Sertifikalı entegratörler aracılığıyla doğrudan KSeF iletimi (Comarch, Asseco WAPRO, Symfonia, inFakt, fakturownia)
• İade ve geri ödemelerde otomatik alacak dekontları (faktura korygująca)
• Aylık JPK_VAT ve JPK_FA dosya oluşturma
• PDF fatura, alıcılara e-posta + alıcı paneli aracılığıyla otomatik teslim
• Tam GDPR (RODO) uyumluluğu ve UODO veri-işleme kayıt girişleri

Allegro Kargo Entegrasyonu — InPost + Kuryeler

Polonya e-ticaret lojistiğine InPost paket dolapları (Paczkomat) hakimdir — Allegro'da geniş bir farkla en çok kullanılan teslimat yöntemi ve Smart!'ın belkemiği. Satıcılar ayrıca DPD Polska, DHL Polska, GLS Polska, Poczta Polska ve Allegro Kurier (Allegro'nun kendi kurye hizmeti) seçeneklerini sunabilir. Çekya, Slovakya ve Macaristan'a sınır ötesi kargo entegre Allegro uluslararası ağı üzerinden desteklenir.

Zunapro'nun çoklu-kurye modülü, ağırlık, varış noktası, beyan edilen SLA ve alıcının tercih ettiği teslimat yöntemine (Smart! dolap seçimi dahil) göre sipariş başına en uygun taşıyıcıyı otomatik seçer; etiketleri basar, takip numaralarını yakalar ve bunları otomatik olarak Allegro'ya geri yollar.

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

Polonya tüketici hukuku, B2C alımlar için 14 günlük cayma hakkı tanır ve Allegro sıkı bir 2 yıllık garanti (rękojmia (Polonya garantisi)) uygular. İade oranları kategoriye göre değişir: moda tipik olarak %25–35, elektronik %5–10, ev & yaşam %8–15. İadeleri kötü yöneten satıcıların puanı hızla düşer.

Standart Allegro İade Akışı:

1. Alıcı, teslimattan sonraki 14 gün içinde Allegro panelinde bir iade açar
2. Ücretsiz InPost dolap bırakma veya kurye alımı otomatik olarak oluşturulur
3. Ürün satıcıya (veya One Fulfillment için Allegro deposuna) ulaşır
4. Satıcı, iadeyi 14 gün içinde onaylar veya reddeder
5. Geri ödeme, alıcının Allegro Pay bakiyesine veya orijinal ödeme yöntemine yapılır

Zunapro iade modülü, her adımı izler, panel bildirimleri gönderir, ilgili alacak dekontunu (faktura korygująca) KSeF'de oluşturur ve stoğu otomatik olarak günceller.

Zunapro ile Allegro Entegrasyonu — 4 Adımlı Kurulum (10 Dakika)

1. Allegro Kimlik Bilgilerinizi Girin — Zunapro panelinde Pazaryeri → Allegro'ya gidin, OAuth 2.0 client_id ve client_secret'inizi yapıştırın, ardından satıcı hesabını yetkilendirin.
2. Mağazanızı Bağlayın — Shopify, WooCommerce, Magento, PrestaShop, BaseLinker dışa aktarımları ve özel REST API'ler için önceden hazırlanmış konnektörler. URL'yi ve erişim anahtarını girin.
3. Kategori Eşleme Sihirbazı — Mağaza kategorilerinizi Allegro'nun kategori ağacına sürükleyip bırakın. AI önerileri eşlemeyi dakikalar içinde tamamlar; EAN eşleştirme Allegro'nun kataloğuyla otomatik hizalanır.
4. İlk Senkronizasyon — Ürünler, stok, fiyatlar, siparişler, kargo, KSeF fatura — her senkronizasyon otomatik olarak başlar. 10 dakika içinde Allegro mağazanız Zunapro panelinden tam olarak yönetilir.

Allegro Entegrasyonu Sıkça Sorulan Sorular (SSS)