C2C E-PAZARYERİ ENTEGRASYON REFERANS DOKÜMANTASYONU KMK C2C E-Pazaryeri Entegrasyon Servisleri, Metotları ve Kullanım Örnekleri 29.12.2016
1 Giriş 3 2 Entegrasyon Şablonu Oluşturma 2-1 Ürün Entegrasyonu Şablonu Oluşturmak 2-2 İlan Entegrasyonu Şablonu Oluşturma 2-3 Kod ile Entegrasyon Oluşturma İçindekiler 4 5 14 23 3 Hazır Entegrasyonlar 24 4 Entegrasyon Arama 25 5 XML Yükleme ve İndirme 27 6 Ürün/İlan Kotası 35 7 Ürün/İlan Güncelleme 36 8 Entegrasyon Destek Merkezi 36 KMK Bilgi Teknolojileri A.Ş. Sayfa 2 / 36
1. GİRİŞ Bu dokümanda, KMK C2c E-Pazaryeri kullanıcılarının site veya mağaza kontrol panelleri tarafından toplu ürün/ilan ekleme, indirme ve düzenleme entegrasyon bilgileri yer almaktadır. Bu dokümanda, KMK C2c E-Pazaryeri kullanıcılarının site veya mağaza kontrol panelleri tarafından toplu ürün/ilan ekleme, indirme ve düzenleme entegrasyon bilgileri yer almaktadır. Entegrasyon servisine kontrol panelinizden Ayarlar/Entegrasyon bölümünden erişebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 3 / 36
2. ENTEGRASYON ŞABLONU OLUŞTURMA Bu alandan e-ticaret sitenize yeni entegrasyon sistemleri ekleyebilirsiniz. Sitenizdeki ürün ve ilanlar için ayrı ayrı şablonlar oluşturmalısınız. Kod ile oluştur bölümüne tıklayarak kısa bir sürede entegrasyon şablonunuzu oluşturabilirsiniz. 1. Yeni Entegrasyon Bu alana tıklayarak e-ticaret sitenize yeni entegrasyon sistemleri ekleyebilirsiniz. Sitenizdeki ürün ve ilanlar için ayrı ayrı şablonlar oluşturmalısınız. Kod ile oluştur bölümüne tıklayarak kısa bir sürede entegrasyon şablonunuzu oluşturabilirsiniz. 2. Ürün Entegrasyonu Bu bölüme tıklayarak yeni bir ürün entegrasyonu oluşturmaya başlayınız. Bir ürün entegrasyonu oluşturduğunuzda sistemdeki ilanlar bu entegrasyona dahil olmayacaktır. Sadece ürünler çekilecektir. Buraya tıklayarak daha detaylı bilgi edinebilirsiniz. 3. İlan Entegrasyonu Bu bölüme tıklayarak yeni bir ilan entegrasyonu oluşturmaya başlayınız. Bir ilan entegrasyonu oluşturduğunuzda sistemdeki ürünler bu entegrasyona dahil olmayacaktır. Sadece ilanlar çekilecektir. Buraya tıklayarak daha detaylı bilgi edinebilirsiniz. 4. Kod ile Oluştur Bu alana tıklayarak destek ekibimizden tarafınıza gönderilen kodu yapıştırarak bir entegrasyon şablonu oluşturabilirsiniz. Destek ekimizden istediğiniz entegrasyon şablonunun kodunu talep ederseniz size mail yolu ile gönderilecektir. Sonrasında gönderilen kodda hiç bir değişiklik yapmadan bu alana yapıştırdığınızda entegrasyon şablonunuz oluşturulacaktır. Buraya tıklayarak daha detaylı bilgi edinebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 4 / 36
2.1 Ürün Entegrasyon Şablonu Oluşturma Ürünler üzerindeki entegrasyon işlemlerinizi bu alandan düzenleyebilir ve Entegrasyon şablonu üzerinde mağazaların yaptıkları tüm indirme yükleme işlemlerini rahatlıkla takip edebilirsiniz. Entegrasyon Bilgileri 1. Entegrasyon Tanımı Oluşturacağınız entegrasyon şablonunun ismini bu alana giriniz. Örneğin; "n11 Ürün Entegrasyonu" 2. Açıklama Oluşturacağınız entegrasyonla ilgili kısa bir açıklama girebilirsiniz. 3. Entegrasyon Verisi Entegrasyon verisi bu alanda görünecektir. Oluşturacağınız entegrasyonda bu alandaki veriler çekilecektir. Ürün ya da İlan olarak iki seçenek mevcuttur. Bu alana müdahale edilemez. Sonradan değiştirilemez. 4. Özel Kod Bu alana bir özel kod girerek ürünler arasında gruplandırma yapmış olursunuz. Bir örnek ile anlatacak olursak, örneğin ürün entegrasyonunuzda sadece telefonları çekmek istiyorsanız telefon kategorisindeki ürünlerin özel kod kısımlarına bir kod yazmalısınız. "Telefon" yazığınızı varsayarsak bu ürün entegrasyon şablonunun Özel Kod bölümüne de "Telefon" KMK Bilgi Teknolojileri A.Ş. Sayfa 5 / 36
yazarsanız. Şablon sadece özel kodu "Telefon" olan ürünleri çekecektir. Bu alanı kullanarak istediğiniz gibi gruplandırma yapabilirsiniz. 5. Yetki Kodu Yetki kodu entegrasyon şablonunuza kullanıcıların erişim ve müdahale etme yetkisini belirler. 6. Veri Bloğu Bu alanda Entegrasyon Şablonunu sisteme yüklerken ya da indirirken verilerin kaçarlık gruplar halinde çekileceğini belirtmelisiniz. Çok detaylı veya çok fazla bilgi içeren kayıtlarda bu alanı düşük tutmanız önerilir. Yüksek sayılarla çekildiğinde sistemde kasma ve yavaşlama gibi sorunlar yaşanabilir. 7. Kayıt Limiti Kayıt limiti ise bir seferde kaç adet kaydın(ürün ya da ilan) çekileceğini gösterir. 8. Kayıt Büyüklüğü Sisteme yüklenen ya da indirilen dosyanın büyüklüğünü bu alandan seçebilirsiniz. En fazla 5 MB büyüklüğünde dosyalar şeklinde çalışabilirsiniz. 9. Durum Entegrasyon şablonunun aktif pasif durumunu bu alandan belirtebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 6 / 36
Entegrasyon Yapısı 1. Yeni Element Ana element eklemek için bu alana tıklayabilirsiniz. Aşağıda daha detaylı bir şekilde anlatılmıştır. Element ayarlamalarını yapmadan önce elementi ismini girip kaydetmelisiniz. Kaydettikten sonra ayarlama ekranı açılacaktır. KMK Bilgi Teknolojileri A.Ş. Sayfa 7 / 36
1. Element Tag Eklemek istediğiniz element tagını bu alana giriniz. 2. Data Collection Veriler hangi elementin içinde tekrarlanacaksa sadece o elementin Data Collection değerini "Evet" olarak işaretlemelisiniz. Örneğin; "Urun" tagı. İsimler değişebilir ama asıl tekrarlanacak kayıtlar ürün olduğu için Data Collection değeri Evet olmalıdır. Data Collection nesnesi sonradan değiştirilirse şablondaki tüm veri yapıları silinecektir. Yani yaptığınız data veya attribute ayarları sıfırlanacaktır. 3. Empty Closed Element tagı boş kapatılacaksa bu alandan Evet'i işaretlemelisiniz. Yani hiç bir değer içermeyecek ise bu alandan "Evet" seçilmelidir. Örneğin; " <indirimtutari />"... 4. Hide Blank Değer içermeyecek ise XML dosyasında bu elementi gizlemek isterseniz bu alanı "Evet" olarak işaretleyebilirsiniz. Böylece XML dosyasında bu element boş ise görünmeyecektir. 5. Kaydet Bilgileri girdikten sonra bu butona tıklayarak elementin data veya attribute ayarlarını yapabileceğiniz ekran açılacaktır. 6. Yeni Attribute Elemente attribute eklemek isterseniz bu alana tıklayarak ekleyebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 8 / 36
7. Definition Eğer elementin Data'sına değer girişi yapacaksanız bu isim değişmez. Yeni attribute ekleyeceğiniz zaman attribute adını bu alana girmeniz gerekir. Kaydettikten sonra değeri girebilirsiniz. 8. Data Type Bu alanda XML tablosunda görünen Elementlerin değerlerini belirleyebilirsiniz. Örneğin; <Fiyat>10.00 </Fiyat> etiketinin arasındaki 10.00 elementin değeridir. Bu değerleri bu alandaki seçenekler ile doldurabilirsiniz. Şimdi bu seçenekleri açıklayalım. Null Herhangi bir değer girmek istemiyorsanız bu alandan Null seçeneğini seçmelisiniz. İndex Otomatik artan değer vermek istiyorsanız "İndex" seçeneğini işaretleyiniz. Aşağıdaki resimde görüldüğü üzere Pattern seçeneği otomatik artan sayının başına bir ek eklenmesini istiyorsanız bu sebeple kullanabilirsiniz. Doldurmak zorunda değilsiniz. P harfinin yanına üç adet 0 sayısı yazdık. Bizim değerimiz arttıkça bu şu şekilde artacaktır. "P001, P002,..., P010,.., P999" a kadar devam edecektir. Start seçeneği ise otomatik artan sayının kaçtan başlayacağını belirtmenizi sağlar. Oraya hangi değeri verirseniz elementin değerine (datasına) o değerden başlayarak değer vermeye başlar. Constant Sabit bir değer vermek istiyorsanız bu alana değeri giriniz. Tüm ürünlerde sabit değer verdiğiniz elementte verdiğiniz değer gözükecektir. KMK Bilgi Teknolojileri A.Ş. Sayfa 9 / 36
Datafield Elementin değerini veritabanından çekmek istiyorsanız Field alanından ilgili alanı seçiniz. Data Collection nesnesi her tekrarlandığında yani yeni ürün çektikçe o ürüne ait bilgiyi veritabanından çekecektir. Format bölümünden değerin türünü seçiniz. Metin olacaksa String seçmelisiniz. Type alanında ise uzun Türkçe karakter ve html kodu içeren alanlar için örneğin ürün detayı bölümü gibi yerlerde kayıplar ve bozulmalar yaşanmaması için CDATA seçeneğini seçmelisiniz. Tarih olacaksa Date seçmelisiniz. Type alanında ise Local ve UTC olarak iki seçenek mevcuttur. Local seçeneği bilgisayarınızdaki formatta tarihi çekmektedir. UTC ise sunucu formatında çekmektedir. Örneğin; Localde "27/12/2016" UTC "2016-12-27" şeklinde görülmektedir. Localde ayırıcı / işareti UTC formatında ise - işaretidir. Dilerseniz. Seperator bölümünden yeni bir ayırıcı tanımlayabilirsiniz. Yani. işareti koyarsanız tarih Localde 27.12.2016 UTCde 2016.12.27 şeklinde görünür. Tarih ve Saat kullanılacaksa Datetime seçilmelidir. Bu da bir üst satırda açıklanan Date tanımı gibi çalışmaktadır. Sayı kullanılacaksa Integer seçeneği işareti kullanılmalıdır. Integer tam sayı şeklinde çalışır. Ondalıklı sayılarda Float seçeneği seçilmelidir. Decimal alanına virgülden sonra gelecek basamak sayısı yazılır. Örneğin 2 olursa, 11,2345 sayısının sadece 11,23 kısmını alacaktır. Symbol'de ondalıklı sayı ayırma sembolünü değiştirebilirsiniz. Örneğin nokta yerine virgül kullanmak isterseniz buraya virgül işareti koymalısınız. Pairs alanı ise dışarıdan gelen veri ile veritabanındaki verinin ilişki kurmasını sağlar. Örnek olarak ürünün aktif pasif durumu üzerinden gösterelim. Bizim sistemimizde aktif ürünlerin durum değeri "1" pasif ürünlerin durum değeri ise "0" ile saklanmaktadır. Dışarıdan gelen veride ise bu durum "Aktif" ve "Pasif" olarak saklanmaktadır. Bu durumda bir eşleştirme yapmamız gerekir. Bu sebeple Pairs alanını kullanacağız. Local Pair Data bölümü bizim sistemimizdeki değerlerdir. Buraya "0,1" girelim. Remote Pair Data ise dışarıdaki verilerdir. Bizdeki verilerin karşılığı KMK Bilgi Teknolojileri A.Ş. Sayfa 10 / 36
olarak "Pasif,Aktif" şeklinde girersek sistem bu eşleştirmeyi yapacaktır ve ürün durumlarını bu ayarlamaya göre düzenleyecektir. DataList Veritabanında bir karşılığı olmayan değerler için kullanılır. List alanına aralarına virgül konularak değerler girilir. Default bölümüne ise ürüne herhangi bir değer verilmediği taktirde çekeceği değer girilir. List bölümüne virgül ile ayırarak değerler girildikten sonra ilgili ürünlere gidilir. Entegrasyon bölümünden ilgili entegrasyon seçilir sağ tarafta Tanımlar bölümünden değer seçilir. Eğer seçilmez ise Datalist bölümünde Default alanına yazılan değeri çekecektir. 9. Prefix Elementin değerine ön ek eklemek isterseniz örneğin tırnak içinde yazmak isterseniz bu alana bir tırnak işareti koymalısınız. Vereceğiniz değerin başına gelecektir. 10. Suffix Elementin değerine son ek eklemek isterseniz örneğin tırnak içinde yazmak isterseniz bu alana bir tırnak işareti koymalısınız. Yani hem ön eke hem son eke " işareti koymalısınız. Vereceğiniz değerin sonuna gelecektir. 11. Seperator Ayırıcı olarak kullanmak istediğiniz sembolü giriniz. Örneğin birden fazla resim olan bir ürün düşünün tüm resimleri çekecektir. Bunun için bir ayırıcıya ihtiyacınız olacaktır. Tarih ve saat seçimlerinde de kullanılır. KMK Bilgi Teknolojileri A.Ş. Sayfa 11 / 36
12. Clear Data Temizlenmesini istediğiniz ya da boş gitmesi gereken değerleri temizler. Örneğin bu alana "0" yazarsanız değeri "0" olan alanları temizler ve boş şekilde gönderir. 2. Yeni Alt Element Elementler içinde hiyerarşik bir düzen oluşturmak için alt element eklediğiniz elementin yanındaki bu ikona tıklayarak yeni alt element oluşturabilirsiniz. 3. Element Düzenleme Düzenlemek istediğiniz elementin yanındaki bu ikona tıklayarak düzenleme işlemini gerçekleştirebilirsiniz. 4. (*) İşareti Attribute Yanında * işareti bulunan elementler Attribute denilen özelliğe sahiptir. Bu özelliğe sahip entegrasyon şablonları XLS formatında kullanılamaz. Aşağıda daha detaylı bir şekilde anlatılmıştır. Entegrasyon İşlemleri Bu alandan entegrasyon şablonu üzerinden yapılan tüm işlemleri görebilirsiniz. İndirilen, yüklenen dosyaları takip edebilir. Hangi mağazanın hangi işlemi yaptığını tarih ve saat bazında görebilirsiniz. Alınan hata ve bilgi mesajlarını görebilir. Kayıt sayısı ve dosya boyutlarını inceleyebilirsiniz. Tamamlanmayan işlemleri tamamlayabilir, yüklenen dosyaları bilgisayarınıza indirebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 12 / 36
Entegrasyon Kodu Burada oluşturulan entegrasyon şablonunun kodu verilir. Bu kodu kopyalayarak hiç bir değişiklik yapmadan kod ile oluştur kısmından yapıştırarak şablonu çoğaltabilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 13 / 36
2.2 İlan Entegrasyon Şablonu Oluşturma İlanlar üzerindeki entegrasyon işlemlerinizi bu alandan düzenleyebilir ve Entegrasyon şablonu üzerinde mağazaların yaptıkları tüm indirme yükleme işlemlerini rahatlıkla takip edebilirsiniz. Entegrasyon Bilgileri 1. Entegrasyon Tanımı Oluşturacağınız entegrasyon şablonunun ismini bu alana giriniz. Örneğin; "n11 Ürün Entegrasyonu" 2. Açıklama Oluşturacağınız entegrasyonla ilgili kısa bir açıklama girebilirsiniz. 3. Entegrasyon Verisi Entegrasyon verisi bu alanda görünecektir. Oluşturacağınız entegrasyonda bu alandaki veriler çekilecektir. Ürün ya da İlan olarak iki seçenek mevcuttur. Bu alana müdahale edilemez. Sonradan değiştirilemez. 4. Özel Kod Bu alana bir özel kod girerek ilanlar arasında gruplandırma yapmış olursunuz. Bir örnek ile anlatacak olursak, örneğin ilan entegrasyonunuzda sadece telefonları çekmek istiyorsanız telefon kategorisindeki ilanların özel kod kısımlarına bir kod yazmalısınız. "Telefon" yazığınızı varsayarsak bu ilan entegrasyon şablonunun Özel Kod bölümüne de "Telefon" yazarsanız. KMK Bilgi Teknolojileri A.Ş. Sayfa 14 / 36
Şablon sadece özel kodu "Telefon" olan ilanları çekecektir. Bu alanı kullanarak istediğiniz gibi gruplandırma yapabilirsiniz. 5. Yetki Kodu Yetki kodu entegrasyon şablonunuza kullanıcıların erişim ve müdahale etme yetkisini belirler. 6. Veri Bloğu Bu alanda Entegrasyon Şablonunu sisteme yüklerken ya da indirirken verilerin kaçarlık gruplar halinde çekileceğini belirtmelisiniz. Çok detaylı veya çok fazla bilgi içeren kayıtlarda bu alanı düşük tutmanız önerilir. Yüksek sayılarla çekildiğinde sistemde kasma ve yavaşlama gibi sorunlar yaşanabilir. 7. Kayıt Limiti Kayıt limiti ise bir seferde kaç adet kaydın(ürün ya da ilan) çekileceğini gösterir. 8. Kayıt Büyüklüğü Sisteme yüklenen ya da indirilen dosyanın büyüklüğünü bu alandan seçebilirsiniz. En fazla 5 MB büyüklüğünde dosyalar şeklinde çalışabilirsiniz. 9. Durum Entegrasyon şablonunun aktif pasif durumunu bu alandan belirtebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 15 / 36
Entegrasyon Yapısı 1. Yeni Element Ana element eklemek için bu alana tıklayabilirsiniz. Aşağıda daha detaylı bir şekilde anlatılmıştır. Element ayarlamalarını yapmadan önce elementi ismini girip kaydetmelisiniz. Kaydettikten sonra ayarlama ekranı açılacaktır. 1. Element Tag Eklemek istediğiniz element tagını bu alana giriniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 16 / 36
2. Data Collection Veriler hangi elementin içinde tekrarlanacaksa sadece o elementin Data Collection değerini "Evet" olarak işaretlemelisiniz. Örneğin; "Urun" tagı. İsimler değişebilir ama asıl tekrarlanacak kayıtlar ürün olduğu için Data Collection değeri Evet olmalıdır. Data Collection nesnesi sonradan değiştirilirse şablondaki tüm veri yapıları silinecektir. Yani yaptığınız data veya attribute ayarları sıfırlanacaktır. 3. Empty Closed Element tagı boş kapatılacaksa bu alandan Evet'i işaretlemelisiniz. Yani hiç bir değer içermeyecek ise bu alandan "Evet" seçilmelidir. Örneğin; " <indirimtutari />"... 4. Hide Blank Değer içermeyecek ise XML dosyasında bu elementi gizlemek isterseniz bu alanı "Evet" olarak işaretleyebilirsiniz. Böylece XML dosyasında bu element boş ise görünmeyecektir. 5. Kaydet Bilgileri girdikten sonra bu butona tıklayarak elementin data veya attribute ayarlarını yapabileceğiniz ekran açılacaktır. 6. Yeni Attribute Elemente attribute eklemek isterseniz bu alana tıklayarak ekleyebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 17 / 36
7. Definition Eğer elementin Data'sına değer girişi yapacaksanız bu isim değişmez. Yeni attribute ekleyeceğiniz zaman attribute adını bu alana girmeniz gerekir. Kaydettikten sonra değeri girebilirsiniz. 8. Data Type Bu alanda XML tablosunda görünen Elementlerin değerlerini belirleyebilirsiniz. Örneğin; <Fiyat>10.00 </Fiyat> etiketinin arasındaki 10.00 elementin değeridir. Bu değerleri bu alandaki seçenekler ile doldurabilirsiniz. Şimdi bu seçenekleri açıklayalım. Null Herhangi bir değer girmek istemiyorsanız bu alandan Null seçeneğini seçmelisiniz. İndex Otomatik artan değer vermek istiyorsanız "İndex" seçeneğini işaretleyiniz. Aşağıdaki resimde görüldüğü üzere Pattern seçeneği otomatik artan sayının başına bir ek eklenmesini istiyorsanız bu sebeple kullanabilirsiniz. Doldurmak zorunda değilsiniz. P harfinin yanına üç adet 0 sayısı yazdık. Bizim değerimiz arttıkça bu şu şekilde artacaktır. "P001, P002,..., P010,.., P999" a kadar devam edecektir. Start seçeneği ise otomatik artan sayının kaçtan başlayacağını belirtmenizi sağlar. Oraya hangi değeri verirseniz elementin değerine (datasına) o değerden başlayarak değer vermeye başlar. Constant Sabit bir değer vermek istiyorsanız bu alana değeri giriniz. Tüm ilanlarda sabit değer verdiğiniz elementte verdiğiniz değer gözükecektir. KMK Bilgi Teknolojileri A.Ş. Sayfa 18 / 36
Datafield Elementin değerini veritabanından çekmek istiyorsanız Field alanından ilgili alanı seçiniz. Data Collection nesnesi her tekrarlandığında yani yeni ilan çektikçe o ilana ait bilgiyi veritabanından çekecektir. Format bölümünden değerin türünü seçiniz. Metin olacaksa String seçmelisiniz. Type alanında ise uzun türkçe karakter ve html kodu içeren alanlar için örneğin ilan detayı bölümü gibi yerlerde kayıplar ve bozulmalar yaşanmaması için CDATA seçeneğini seçmelisiniz. Tarih olacaksa Date seçmelisiniz. Type alanında ise Local ve UTC olarak iki seçenek mevcuttur. Local seçeneği bilgisayarınızdaki formatta tarihi çekmektedir. UTC ise sunucu formatında çekmektedir. Örneğin; Localde "27/12/2016" UTC "2016-12-27" şeklinde görülmektedir. Localde ayırıcı / işareti UTC formatında ise - işaretidir. Dilerseniz. Seperator bölümünden yeni bir ayırıcı tanımlayabilirsiniz. Yani. işareti koyarsanız tarih Localde 27.12.2016 UTCde 2016.12.27 şeklinde görünür. Tarih ve Saat kullanılacaksa Datetime seçilmelidir. Bu da bir üst satırda açıklanan Date tanımı gibi çalışmaktadır. Sayı kullanılacaksa Integer seçeneği işareti kullanılmalıdır. Integer tam sayı şeklinde çalışır. Ondalıklı sayılarda Float seçeneği seçilmelidir. Decimal alanına virgülden sonra gelecek basamak sayısı yazılır. Örneğin 2 olursa, 11,2345 sayısının sadece 11,23 kısmını alacaktır. Symbol'de ondalıklı sayı ayırma sembolünü değiştirebilirsiniz. Örneğin nokta yerine virgül kullanmak isterseniz buraya virgül işareti koymalısınız. Pairs alanı ise dışarıdan gelen veri ile veritabanındaki verinin ilişki kurmasını sağlar. Örnek olarak ilanın aktif pasif durumu üzerinden gösterelim. Bizim sistemimizde aktif ilanların durum değeri "1" pasif ilanların durum değeri ise "0" ile saklanmaktadır. Dışarıdan gelen veride ise bu durum "Aktif" ve "Pasif" olarak saklanmaktadır. Bu durumda bir eşleştirme yapmamız gerekir. Bu sebeple Pairs alanını kullanacağız. Local Pair Data bölümü bizim sistemimizdeki değerlerdir. Buraya "0,1" girelim. Remote Pair Data ise dışarıdaki verilerdir. Bizdeki verilerin karşılığı olarak "Pasif,Aktif" şeklinde KMK Bilgi Teknolojileri A.Ş. Sayfa 19 / 36
girersek sistem bu eşleştirmeyi yapacaktır ve ilan durumlarını bu ayarlamaya göre düzenleyecektir. DataList Veritabanında bir karşılığı olmayan değerler için kullanılır. List alanına aralarına virgül konularak değerler girilir. Default bölümüne ise ilana herhangi bir değer verilmediği taktirde çekeceği değer girilir. List bölümüne virgül ile ayırarak değerler girildikten sonra ilgili ilanlara gidilir. Entegrasyon bölümünden ilgili entegrasyon seçilir sağ tarafta Tanımlar bölümünden değer seçilir. Eğer seçilmez ise Datalist bölümünde Default alanına yazılan değeri çekecektir. 9. Prefix Elementin değerine ön ek eklemek isterseniz örneğin tırnak içinde yazmak isterseniz bu alana bir tırnak işareti koymalısınız. Vereceğiniz değerin başına gelecektir. 10. Suffix Elementin değerine son ek eklemek isterseniz örneğin tırnak içinde yazmak isterseniz bu alana bir tırnak işareti koymalısınız. Yani hem ön eke hem son eke " işareti koymalısınız. Vereceğiniz değerin sonuna gelecektir. 11. Seperator Ayırıcı olarak kullanmak istediğiniz sembolü giriniz. Örneğin birden fazla resim olan bir ilan düşünün tüm resimleri çekecektir. Bunun için bir ayırıcıya ihtiyacınız olacaktır. Tarih ve saat seçimlerindede kullanılır. KMK Bilgi Teknolojileri A.Ş. Sayfa 20 / 36
12. Clear Data Temizlenmesini istediğiniz ya da boş gitmesi gereken değerleri temizler. Örneğin bu alana "0" yazarsanız değeri "0" olan alanları temizler ve boş şekilde gönderir. 2. Yeni Alt Element Elementler içinde hiyerarşik bir düzen oluşturmak için alt element eklediğiniz elementin yanındaki bu ikona tıklayarak yeni alt element oluşturabilirsiniz. 3. Element Düzenleme Düzenlemek istediğiniz elementin yanındaki bu ikona tıklayarak düzenleme işlemini gerçekleştirebilirsiniz. 4. (*) İşareti Attribute Yanında * işareti bulunan elementler Attribute denilen özelliğe sahiptir. Bu özelliğe sahip entegrasyon şablonları XLS formatında kullanılamaz. Aşağıda daha detaylı bir şekilde anlatılmıştır. Entegrasyon İşlemleri Bu alandan entegrasyon şablonu üzerinden yapılan tüm işlemleri görebilirsiniz. İndirilen, yüklenen dosyaları takip edebilir. Hangi mağazanın hangi işlemi yaptığını tarih ve saat bazında görebilirsiniz. Alınan hata ve bilgi mesajlarını görebilir. Kayıt sayısı ve dosya boyutlarını inceleyebilirsiniz. Tamamlanmayan işlemleri tamamlayabilir, yüklenen dosyaları bilgisayarınıza indirebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 21 / 36
Entegrasyon Kodu Burada oluşturulan entegrasyon şablonunun kodu verilir. Bu kodu kopyalayarak hiç bir değişiklik yapmadan kod ile oluştur kısmından yapıştırarak şablonu çoğaltabilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 22 / 36
2.3 Kod ile Entegrasyon Şablonu Oluşturma Bu alandan destek ekibimizden ya da daha önce oluşturulmuş entegrasyon şablonlarından almış olduğunuz kodu yapıştırarak kısa sürede bir entegrasyon şablonu oluşturabilirsiniz. Bu alandan destek ekibimizden ya da daha önce oluşturulmuş entegrasyon şablonlarından almış olduğunuz kodu yapıştırarak kısa sürede bir entegrasyon şablonu oluşturabilirsiniz. Kod harfler ve rakamlardan oluşmaktadır. Size gönderilen koda hiç bir değişiklik yapmadan eksiksiz bir şekilde yapıştırmanız gerekmektedir. KMK Bilgi Teknolojileri A.Ş. Sayfa 23 / 36
3. HAZIR ENTEGRASYONLAR Hazır Entegrasyonlar bölümü ile sistemimizde bulunan entegrasyon şablonlarından yararlanarak zaman kazanabilirsiniz. Var olan şablonu tekrar oluşturmanıza gerek kalmayacaktır. 1. Hazır Entegrasyonlar Sistemimizde hali hazırda bulunan entegrasyon şablonlarına ulaşmak için bu alana tıklayınız. 2. Yükle Sistemimizde bulunan hazır entegrasyonların yanındaki yükle butonuna tıklayarak sisteminize yükleyebilirsiniz. Böylece zaman kazanmış olursunuz. Şablonu tekrar oluşturmanıza gerek kalmaz. KMK Bilgi Teknolojileri A.Ş. Sayfa 24 / 36
4. ENTEGRASYON ARAMA Entegrasyonlar arasında arama yapmak için bu alanı kullanabilirsiniz. Entegrasyon Bilgileri bölümünden entegrasyonun adına, içeriğine özel koduna göre arama işlemlerini gerçekleştirebilirsiniz. Entegrasyon Kriterleri alanından ise Entegrasyon tipi, durumu ve dosya türüne göre arama işlemi gerçekleştirebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 25 / 36
5. XML YÜKLEME ve İNDİRME Toplu Ürün İşlemleri(Yükleme/İndirme) iki ayrı yoldan yapılabilmektedir. Birinci seçenek; Ürün/İlan > Mağaza Ürünleri bölümünden mağaza seçerek yapılmaktadır. İkinci seçenek; Ayarlar > Entegrasyonlar > Entegrasyon(Üzerine Tıklamayla Açılır) > Entegrasyon İşlemleri bölümünden mağaza seçerek yapılmaktadır. Yükleyeceğiniz XML dosyası UTF-8 formatında olmalıdır. Eğer dosyanız UTF-8 formatında değilse dosyayı Not Defteri'nde açınız. Farklı Kaydet diyerek alt köşeden (Kodlama bölümünden) UTF-8 formatını seçerek kaydediniz. Bu işlemi yaptığınız taktirde kodlama ile ilgili hata almazsınız. Size önerilen XML Bölme Programı bazen UTF-8 XML dosyalarını Unicode formatına çevirebilmektedir. Bu durumda bölme işleminden sonra bu işlemi gerçekleştirmelisiniz. 5.1 "Ürün/İlan > Mağaza Ürünleri" Bölümünden Toplu Ürün Yönetimi 1. Mağaza Seçme XML Dosyası yüklemek ya da indirmek istediğiniz mağazayı seçtikten sonra 2 numaralı bölümde Toplu Ürün Yönetimi seçeneği çıkacaktır. Bu sebeple öncelikle mağaza seçmeniz gerekir. 2. Toplu Ürün Yönetimi Bu butona tıklayarak toplu ürün yönetimine başlayabilirsiniz. XML dosyalarını yükleyip bilgisayarınıza indirebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 26 / 36
İndirme Sekmesi 3. Yükle Sekmesi Toplu Ürün Yönetimi sayfası açıldığında İndir Sekmesi açık bir şekilde gelir. Bu alana tıklayarak yükleme sekmesine geçebilirsiniz. 4. Dosyaları Gör ve İndir Bu sayfada tüm XML dosyası indirme işlemleri mağaza, tarih saat bazında görüntülenir. Bu butona tıklayarak indirilen XML dosyalarını görebilir ve indirebilirsiniz. Entegrasyon şablonunda tanımladığınız kayıt sayısına göre indirilen dosyalar parçalara ayrılmış olabilir. Bu parçaların hepsine bu alandan ulaşabilirsiniz. 5. Dosyaları Zip Olarak İndir Tüm XML dosyalarını tek zip halinde bilgisayarınıza indirmenizi sağlar. 6. XML İndir Bu butona tıklayarak mağazaya ait XML'i indirebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 27 / 36
7. Entegrasyon Seçiniz XML İndir butonuna tıkladıktan sonra Entegrasyon seçiniz. XML dosyasının indirileceği entegrasyon şablonunu belirleyin. Entegrasyon şablonun üzerine tıkladıktan sonra indirmeyi başlatma penceresi açılacaktır. KMK Bilgi Teknolojileri A.Ş. Sayfa 28 / 36
8. İndirmeyi Başlat Bu butona tıkladığınız zaman XML dosyası hazırlanarak bilgisayarınıza zip dosyası olarak indirilecektir. İndirme işlemini başlatmak için mutlaka bu butona tıklayınız. Yükleme Sekmesi 9 İndir Sekmesi İndir sekmesine geri dönmek için bu alana tıklayabilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 29 / 36
10. Yüklemeyi Tamamla Yarım kalan XML yükleme işlemlerinin yanında bu buton görünecektir. Butonun üzerine tıklayarak XML yükleme işleminize devam edebilir ve tamamlayabilirsiniz. 11. Tamamlanan Yükleme Tamamlanan yüklemelerin yanında bu buton görünecektir. Üzerine geldiğinizde "Tamamlandı" ifadesi yer alacaktır. 12. XML Yükle Sisteme XML yüklemek için bu butona tıklayarak yükleme işlemine başlayabilirsiniz. 13. Entegrasyon Seçiniz XML Yükle butonuna tıkladıktan sonra Entegrasyon seçiniz. XML dosyasının yükleneceği entegrasyon şablonunu belirleyin. Entegrasyon şablonun üzerine tıkladıktan sonra yüklemeyi başlatma penceresi açılacaktır. Bu alandan bilgisayarınızdan bir XML dosyasını sürükleyerek ya da üzerine tıklayarak seçebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 30 / 36
14. Gönder Yüklemek istediğiniz XML dosyasını seçtikten sonra bu butona tıklamalısınız. Buraya tıklayarak XML dosyasını sisteme gönderiniz. 15. Başlat Daha sonra Başlat butonuna tıklayarak yükleme işlemini başlatınız. KMK Bilgi Teknolojileri A.Ş. Sayfa 31 / 36
16. Görselleri Yükle Yükleme işleminden sonra XML dosyasındaki görselleri yüklemek için bu alana mutlaka tıklamalısınız. Yüklenemeyen görselleri de bu alandan görebilirsiniz. 17. Bilgi Hataları İncele / Düzelt Yükleme esnasında meydana gelen eşlememe gibi bilgi hataları bu alanda görünecektir. İncele/Düzelt yazısına tıklayarak hata mesajlarını görebilirsiniz. Hata mesajlarının üzerine tıklayarak hataları giderebilir ve düzeltebilirsiniz. Yoksay butonu ile hatayı yok sayıp yüklemeyi tamamlayabilirsiniz. 18. Bilgi Uyarıları İncele Bu alanda hata olmayan ancak uyarı anlamındaki mesajlar görüntülenir. İncele yazısına tıklayarak mesajları görüntüleyebilirsiniz. 19. Yüklemeyi Tamamla Bu butona tıklayarak Tamamlama penceresini açınız. Başlat butonuna tıklayarak yükleme işlemini tamamlayınız. "Yükleme Tamamlandı" mesajını aldıktan sonra Mağaza Ürünleri bölümünden ürünleri görebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 32 / 36
5.2 "Ayarlar > Entegrasyonlar > Entegrasyon(Üzerine Tıklamayla Açılır) > Entegrasyon İşlemleri" Bölümünden Toplu Ürün Yönetimi Her iki seçenekte de XML yükleme ve indirme basamakları aynıdır. Mağaza Ürünleri bölümünden yapılan işlemlerde entegrasyon seçilirken, Entegrasyonlar bölümünde yapılan işlemlerde farklı olarak Mağaza seçilmektedir. Geriye kalan tüm işlemler aynıdır. Entegrasyonlar bölümünden indirme/yükleme işlemleri yapmak için izleyeceğiniz yol şu şekildedir. Ayarlar bölümünden Entegrasyonlar başlığına tıklayınız. Entegrasyonlar arasında indirme/yükleme işlemini hangi entegrasyon şablonuyla yapmak istiyorsanız o entegrasyonun üzerine tıklayarak açınız. Açılan pencerede "Entegrasyon İşlemleri" bölümüne tıklayarak geliniz. Bundan sonraki işlemler yukarıda anlatıldığı gibi devam edecektir. KMK Bilgi Teknolojileri A.Ş. Sayfa 33 / 36
6. ÜRÜN/İLAN KOTASI Her C2C veya Pazaryeri e-ticaret sitesinin varsayılan ürün/ilan ekleme kotası 20.000'dir. Mağazaların ürün/ilan ekleme ve yayınlama limitleri varsayılan 500 olarak gelmektedir. Mağazaların ürün/ilan ekleme ve yayınlama limitlerini kendiniz değiştirebilirsiniz. Sitenizin toplam kotasını ya da mağazaların ürün/ilan ekleme veya yayınlama limitlerinin varsayılan değerlerini değiştirmek için bizimle iletişime geçmelisiniz. 1. Kotanız Bu alandan toplam kotanızı, kullanılan kotanızı ve kalan kotanızı görebilirsiniz. Her C2C ve Pazaryeri sitesinin varsayılan ürün/ilan ekleme kotası 20.000dir. Bunu değiştirmek için bizimle iletişime geçebilirsiniz. KMK Bilgi Teknolojileri A.Ş. Sayfa 34 / 36
Sistemde varsayılan olarak ürün/ilan ekleme ve yayınlama limiti her mağaza için 500 olarak gelmektedir. Varsayılan değeri değiştirmek için bizimle iletişime geçebilirsiniz. Bunu her mağaza için kendiniz değiştirebilir, arttırabilir veya azaltabilirsiniz. Bunu yapabilmek için Mağazalar bölümünden düzenleme yapmak istediğiniz mağazanın üzerine tıklayınız. Açılan pencereden Mağaza Ayarları bölümüne tıklayınız. Bu alandan Diğer Tanımlar sekmesine tıklayınız. Buradan mağaza kotasıyla ilgili istediğiniz düzenlemeyi yapabilirsiniz. 2. Ürün/İlan Ekleme Limiti Buradan mağazanın ürün veya ilan ekleme limitini limitsiz veya kendiniz bir değer vererek değiştirebilirsiniz. Varsayılan seçeneğini işaretleyerek varsayılan değerine döndürebilirsiniz. Limitsiz seçeneğini seçtiğinizde o mağaza 20.000 ürün/ilanlık kotanız dahilinde istediği kadar ürün/ilan ekleyebilir. 3. Ürün/İlan Yayınlama Limiti Buradan mağazanın ürün veya ilan yayınlama limitini limitsiz veya kendiniz bir değer vererek değiştirebilirsiniz. Varsayılan seçeneğini işaretleyerek varsayılan değerine döndürebilirsiniz. Limitsiz seçeneğini seçtiğinizde mağaza siteniz üzerinde istediği kadar ürün/ilan yayınlayabilir. KMK Bilgi Teknolojileri A.Ş. Sayfa 35 / 36
7. ÜRÜN/İLAN GÜNCELLEME Toplu Ürün Güncelleme İşleminde ürün kodunuz baz alınır. Sisteme yüklediğiniz XML dosyasındaki ürün kodu sistemdeki ürün kodu ile uyuyorsa XML dosyasındaki tüm değişiklikler sisteme aktarılır. Daha açık şekilde güncelleme işlemi yapmak için XML dosyasındaki ürün kodunuzun sistem üzerindeki ürün kodları ile aynı olması gerekir. 8. ENTEGRASYON DESTEK MERKEZİ Online Entegrasyon Destek Merkezi ne ulaşmak için aşağıdaki linke tıklayabilirsiniz. http://destek.kmk.net.tr/entegrasyon.html KMK Bilgi Teknolojileri A.Ş. Sayfa 36 / 36