CANLI XML / UTF-8 v1.0

Hepsibayi B2B
XML Entegrasyonu

Stoksuz e-ticaret için güvenilir ürün senkronizasyonu. Saatlik güncellenen XML feed'leri ile stok, fiyat ve varyant verilerini kolayca entegre edin; stok sorunlarını ortadan kaldırın.

XML Feed Türü

60dk

Güncelleme

UTF-8

Encoding

HTTPS

Güvenli

Nasıl Çalışır?

Hepsibayi B2B XML entegrasyonu üç temel adımdan oluşur.

Panel Erişimi

hesabim adresinden panelinize giriş yapın. XML feed linklerinize buradan ulaşabilirsiniz.

XML Verisini Alın

Feed URL'nizi HTTP POST isteği ile çağırın. Sunucu doğrudan UTF-8 enkodlu XML döndürür; JSON wrapper yoktur.

Entegre Edin

simplexml_load_string() (PHP) veya DOMParser (JS) ile parse edin.

Response Formatı

HTTP Response

Content-Typeapplication/xml

EncodingUTF-8

Root Element<products>

Feed Kapsamı

Varyantlı & Varyantsız Ürünler

Stok & KDV Dahil Fiyat

CDN Görsel URL'leri (max 6)

Kategori Hiyerarşisi

XML Feed Türleri

Her feed türü farklı ürün yapılarını hedefler. Entegrasyonunuzu ihtiyacınıza göre tek feed ya da tümünü birleştirerek kurabilirsiniz.

Karışık XML - Canlıda Kullanılacak Örnek

Tüm XML Yapısı

Aktif

Varyantlı ve varyantsız olarak tümünün yer aldığı (renk × beden gibi) içeren ürünlerin tam listesi. Her kombinasyon için ayrı <variant> elemanı; barkod ve stok varyant bazında takip edilir.

Kullanım AlanıElektronik, giyim, aksesuar — renk+beden kombine seçenekleri sunan ürünler.

Panele Git

Varyantlı Ürünler Örneği

variantsXml

Aktif

Birden fazla varyant boyutu (renk × beden gibi) içeren ürünlerin tam listesi. Her kombinasyon için ayrı <variant> elemanı; barkod ve stok varyant bazında takip edilir.

Kullanım AlanıElektronik, giyim, aksesuar — renk+beden kombine seçenekleri sunan ürünler.

Panele Git

Varyantsız Ürünler Örneği

noVariantXml

Aktif

Seçenek sunmayan tek SKU'lu ürünlerin flat feed'i. <variants> bloğu yoktur veya yalnızca tek placeholder giriş içerir. En hızlı parse edilen endpoint türüdür.

Kullanım AlanıTemizlik ürünleri, sarf malzemeleri, sabit ölçülü ev & yaşam ürünleri.

Panele Git

Renkli Varyantlar Örneği

ColorVariantXml

Aktif

Yalnızca renk boyutunda farklılaşan ürünlerin feed'i. Her renk için ayrı <variant> kaydı oluşturulur; görsel başına renk bazlı URL sunulabilir.

Kullanım AlanıKalemlik, çanta, kılıf gibi sabit boyutlu renkli aksesuarlar; ev dekorasyon ürünleri.

Panele Git

Test Aracı

Feed türünü seçin ve gerçek API yanıtını anında görüntüleyin. Kendi sisteminizi yazmadan önce veri yapısını incelemenizi tavsiye ederiz.

POST https://dev.hepsibayi.com.tr/graphql.php

operation= variantsXml

Feed türünü seçin ve "Çalıştır"a tıklayın

Canlı test gerçek API endpoint'ini çağırır. Panelden aldığınız URL üzerinden de kendi ortamınızda test edebilirsiniz. Sık istek atmak oturum kısıtlamalarına yol açabilir.

XML Örnek Çıktılar

Aşağıdaki örnekler gerçek feed yapısını yansıtır. Parse kodunuzu bu statik örneklerle test edebilirsiniz.

Canlı Feed Erişimi

Gerçek ürün verisi için hepsibayi.com.tr/hesabim adresinden panelinize giriş yapabilirsiniz.

Varyantlı + Varyantsız Saatlik Güncelleme

Panele Git

response.xml — variantsXml

<?xml version="1.0" encoding="UTF-8"?>
<!--netafast.com.tr - E-Market Çözümleri-->
<products>
  <product>
    <title>Ally HB01 5In1 Type C Dönüştürücü Adaptör Hub-(5775)</title>
    <stock_code>HS7380-4619</stock_code>
    <barcode>HS7639262516</barcode>
    <brand>Hepsibayi</brand>
    <category>ELEKTRONİK >>> Cep Telefonu >>> Aksesuarlar</category>
    <main_category>ELEKTRONİK</main_category>
    <sub_category>Cep Telefonu</sub_category>
    <sub_category_2>Cep Telefonu Aksesuarları</sub_category_2>
    <stock>39</stock>
    <sale_price>259.81</sale_price>
    <currency>TL</currency>
    <tax>20</tax>
    <description>Ally HB01 5In1 Type C — 3x Type-C, USB-A, HDMI destekli hub.</description>
    <image_count>4</image_count>
    <image_1>https://hepsicdn.com.tr/static/product/hbnet638d6c3a_4901001.png</image_1>
    <image_2>https://hepsicdn.com.tr/static/product/hbnet638d6c3a_4901002.png</image_2>
    <image_3>https://hepsicdn.com.tr/static/product/hbnet638d6c3a_4901003.png</image_3>
    <image_4>https://hepsicdn.com.tr/static/product/hbnet638d6c3a_4901004.png</image_4>
    <variants>
      <variant>
        <barcode>HS0891698570</barcode>
        <stock>39</stock>
        <name>Renk</name>
        <value>Siyah</value>
        <color/>
      </variant>
    </variants>
  </product>
  <product>
    <title>ALLY büyük kapasiteli tuval kalemlik kılıf-(5775)</title>
    <stock_code>HS3712-3115</stock_code>
    <barcode>HS5870792458</barcode>
    <stock>534</stock>
    <sale_price>464.40</sale_price>
    <currency>TL</currency>
    <tax>20</tax>
    <image_count>6</image_count>
    <variants>
      <variant>
        <barcode>HS5978792889</barcode>
        <stock>88</stock>
        <name>Renk</name>
        <value>Siyah</value>
        <color/>
      </variant>
      <variant>
        <barcode>HS4456697961</barcode>
        <stock>446</stock>
        <name>Renk</name>
        <value>Mavi</value>
        <color/>
      </variant>
    </variants>
  </product>
</products>

Varyant Yapısı

Feed'lerde üç farklı varyant senaryosu bulunur. Entegrasyonunuzu yazarken her durumu ayrı ele almak stok tutarsızlıklarını önler.

Varyantsız / Tek SKU

noVariantXml

Ürünün yalnızca bir versiyonu. <variants> bloğu yoktur ya da "RZ" placeholder içerir. Stok doğrudan ürün düzeyinden okunur.

<variants>
  <variant>
    <barcode>HS5265798466</barcode>
    <stock>132</stock>
    <name>Renk</name>
    <value>RZ</value>
    <color/>
  </variant>
</variants>

Çoklu Renk Varyantı

önerilen

ColorVariantXml

Aynı ürün farklı renklerde. Her renk için <variant> tekrar eder; kendi barkod ve stoğu vardır.

<variants>
  <variant>
    <barcode>HS5978792889</barcode>
    <stock>88</stock>
    <name>Renk</name>
    <value>Siyah</value>
  </variant>
  <variant>
    <barcode>HS4456697961</barcode>
    <stock>446</stock>
    <name>Renk</name>
    <value>Mavi</value>
  </variant>
</variants>

Beden + Renk Kombinasyonu

variantsXml

İki boyutlu varyantlar. Her renk × beden kombinasyonu için ayrı satır. Doğru eşleme için barkod zorunludur.

<variants>
  <variant>
    <barcode>HS1234567890</barcode>
    <stock>25</stock>
    <name>Beden</name>
    <value>M</value>
  </variant>
  <variant>
    <barcode>HS9876543210</barcode>
    <stock>10</stock>
    <name>Beden</name>
    <value>XL</value>
  </variant>
</variants>

Toplam Stok Hesaplama

Varyantlı ürünlerde ürün düzeyindeki <stock> tüm varyantların toplamına eşit veya yakın olabilir. Güvenilir stok takibi için her <variant> içindeki barkod bazlı stok değerini kullanın.

XML Tag Referansı

Feed'de kullanılan tüm XML elementleri, tipleri ve zorunluluk durumları.

Tag	Açıklama	Tip	Durum
<products>	Kök element. Tüm ürün listesini kapsar.	Element	Zorunlu
<product>	Tek bir ürün kaydı.	Element	Zorunlu
<title>	Ürünün tam adı. Model ve marka dahil.	String	Zorunlu
<stock_code>	Tedarikçi benzersiz stok kodu.	String	Zorunlu
<barcode>	Ürün düzeyinde ana barkod.	String	Zorunlu
<brand>	Marka adı. Daima "Hepsibayi".	String	Zorunlu
<category>	Tam hiyerarşi; `>>>` ayırıcılı.	String	Zorunlu
<stock>	Ürün düzeyi toplam stok adedi.	Integer	Zorunlu
<sale_price>	KDV dahil satış fiyatı. Ondalık: nokta.	Decimal	Zorunlu
<currency>	Para birimi. Daima "TL".	String	Zorunlu
<tax>	KDV oranı yüzde. Ör: 20 → %20.	Integer	Zorunlu
<image_count>	Görsel sayısı (1–6). image_N URL sayısını belirtir.	Integer	Zorunlu
<image_1..6>	CDN görsel URL'leri. "Hata:" içeriyorsa atlayın.	URL	Zorunlu
<sub_category_2..4>	İsteğe bağlı derin kategori seviyeleri.	String	Opsiyonel
<variants>	Tüm varyantları kapsayan container.	Element	Opsiyonel
<variant>	Tek varyant kombinasyonu. Renk/beden başına tekrar.	Element	Opsiyonel
<name>	Varyant boyutu adı. Ör: "Renk", "Beden".	String	Opsiyonel
<value>	Varyant değeri. Ör: "Siyah", "XL".	String	Opsiyonel
<color>	Renk kodu veya adı. Uygulanamıyorsa self-closing.	String	Opsiyonel

Kod Örnekleri

PHP ve JavaScript ile XML parse etmek için hazır başlangıç kodları.

parse-xml.php

<?php
/**
 * Hepsibayi XML Feed — PHP Parse Örneği
 */

$xmlString = file_get_contents('hepsibayi_feed.xml');
$xml = simplexml_load_string($xmlString, 'SimpleXMLElement', LIBXML_NOCDATA);

foreach ($xml->product as $product) {
    $title    = (string) $product->title;
    $price    = (float)  $product->sale_price;
    $currency = (string) $product->currency;
    $stock    = (int)    $product->stock;
    $taxRate  = (int)    $product->tax;

    // Net fiyat hesapla
    $netPrice = round($price / (1 + $taxRate / 100), 2);

    echo "📦 {$title}\n";
    echo "   Fiyat : {$price} {$currency}  (net: {$netPrice})\n";
    echo "   Stok  : {$stock} adet\n";

    // Görselleri filtrele
    $imgCount = (int) $product->image_count;
    for ($i = 1; $i <= $imgCount; $i++) {
        $url = (string) $product->{"image_{$i}"};
        if (!str_contains($url, 'Hata:')) {
            echo "   Görsel {$i}: {$url}\n";
        }
    }

    // Varyantlar
    if (isset($product->variants->variant)) {
        foreach ($product->variants->variant as $v) {
            $vBarcode = (string) $v->barcode;
            $vName    = (string) $v->name;
            $vValue   = (string) $v->value;
            $vStock   = (int)    $v->stock;
            echo "   [{$vName}: {$vValue}]  Stok: {$vStock}  Barkod: {$vBarcode}\n";
        }
    }
    echo str_repeat('─', 60) . "\n";
}

/**
 * Hepsibayi XML Feed — JavaScript Parse Örneği
 */

function parseHepsibayiXML(xmlText) {
  const parser = new DOMParser();
  const xmlDoc = parser.parseFromString(xmlText, 'application/xml');

  return [...xmlDoc.querySelectorAll('product')].map(p => {
    // Görselleri filtrele — hatalı URL'leri atla
    const imgCount = parseInt(p.querySelector('image_count')?.textContent ?? '0');
    const images = [];
    for (let i = 1; i <= imgCount; i++) {
      const url = p.querySelector(`image_${i}`)?.textContent ?? '';
      if (!url.includes('Hata:')) images.push(url);
    }

    // Varyantları dönüştür
    const variants = [...p.querySelectorAll('variant')].map(v => ({
      barcode: v.querySelector('barcode')?.textContent,
      name:    v.querySelector('name')?.textContent,
      value:   v.querySelector('value')?.textContent,
      stock:   parseInt(v.querySelector('stock')?.textContent ?? '0'),
    }));

    return {
      title:     p.querySelector('title')?.textContent,
      stockCode: p.querySelector('stock_code')?.textContent,
      price:     parseFloat(p.querySelector('sale_price')?.textContent),
      currency:  p.querySelector('currency')?.textContent,
      stock:     parseInt(p.querySelector('stock')?.textContent ?? '0'),
      tax:       parseInt(p.querySelector('tax')?.textContent ?? '0'),
      images, variants,
    };
  });
}

// Kullanım örneği
const res = await fetch('https://dev.hepsibayi.com.tr/graphql.php', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: 'operation=variantsXml',
});
const xmlText = await res.text();
const products = parseHepsibayiXML(xmlText);
console.table(products);

Önemli Notlar

Entegrasyon sırasında dikkat edilmesi gereken kritik noktalar.

Saatlik Güncelleme Döngüsü

Tüm feed'ler saatte bir güncellenir. Polling aralığını en fazla 60 dakikaya ayarlayın. Sık istek oturum kısıtlamalarına yol açabilir.

CDATA Kullanılmaz

Özel karakterler XML entity olarak encode edilir. PHP'de html_entity_decode(), JS'de DOMParser ile decode edin.

Hatalı Görsel URL'leri

"Hata: Görsel indirilemedi." içeren URL'leri atlayın. str_contains($url, 'Hata:') ile filtreleyin.

Kategori Hiyerarşisi

<category> tam ağacı >>> ayırıcısıyla içerir. sub_category_2..4 opsiyoneldir; isset() ile kontrol edin.

Fiyat KDV Dahildir

<sale_price> her zaman KDV dahil. Net fiyat: salePrice / (1 + tax/100).

Benzersiz Tanımlayıcılar

stock_code ürün eşleme, barcode tanımlama için. Varyant bazlı işlemler için her <variant>'ın kendi barkodunu kullanın.

Sıkça Sorulan Sorular

En çok sorulan entegrasyon sorularına yanıtlar.

Hepsibayi B2B XML Entegrasyonu

Nasıl Çalışır?

Panel Erişimi

XML Verisini Alın

Entegre Edin

XML Feed Türleri

Karışık XML - Canlıda Kullanılacak Örnek

Varyantlı Ürünler Örneği

Varyantsız Ürünler Örneği

Renkli Varyantlar Örneği

Test Aracı

XML Örnek Çıktılar

Canlı Feed Erişimi

Varyant Yapısı

Varyantsız / Tek SKU

Çoklu Renk Varyantı

Beden + Renk Kombinasyonu

Toplam Stok Hesaplama

XML Tag Referansı

Kod Örnekleri

Önemli Notlar

Saatlik Güncelleme Döngüsü

CDATA Kullanılmaz

Hatalı Görsel URL'leri

Kategori Hiyerarşisi

Fiyat KDV Dahildir

Benzersiz Tanımlayıcılar

Sıkça Sorulan Sorular

Hepsibayi B2B
XML Entegrasyonu