OLX Portekiz Entegrasyonu: API, OLX Pro ve İlan+Yeni Mal Yönetimi

OLX Portekiz Hakkında: Kuruluş, Sahiplik ve Pazar Konumu

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

OLX ("OnLine eXchange"), 2006'da Arjantinli girişimci Alec Oxenford ve Fransız-Amerikalı yatırımcı Fabrice Grinda tarafından gelişmekte olan pazarlar için mobil öncelikli bir ilan platformu olarak uluslararası ölçekte kuruldu. Portekiz operasyonu OLX Portekiz, 2009'da faaliyete geçti ve yerel piyasayı hızla konsolide ederek iki köklü Portekiz ilan markasını satın aldı: Custojusto.pt ve Coisas.com. 2014 yılına gelindiğinde birleşmiş operasyon doğrudan rekabeti fiilen ortadan kaldırmış ve OLX, Portekiz'de hem C2C hem de gelişmekte olan B2C ilanlar için varsayılan destinasyon haline gelmişti.

2014'te Naspers (Güney Afrika'nın en büyük medya ve teknoloji holdingi) OLX'i küresel ölçekte satın aldı ve e-ticaret portföyüne dahil etti. 2019'da Naspers, uluslararası internet varlıklarını Prosus N.V. (Amsterdam borsa kodu AMS:PRX) çatısı altında ayrıştırdı; bu yapı bugün OLX Group ile birlikte Tencent, Delivery Hero, Swiggy ve iFood yatırımlarını barındırıyor. OLX Portekiz'in merkezi Lizbon'da bulunuyor ve profesyonel satıcılar için yerelleştirilmiş OLX Pro katmanını işletiyor.

OLX Portekiz Ortaklık Yapısı (2026)

• Prosus N.V. (AMS:PRX) — OLX Group'un doğrudan ana şirketi
• Naspers — Prosus N.V.'nin çoğunluk hissedarı, Güney Afrikalı medya grubu
• OLX Group — Brezilya, Polonya, Romanya, Ukrayna, Hindistan, Portekiz ve diğer ülke birimlerini işleten operasyonel holding
• Alec Oxenford, Fabrice Grinda — Kurucu ortaklar, Naspers satın alımı sonrası operasyondan ayrıldı
• OLX Portugal S.A. — Lizbon merkezli ülke kuruluşu, .pt platformunu ve OLX Pro'yu işletiyor

Portekiz E-ticaret ve İlan Pazarındaki Konumu

OLX Portekiz, ilan ve pazaryerinin kesişiminde benzersiz bir konumda bulunuyor. Worten, FNAC ve Amazon.es/Amazon.fr Portekiz'de saf yeni mal e-ticaretinde önde olsa da, OLX ikinci el otomobil, ikinci el elektronik, ikinci el moda ve B2C emlak ilanları alanında baskın konumda. Kardeş markası Imovirtual (yine OLX Group bünyesinde) emlak dikeyini ele alıyor. 10,3M nüfuslu bir ülkede 5M+ aylık aktif kullanıcısı ile OLX, kabaca her 2 Portekizli yetişkinden 1'ine ulaşıyor — bu da onu ülkenin en yüksek erişimli dijital ilan platformu yapıyor.

OLX Portekiz Hacim ve Erişim (2024–2026 Verileri)

GMV yayımlayan saf transaksiyonel pazaryerlerinden farklı olarak OLX başarıyı ilan hacmi, aylık aktif kullanıcı (MAU) ve lead-to-deal dönüşümü üzerinden ölçüyor. Portekiz birimi son üç raporlama döneminde yıllık %12–18 büyüme gösterdi.

Yıl	Aylık Aktif Kullanıcı	Yıllık İlanlar	OLX Pro Hesapları (PT)	Aktif Dikey Sayısı
2020	~3,2M	18M	3,1K	7
2022	~4,1M	23M	5,4K	8
2024	~5M+	30M+	8K+	9
2026 (tahmin)	~5,5M	34M	10K	9

Büyüme volanı ikinci el otomobiller (Portekiz'in en büyük ikinci el araç ilan kanalı), emlak (kardeş markası Imovirtual ile birlikte) ve OLX Pro kurumsal hesaplarının hızlı genişlemesi tarafından sürükleniyor. Yeni mal satıcıları için bu, kitlenin zaten fırsat aradığı bir pazaryerine katılmak demek — ve burada saf e-ticaret oyuncularıyla rekabet, Amazon veya Worten'a göre çok daha düşük.

OLX Pro Portekiz Hesabı Açma (2026 Güncel Kurallar)

1. Yasal ve Vergi Gereksinimleri

OLX Pro Portekiz'de satış yapmak için aktif bir Portekiz vergi mukimliği gerekiyor. Bireysel girişimci (Empresário em Nome Individual / ENI), Lda. veya S.A. yapılarının tümü kabul ediliyor, ancak Autoridade Tributária (AT) ile NIF kaydı ve e-Fatura uyumluluğu (SAF-T PT) Pro hesaplar için zorunlu.

• NIF (Número de Identificação Fiscal) — Portekiz vergi kimlik numarası
• AT kaydı doğru CAE faaliyet kodu ile
• Ticaret sicil kaydı (Registo Comercial) Lda./S.A. için
• IBAN (Portekiz banka hesabı) — ödeme ve mutabakat için zorunlu
• e-Fatura / SAF-T PT sertifikalı bir faturalama yazılımı sağlayıcısı üzerinden
• Uygulanabilir sektör lisansları: galericiler için IMT lisansı, emlak ofisleri için AMI lisansı, gıda/kozmetik için ASAE kaydı

2. OLX Pro Portekiz Portalı Üzerinden Başvuru

Kurumsal profilinizi olx.pt/pro üzerinden gönderirsiniz. Onay tipik olarak 3–7 iş günü sürer. Onaylandıktan sonra OLX Pro hesap kimliğinizi (sellerId), API anahtarınızı ve webhook imza secret'ınızı alırsınız — bu üç kimlik bilgisi, Zunapro'nun ilan ve lead senkronizasyonunu başlatmak için ihtiyaç duyduğu her şeydir.

📥 Resmi OLX Pro Portekiz Satıcı Başvurusu olx.pt/pro — ücretsiz başvuru, 3–7 iş günü onay →

3. İlan Kalite Kuralları

OLX Portekiz, özellikle kurumsal satıcıların daha yüksek bir standartta tutulduğu Pro hesaplar için katı ilan kalite kuralları uyguluyor:

• Başlık: 30–70 karakter, marka + model + durum + temel özellik
• Görseller: minimum 4 fotoğraf, maksimum 12, filigran yok, görselde telefon numarası yok
• Açıklama: minimum 200 karakter, düz metin + yapılandırılmış öznitelikler
• Kategori eşleştirme: doğru OLX kategori ID + öznitelikler (yıl, kilometre, durum vb.)
• Durum bayrağı: new, used, refurbished — garanti kuralları için kritik
• Kalite puanı: 70/100 üzerinde kalmalı; eşik altında ilan görünürlük kaybeder

OLX Pro Portekiz Fiyatlandırması ve Abonelik Katmanları (2026)

Yüzdesel komisyon alan pazaryerlerinin aksine, OLX Pro Portekiz abonelik modeli kullanır. İlanların kendisi katmanınız dahilinde sınırsızdır; gelir aylık ücretler artı opsiyonel boost'lardan (öne çıkan yerleşim, anasayfa vurgu, arama üstü tanıtım) gelir. Üzerine %23 KDV eklenir. 2026 sadeleştirilmiş katman yapısı şöyle:

Net marj hesaplaması: Satış fiyatı − OLX Pro abonelik maliyet payı − KDV − kargo − ürün maliyeti = net marj. Zunapro fiyatlandırma modülü bu hesaplamayı ilan ve kategori bazında otomatik yapar ve minimum marj eşiğinizin altına düşen ürünleri işaretler.

OLX Pro Portekiz API Entegrasyonu — Teknik Detaylar

OLX Pro API, onaylı Pro satıcıların ilanları, stoku, lead'leri, fiyatları ve siparişleri programatik olarak yönetmesine olanak tanıyan RESTful bir arayüzdür. Base URL: https://api.olx.pt/pro/v2/sellers/{sellerId}/

API Kimlik Doğrulama

OLX Pro Portekiz, REST API için OAuth 2.0 ile Bearer token kullanır. İlk kimlik bilgileri /oauth/token üzerinden değiştirilir; access token'lar 60 dakika, refresh token'lar 30 gün geçerlidir. Webhook'lar webhook secret'ınız kullanılarak HMAC-SHA256 imzayla imzalanır — Zunapro her callback'i otomatik doğrular.

Birincil Endpoint Kategorileri

• Listings API — İlan oluşturma, güncelleme, devre dışı bırakma; kategori ve öznitelik eşleştirme; kalite puanı sorgulama
• Inventory API — Stok ve fiyat senkronizasyonu (toplu endpoint çağrı başına 100 ürüne kadar)
• Leads API — İlgilenen alıcılardan gelen mesajlar ve iletişim talepleri
• Orders API — Kargolanabilir kategoriler için: sipariş listesi, durum güncellemeleri, gönderi oluşturma
• Shipment API — CTT / DPD Portugal / MRW etiketleri üretme, takip numaralarını senkronize etme
• Boost API — Öne çıkan ilan ve tanıtım boost'larını programatik olarak uygulama
• Webhooks — Yeni lead, sipariş durum değişiklikleri ve ilan moderasyon olayları için gerçek zamanlı callback'ler

Rate Limit'ler ve Hata Yönetimi

OLX Pro Portekiz API rate limit'i satıcı başına yaklaşık saniyede 10 istek'tir. Limit aşımı 429 Too Many Requests döner. Yaygın hata kodları: 400 (geçersiz ilan payload'ı), 401 (kimlik doğrulama hatası veya süresi dolmuş token), 403 (Pro aboneliği aktif değil), 404 (kategori/sellerId bulunamadı), 500 (OLX sistem hatası — üstel geri çekilme ile yeniden deneme). Zunapro entegratörü token yenileme, üstel geri çekilme, yeniden denemeleri ve dead-letter queue'yu otomatik yönetir.

Toplu İlan Yükleme — Tedarikçi Feed'lerinden OLX Portekiz'e

Toplu ilan yükleme, mevcut ürün kataloğunuzu (Shopify, WooCommerce, Magento, özel feed) veya tedarikçi envanter feed'inizi (XML, JSON, CSV) alır ve otomatik olarak OLX Portekiz ilanı olarak yayınlar. Yüzlerce ilanı manuel oluşturmak yerine dakikalar içinde binlerce ürünü gönderirsiniz.

Zorunlu İlan Alanları (OLX Portekiz Şeması)

OLX Pro API'nin her ilanda beklediği temel alanlar:

• externalId — Dahili SKU'nuz (idempotent güncellemeler için kullanılır)
• title, description, condition (new / used / refurbished)
• categoryId (OLX taksonomisi) + attributes (marka, model, yıl, beden, renk)
• price, currency (EUR), negotiable (boolean)
• location (şehir + ilçe), contactPhone, contactEmail
• images (4–12 URL, min 800×600), shippingEnabled (kargolanabilir kategoriler için boolean)
• vatRate (kategoriye göre %23, %13 veya %6)

Tedarikçi Feed'inden OLX İlanına

Portekizli toptancı ve distribütörlerin çoğu (Lizbon ve Porto'daki elektronik ithalatçıları, kuzeydeki moda satıcıları, yenilenmiş teknoloji oyuncuları) feed'lerini XML, JSON veya CSV olarak yayımlar. Zunapro feed modülü:

1. Tedarikçi feed'ini sorgular saatlik veya günlük programla
2. Kategori eşleştirmesini öğrenir (ilk eşleştirme manuel, sonrası otomatik uygulanır)
3. Öznitelikleri normalize eder — marka adları, bedenler, renkler, durumlar
4. Marj ve fiyatlandırma kurallarını uygular — kâr marjınızı artı KDV ekler
5. Stoku takip eder — tedarikçi sıfır stok gösterdiğinde ilanları devre dışı bırakır
6. OLX Portekiz'e gönderir OLX Pro API üzerinden

Kargo ve Fulfillment — CTT, DPD Portugal ve MRW

Amazon FBA veya transaksiyonel pazaryerlerinin aksine, OLX Portekiz kendi fulfillment ağını işletmiyor. Platformun mirası yüz yüze ilan satışlarına dayanıyor — ikinci el araçlar galericinin oto parkında muayene ediliyor, emlak yerinde geziliyor, ikinci el elektronik yerel olarak takas ediliyor. Kargolanabilir kategoriler (küçük elektronik, moda, aksesuar, yenilenmiş ürünler, kitap) için satıcılar Portekizli kargo firmalarıyla doğrudan entegre oluyor.

Birincil Portekiz Kargo Seçenekleri

• CTT — Correios de Portugal: Ulusal posta operatörü, uzak bölgeler ve adalar dahil (Madeira, Azorlar) en geniş kapsama; 2 kg altı küçük gönderilerde en güçlü
• DPD Portugal: Lizbon ve Porto metropolitan alanlarında aynı gün alımıyla express B2C/B2B ağı; 2–30 kg arası gönderiler için güvenilir takiple güçlü
• MRW: Derin İspanya–Portekiz sınır ötesi kapsamı olan İberya operatörü; İspanyol müşterilere de gönderim yapan satıcılar arasında popüler
• CTT Expresso: Portekiz anakarasında ertesi gün teslimat için CTT'nin hızlandırılmış katmanı

Kargo Maliyet Aralıkları (2026 yaklaşık)

• CTT standart küçük paket (2 kg altı): anakara €3,50–6,00, adalar €6–10
• DPD Portugal ertesi gün (2–10 kg): anakara €5–12
• MRW İberya (2–10 kg): PT–PT €6–14, PT–ES €10–22
• Ağır ürünler (10–30 kg): DPD ekonomi €18–35

Yüksek hacimli satıcılar için, CTT veya DPD ile doğrudan kargo sözleşmeleri perakende oranlara göre paket başına maliyeti %25–40 düşürür. Zunapro'nun çoklu kargo modülü sözleşmeli oranlarınızı karşılaştırır ve her sipariş için en ucuz seçeneği seçer.

OLX Pro Kalite Puanı ve Hesap Sağlığı

OLX Pro Portekiz her kurumsal satıcıya 1–10 ölçeğinde bir kalite puanı atar; bu puan yanıt süresi, lead-to-deal dönüşümü, ilan doğruluğu ve müşterinin bildirdiği sorunlardan türetilir. Bu puan, ilanlarınızın yerleşimini ve gösterilen rozetini doğrudan etkiler. Puanı düşüren faktörler:

• Lead'lere yavaş yanıt — 24 saat sonra gelen yanıtlar puanı önemli ölçüde düşürür
• Hatalı ilanlar — VIN'le uyuşmayan araç fotoğrafları, telefonlarda eksik IMEI, yanlış durum bayrağı
• Stok-out iptalleri — ürün başka yerde satıldıktan sonra hâlâ aktif ilan
• Müşteri şikayetleri — OLX Pro destek üzerinden açılan uyuşmazlıklar
• İlan reddi — yasak içerik veya politika ihlalleri nedeniyle tekrarlanan moderatör reddi

Zunapro'nun otomatik stok senkronu stok-out iptal riskini ~%90 azaltır; bir ürün web sitenizde, Worten Marketplace'te veya fiziksel mağazanızda satıldığı anda OLX Portekiz ilanı saniyeler içinde devre dışı bırakılır.

OLX Pro Boost'ları, Tanıtımlı İlanlar ve Akıllı Fiyatlandırma

OLX Portekiz Boost Ürünleri

• Öne Çıkan İlan (Destaque) — Arama sonuçlarında vurgulanmış kart (ilan başına ücret, tipik olarak €3–8)
• Üst Sıra (Topo) — 24–72 saat boyunca ilgili kategori aramasının en üstüne boost
• Anasayfa Vitrini — Kategori anasayfalarında premium banner yerleşimi (rotasyonlu)
• Otomatik boost aboneliği — Süresi dolan ilanları otomatik yeniden boost'lar

Akıllı Fiyatlandırma (Repricer)

OLX Portekiz, emtia haline gelmiş kategorilerde (yenilenmiş akıllı telefonlar, popüler ikinci el araç modelleri, markalı moda) rekabetçidir. 10+ satıcı aynı modeli listelediğinde, alıcı neredeyse her zaman önce en düşük fiyatlı ilana tıklar. Zunapro repricer modülü rakip OLX Pro ilanlarını takip eder ve fiyatlarınızı saniyeler içinde ayarlar — minimum marj tabanınızı asla geçmeden.

OLX Portekiz e-Fatura, SAF-T PT ve KDV Uyumluluğu

OLX Portekiz'deki her Pro satıcı, Portekiz vergi kanunu kapsamında uyumlu faturalar düzenlemek zorundadır. B2C satışlar için AT (Autoridade Tributária) tarafından sertifikalı bir elektronik fatura (Fatura) düzenlersiniz; B2B satışlar için her iki tarafın da NIF'i ile tam elektronik fatura düzenlersiniz. AT raporlaması için aylık SAF-T PT exportları zorunludur. Günde 100+ siparişte bunu elle yapmak imkansızdır.

Zunapro e-Fatura modülü:

• OLX siparişi onaylandığı anda sertifikalı e-Fatura'yı otomatik üretir
• AT sertifikalı Portekiz faturalama yazılımlarıyla entegre olur (Moloni, InvoiceXpress, PHC, Sage PT, Primavera)
• 14 günlük yasal cayma süresi içindeki iadelerde (DL 24/2014) otomatik olarak iade faturası düzenler
• Muhasebeciniz için aylık SAF-T PT exportları üretir
• Alıcıya fatura PDF'ini e-posta ve SMS ile iletir

Portekiz Hukuki Çerçevesi — KDV, Garanti, GDPR, Cayma Hakkı

OLX Pro Portekiz'de işletme olarak satış yapmak, tam Portekiz tüketici koruma rejimini beraberinde getirir. Temel yükümlülükler:

• KDV (IVA): Standart oran %23, ara oran %13, indirimli oran %6 (kitap, temel gıda, belirli sağlık ürünleri). Madeira ve Azorlar'ın ayrı bölgesel oranları vardır
• AT (Autoridade Tributária): Tam e-faturalama raporlaması + aylık SAF-T PT exportu
• 14 günlük cayma hakkı DL 24/2014 kapsamında tüketicilere mesafeli satışlar için — Pro satıcılardan kargolanan siparişlere uygulanır
• Yasal garanti: Yeni tüketici ürünlerinde 3 yıl; ikinci el ürünlerde "gizli ayıp" (vícios ocultos) kapsamı
• GDPR + CNPD: Alıcıların ve lead iletişimlerinin kişisel verileri, ulusal denetim otoritesi CNPD ile birlikte AB GDPR kapsamında işlenmelidir
• WEEE / REACH / CE işareti: Elektronik, kimyasallar ve düzenlenmiş ürün kategorileri için gereklidir

Zunapro'nun Portekiz uyum modülü, yasal bildirimleri (garanti şartları, KDV dahillik, cayma hakkı bildirimi) eksik ilanları işaretler ve yayımlamayı reddeder — sizi CNPD para cezalarından ve AT teftiş yaptırımlarından korur.

OLX Portekiz'de İadeler ve Alıcı Uyuşmazlıkları

Yüz yüze teslim kategorileri (otomobil, emlak, büyük mobilya) için iadeler yerel olarak müzakere edilir ve nadirdir. Kargolanan B2C siparişler için standart Portekiz iade oranı modada %10–15, yenilenmiş elektronikte %5–8, yeni aksesuarlarda %3–5 civarındadır. İadeler, Pro kalite puanınızı korumak için temiz şekilde işlenmelidir.

OLX Portekiz standart iade akışı:

1. Alıcı teslimattan sonraki 14 gün içinde OLX Pro destek üzerinden veya doğrudan satıcıyla iade talebi açar
2. Satıcı iade etiketi (CTT veya DPD) hazırlar veya yüz yüze iadeyi kabul eder
3. Kargo ulaşır, satıcı 1–3 iş günü içinde inceler
4. Satıcı iadeyi onaylar veya reddeder, iade faturası (Nota de Crédito) düzenler
5. İade, alıcının orijinal ödeme yöntemine yapılır

Zunapro iade modülü her adımı otomatikleştirir: satıcıya panel bildirimleri, etiket üretimi, otomatik iade faturası (Nota de Crédito) düzenleme, AT raporlama ve alıcı iletişimi.

Zunapro × OLX Portekiz — 4 Adımlık Kurulum (10 Dakika)

1. OLX Pro hesap kimlik bilgilerinizi girin — Zunapro panelinde Pazaryeri → OLX Portekiz'i açın ve sellerId, OAuth client ID/secret ve webhook imza secret'ınızı yapıştırın.
2. Mevcut mağazanızı bağlayın — Shopify, WooCommerce, PrestaShop, Magento, BigCommerce ve özel REST feed'leri için hazır konnektörler. API URL'sini ve erişim anahtarını girin.
3. Kategori eşleştirme sihirbazı — Mağaza kategorilerinizi OLX Portekiz kategorilerine sürükle bırak ile eşleştirin. AI önerileri eşleştirmeyi dakikalar içinde tamamlar.
4. İlk senkron — İlanlar, stok, fiyatlar, lead'ler ve siparişler otomatik olarak senkronize olmaya başlar. 10 dakika içinde OLX Portekiz Pro hesabınız tamamen Zunapro panelinden yönetilir.

OLX Portekiz Entegrasyonu — Sıkça Sorulan Sorular (SSS)