← Şirket başvurusuna dön
📋 STANDART XML FORMATI

Mağaza Feed Dokümantasyonu

Prizm Cards mağaza katalogu için tek standart XML yapısı

📌 Nasıl çalışır?

  1. Mağaza yöneticisi olarak şirket başvurusu yap.
  2. E-postanı doğrula. Admin başvurunu inceler (1-2 iş günü).
  3. Onay sonrası mağaza paneline (/store-dashboard) giriş yap.
  4. Aşağıdaki standart formatta bir XML feed üret, public URL'ini panele ekle.
  5. Sistemimiz feed URL'ini günde 3 kere (08:00, 14:00, 20:00) otomatik çeker.
  6. Eşleşen kart ürünleri fiyat-karşılaştırma katalog'una eklenir.

📂 XML Yapısı

Feed URL'in HTTP/HTTPS üzerinden 200 OK ile bir XML dökümanı dönmeli. Yapı:

<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product>
    <id>SKU-12345</id>
    <name><![CDATA[Charizard ex 199/197 - Obsidian Flames]]></name>
    <price>1499.90</price>
    <listPrice>1999.00</listPrice>
    <currency>TRY</currency>
    <quantity>3</quantity>
    <link>https://magaza.com/charizard-ex-199-197</link>
    <image1>https://magaza.com/img/charizard.jpg</image1>
    <top_category><![CDATA[English Single Cards]]></top_category>
    <main_category><![CDATA[Pokemon]]></main_category>
  </product>

  <product>
    <id>OP-OP14-042</id>
    <name><![CDATA[Monkey D. Luffy OP14-042 - Azure Sea's Seven]]></name>
    <price>349.00</price>
    <currency>TRY</currency>
    <quantity>0</quantity>
    <link>https://magaza.com/monkey-d-luffy-op14-042</link>
    <image1>https://magaza.com/img/luffy.jpg</image1>
    <top_category><![CDATA[One Piece Single Cards]]></top_category>
    <main_category><![CDATA[One Piece]]></main_category>
  </product>
</products>

🔑 Alan Açıklamaları

AlanZorunluAçıklama
<id>Zorunlu Mağaza içi tekil ürün kodu / SKU. Aynı ürün için her feed'de aynı kalmalı.
<name>Zorunlu Tam ürün adı. Kart numarası (örn. 199/197 veya OP14-042) ve set adı içermesi eşleşmeyi büyük ölçüde artırır. CDATA önerilir.
<price>Zorunlu Satış fiyatı. Ondalık ayracı . (nokta). Para birimi olmadan sayı: 149.90.
<listPrice>Opsiyonel İndirim öncesi orijinal fiyat. Yoksa boş bırak veya alanı atla.
<currency>Opsiyonel ISO 4217 kodu. Varsayılan TRY. Diğer kabul edilenler: USD, EUR, JPY.
<quantity>Zorunlu Stok sayısı. 0 = tükendi (yine listelenir ama "stokta yok" etiketiyle). Tam sayı.
<link>Zorunlu Ürünün mağazadaki tam URL'i. Müşteri bu linke yönlendirilir.
<image1>Opsiyonel Ürün görseli tam URL. Bizim katalog'da Türk lirası fiyatın yanında küçük thumbnail için kullanılır.
<top_category>Zorunlu Aşağıdaki listeden BİRİ olmalı (CDATA). Bu alan eşleştirme için kritik.
<main_category>Opsiyonel "Pokemon" / "One Piece" / "Magic: The Gathering" / "Yu-Gi-Oh!" gibi üst başlık.

🏷 Kabul edilen top_category değerleri

⚠ Önemli: "Single Cards" kelimesi içermeyen top_category'ler şu an otomatik filtreleniyor ve fiyat-karşılaştırmaya dahil edilmiyor. Sealed product agregatörü ayrı bir versiyonda gelecek.

✅ İyi Pratikler

🧪 Feed Validasyon

Feed URL'ini mağaza panelinde girdikten sonra "Test Et" butonu ile manuel sync yapabilirsin. Sistem feed'i çeker, parse eder, ne kadar ürün eşleştiğini gösterir.

💡 İlk sync özet: Tipik bir 5K ürünlü Pokemon mağazası için sync ~30-60 saniye sürer. %70+ eşleşme oranı iyi sayılır (kalan %30 set adı/kart numarası eksik olabilir — name alanını zenginleştirerek artırabilirsin).

❓ Yardım

Format ile ilgili sorularını noreply@prizmcards.com adresine yazabilirsin. Mağaza panelinden de hata raporlarını görebilirsin.