XML Entegrasyon Hata Logları Nasıl Okunur? XML Hataları ve Çözümleri

XML entegrasyonu kurulduktan sonra en çok vakit kaybettiren şey, neden çıktığı anlaşılmayan hatalardır. Ürünler aktarılmaz, stok güncellenmez, pazaryeri ürünü reddeder ve ekranda "XML parser error" gibi anlaşılması zor bir mesaj görürsünüz. Bu rehberde hata loglarını nasıl okuyacağınızı, hatanın hangi aşamada çıktığını nasıl bulacağınızı ve en sık karşılaşılan XML hatalarının ne anlama geldiğini ve nasıl çözüleceğini sade bir dille anlatıyoruz.

XML Hata Logu Nedir?

Hata logu, entegrasyon programınızın her XML okumasında ne yaptığını ve nerede sorun yaşadığını kaydettiği listedir. İyi bir log kaydında genellikle şunlar bulunur: işlemin zamanı, hatanın seviyesi (bilgi, uyarı veya hata), hangi ürünü etkilediği (ürün kodu) ve hata mesajı. Log, "bir şeyler ters gitti" demekten çok, sorunun nerede başladığını gösterir.

Hata Logu 5 Adımda Nasıl Okunur?

1. Zamana bakın. Sorun ne zaman başladı? O saatte tedarikçi tarafında veya sizin sisteminizde bir değişiklik oldu mu?
2. Hatanın aşamasını bulun. Dosya indirilemedi mi, okunamadı mı, yoksa okundu ama ürün kaydedilemedi mi? Aşağıdaki 5 aşama bunu anlamanızı sağlar.
3. Ürün kodunu bulun. Hata tek bir üründe mi, bir kategoride mi, yoksa tüm üründe mi?
4. İlk hatayı okuyun. Yüzlerce hata satırı varsa çoğu zaman ilk hata asıl nedendir, diğerleri onun sonucudur.
5. Son başarılı güncellemeyle karşılaştırın. Dün çalışan bir alan bugün hata veriyorsa, XML'deki o alanın değeri veya yapısı değişmiş olabilir.

XML Hataları Hangi Aşamada Çıkar?

• 1. İndirme aşaması: XML linkine ulaşılamaz. HTTP 404, 401, 403, 500 veya zaman aşımı (timeout) hataları bu aşamadadır.
• 2. Okuma (parse) aşaması: Dosya indirilir ama yapısı bozuk olduğu için okunamaz. "XML parser error", "unexpected end of file" bu aşamadadır.
• 3. Eşleştirme (mapping) aşaması: Dosya okunur ama XML'deki alan, sizin sisteminizdeki alanla eşleşmez. "Fiyat alanı bulunamadı" gibi.
• 4. Doğrulama aşaması: Alan bulunur ama değeri geçersizdir. Boş fiyat, harf içeren stok, geçersiz barkod gibi.
• 5. Satış kanalı aşaması: Ürün sizin sisteminize kaydedilir ama pazaryeri reddeder. "Required attribute missing", "product rejected" gibi.

Hatayı doğru aşamaya yerleştirmek, çözümün yarısıdır: indirme hatası tedarikçinin veya sunucunun, satış kanalı hatası ise genellikle sizin kategori ve özellik eşleştirmenizin konusudur.

En Sık XML Hataları ve Çözümleri

XML parser error ne demek?

XML parser error, XML dosyasının yapısının bozuk olduğu ve okunamadığı anlamına gelir. Genellikle kapanmamış bir etiket, hatalı bir özel karakter veya yarım inmiş bir dosya yüzünden çıkar. Hata mesajında genellikle satır ve sütun numarası yazar (örneğin "line 4821, column 39"). XML linkini tarayıcıda açıp o satıra bakarak sorunlu ürünü bulabilirsiniz. Hata tedarikçinin dosyasındaysa bu satır bilgisiyle birlikte tedarikçinize bildirin.

Unexpected end of file (dosya beklenmedik şekilde bitti)

Dosya yarım inmiştir. Genellikle bağlantı kopması, sunucu yoğunluğu veya çok büyük dosyalarda zaman aşımı nedeniyle olur. Bir sonraki okumada genellikle kendiliğinden düzelir. Sürekli tekrarlanıyorsa entegrasyon programınızda zaman aşımı süresini uzatın.

Özel karakter hataları (& ve < işaretleri)

Ürün adında veya açıklamasında geçen "&" ya da "<" işaretleri XML'de özel anlam taşır ve doğru şekilde kodlanmazsa dosyayı bozar. "EntityRef: expecting ;" gibi hatalar bu nedenle çıkar. Çözüm tedarikçi tarafındadır; hatanın satırını tedarikçinize iletin.

Türkçe karakter bozulması (encoding hatası)

Ürün adlarında "ÅŸ", "ı" gibi garip karakterler görüyorsanız dosyanın karakter kodlaması (encoding) ile sisteminizin beklediği kodlama uyuşmuyordur. XML'in başındaki encoding bilgisini kontrol edin ve entegrasyon programınızda aynı kodlamayı (genellikle UTF-8) seçin.

HTTP 404, 401, 403 ve 500 hataları

• 404: XML linki yanlış veya değişmiş. Linki tedarikçinizden yeniden alın.
• 401 ve 403: Yetki sorunu. Kullanıcı bilgileriniz veya erişim izniniz geçersiz olabilir.
• 500: Tedarikçinin sunucusunda geçici bir sorun. Genellikle bir sonraki denemede düzelir.

Not: Ürün görselinden dönen 404 hatası, XML linkinin 404 hatasıyla aynı şey değildir. Görsel hatası sadece o ürünün görselini etkiler.

Zorunlu alan eksik (price is required, category required)

XML'deki ilgili ürünün fiyat, kategori veya stok alanı boş gelmiştir ya da alan adı değişmiştir. Önce o ürünü XML'de bulun: alan boşsa tedarikçiye bildirin, alan adı değiştiyse eşleştirmenizi güncelleyin.

Kategori eşleştirme hataları

XML'deki kategori yolu sizin sitenizdeki veya pazaryerindeki bir kategoriyle eşleşmediğinde ürün aktarılmaz ya da yanlış kategoriye düşer. Tedarikçi yeni bir kategori eklediğinde bu hata sıkça görülür. Eşleşmemiş kategorileri düzenli kontrol edin ve yeni kategorileri eşleştirme tablonuza ekleyin.

Görsel URL hataları

Görsel linki açılmıyor, çok büyük veya yanlış formattaysa ürün görselsiz aktarılır ya da pazaryeri ürünü reddeder. Hatalı görselin linkini tarayıcıda açıp kontrol edin; görsel açılmıyorsa tedarikçiye bildirin. Görsellerin kalitesini nasıl kontrol edeceğinizi XML ürün açıklamaları ve görsel düzenleme rehberimizde anlattık.

Yinelenen ürünler (duplicate key)

Aynı ürün koduyla iki ürün gelirse veya sisteminiz ürün kodu yerine ürün adıyla eşleştirme yapıyorsa ürünler çoğalır ya da "duplicate key" hatası alırsınız. Eşleştirmeyi her zaman ürün kodu üzerinden yapın. Aynı kodla gelen iki farklı ürün varsa tedarikçinize bildirin.

Eksik barkod sorunu

Pazaryerlerinin çoğu barkod ister. Barkodu boş gelen ürünler pazaryerinde reddedilir. Bu ürünleri ayrı bir listede toplayın ve pazaryerinin barkodsuz ürün kurallarına göre işlem yapın; uydurma barkod kullanmayın.

Pazaryeri ürün reddi (required attribute missing)

Ürün sizin sisteminize sorunsuz kaydedilmiş ama pazaryeri reddetmişse sorun XML'de değil, pazaryerinin istediği zorunlu özelliklerdedir (renk, beden, malzeme, garanti süresi gibi). Pazaryerinin döndürdüğü hata kodunu saklayın; hangi özelliğin eksik olduğunu bu kod gösterir. Adım adım yükleme için XML ürünleri Trendyol'a nasıl yüklenir yazımıza bakın.

Aynı Hata Binlerce Üründe Görünüyorsa

Ürünleri tek tek kontrol etmeyin. Aynı hatanın binlerce kez tekrarlanması genellikle tek bir ortak nedeni gösterir: alan adının değişmesi, dosyanın yarım inmesi veya bir eşleştirme ayarının bozulması gibi. Hataları türüne göre gruplayın ve en kalabalık grubun ilk hatasından başlayın.

Veri Yedekleme ve Değişiklik Geçmişi

Hatalı bir güncelleme yüzlerce ürünün fiyatını veya stoğunu bozabilir. Böyle durumlarda geri dönebilmek için:

• Entegrasyon programınızda ürün değişiklik geçmişi tutuluyorsa açın; hangi ürünün ne zaman, hangi değerden hangi değere değiştiğini görebilirsiniz.
• Büyük değişikliklerden önce ürün listenizin yedeğini alın.
• Çözülen hataların log kaydını silmeyin; aynı hata tekrar ettiğinde neyin işe yaradığını görürsünüz.

Fiyat ve stok hatalarını baştan önlemek için XML fiyat ve stok güncellemesi rehberimizdeki stok eşiği ve fiyat kontrolü ayarlarını kullanın.

Tedarikçi Değiştirirken Ürün Verileri Nasıl Korunur?

Tedarikçi değiştirdiğinizde ürün kodları değişir. Eski ürünleri silip yenilerini yüklemek, ürün sayfalarınızın Google sıralamasını ve pazaryerindeki yorumlarını kaybetmenize neden olur. Bunun yerine eski ve yeni ürün kodlarını bir eşleştirme tablosuyla bağlayın, satışı devam etmeyecek ürünleri silmek yerine stoğunu sıfırlayın ve kendi sitenizde ürün adresi değişiyorsa eski adresi yenisine 301 ile yönlendirin.

XML Hata Kontrol Listesi

1. XML linki tarayıcıda açılıyor mu?
2. Dosya tam iniyor mu, boyutu olağan mı?
3. Türkçe karakterler doğru görünüyor mu?
4. Fiyat, stok ve kategori alanları dolu mu?
5. Eşleştirme ürün kodu üzerinden mi yapılıyor?
6. Eşleşmemiş yeni kategori var mı?
7. Pazaryeri reddi varsa hata kodu kaydediliyor mu?

Ulu İthalat XML ile Çalışın

Ulu İthalat XML'i ürün kodu, ad, fiyat, stok, marka, kategori, açıklama ve görsel alanlarıyla düzenli yapıda gelir ve 3 ile 4 saatte bir güncellenir. Entegrasyon sırasında bir sorunla karşılaşırsanız, hata mesajını ve ilgili ürün kodunu bize iletmeniz yeterlidir. XML'in temel yapısını XML entegrasyonu nedir yazımızda anlattık.

Ücretsiz XML bayilik hakkında bilgi alın · Hemen bayilik başvurusu yapın

Sık Sorulan Sorular

XML parse error ne anlama gelir?

XML dosyasının yapısı bozuk olduğu için okunamadığı anlamına gelir. Genellikle kapanmamış etiket, hatalı özel karakter veya yarım inmiş dosya yüzünden çıkar.

Logda ERROR yazması hiçbir ürünün aktarılmadığı anlamına mı gelir?

Hayır. Çoğu zaman hata sadece birkaç ürünü etkiler, diğer ürünler sorunsuz aktarılır. Hatanın tek ürün mü yoksa tüm dosya mı olduğuna bakın.

Bir ürün aktarılmadıysa önce nereye bakmalıyım?

Önce o ürünün kodunu logda arayın, sonra XML'de o ürünün fiyat, stok, kategori ve görsel alanlarının dolu olup olmadığını kontrol edin.

Aynı hata binlerce üründe çıkıyorsa ne yapmalıyım?

Ürünleri tek tek düzeltmeyin. Hataları gruplayın; büyük ihtimalle ortak bir neden vardır, örneğin değişen bir alan adı veya bozulan bir eşleştirme ayarı.

Türkçe karakterler bozuk görünüyorsa ne yapmalıyım?

Entegrasyon programınızdaki karakter kodlaması ayarını XML'in başında yazan kodlamayla (genellikle UTF-8) aynı yapın.