E-ticaret sözlüğüAltyapı ve teknoloji

XML entegrasyonu nedir?

XML: Extensible Markup Language · genişletilebilir işaretleme dili

XML entegrasyonu, ürün veya başka iş verilerinin XML biçiminde alınarak kaynak alanlarının hedef sistemdeki karşılıklarına eşlenmesi ve ilgili kayıtlara aktarılması sürecidir. Kurguda 1.500 TL satış fiyatı yerine 1.000 TL alış alanı aktarılırsa fark 500 TL olur.

Son kontrol: 27 Ekim 20263 resmî kaynakGündem Masası

Tanım

XML entegrasyonu, ürün veya başka iş verilerinin XML biçiminde alınarak kaynak alanlarının hedef sistemdeki karşılıklarına eşlenmesi ve ilgili kayıtlara aktarılması sürecidir.

Bir bakışta

İşlevXML verisini hedef ürün ve işlem alanlarıyla eşleme

Kurgu fiyatHedef 1.500 TL; yanlış aktarılan 1.000 TL

Kurgu fark500 TL; amaçlanan satış fiyatının yaklaşık %33,33’ü

KontrolKaynak zamanı, alan eşleşmesi ve hedef kayıt sonucu

XML dosyası mağazaya hangi bilgileri taşıyabilir?

XML, Extensible Markup Language ifadesinin kısaltmasıdır; Türkçede genişletilebilir işaretleme dili olarak açıklanır. Verinin yapısını etiketli bir düzenle ifade eder. E-ticarette ürün adı, stok, fiyat, görsel veya varyant bilgilerinin aktarılmasında kullanılabilir. Türkiye’de satıcı için temel soru, tedarikçinin dosya vermesi kadar mağazanızın o dosyayı doğru anlamasıdır. Dosyanın okunabilir olmasıyla satışa uygun ürün kaydının oluşmasını ayrı kontrol edin. W3C XML standardı veri belgesinin yapısal kurallarını tanımlar; hangi alanın sizin satış fiyatınız olacağını mağazanızın veri eşleştirmesi belirler. Kaynak dosyanın bir örneğini ve alan açıklamalarını kurulumdan önce isteyin.

Ticimax’ın resmî destek belgesi, XML çıktısında fiyat tipi ve ürün filtrelerinin seçilebildiğini açıklar. Bu, aynı mağazadan üretilen her bağlantının aynı ürünleri veya aynı fiyat alanını içerdiği varsayımının yanlış olabileceğini gösterir. Tedarikçi veya bayiyle çalışırken size verilen dosyanın kapsamını yazın. Ürün adı, kimlik, fiyat, para birimi, stok ve seçenek alanlarının karşılıklarını birlikte kontrol edin. Bir alanın adı benzer görünse bile alış fiyatını satış fiyatına bağlamayın. Dosyada eksik değer varsa hedefte hangi davranışın uygulanacağını öğrenin. Boş veri, sıfır ve güncelleme yapılmaması seçeneklerini aynı karar gibi ele almayın.

API ve webhook ile ilişkisi nasıl ayrılır?

XML bir veri biçimidir; API ise yazılım işlevlerine programla erişim arayüzünü anlatır. API üzerinden XML taşınması da mümkün olabileceğinden bunları her durumda birbirini dışlayan iki bağlantı seçeneği gibi sunmayın. Webhook ise bir olaydan sonra başka sisteme bildirim gönderilmesini ifade eder. Elinizde XML adresi olması, sipariş iptalinde anında bildirim geleceğini göstermez. Hangi verinin hangi yönde taşındığını belirleyin: tedarikçiden mağazaya ürün almak ile mağazadan tedarikçiye sipariş göndermek ayrı işlevlerdir. Sadece ürün aktarımı için alınan hizmetin bütün sipariş yönetimini kapsadığını varsaymayın.

Mağazanız SaaS veya açık kaynak yazılım üzerinde çalışabilir. XML eşleştirmesini hangi bileşenin yaptığını, çalışmayı kimin izlediğini ve hata kaydını kimin okuyacağını belirleyin. Kaynağın güncellenme zamanı ile mağazanızın veriyi çekme zamanı aynı olmayabilir. Güncelleme sıklığını, son başarılı aktarımı ve hata halinde izlenen yöntemi hizmetinizin belgesinden öğrenin. Bir bağlantının adında XML geçmesi bütün sistemler için ortak dakika veya saat garantisi oluşturmaz. Tedarikçinin dosyayı ne zaman ürettiği bilinmiyorsa son çekim zamanı tek başına ürün stoklarının güncelliğini açıklamaz. İki aşamayı takip tablonuzda ayrı gösterin.

Ürün ve varyant eşleştirmesi nasıl kontrol edilir?

Ürün varyantı bulunan katalogda ana ürünle tekil seçenekleri ayırın. Aynı modelin renk ve bedenleri için hangi kimliğin ortak, hangisinin ayrı olduğunu belirleyin. Google Merchant Center’ın ürün grubu kimliği belgesi, tekil ürün kimliği ile varyantları birleştiren grup kimliğini ayırır. Bu örnekteki alan adlarını her tedarikçi dosyasına zorunlu alan diye taşımayın; kendi kaynak ve hedefinizin şemasını esas alın. Kontrol için farklı seçenekleri olan birkaç ürünü seçin. Görsel, fiyat ve stok bilgisinin doğru seçenekle eşleştiğini deneme aktarımında inceleyin. Yalnız ana ürün başlığının gelmesini başarılı varyant aktarımı saymayın.

W3C’nin yapısal kuralları bakımından düzgün okunabilen bir XML belgesinde ticari açıdan yanlış fiyat veya kimlik bulunabilir. Bu yüzden teknik okuma hatasıyla veri eşleştirme hatasını ayırın. Önce dosyanın alınabildiği ve işlenebildiği kontrol edilir; sonra hedef kaydın doğru ürün, seçenek ve değerlerle oluştuğu karşılaştırılır. İlk aktarımı küçük bir örnek grubunda denemek, hatalı eşleştirmenin bütün kataloğa yayılmasını önler. Kaynaktan kaldırılan ürünün mağazada ne olacağını da önceden belirleyin. Son aktarımda görünmeyen bir kaydı hemen silmek veya süresiz eski stokla tutmak farklı sonuçlar doğurur. Kullandığınız hizmetin davranışını belgeleyin ve işletmenizin kararını buna göre verin.

Özgün örnek: yanlış fiyat alanının etkisi

Kurgusal bir kaynakta aynı ürün için alış fiyatı 1.000 TL, satış fiyatı 1.500 TL olsun. Bu örnekte mağazaya aktarılmak istenen alan satış fiyatıdır; vergi kapsamları aynı varsayılmış ve ayrıca vergi hesabı yapılmamıştır. Eşleştirmede alış alanı seçilirse mağazada 1.000 TL görünür. Doğru hedefle fark 1.500 TL − 1.000 TL = 500 TL’dir. Eksikliğin amaçlanan satış fiyatına oranı 500 / 1.500 × 100 ≈ %33,33 olur. Sayılar gerçek tedarikçi verisi değildir. Dosyanın sorunsuz okunması bu 500 TL farkı ortadan kaldırmaz; doğru alan eşleştirilmelidir.

Eşleştirme düzeltilip deneme ürünü yeniden aktarıldığında hedef fiyat 1.500 TL ile eşleşir ve fark 0 TL olur. Aynı ürünün üç seçeneğinde satılabilir stokların sırasıyla 4, 6 ve 0 olduğunu da varsayalım. Toplam 10 adet bulunması, bu toplamın her seçeneğe 10 adet yazılmasını gerektirmez. Doğru seçenekler kendi stoklarını korur; stok toplamını her satıra kopyalamak bu kurguda toplam görünümü 30 adede çıkarır. Fiyat ve seçenek kontrolleri ayrı yapılmalıdır. Sonuçtan kâr, komisyon veya vergi tutarı hesaplanmamıştır. Denemede doğru görülen alanları onayladıktan sonra daha geniş aktarımı aynı eşleştirme ve sonuç kontrolüyle yürütün.

05 · Örnek

Örnek: Alış alanının satış alanına yanlış bağlanması

Kurguda alış fiyatı 1.000 TL, aktarılmak istenen satış fiyatı 1.500 TL’dir. Yanlış eşleştirmeyle hedefte 1.000 TL görünür.

1.500 TL − 1.000 TL = 500 TL farkı bulun.
500 / 1.500 × 100 ≈ %33,33 eksiklik oranını bulun.
Kaynak satış alanını hedef satış fiyatıyla doğru eşleştirin.
Yeniden aktarılan deneme ürününde 1.500 TL ve 0 TL farkı doğrulayın.

Sonuç

Kurguda doğru alan seçilince hedef fiyat 1.500 TL olur; hesap kâr veya vergi hesabı değildir.

06 · Fark

XML entegrasyonu ile karıştırılan kavramlar

XML entegrasyonu ≠ API

Yazılım işlevlerine erişim arayüzüdür; XML bu arayüzde de taşınabilecek veri biçimidir.

XML entegrasyonu ≠ Webhook

Olay sonrası bildirim mekanizmasıdır; XML dosyası bulunması anlık olay bildirimi sağlamaz.

XML entegrasyonu ≠ Dosyanın okunması

Teknik işleme aşamasıdır; fiyat ve varyantların doğru hedeflere yazılması ayrıca karşılaştırılır.

07 · Satıcı için

Satıcı ne yapmalı?

Kaynak dosya ve alan açıklamalarını alın.
Ürün kimliği, varyant, fiyat, para birimi ve stok karşılıklarını eşleştirin.
Ürün alma ile sipariş gönderme kapsamlarını ayırın.
Küçük bir deneme grubunda hedef sonuçları kontrol edin.
Kaynak güncellemesiyle son başarılı çekim zamanını ayrı izleyin.
Eksik, boş veya kaldırılan ürünler için uygulanacak davranışı belirleyin.

08 · Devamı

İlgili rehberler

09 · Sık sorulanlar

XML entegrasyonu hakkında sık sorulanlar

XML entegrasyonu yalnız dosyayı indirmek mi?

Dosyanın alınmasının ardından alanların hedef karşılıklarına eşlenmesi ve kayıtların doğru oluştuğunun kontrol edilmesi gerekir.

Her XML aynı ürün alanlarını mı kullanır?

Kaynaklar farklı alan adları ve yapılar kullanabilir. Kaynak açıklamasıyla hedef sistemin istediği şema eşleştirilmelidir.

XML ve API birbirinin zıttı mı?

XML veri biçimini, API erişim arayüzünü anlatır. Bir API üzerinden XML veri taşınması da mümkün olabilir.

XML adresi varsa stok anında güncellenir mi?

Kaynağın üretim ve hedefin çekim zamanları kontrol edilmelidir. Bağlantı adı tek başına ortak bir anlık güncelleme garantisi vermez.

Dosya hatasız okunuyorsa fiyat da doğru mu?

Teknik olarak okunabilen dosyada yanlış alan eşleşmesi olabilir. Alış ve satış fiyatı gibi değerleri kaynakla hedef arasında karşılaştırın.