--- title: "XML Entegrasyonu Nedir? Ürün XML'i, İçeri Alma ve Dışarı Verme, Alan Eşleştirme, Stok ve Fiyat Güncelleme Sıklığı, Hata Yönetimi, Güncelleme Gecikmesi Maliyeti Hesaplayıcısı ve XML Kontrol Listesi" description: "XML entegrasyonu nedir, nasıl çalışır? Ürün XML'i, tedarikçiden içeri alma, reklam için dışarı verme, alan eşleştirme, güncelleme sıklığı ve sık yapılan hatalar." url: https://www.faprika.com/blog/xml-entegrasyonu-nedir language: tr site: Faprika --- # XML Entegrasyonu Nedir? Ürün XML'i, İçeri Alma ve Dışarı Verme, Alan Eşleştirme, Stok ve Fiyat Güncelleme Sıklığı, Hata Yönetimi, Güncelleme Gecikmesi Maliyeti Hesaplayıcısı ve XML Kontrol Listesi > XML entegrasyonu nedir, nasıl çalışır? Ürün XML'i, tedarikçiden içeri alma, reklam için dışarı verme, alan eşleştirme, güncelleme sıklığı ve sık yapılan hatalar. Tedarikçinizin yüzlerce ürününü elle girmek, stok bittiğinde her satırı tek tek kapatmak ve aynı ürünü reklam platformlarına ayrıca yüklemek bir noktadan sonra işletmeyi yavaşlatır. Ürün verisi bir yerde değiştiğinde diğer yerlerin kendiliğinden güncellenmesi için sistemlerin birbiriyle aynı dilde konuşması gerekir. E-ticarette bu ortak dilin en yaygın olanı XML'dir. Bu rehberde **XML entegrasyonu** baştan sona ele alınıyor: XML'in ne olduğu, ürün XML'inin nasıl göründüğü, verinin içeri alınması ve dışarı verilmesi arasındaki fark, alan eşleştirmenin nasıl yapıldığı, stok ve fiyat güncellemesinin ne sıklıkla çalışması gerektiği ve en sık görülen hatalar. Güncelleme gecikmesinin size maliyetini hesaplayan bir araç ile kendi XML kaynağınızı ve çıktınızı denetleyebileceğiniz bir kontrol listesi de var. Tedarikçi tarafını anlatan [XML Tedarikçi Nedir?](https://www.faprika.com/blog/xml-tedarikci-nedir) yazısıyla yöntemin iş modeli yanını ele alan [Xml Bayiliği Nedir ve Nasıl Başlanır?](https://www.faprika.com/blog/xml-bayiligi-nedir-ve-nasil-baslanir) yazısını tekrar etmeden, burada bağlantının kendisine, yani tekniğe ve işletmeye odaklanıyoruz. Anahtar Düşünce “XML entegrasyonunun değeri dosyanın kendisinde değil, ne sıklıkla ve ne kadar doğru okunduğundadır. Dakikalar içinde güncellenen bir akış stok hatasını önler; günde bir kez yenilenen akış her gün biraz yanlış satış demektir.” ## XML Entegrasyonu Nedir? XML entegrasyonu, ürün, stok, fiyat ya da sipariş gibi verilerin XML adı verilen yapılandırılmış bir dosya biçimiyle iki sistem arasında otomatik olarak aktarılmasıdır. Bir taraf veriyi XML olarak yayınlar, diğer taraf belirli aralıklarla bu dosyayı okuyup kendi kayıtlarına işler. Yöntemin gücü, iki sistemin birbirini tanımak zorunda olmamasıdır. Kaynak sistem veriyi herkesin okuyabileceği bir bağlantıda sunar; okuyan sistem bu bağlantıya gider ve içeriği kendi alanlarına yerleştirir. Aktarımın yönüne göre iki ana kullanım vardır: | Yön | Ne yapılır? | Kimden kime? | Tipik kullanım | | --- | --- | --- | --- | | İçeri alma | Dışarıdaki bir kaynağın ürün ve stok verisi mağazaya okunur | Tedarikçi ya da toptancı → mağaza | Ürün kataloğunu kurmak, stok ve fiyatı güncel tutmak | | Dışarı verme | Mağazadaki ürün verisi bir XML bağlantısı olarak yayınlanır | Mağaza → reklam, alışveriş ve katalog platformları | Ürünleri reklama ve vitrinlere açmak, satış raporlarını paylaşmak | *Görsel: XML entegrasyonu nedir: tedarikçiden mağazaya içeri alma ve mağazadan reklam ve alışveriş platformlarına dışarı verme (XML entegrasyonunun iki yönü)* Aynı mağaza çoğu zaman iki yönü birlikte kullanır: tedarikçisinden ürün alır, kendi ürünlerini de reklam platformlarına verir. İki yönün mantığı aynıdır; farkı, kimin yayıncı ve kimin okuyucu olduğudur. Okumanızı öneririz XML Tedarikçi Nedir? ## XML Nedir ve Ürün XML'i Nasıl Görünür? XML, verinin etiketlerle tanımlandığı bir biçimlendirme dilidir; her bilgi bir açılış ve bir kapanış etiketi arasında durur ve etiketler iç içe geçerek bir ağaç oluşturur. Ürün XML'i bu ağacın her dalında bir ürünü anlatır. Aşağıdaki örnek temsili bir üründür; etiket adları kaynaktan kaynağa değişir ve her kaynak kendi yapısını belirler. ORN-1001 8690000000012 Örnek Keten Gömlek 1250.00 14 Giyim > Gömlek https://www.ornek.com/img/gomlek-1.jpg *Görsel: Ürün XML'inin anatomisi: XML bildirimi, kök etiket, ürün etiketi, stok kodu, fiyat ve stok alanları (Bir ürün XML'inin parçaları)* | Öğe | Ne işe yarar? | Dikkat edilecek nokta | | --- | --- | --- | | XML bildirimi | Dosyanın XML olduğunu ve karakter kodlamasını söyler | Türkçe karakterler için kodlama UTF-8 olmalı | | Kök etiket | Bütün ürünleri kapsayan en dıştaki etiket | Kapanmayan kök etiket dosyanın tamamını geçersiz kılar | | Ürün etiketi | Her ürünün bir kayıt olarak tekrarlandığı blok | Okuyan sistem kayıtları bu etiketin adına göre ayırır | | Alan etiketleri | Stok kodu, fiyat, stok, kategori gibi tek tek bilgiler | Aynı bilgi her üründe aynı etiketle gelmeli | | Nitelik (öznitelik) | Etiketin içine yazılan ek bilgi, örneğin para birimi | Okuyucunun bunu da okuyacak şekilde ayarlanması gerekir | XML'in bu denli yaygın olmasının nedeni, insanın da makinenin de okuyabilmesidir. Bir dosyayı tarayıcıda açıp içine bakabilir, bir şeyin neden yanlış gittiğini gözle görebilirsiniz. Bu özellik, hata ayıklamayı diğer aktarım yöntemlerine göre kolaylaştırır. Ürün verisi gibi büyük listeler için sözlükte ayrıca [XML feed](https://www.faprika.com/sozluk/xml-feed-nedir) kavramı da anlatılıyor. İpucu Önce dosyayı kendi gözünüzle açın Bir XML bağlantısı aldığınızda entegrasyonu kurmadan önce bağlantıyı tarayıcıda açın. Etiketlerin düzgün kapandığını, Türkçe karakterlerin bozulmadığını ve her üründe aynı alanların bulunduğunu ilk bakışta görürsünüz. Sorunların büyük bölümü daha kurulum aşamasında burada yakalanır. ## XML Entegrasyonu Nasıl Çalışır? XML entegrasyonu, okuyan sistemin kaynağın bağlantısına belirli aralıklarla gidip dosyayı indirmesi, içeriği ayrıştırması, alanları kendi karşılıklarıyla eşleştirmesi ve değişiklikleri kayıtlara yazmasıyla çalışır. Süreç her turda aynı sırayı izler. 1. **Bağlantıya gider:** Okuyucu, kaynağın verdiği XML adresine istek gönderir. Kaynak bazen yalnız belirli adreslerden gelen isteklere izin verir. 2. **Dosyayı indirir:** Büyük bir ürün listesi birkaç parçaya bölünmüş olabilir; okuyucu parçaları sırayla alır. 3. **Ayrıştırır:** Etiketler okunur, her ürün bir kayıt olarak ayrılır. Bozuk bir etiket bu adımda hata verir. 4. **Eşleştirir:** Kaynaktaki alanlar mağazadaki alanlarla ilişkilendirilir: stok kodu stok koduna, fiyat fiyata. 5. **Karşılaştırır:** Yeni gelen veri mevcut kayıtla kıyaslanır; yalnız değişen ürünler güncellenir, yeni ürünler eklenir, kaynaktan kalkanlar işaretlenir. 6. **Yazar ve kaydeder:** Değişiklikler mağazaya işlenir; kaç ürünün eklendiği, güncellendiği ve hata verdiği günlüğe yazılır. 7. **Bekler:** Bir sonraki tur zamanı gelene kadar sistem durur; sıklığı belirleyen ayardır. Dışarı verme yönünde sıra tersine döner: mağaza kendi ürünlerini XML'e çevirir ve bir bağlantıda yayınlar; reklam ya da alışveriş platformu bu bağlantıyı kendi zamanlamasıyla okur. Burada kontrol sizdedir, çünkü hangi ürünlerin, hangi fiyatla ve hangi dilde yayınlanacağını siz belirlersiniz. ## Tedarikçiden Ürün Alma (İçeri Alma) Nasıl Yapılır? Tedarikçiden ürün almak için tedarikçinin XML bağlantısını mağazaya tanıtır, alanları eşleştirir ve güncelleme sıklığını belirlersiniz. Kurulum bir kez yapılır; sonrasında katalog ve stok kendiliğinden güncel kalır. ### İçeri Almadan Önce Neye Bakılır? Kaynak dosyanın kalitesi entegrasyonun kalitesini belirler. Bağlantıyı bağlamadan önce şu soruları cevaplayın: - **Güncelleme sıklığı:** Kaynak veriyi ne sıklıkla yeniliyor? Siz dakikada bir okusanız bile kaynak günde bir yenileniyorsa taze veri alamazsınız. - **Alan bütünlüğü:** Her üründe stok kodu, fiyat, stok ve görsel var mı? Boş gelen alanlar boş sayfa demektir. - **Tekil kimlik:** Ürünleri birbirinden ayıran tek bir alan (stok kodu ya da barkod) var mı? Bu alan eşleştirmenin anahtarıdır. - **Varyantlar:** Beden ve renk gibi seçenekler tek ürünün içinde mi, ayrı kayıt olarak mı geliyor? - **Kaynağın güvenilirliği:** Bağlantı sık kesiliyor mu, dosya boyutu çok mu büyük? Kaynağın tedarikçi olarak nasıl seçileceğini ve iş ilişkisinin nasıl kurulacağını [XML Tedarikçi Nedir?](https://www.faprika.com/blog/xml-tedarikci-nedir) yazısında bulabilirsiniz; stoksuz çalışan modelin genel mantığı için [Stoksuz e-Ticaret Nedir? Stoksuz Satış Nasıl Yapılır?](https://www.faprika.com/blog/stoksuz-e-ticaret-nedir-stoksuz-satis-nasil-yapilir) yazısı faydalıdır. ### İlk İçeri Alma ile Sonraki Güncellemeler Aynı Şey Değildir İlk aktarım kataloğu oluşturur: tüm ürünler, görseller ve açıklamalar mağazaya gelir. Sonraki turlar ise yalnız değişimi taşır: stok ve fiyat sık, açıklama ve görsel seyrek değişir. Bu ayrım önemlidir, çünkü her turda her şeyi yeniden yazmak hem yavaştır hem de elle yaptığınız düzeltmelerin üzerine yazabilir. Hangi alanların sürekli kaynaktan, hangilerinin yalnız ilk seferde alınacağını baştan belirleyin. İpucu Elle düzelttiğiniz alanı koruyun Ürün adını ya da açıklamayı kendi SEO çalışmanıza göre yeniden yazdıysanız, bu alanların her turda kaynaktan üzerine yazılmadığından emin olun. Stok ve fiyatı kaynağa bağlayıp metin alanlarını kendinizde tutmak çoğu mağaza için dengeli bir düzendir. ## Ürünleri Reklam ve Alışveriş Platformlarına Dışarı Verme Nasıl Yapılır? Dışarı verme, mağazadaki ürünlerin reklam ve alışveriş platformlarının istediği biçimde bir XML bağlantısı olarak yayınlanmasıdır. Platform bu bağlantıyı düzenli aralıklarla okuyup ürünlerinizi kendi vitrininde ve reklamlarında gösterir. Her platformun beklediği alan adları ve zorunlu bilgiler ayrıdır. Bu yüzden dışarı verme çoğu zaman bir şablonla yapılır: şablon, mağazadaki alanların platformun beklediği etiketlere nasıl çevrileceğini belirler. Dikkat edilecekler şunlardır: - **Yalnız satılabilir ürünleri verin:** Görseli ve stoğu olmayan ürün reklama çıkarsa ya hata alırsınız ya da tükenmiş ürüne reklam harcarsınız. - **Fiyatı platforma göre ayarlayın:** Bazı platformlarda farklı fiyat politikası uygulanabilir; çıktıda fiyatı tutar ya da yüzde olarak artırıp azaltabilmek bu yüzden önemlidir. - **Dil ve para birimini seçin:** Yurt dışı pazara yönelik reklamda ürünün ilgili dilde ve para biriminde gitmesi gerekir. - **Bağlantıyı koruyun:** Çıktı adresi herkese açık olursa rakipler de ürün ve fiyat listenizi okuyabilir; mümkünse yalnız belirli adreslerden erişime izin verin. - **Dosyayı parçalayın:** Çok büyük kataloglarda tek dosya yerine birkaç parça daha güvenli ve hızlı okunur. Arama motorlarının ürün sayfalarını anlaması için kullanılan yapılandırılmış veri ise ayrı bir konudur; onu [Yapılandırılmış Veri (Schema) Nedir?](https://www.faprika.com/blog/yapilandirilmis-veri-nedir) yazısında okuyabilirsiniz. Okumanızı öneririz Toplu Ürün Güncelleme Nasıl Yapılır? ## XML'de Alan Eşleştirme Nasıl Yapılır? Alan eşleştirme, kaynak XML'deki her etiketin mağazadaki hangi alana yazılacağının belirlenmesidir. Eşleştirme yanlışsa veri akar ama yanlış yere akar: fiyat stok alanına, barkod stok koduna yazılabilir. | Kaynaktaki bilgi | Mağazadaki karşılığı | Dikkat edilecek nokta | | --- | --- | --- | | Stok kodu | Ürün stok kodu (SKU) | Eşleştirmenin anahtarı; benzersiz ve sabit olmalı | | Barkod | Barkod alanı | Boş ya da tekrarlı barkodlar pazaryeri ve reklam kurallarına takılabilir | | Ürün adı | Ürün adı | Fazla uzun ya da büyük harfli adlar düzenlenmeli | | Fiyat | Satış fiyatı | KDV dahil mi hariç mi geldiği netleştirilmeli | | Stok miktarı | Stok adedi | Negatif ve boş değerler 0 sayılmalı | | Kategori | Mağaza kategorisi | Kaynağın kategori ağacı sizinkine çevrilmeli | | Görsel bağlantısı | Ürün görselleri | Bağlantı çalışmalı; kaynak görseli kaldırırsa sayfa boş kalır | | Varyant (beden, renk) | Seçenekler ve varyantlar | Ana ürün ile alt kayıtların ilişkisi doğru kurulmalı | Stok kodunu doğru yönetmek eşleştirmenin temelidir; stok kodlarının nasıl kurulması gerektiğini [SKU Nedir? Stok Kodu (SKU) Nasıl Oluşturulur?](https://www.faprika.com/blog/sku-nedir) yazısı anlatıyor. Kaynakta kategori ağacı sizinkinden farklıysa, her kaynak kategorisini kendi kategorinizle bir kez eşleştirmek sonraki turlarda sizi yeniden uğraştırmaz. ## XML Güncelleme Sıklığı Ne Olmalı? Güncelleme sıklığı, verinin ne kadar çabuk değiştiğine ve bu gecikmenin size ne kadara mal olduğuna göre belirlenir. Stok ve fiyat sık, açıklama ve görsel seyrek güncellenir; sıklık arttıkça yanlış satış ihtimali azalır. | Veri türü | Değişme hızı | Güncelleme yaklaşımı | | --- | --- | --- | | Stok miktarı | Çok hızlı, her satışta | En sık turlar; mümkünse dakikalar | | Fiyat | Orta, kampanya ve kur dönemlerinde hızlı | Sık turlar; kampanya öncesi elle tetikleme | | Ürün durumu (aktif, pasif) | Orta | Stokla birlikte güncellenir | | Açıklama ve özellikler | Yavaş | Seyrek tur ya da yalnız ilk aktarımda | | Görseller | Yavaş | Seyrek tur; yeni ürün geldiğinde | | Yeni ürün ve kategori | Düzensiz | Günlük ya da haftalık tur | Burada iki ayrı gecikme birbirine karışır. Birincisi okuma aralığıdır: sisteminiz XML'i kaç dakikada bir okuyor? İkincisi kaynağın kendi yenileme aralığıdır: tedarikçi dosyasını ne sıklıkla güncelliyor? Verinin ortalama yaşı, bu iki gecikmenin toplamına bağlıdır. Ne kadar sık okursanız okuyun, kaynak günde bir yenileniyorsa stok o kadar eski kalır. Faprika'nın XML yönetiminde güncelleme süreleri ve birçok alan müşteri tarafından yönetilir; güncelleme günlük değil, dakikalarla yapılabilir. Dinamik XML Yönetimi eklentisinin tanıtımında da diğer firmalarda ortalama bir gün süren güncelleme süresinin Faprika'da müşteriye bırakıldığı ve dakikalara indirilebildiği belirtilir. Pazaryerleriyle stok eşitleme tarafı için [Pazaryeri Stok Senkronizasyonu Nasıl Yapılır?](https://www.faprika.com/blog/pazaryeri-stok-senkronizasyonu) rehberine bakabilirsiniz. Okumanızı öneririz Pazaryeri Stok Senkronizasyonu Nasıl Yapılır? ### Güncelleme Gecikmesinin Maliyeti Nasıl Hesaplanır? Gecikmenin maliyeti, veri bayatken alınan siparişlerin bir kısmının stoğu olmayan ürüne gelmesinden doğar: sipariş iptal edilir, müşteri kaybedilir, bazı kanallarda ceza ya da puan kaybı yaşanır. Aşağıdaki araç bunu kaba bir model üzerinden tahmin eder. Model şöyle çalışır: günlük güncelleme sayısı turlar arasındaki aralığı verir; verinin ortalama yaşı bu aralığın yarısı ile gecikmenin toplamıdır; yaşın günün ne kadarını kapladığı, bayat veriyle sipariş alma payını gösterir; bu payın stok farkı oranıyla çarpımı tahmini hatalı sipariş sayısını verir. Değerler varsayımdır, kendi verinizle değiştirin. Güncelleme gecikmesi maliyeti Ürün sayısı Günlük güncelleme sayısı Ortalama gecikme (saat) Günlük sipariş sayısı Ortalama sipariş tutarı (para birimi) Bayat veride hatalı sipariş oranı (%) Verinin ortalama yaşı (saat)**4** Bayat veri payı (gün içinde, %)**16,7** Her gün taranan ürün satırı**20.000** Günlük tahmini hatalı sipariş**1** Aylık tahmini hatalı sipariş**30** Aylık hatalı sipariş tutarı (para birimi)**24.000** Bayat veri payı düşük görünüyor. Güncelleme sıklığınız bu sipariş hacmi için yeterli; kaynağın kendi yenileme aralığını da kontrol edin. Bayat veri payı orta düzeyde. Günlük güncelleme sayısını artırmak ya da gecikmeyi azaltmak hatalı siparişleri belirgin biçimde düşürebilir. Bayat veri payı yüksek görünüyor. Stok ve fiyatı daha sık güncellemek, özellikle yoğun satış saatlerinde, bu maliyeti en hızlı azaltacak adımdır. Hesap: aralık = 24 ÷ günlük güncelleme sayısı; ortalama yaş = aralık ÷ 2 + gecikme; bayat veri payı = ortalama yaş ÷ 24 (en çok %100); günlük hatalı sipariş = günlük sipariş × bayat veri payı × hatalı sipariş oranı; aylık değerler 30 gün üzerinden; tutar = aylık hatalı sipariş × ortalama sipariş tutarı. Siparişlerin gün içinde eşit dağıldığı varsayılır. Gerçek maliyet, ürünlerin ne kadar hızlı satıldığına, kampanya yoğunluğuna ve kanalların iptal kurallarına göre değişir; sonuç karar için bir başlangıç çerçevesidir, kesin kayıp değildir. Sonucu okurken iki şeyi akılda tutun. Birincisi, güncelleme sayısını iki katına çıkarmak verinin yaşını yarıya indirmez; çünkü gecikme sabit kalır. İkincisi, hesap yalnız doğrudan kaybı gösterir; müşterinin iptal edilen siparişten sonra mağazaya duyduğu güven kaybını rakamla ifade etmek zordur ama gerçektir. Gecikmeyi azaltmanın en etkili yolu çoğu zaman sıklığı değil, okuma ile yazma arasındaki bekleyişi kısaltmaktır. ## XML Entegrasyonunda Hatalar Nasıl Yönetilir? XML entegrasyonunda hata yönetimi, hatayı önceden önlemek, olduğunda hızlı fark etmek ve kimin neyi düzelteceğini bilmekten oluşur. Sessiz çalışan bir entegrasyon sorunsuz çalışan entegrasyon demek değildir; aktarım günlüğü düzenli okunmalıdır. Üç katman birlikte çalışır: kaynak dosyayı denetleyen kurallar (zorunlu alan boş mu, fiyat sıfır mı), aktarım günlüğü (kaç ürün eklendi, güncellendi, hata verdi) ve uyarı (hata oranı eşiği aştığında haber veren mekanizma). Aşağıdaki tablo en sık karşılaşılan durumları özetler. | Belirti | Olası neden | Ne yapılır? | | --- | --- | --- | | Türkçe karakterler bozuk geliyor | Kodlama UTF-8 değil ya da yanlış okunuyor | Dosyanın bildirimindeki kodlamayı ve okuyucunun kodlama ayarını denetleyin | | Dosya hiç okunamıyor | Kapanmayan etiket, geçersiz karakter ya da kesilmiş dosya | Dosyayı tarayıcıda açıp hata satırını bulun; kaynağa bildirin | | Bağlantı zaman aşımına uğruyor | Dosya çok büyük ya da kaynak yavaş | Dosyayı parçalara bölün, okuma saatini yoğun saatlerin dışına alın | | Ürünler çift görünüyor | Eşleştirme anahtarı (stok kodu) benzersiz değil | Anahtarı değiştirin ya da kaynaktaki tekrarları temizletin | | Fiyat ya da stok yanlış alana yazılıyor | Alan eşleştirmesi hatalı | Eşleştirmeyi tek bir ürün üzerinde deneyip kontrol edin | | Ürünler birden pasife düşüyor | Kaynak geçici olarak boş dosya yayınladı | Boş ya da çok küçük dosyada güncellemeyi durduran bir eşik koyun | | Görseller görünmüyor | Görsel bağlantısı kırık ya da kaynak erişimi kısıtlıyor | Görselleri kendi sunucunuza almayı ya da kaynakla erişimi netleştirmeyi düşünün | | Stok sıfır olmasına rağmen ürün satışta | Güncelleme gecikmesi ya da stok alanının yanlış okunması | Sıklığı artırın; güvenlik stoku bırakın | Özellikle boş dosya durumu tehlikelidir: kaynak bir arıza sırasında içi boş bir XML yayınlarsa, entegrasyon bunu “tüm ürünlerin stoğu bitti” diye yorumlayıp bütün kataloğu kapatabilir. Bunu önlemek için gelen kayıt sayısı önceki turdan keskin biçimde azalmışsa güncellemeyi uygulamayan bir eşik kullanın. Güvenlik stoku ise kaynakta görünen stoktan belirli bir miktarı mağazada saklı tutarak gecikmenin yol açtığı fazla satışı tamponlar. İpucu Hatayı kaynakla birlikte çözün Kaynağın bozuk veri yayınladığı durumlarda mağazada yapılacak düzeltme geçicidir. Hatalı dosya örneğini, saat ve ürün koduyla birlikte kaynağa iletmek sorunun kalıcı çözülmesini sağlar. Hata günlüğünden aldığınız birkaç somut örnek, tarif etmeye çalışmaktan daha hızlı sonuç verir. ## XML Entegrasyonunda Sık Yapılan Hatalar XML kurulumundaki hatalar çoğunlukla teknik değil, planlama kaynaklıdır. En sık görülenler şunlardır: - **Kaynağın güncelleme aralığını sormamak:** Siz sık okusanız da kaynak seyrek yeniliyorsa gecikme kaçınılmazdır. - **Her şeyi her turda yazmak:** Elle düzelttiğiniz metinler ve görseller sürekli üzerine yazılır. - **Eşleştirmeyi tek üründe denemeden tüm kataloğa uygulamak:** Yanlış eşleşme binlerce kaydı bozabilir. - **Boş dosyaya karşı koruma koymamak:** Tek bir arıza bütün kataloğu pasife alabilir. - **Güvenlik stoku bırakmamak:** Stok sıfıra inene kadar satmak, gecikme olduğunda satılamayacak ürünü satmak demektir. - **Dışarı verilen çıktıda stoksuz ve görselsiz ürün bırakmak:** Reklam tükenmiş ürüne gider ya da hata alınır. - **Çıktı adresini herkese açık bırakmak:** Ürün ve fiyat listeniz kolayca kopyalanır. - **Günlüğü okumamak:** Hata uzun süre fark edilmeden birikir. Okumanızı öneririz Stokta Olmayan Ürün Sayfası Ne Yapılmalı? ## Faprika ile XML Entegrasyonu Nasıl Yapılır? Faprika'da XML yönetimi iki parçadan oluşur: ürün aktarımı ve stok güncellemesi için kullanılan Dinamik XML Yönetimi ile panelden alınan ürün çıktısı. İkisinde de hedef aynıdır: güncelleme sürelerini ve alanları sizin yönetmeniz. [Dinamik XML Yönetimi](https://www.faprika.com/eklenti/dinamik-xml-yonetimi) eklentisi ürün aktarımını, stok güncellemeyi ve satış raporlarını dışa aktarmayı özelleştirilebilir XML yapılarıyla yönetmenizi sağlar. Alanların özelleştirilebilir olması, kaynağın yapısına uymanıza ve kendi tercihlerinizi belirlemenize imkân verir. Eklenti, süreci otomatik ve sürekli kılmak için tasarlanmıştır. ### Panelden Ürün XML'i Nasıl Alınır? Reklam ve alışveriş platformları için ürün çıktısı panelden birkaç adımda oluşturulur. Yönetici panelinde **Katalog, Aktarım, Ürünleri Dışarı Aktar** adımlarını izlersiniz. Ayrıntılı anlatım için [Ürünleri Dışarı Aktarma eğitimine](https://www.faprika.com/egitim/facebook-ve-google-icin-xml-almak) bakabilirsiniz. *Görsel: Faprika panelinde Ürünleri Dışarı Aktar ekranı: filtre alanları, şablon, dil, para birimi ve fiyat farkı ayarları (Ürünleri Dışarı Aktar ekranı: önce filtre, sonra çıktı ayarı)* Önce hangi ürünlerin dışarı verileceğini filtrelersiniz: resimli ürünler, ürün tipi, aktif ürünler, stok başlangıç miktarı ve kategori. Filtrelemeyi boş bırakırsanız tüm ürünler gönderilir. Ardından çıktı ayarlarını doldurursunuz: | Alan | Ne işe yarar? | | --- | --- | | Çıktı adı | Çıktıyı diğerlerinden ayırmak için verdiğiniz ad | | Dosya tipi | Bu akışta XML seçilir | | Şablon | Çıktının hangi platformun biçimine göre üretileceği; platformun şablonu seçilir | | Dil | Ürünlerde ek dil bilgisi varsa farklı dillerde çıktı alınır | | Para birimi | Çıktıdaki fiyatın hangi birimle yazılacağı | | Fiyat değeri | Fiyata eklenecek ya da çıkarılacak değer; fark istemiyorsanız 0 kalır | | Fiyat tipi | Hangi fiyat üzerinden gönderim yapılacağı | | Hesaplama tipi | Farkın tutar mı yüzde mi olacağı | | Hesaplama yönü | Fiyatı artırmak ya da azaltmak | | Toplam parça | Çıktının kaç bağlantıya bölüneceği; çok ürünlü XML'lerde kullanılır, genel öneri 1'dir | | İzin verilen IP adresleri | Yalnız belirli adreslerden erişim istiyorsanız kısıtlama; yoksa boş | Aktif kutusunu işaretleyip kaydettikten sonra çıktı bağlantılarına girer ve karşınıza çıkan XML bağlantısını kullanırsınız. Filtreleme zorunlu değildir; ancak reklam çıkacağınız ürünlerin görselleri ve stokları olması hata almamanızı ve stoğu olmayan ürüne reklam çıkmamasını sağlar. ### Faprika'da Güncelleme Nasıl Yönetilir? Faprika, XML güncellemelerinde süre ve alanları müşteriye bırakır. Bu, iki pratik sonuç doğurur: kampanya ya da yoğun satış döneminde sıklığı artırabilir, sakin dönemde azaltabilirsiniz; ve kaynaktaki alanları kendi mağaza yapınıza uygun eşleştirebilirsiniz. Eklenti ve diğer çözümlerin hangi pakette bulunduğu paketlere göre değişir; ayrıntılar için [e-ticaret paketleri](https://www.faprika.com/e-ticaret-paketleri) karşılaştırmasına bakabilirsiniz. ## XML Entegrasyonu Kontrol Listesi Bir XML kaynağını bağlamadan ya da bir çıktıyı yayınlamadan önce aşağıdaki listeden geçin. Her madde “evet” olduğunda akışınız sağlam bir temele oturmuş demektir. *Görsel: XML entegrasyonu kontrol listesi: kodlama, benzersiz stok kodu, alan eşleştirme, güncelleme sıklığı, boş dosya koruması ve çıktı filtresi (XML kaynağı ve çıktısı için altı kontrol)* XML kaynağı ve çıktı denetimi Dosya tarayıcıda hatasız açılıyor ve Türkçe karakterler doğru görünüyor Her üründe benzersiz bir stok kodu var Fiyat, stok ve kategori alanları tek üründe denendi ve doğru yazıldı Kaynağın kendi yenileme aralığını ve kendi okuma sıklığımı biliyorum Boş ya da çok küçük dosyada güncellemeyi durduran bir koruma var Elle düzenlediğim metin alanları üzerine yazılmıyor Dışarı verilen çıktıda yalnız görseli ve stoğu olan ürünler var Aktarım günlüğünü ve hata sayısını düzenli kontrol ediyorum Uyan madde**2 / 8** XML akışı henüz oturmamış görünüyor. Önce dosyanın doğruluğunu, benzersiz stok kodunu ve alan eşleştirmeyi tamamlayın. Temel akış var ama eksikler duruyor. Boş dosya koruması, güncelleme sıklığı ve günlük kontrolünü gözden geçirin. XML akışınız sağlam. Şimdi güncelleme gecikmesini ölçüp sıklığı sipariş hacminize göre ayarlayın. | Alan | Kontrol | Tamam mı? | | --- | --- | --- | | Dosya | Tarayıcıda hatasız açılıyor, kodlama doğru | Evet / Hayır | | Kimlik | Her üründe benzersiz stok kodu var | Evet / Hayır | | Eşleştirme | Fiyat, stok ve kategori tek üründe denendi | Evet / Hayır | | Sıklık | Kaynağın ve kendi okuma aralığım biliniyor | Evet / Hayır | | Koruma | Boş ya da küçük dosyada güncelleme durur | Evet / Hayır | | Üzerine yazma | Elle düzenlenen metinler korunuyor | Evet / Hayır | | Çıktı | Yalnız görselli ve stoklu ürünler dışarı veriliyor | Evet / Hayır | | Günlük | Hata sayısı düzenli izleniyor | Evet / Hayır | ## Sıkça Sorulan Sorular **XML entegrasyonu nedir?** XML entegrasyonu, ürün, stok ve fiyat gibi verilerin XML biçimindeki bir dosya aracılığıyla iki sistem arasında otomatik aktarılmasıdır. Bir sistem veriyi XML bağlantısında yayınlar, diğeri belirli aralıklarla okuyup kendi kayıtlarına işler. **XML ile ürün içeri almak ile dışarı vermek arasındaki fark nedir?** İçeri almada dışarıdaki bir kaynağın ürün ve stok verisi mağazanıza okunur; tedarikçiden katalog kurmak için kullanılır. Dışarı vermede mağazanızdaki ürünler XML bağlantısı olarak yayınlanır; reklam ve alışveriş platformları bu bağlantıyı okur. **XML güncellemesi ne sıklıkla yapılmalı?** Stok ve fiyat en sık, açıklama ve görseller seyrek güncellenir. Sipariş hacmi yükseldikçe ve kaynak sık yenilendikçe sıklık artırılmalıdır. Faprika'da güncelleme süreleri müşteri tarafından yönetilir ve günlük değil dakikalarla yapılabilir. **XML'de alan eşleştirme neden önemlidir?** Eşleştirme kaynaktaki her bilginin mağazada doğru alana yazılmasını sağlar. Hatalı eşleştirmede fiyat stok alanına ya da barkod stok koduna yazılabilir. Bu yüzden eşleştirme önce tek üründe denenmeli, sonra tüm kataloğa uygulanmalıdır. **XML entegrasyonunda en sık hata nedir?** Bozuk karakter kodlaması, benzersiz olmayan stok kodu, yanlış alan eşleştirmesi, kaynağın boş dosya yayınlaması ve güncelleme gecikmesi en sık görülen hatalardır. Aktarım günlüğünü düzenli okumak ve boş dosyaya karşı koruma koymak bunların çoğunu önler. **Faprika'da ürünleri reklam platformları için XML olarak nasıl alırım?** Yönetici panelinde Katalog, Aktarım, Ürünleri Dışarı Aktar adımlarında ürünleri filtreler; çıktı adı, dosya tipi, şablon, dil, para birimi ve fiyat farkını ayarlar ve kaydettikten sonra çıktı bağlantısındaki XML adresini kullanırsınız. Reklam çıkacağınız ürünlerde görsel ve stok bulunması hata almamanızı sağlar. Stok ve fiyat dakikalarla güncel kalsın Faprika'nın Dinamik XML Yönetimi ile ürün aktarımını otomatik hâle getirin, güncelleme sürelerini kendiniz belirleyin ve ürünlerinizi reklam platformlarına tek bağlantıyla açın. Uzmanlarımızla XML akışınızı birlikte planlayalım. Demo İsteyin #### İlginizi Çekebilecek Yazılar - [**XML Tedarikçi Nedir?**](https://www.faprika.com/blog/xml-tedarikci-nedir) - [**Toplu Ürün Güncelleme Nasıl Yapılır?**](https://www.faprika.com/blog/toplu-urun-guncelleme-nasil-yapilir) - [**Pazaryeri Stok Senkronizasyonu Nasıl Yapılır?**](https://www.faprika.com/blog/pazaryeri-stok-senkronizasyonu) - [**Stok Takibi Nedir? Nasıl Yapılır?**](https://www.faprika.com/blog/stok-takibi-nedir-nasil-yapilir)