Ürün Entegrasyonu

XML Feed Entegrasyonu

XML Feed entegrasyonu, satıcıların kendi sistemlerinden ürün, stok, fiyat, varyant ve görsel bilgilerini BaZaaR'Dan satıcı paneline toplu şekilde aktarmasını sağlar.

Kullanım Alanı Satıcı panelindeki Toplu Ürün Yükleme > XML Feed ekranı

Aktarım Tipi XML URL veya XML dosyası ile ürün aktarımı

Güncelleme Mantığı Barkod, stok kodu veya SKU ile eşleştirme

Genel Akış

Satıcı panelinden XML Feed URL girilir veya XML dosyası yüklenir.
Sistem XML içeriğini okur ve ürün/varyant alanlarını analiz eder.
Kategori eşleşmeleri yapılır.
Ön izleme sonrası ürünler BaZaaR'Dan ürün sistemine aktarılır.
Sonraki senkronlarda stok ve fiyat bilgileri güncellenir.

Önerilen XML Yapısı

Her ürün product node'u altında tutulmalıdır. Varyantlı ürünlerde varyantlar variants.variant altında gönderilebilir.

Örnek XML

<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product>
    <id>11329</id>
    <productCode>ALIS050370</productCode>
    <name>Kadın Toparlayıcı Sütyen</name>
    <description>Ürün açıklaması</description>
    <detail>Detaylı ürün bilgisi</detail>
    <brand>Alışveriş Meydanı</brand>
    <categoryID>299</categoryID>
    <category>Sütyen</category>
    <listPrice>599.99</listPrice>
    <price>481.59</price>
    <quantity>7</quantity>
    <image1>https://cdn.example.com/product-1.webp</image1>
    <image2>https://cdn.example.com/product-2.webp</image2>

    <variants>
      <variant>
        <barcode>ALIS050370-75C</barcode>
        <productCode>ALIS050370-75C</productCode>
        <sku>ALIS050370-75C</sku>
        <price>481.59</price>
        <quantity>2</quantity>
        <attributes>
          <attribute>
            <name>Renk</name>
            <value>Ten</value>
          </attribute>
          <attribute>
            <name>Beden</name>
            <value>75C</value>
          </attribute>
        </attributes>
      </variant>
    </variants>
  </product>
</products>

Zorunlu Alanlar

Alan	Açıklama	Örnek
`id`	Satıcının kendi sistemindeki ürün ID değeridir.	11329
`name`	Ürün adıdır.	Kadın Toparlayıcı Sütyen
`price`	Satış fiyatıdır. Noktalı decimal format önerilir.	481.59
`quantity`	Ürün veya varyant stok adedidir.	7
`barcode`	Varyantlı ürünlerde benzersiz barkod önerilir.	ALIS050370-75C

Önerilen Alanlar

Alan	Kullanım
`productCode`	Ürün/stok kodu eşleştirmesi için kullanılır.
`sku`	SKU bazlı eşleştirme yapmak isteyen satıcılar için kullanılır.
`brand`	Marka bilgisidir.
`categoryID`	Satıcı XML kategorisinin ID değeridir.
`category`	Satıcı XML kategorisinin görünen adıdır.
`image1` - `image8`	Ürün görselleridir. HTTPS görsel URL kullanılması önerilir.

Varyant Yapısı

Renk, beden, numara gibi seçenekli ürünlerde her varyantın ayrı barkod veya stok kodu ile gelmesi önerilir. Böylece stok ve fiyat güncellemeleri güvenli şekilde yapılabilir.

Varyant Örneği

<variants>
  <variant>
    <barcode>ALIS050370-75C</barcode>
    <sku>ALIS050370-75C</sku>
    <price>481.59</price>
    <quantity>2</quantity>
    <attributes>
      <attribute>
        <name>Renk</name>
        <value>Ten</value>
      </attribute>
      <attribute>
        <name>Beden</name>
        <value>75C</value>
      </attribute>
    </attributes>
  </variant>
</variants>

Kategori Eşleştirme

XML'den gelen kategori bilgileri BaZaaR'Dan kategori ağacıyla eşleştirilir. Örneğin XML kategorisi Sütyen, BaZaaR'Dan tarafında ilgili ana kategori, alt kategori ve alt-alt kategoriye bağlanır.

XML Alanı	BaZaaR'Dan Karşılığı
`categoryID`	XML kategori ID
`category`	XML kategori adı
`category_id`	BaZaaR'Dan ana kategori
`subcategory_id`	BaZaaR'Dan alt kategori
`sub_subcategory_id`	BaZaaR'Dan alt-alt kategori

Stok ve Fiyat Güncelleme Mantığı

Senkronlarda ürünler barcode, productCode veya sku alanlarından biriyle eşleştirilebilir. En güvenli yöntem barkod eşleştirmesidir.

Öneri: Varyantlı ürünlerde her varyant için benzersiz barkod gönderin. Aynı barkod birden fazla varyanta verilmemelidir.

Görsel Kuralları

Görsel URL'leri HTTPS olmalıdır.
JPG, JPEG, PNG veya WEBP formatı önerilir.
Ürün başına en fazla 8 ana görsel önerilir.
Bozuk veya erişilemeyen görseller import sırasında hata/uyarı oluşturabilir.

Satıcı Paneli Kullanımı

Satıcılar XML entegrasyonunu satıcı panelindeki Ürün > Toplu Ürün Yükleme > XML Feed ekranından yönetir. Developer portal yalnızca format ve entegrasyon dokümantasyonu sağlar.

İlgili Sayfalar

Authentication Partner API HMAC imza standardı. Aç

Stock Update API ile stok güncelleme yapan entegratörler için. Aç

Webhooks Import sonuç bildirimleri ve event mantığı. Aç

Satıcı Paneli XML Feed Merkezi

Satıcı panelindeki Ürün > Toplu Ürün Yükleme > XML Feed ekranı, teknik entegrasyon bilgisi gerektirmeden XML feed yönetimi sağlar. Satıcı XML URL ekleyebilir, XML dosyası yükleyebilir, güvenli full import ön izlemesi alabilir, mevcut eşleşmiş ürünlerde stok/fiyat senkronizasyonu yapabilir ve feed’i pasifleştirebilir.

Otomatik Kategori Eşleştirme

Full Import Ön İzleme çalıştırıldığında sistem önce XML kategorilerini otomatik eşleştirmeye çalışır. Bu işlem auto_category_mappings.php akışıyla yapılır ve güvenilir kategori karşılıkları seller_xml_category_mappings tablosuna kaydedilir. Ardından dry_run=true ile güvenli ön izleme çalışır.

Güvenlik: Otomatik kategori eşleştirme ürün oluşturmaz. Ürün/varyant oluşturma sadece full import gerçek modda yapılabilir. Satıcı panelinde gerçek full import, sunucu tarafında SELLER_XML_REAL_IMPORT_ENABLED=1 açılmadan çalışmaz.

Full Import Ön İzleme Akışı

Satıcı XML URL veya XML dosyası ekler.
Sistem XML ürünlerini ve kategorilerini okur.
Otomatik kategori mapping denenir.
full_import modu dry_run=true ile çalışır.
Panelde toplam ürün, toplam varyant, oluşacak ürün/varyant ve atlama nedenleri gösterilir.

Atlama / Güvenlik Nedenleri

Neden	Açıklama
`missing_category_mapping`	XML kategorisi BaZaaR'Dan kategorisiyle eşleşmemiştir.
`duplicate_barcode`	Barkod başka ürün veya satıcıda kayıtlıdır; ürün oluşturma engellenir.
`duplicate_sku`	SKU başka ürün veya satıcıda kayıtlıdır.
`missing_barcode`	XML varyantında barkod alanı eksiktir.
`missing_price`	Fiyat alanı eksiktir veya geçersizdir.
`missing_stock`	Stok alanı eksiktir veya geçersizdir.
`missing_attribute_value`	Varyant özellik değeri eşleşmemiştir.

Feed Pasifleştirme ve Silme

Satıcı panelinde XML feed kartında Pasifleştir ve Sil işlemleri bulunur. Pasifleştirme feed’i disabled durumuna alır ve senkronizasyonu durdurur. Silme işlemi test feed kayıtları için kullanılabilir.

Ürün bağlantısı olan gerçek feedlerde kalıcı silme varsayılan olarak engellenir. Bu durumda önerilen işlem feed’i pasifleştirmektir.

Partner API XML Feed Endpoints

Open Partner API üzerinden XML feed oluşturma, güncelleme, pasifleştirme ve mevcut eşleşmiş ürünleri senkronize etme işlemleri yapılabilir.

Permission	Method	Endpoint	Açıklama
`xml_feeds:read`	GET	`/xml_feeds.php`	XML feed listesini döndürür.
`xml_feeds:write`	POST	`/xml_feeds.php`	Yeni XML feed oluşturur.
`xml_feeds:write`	PATCH	`/xml_feeds.php`	XML feed ayarlarını günceller.
`xml_feeds:write`	DELETE	`/xml_feeds.php`	XML feed kaydını soft-disable yapar.
`xml_feeds:write`	POST	`/xml_feed_sync.php`	Mevcut mapping kayıtları üzerinden stok/fiyat sync yapar.
`xml_feeds:read`	GET	`/xml_feed_products.php`	XML feed ürün eşleşmelerini listeler.
`xml_feeds:read`	GET	`/xml_feed_import_runs.php`	XML aktarım geçmişini listeler.

Full Import Dry Run

POST /xml_feed_sync.php endpointi iki mod destekler: existing_mappings_only ve full_import. full_import modu, mapping olmayan XML ürün/varyantlarını kategori mapping kurallarına göre oluşturabilir.

Alan	Değer	Açıklama
`mode`	`existing_mappings_only`	Sadece mevcut XML mapping kayıtları üzerinden stok/fiyat günceller.
`mode`	`full_import`	Mapping olmayan ürün/varyantları oluşturabilecek geniş import modudur.
`dry_run`	`true`	Varsayılan güvenli moddur; ürün/varyant oluşturmaz, sadece ne yapılacağını raporlar.
`dry_run`	`false`	Gerçek import yapar. Canlıya almadan önce dry-run sonucu kontrol edilmelidir.

{
  "id": 2,
  "mode": "full_import",
  "dry_run": true
}

Güvenlik için dry_run gönderilmezse varsayılan değer true kabul edilir.