Aynı ürünün açıklaması ERP’de bir şey, Excel’deki katalog dosyasında başka, WooCommerce panelinde üçüncü bir şey söylüyorsa sorun yazılımda değil, veri sahipliğindedir. Ürün verisi fiyat ve stoktan ibaret değildir: teknik öznitelikler, varyantlar, görseller, teknik föyler, çeviriler, kanal bazlı açıklamalar. Bu verinin üç ayrı yerde elle güncellendiği yapıda tutarsızlık kaçınılmazdır. Aşağıda PIM (Product Information Management) sisteminin ERP ile e-ticaret arasındaki yerini, ne zaman gerçekten gerektiğini ve ürün veri modelinin nasıl kurulacağını anlatıyoruz.
PIM, ERP ve e-ticaretin rol dağılımı
PIM nedir sorusunun kısa cevabı: ürünün “ne olduğunu” anlatan zengin verinin tek doğru kaynağı. ERP ürünün ticari ve operasyonel tarafını (stok, maliyet, fiyat, vergi, tedarik) yönetir; e-ticaret platformu veriyi müşteriye sunar ve sipariş toplar. PIM bu ikisinin arasında içerik ve öznitelik sahipliğini üstlenir.
Sahada gördüğümüz sorunların çoğu, bir alanın birden fazla sistemde düzenlenebilir olmasından çıkar. İlk iş, her alan için tek bir sahip sistem belirlemektir:
| Veri alanı | Sahip sistem | Not |
|---|---|---|
| SKU, temel ürün kartı | ERP | Yalnız ERP’de açılır |
| Stok ve depo | ERP / WMS | Web yalnız okur |
| Fiyat ve iskonto | ERP | PIM’e taşınmaz |
| Teknik öznitelikler | PIM | Tipli, birimli alanlar |
| Açıklama, başlık, çeviri | PIM | Kanal bazlı olabilir |
| Görsel, föy, sertifika | PIM / DAM | Sürümlü dosya |
| SEO alanları, URL | E-ticaret | Kanala özgü |
Bu tablo kurumun süreçlerine göre değişebilir; değişmemesi gereken, kararın yazılı olması ve entegrasyonun bu kurala uymasıdır. Örneğin WooCommerce’ta açıklama alanı PIM’den besleniyorsa, panelde yapılan elle düzeltme bir sonraki aktarımda ezilir. Editör bunu bilmiyorsa aynı düzeltmeyi her hafta tekrar yapar. Bu davranışı editörlere açıkça bildirin, mümkünse ilgili alanları web tarafında salt okunur yapın. Sistemler arası veri taşımanın teknik desenleri ERP ile web entegrasyonu desenleri yazısında ayrıca ele alınıyor.
PIM’e ihtiyaç olduğunu gösteren işaretler
Her e-ticaret projesi PIM gerektirmez. Aşağıdakilerden birkaçı birlikte görülüyorsa, ürün verisini ayrı bir katmanda yönetmenin maliyeti dağınıklığın maliyetinin altına inmeye başlar:
- Ürün bilgisi birden fazla kanala gidiyor: web sitesi, B2B portal, pazaryeri, basılı katalog, bayi listeleri.
- Teknik öznitelikler filtre ve karşılaştırma için kullanılıyor ve ürün ailesine göre değişiyor.
- Katalog iki veya daha fazla dilde yayınlanıyor.
- Yeni ürünün satışa açılması birden fazla ekibin (ürün yönetimi, pazarlama, çeviri, e-ticaret) katkısını gerektiriyor ve kimin neyi tamamladığı izlenemiyor.
- Tedarikçi verisi farklı formatlarda geliyor ve her seferinde elle düzenleniyor.
- ERP’ye pazarlama metni ve görsel eklemek için özel alanlar açılmış, ERP bu işi taşıyamıyor.
Tersine, tek kanallı, tek dilli ve öznitelik yapısı basit bir katalogda ERP’den WooCommerce’a iyi tanımlanmış bir aktarım ve WooCommerce içinde disiplinli bir öznitelik yapısı yeterli olabilir. PIM önce bir veri yönetişimi kararıdır, sonra yazılım alımı. Süreç tanımlanmadan kurulan PIM, verinin dağınık durduğu üçüncü bir yer olur.
Ürün veri modeli: öznitelik, varyant ve kategori
Hangi PIM seçilirse seçilsin, projenin asıl işi ürün veri modelinin tasarımıdır. Modelin üç temel bileşeni vardır.
Öznitelikler ve öznitelik setleri
Her özniteliğin bir veri tipi olmalı: metin, sayı ve birim, seçim listesi, çoklu seçim, evet/hayır, tarih veya dosya. “Güç: 2,2 kW” gibi değerleri serbest metin olarak tutmak filtrelemeyi ve birim dönüşümünü imkânsız kılar. Sayısal öznitelikte değer ve birim ayrı tutulmalı, birim sabit bir listeden seçilmeli. Metin filtrelenmez.
Öznitelik setleri (aile veya şablon da denir) ürün tipine göre hangi alanların zorunlu olduğunu belirler. Bir kablonun öznitelikleri ile bir sunucununki aynı değildir; tek bir dev form yerine ürün ailesine göre set tanımlamak hem veri girişini hem kalite kontrolünü kolaylaştırır.
Varyant ekseni
Varyant yalnız müşterinin seçim yaptığı eksenler için kullanılır: renk, boyut, kapasite gibi. WooCommerce’ta varyasyonlu ürünler, varyasyon ekseni olarak işaretlenmiş özniteliklerden üretilir ve her varyasyonun kendi SKU’su, fiyatı ve stoğu olabilir. Sahada en sık gördüğümüz hata, teknik olarak farklı ürünleri (farklı ürün koduyla satılan, farklı belgeleri olan modelleri) tek ürünün varyasyonu olarak kurmaktır; bu durumda görsel, doküman ve SEO içeriği ayrıştırılamaz.
Kategori ağacı ve sınıflandırma
Mağaza menüsündeki kategori ağacı bir gezinme yapısıdır ve pazarlama ihtiyacıyla değişir. Ürünün teknik sınıflandırması ise öznitelik setini belirler ve daha kalıcıdır. İkisini ayırın; menü yeniden düzenlendiğinde veri modeli bozulmasın. Kategori yapısının site bilgi mimarisiyle uyumu için kurumsal web sitesi bilgi mimarisi yazısına bakılabilir.
Aşağıdaki örnek, PIM’den kanala aktarılan normalize edilmiş bir ürün kaydının yapısını gösteriyor:
{
"sku": "KBL-C6A-305",
"family": "network_kablo",
"classification": "kablo/bakir/f-utp",
"attributes": {
"kategori_standardi": "Cat6A",
"iletken_kesiti": { "value": 23, "unit": "AWG" },
"kilif_malzemesi": "LSZH",
"uzunluk": { "value": 305, "unit": "m" }
},
"locales": {
"tr_TR": { "name": "Cat6A F/UTP LSZH Kablo 305 m" },
"en_US": { "name": "Cat6A F/UTP LSZH Cable 305 m" }
},
"assets": ["kbl-c6a-305-on.jpg", "kbl-c6a-305-foy.pdf"],
"status": { "completeness": { "web_tr": 100, "web_en": 80 } }
}
Kayıtta fiyat ve stok yok. Bilinçli olarak yok; bunlar ERP’den doğrudan kanala gider. Ürünü sistemler arasında eşleştiren anahtar SKU’dur ve hiçbir sistemde yeniden kullanılmamalıdır. Satıştan kalkan bir ürünün SKU’sunu yeni ürüne vermek, geçmiş siparişlerle yeni katalogu birbirine karıştırır.
Veri kalitesi kuralları ve zenginleştirme akışı
PIM’in değeri, verinin ne zaman “yayına hazır” olduğunu ölçülebilir kılmasından gelir. Bunun için kanal ve dil bazında tamlık kuralları tanımlanır: web için Türkçe ad, kısa açıklama, en az bir görsel ve ailenin zorunlu teknik öznitelikleri doluysa ürün o kanal için tamdır. Tamlık sağlanmadan ürün kanala gönderilmez.
| Kural tipi | Örnek |
|---|---|
| Zorunlu alan | Ailenin teknik öznitelikleri boş olamaz |
| Format | EAN/GTIN kontrol hanesi doğrulanır |
| Değer listesi | Renk yalnız tanımlı listeden seçilir |
| Medya | Ana görsel en az belirlenen çözünürlükte |
| Tutarlılık | Varyant eksenleri tüm varyantlarda dolu |
Zenginleştirme akışı genellikle şu sırayı izler: ERP’de ürün kartı açılır, SKU ve temel bilgiler PIM’e düşer; ürün yönetimi teknik öznitelikleri tamamlar; pazarlama başlık, açıklama ve görselleri ekler; çeviri ekibi diğer dilleri tamamlar; son onaydan sonra ürün kanala yayınlanır. Her adımın sahibi ve bekleyen iş listesi görünür olmalı. PIM’i veri deposundan iş akışı aracına çeviren budur.
Kanallara ürün verisi yayını
Yayın tarafında iki ilke var: yalnız değişen veriyi göndermek (delta) ve her kanal için ayrı bir eşleme tanımlamak. PIM’deki öznitelik adları ile WooCommerce’taki global öznitelikler (WooCommerce’ta pa_ önekiyle taksonomi olarak saklanır) birebir aynı olmak zorunda değildir; eşleme tablosu entegrasyonda tutulur.
WooCommerce REST API, toplu güncelleme için /wp-json/wc/v3/products/batch uç noktasını sunar. Güncelleme isteği ürün ID’si ister; bu yüzden entegrasyon önce SKU ile ID eşleşmesini bulmalı ve bu eşlemeyi önbelleğe almalıdır. Her güncellemede SKU sorgusu atmak, binlerce ürünlük aktarımı saatlere yayar.
# SKU ile ürün ID'sini bulma
curl -s -u "$WC_KEY:$WC_SECRET" \
"https://magaza.example.com/wp-json/wc/v3/products?sku=KBL-C6A-305"
# Toplu güncelleme (varsayılan olarak istek başına en fazla 100 nesne)
curl -s -u "$WC_KEY:$WC_SECRET" -X POST \
-H "Content-Type: application/json" \
"https://magaza.example.com/wp-json/wc/v3/products/batch" \
-d '{"update":[{"id":1543,"short_description":"Cat6A F/UTP, LSZH kılıf"}]}'
Görseller her aktarımda yeniden yüklenmemeli; dosyanın özeti (hash) saklanıp yalnız değiştiğinde medya güncellenmeli. Aksi halde medya kütüphanesi aynı görselin kopyalarıyla şişer ve disk dolduğunda fark edilir. Web tarafında ürün verisi ayrıca schema.org Product yapılandırılmış verisine ve gerekiyorsa ürün feed’lerine dönüştürülür; GTIN, marka ve öznitelikler PIM’de temizse bu çıktılar da tutarlı olur. Önbellek kullanan mağazalarda toplu güncellemeden sonra ilgili ürün sayfalarının temizlenmesi gerekir; bu konudaki tuzaklar WooCommerce cache hataları yazısında anlatılıyor.
Ürün verisi içe aktarma kontrol listesi
İster PIM kurulumunda ister mevcut katalogun yeni platforma taşınmasında, toplu içe aktarmadan önce şunları kontrol edin:
- SKU’lar tekil, boşluk ve görünmez karakter içermiyor; büyük/küçük harf kuralı belirlenmiş.
- Her alanın sahip sistemi yazılı; içe aktarma yalnız o sistemin alanlarını yazıyor.
- Öznitelik değerleri normalleştirilmiş: aynı değerin farklı yazımları birleştirilmiş, birimler ayrı alanda.
- Varyant eksenleri ve ebeveyn–varyant ilişkisi tanımlı; yetim varyant yok.
- Kategori eşleme tablosu hazır; eşlenmeyen ürünler raporlanıyor.
- Görsel dosya adları SKU ile ilişkilendirilmiş; eksik görsel listesi çıkarılmış.
- Karakter kodlaması UTF-8; Türkçe karakterler ve ondalık ayırıcı test edilmiş.
- Önce küçük bir örnek kümeyle test ortamında deneme yapılmış, sonuç ekranda kontrol edilmiş.
- Mevcut ürün URL’leri korunuyor veya yönlendirme listesi hazır.
- İçe aktarmadan önce veritabanı yedeği alınmış ve geri dönüş yolu belirlenmiş.
Kontrol listesinde atlanan madde genellikle görünmez karakterdir: Excel’den gelen SKU’nun sonundaki boşluk, eşleşmeyi sessizce bozar. URL değişikliği içeren katalog taşımalarında arama görünürlüğünü korumak için web sitesi taşırken SEO kaybını önleme adımlarını da plana ekleyin.
Uygulamada karşılaşılan hatalar
- PIM’e fiyat ve stok taşımak: İki sistemde fiyat yönetmek, hangisinin doğru olduğu tartışmasını başlatır. Ticari veri ERP’de kalır.
- Kategori ağacını veri modeli olarak kullanmak: Menü değişikliği öznitelik setlerini bozar.
- Yönetişimsiz kurulum: Roller ve onay adımları tanımlanmadan kurulan PIM’de ürünler “taslak” durumunda birikir.
- Tek yönlü olmayan entegrasyon: Web panelindeki düzeltmeleri PIM’e geri yazmaya çalışmak çakışma üretir; içerik akışı tek yönlü tasarlanmalı.
Ürün veri modeli ve ERP–WooCommerce aktarımının birlikte kurgulanması gereken projelerde WooCommerce e-ticaret ve ERP ve API entegrasyonu çalışmalarını aynı veri sahipliği tablosu üzerinden planlıyoruz.
Sık sorulan sorular
Kaç ürünün üzerinde PIM gerekir?
Belirleyici olan ürün sayısı değil, veri karmaşıklığıdır. Yüz ürünlük ama çok dilli, çok kanallı ve teknik öznitelik yoğun bir katalog PIM’den fayda görebilir; binlerce ürünlü ama tek kanallı ve basit bir katalog ise iyi tasarlanmış bir ERP aktarımıyla yönetilebilir.
PIM ile ERP arasında hangi alan nerede tutulmalı?
Stok, maliyet, fiyat, vergi ve muhasebe kodu ERP’de kalır. Pazarlama açıklamaları, teknik öznitelikler, görseller, dokümanlar ve kanal bazlı içerik PIM’de tutulur. SKU her iki sistemde aynı olmalı ve yalnız bir sistemde oluşturulmalıdır.
WooCommerce PIM olarak kullanılabilir mi?
Tek kanallı küçük kataloglarda WooCommerce fiilen ürün verisinin kaynağı olabilir. Ancak iş akışı, alan bazlı tamlık kuralı, çok kanallı yayın ve sürüm geçmişi gibi PIM yeteneklerini sunmadığı için katalog veya kanal sayısı arttığında bu yaklaşım tıkanır.
Ürün verisi göçünde en sık yapılan hata nedir?
Öznitelik değerlerini normalleştirmeden aktarmak. Aynı değerin farklı yazımları, birimin metin içine gömülmesi ve serbest metin alanlarının filtre olarak kullanılması, göçten sonra filtre ve karşılaştırma işlevlerini bozar.