API Ayarları

XML Tanımlama Ayarları

XML Tanımlama Ayarları makalesini aşağıdan inceleyebilirsiniz.

Yazar: Sopyo Destek Ekibi

Son Güncelleme: 16 Ağustos 2024

Sopyo panelinde sol menüden Ürünler / XML Kaynakları kısmına tıklıyoruz.


XML Ürün Kaynakları
sayfasının sağ tarafında XML tanımlama ile ilgili genel bilgilendirme alanı, sol tarafında ise daha önceden tanımlamış olduğunuz Aktif XML Kaynaklarınız ve onay sürecinde olan Bekleyen XML Entegrasyon Talepleriniz yer alır.


XML talebi oluşturmak için XML Ürün Kaynakları sayfasında bilgilendirme alanının altında bulunan Yeni XML Ürün Kaynağı Tanımla butonuna tıklıyoruz.


Açılan sayfada XML tanımlama için gerekli adımlar yer alır.

⚠️*NOT: Bilgi tanımla alanlarının üzerine geldiğinizde o alan ile ilgili bilgilendirme mesajı çıkmaktadır. Bilgilendirme mesajını okuyarak ilgili alana bilgilerinizi tanımlayabilirsiniz.

1- XML Tanımlama Süreci: XML tanımlama için işlem adımlarının yer aldığı kısımdır.
2- Bilgilendirme (IP Adresi): Bazı tedarikçiler XML kaynağına erişim izni için IP adresi bilgisi isteyebilir. Burada yazan IP Adresini tedarikçinize vererek erişim izni kontrolünü yaptırabilirsiniz.
3- XML Kaynak Adı: Ürün listesinde ürünün nereden geldiğini, hangi kaynaktan geldiğini görmek ve filtrelemek için XML kaynak adı yazılır. Bu alanın doldurulması zorunludur.
4- XML Kaynak Linki:
Tedarikçiniz tarafından verilen ürün bilgilerinin bulunduğu XML kaynağının linki yazılır. Bu alanın doldurulması zorunludur.
5- XML Ekstra Notlar:
XML ile ilgili dikkat edilmesi gereken bir konu var ise buraya yazabilirsiniz.

Tüm alanlar doldurulduktan sonra Devam Et butonuna tıklıyoruz.


Ürün Ayarları
adımında XML 'iniz ile ilgili yapılacak işlemlerin ayarlamaları yapılır.

1- Ürün Kodu Ön Eki kısmına yazdığınız değer ürünleriniz Sopyo'ya yüklenirken stok kodlarının önüne eklenir.
2- Ürün Barkodları Yeniden Oluşturulsun ayarını açarsanız ürünleriniz Sopyo'ya yüklenirken barkodları benzersiz bir şekilde yeniden eklenir.
3- Ürün Stok Güncellemesi Yapılmasın ayarını açarsanız ürünleriniz Sopyo'ya yüklendikten sonra 24 saatte bir stok güncellemesi yapılmaz.
4- Ürün Fiyat Güncellemesi Yapılmasın ayarını açarsanız ürünleriniz Sopyo'ya yüklendikten sonra 24 saatte bir fiyat güncellemesi yapılmaz.
5- Sopyo'da Olmayan Ürünler Eklenmesin ayarını açarsanız ürünleriniz Sopyo'ya yüklendikten sonra 24 saatte bir kontrol edildiğinde Sopyo'da olmayan ürün var ise ürün eklemesi yapılmaz.
6- Stok Sıfırlama Tanımı ayarı sayesinde ürünleriniz Sopyo'ya yüklendikten sonra 24 saatte bir kontrol edildiğinde XML'de stok miktarı belli bir seviyenin altına düştüğünde stoklarınızı sıfırlayıp satışa kapatır.(Kritik Stok Miktarı kısmı varsayılan olarak 3 gelir, dilerseniz değişiklik yapabilirsiniz.)
7- Kritik Stok Miktarı
kısmı Stok Sıfırlama Tanımı ayarını açarsanız aktif olur. XML'de stok miktarı burada belirttiğiniz miktara düştüğünde ürününüzün stoklarını sıfırlayıp satışa kapatır.
8- Otomatik Ürün Gönderimi Yapılsın ayarını açarsanız ürünleriniz Sopyo'ya yüklendikten sonra kategori, seçenek ve marka eşitlemeleri yapılmışsa bir sonraki aktarım kontrolünde otomatik olarak ilgili listeden seçmiş olduğunuz satış kanallarına gönderilir.

⚠️*NOT: Otomatik gönderim yapılacağı zaman ilgili satış kanallarınının entegrasyon ayarlarının yapılmış olması ve entegrasyon durumunun AKTİF olması gerekmektedir.

İlgili ayarlamaları yaptıktan sonra Devam Et butonuna tıklıyoruz.


Tanımladığınız XML Kaynağı Linki uygun değil ise bir uyarı alırsınız ve Tamam butonuna tıkladığınızda XML Ürün Kaynakları sayfasına geri yönlendirilirsiniz. Eğer XML linkinizi Destek Talebi oluşturarak iletirseniz Teknik Ekibimiz inceleyip sizlere geri dönüş yapacaklardır.


XML Kaynağı Linki uygun ise bir sonraki adıma geçer;
Fiyat Ayarları adımında ürünlerinizin fiyatı ile ilgili yapılacak işlemlerin ayarlamaları yapılır.

1- Ürünün Satış Fiyatı Etiketi kısmında ürünün tedarikçi tarafından belirlenen satış fiyatı etiketinin olduğu alan seçilmelidir. Ürün fiyatı o etiketten gelecektir, yanlış seçilir ise işlem gerçekleşemez. Bu alanın doldurulması zorunludur.
2- Ürünün Alış Fiyat Etiketi
kısmında ürünün tedarikçi tarafından belirlenen alış fiyatı etiketinin olduğu alan seçilmelidir. Ürün fiyatı o etiketten gelecektir, yanlış seçilir ise işlem gerçekleşemez.
3- Ürünün Liste(Üstü Çizili) Fiyat Etiketi kısmında ürünün tedarikçi tarafından belirlenen liste fiyatı etiketinin olduğu alan seçilmelidir. Ürün fiyatı o etiketten gelecektir, yanlış seçilir ise işlem gerçekleşemez.
4- KDV ve Fiyat Kuralları ile ilgili istenilen seçimler yapılır.


XML KDV Etiketini Kullan
kuralı seçilir ise alt kısımda açılan alandan seçeceğiniz etiket alanındaki değer KDV oranı olarak uygulanır. Alt kısmından bir seçim yapılmaz ise manuel KDV oranı kullanılır ve tüm ürünlere bu KDV oranı eklenir.


Manuel KDV Oranı Kullan
kuralı seçilir ise alt kısımda açılan alandan seçeceğiniz KDV oranı tüm ürünlere uygulanır.


Fiyat Yuvarlama Uygulanmasın
kuralı seçilir ise fiyatlarda yuvarlama işlemi yapılmaz.


Fiyat Yuvarlama Uygulansın
kuralı seçilir ise alt kısımda açılan alanlardan ilgili seçimler yapılır ve tüm ürünlere bu fiyat yuvarlama kuralı uygulanır.

Örnek; ürünlerinizde fiyatları ,99 olacak şekilde aşağı yuvarlama işlemi istiyorsanız Fiyat Yuvarlama Şekli kısmını ,99 , Fiyat Yuvarlama Yönü kısmını da Aşağı olarak seçmeniz gerekmektedir. Bu işlem sonucunda 11,23 olan fiyatınız 10,99 olacak şekilde yuvarlama işlemi gerçekleşir.


Sabit Fiyat Kuralı Uygulansın
kuralı seçilir ise alt kısımda açılan alanlardan ilgili seçimler yapılır ve tüm ürünlere bu fiyat kuralı uygulanır.

Örnek; ürünlerinizde %20 fiyat atışı ve +10₺ kargo fiyatı eklemesi yapmak istiyorsanız Kural Tipi kısmına Fiyat Artışı, İşlem Tipi kısmına Yüzdelik(%), İşlem Miktarı kısmına 20 ve Ek Fiyat(TL) kısmına da 10 yazmanız gerekmektedir.


Değişken Fiyat Kuralı Uygulansın
kuralı seçilir ise alt kısımda açılan alanlardan ilgili seçimler yapılır ve belirlenen fiyat aralığına göre olan ürünlere belirttiğiniz fiyat kuralı uygulanır.

Örnek; Fiyatı 50₺'den(50₺ dahil) büyük ve 100₺'den(100₺ dahil değil) küçük olan ürünlerinizde %15 fiyat atışı ve +10₺ ek fiyat eklemesi yapmak istiyorsanız Fiyat>= kısmına 50, <Fiyat kısmına 100, Kural Tipi kısmına Fiyat Artışı, İşlem Tipi kısmına Yüzdelik(%), İşlem Miktarı kısmına 15 ve Ek Fiyat(TL) kısmına da 10 yazmanız gerekmektedir.

Burada birden fazla kural eklemesi yapabilirsiniz. Yeni bir kural eklemek istiyorsanız alt kısımda bulunan Yeni Satır Ekle butonuna tıklayabilirsiniz. Oluşturduğunuz kuralın sağ kısmında bulunan çöp kutusu ikonuna tıklayarak kuralı silebilirsiniz.


Fiyat Ayarları
adımında istenilen ayarlamaları yaptıktan sonra Devam Et butonuna tıklıyoruz.


Onay
adımında tanımladığınız XML ile ilgili yapılan ayarlar yer gösterilir.

1- Kaynak Adı kısmında belirttiğiniz XML kaynak adı bilgisi yer alır.
2- Kalan Ürün Limitiniz kısmında tanımladığınız XML içerisinde kaç adet ürün olduğu bilgisi yer alır. ( Kaç adet ürün tanımlandığı bilgisi / Kaç adet ürün tanımlayabileceğiniz bilgisi)
3- Örnek Ürün Değişiklik Önizlemesi kısmında ürünün belirlediğiniz ayarlara göre nasıl gözükeceği önizlemesi yer alır.
4- Ürün Ayar Seçimleri kısmında ürünlerinizde yapılacak olan stok, fiyat yada barkod değişiklik izinleri yer alır.
5- XML Fiyat Ayar Seçimleri kısmında belirlediğiniz fiyat ve KDV etiketi bilgisi yer alır.
6- Fiyat Kuralı Tablosu kısmında ürünlerinize uygulanmasını istediğiniz fiyat kuralları bilgisi yer alır.

⚠️*NOT: Onay ekranında tanımlama yapılan alanların sol yanında bulunan ? ikonunun üzerine geldiğinizde o tanımlama ile ilgili bilgilendirme mesajı çıkmaktadır.

Onay adımında XML'iniz ile ilgili tüm seçimleri/kuralları kontrol ettikten sonra Onayla Ve Bitir butonuna tıklıyoruz.


Karşımıza XML tanımlama işlemi için onay ekranı çıkıyor. Burada yazılan uyarıları dikkatli bir şekilde okuyoruz ve işlemi tamamlamak için Evet butonuna tıklıyoruz.


Onay alındıktan sonra XML tanımlama işleminiz Sopyo'ya talep olarak oluşturulmaktadır. Talepleriniz 24 saat içerisinde kontrol edilir ve herhangi bir sorun olmadığı takdirde ürünlerinizin yüklenmesi için işlem başlatılır.


Tanımladığınız XML'in durumunu XML Ürün Kaynakları sayfasında yer alan Bekleyen XML Entegrasyon Talepleriniz kısmından görüntüleyebilirsiniz.


Aktif yada Bekleyen XML kaynaklarınızın sağ kısmında bulunan Düzenle butonuna tıklayarak değişiklik yapabilirsiniz.


Aktif yada Bekleyen XML kaynaklarınızı sağ kısmında bulunan Sil butonuna tıklayarak silebilirsiniz.

Sopyo panelinde sol menüden Ürünler / XML Kaynakları kısmına tıklıyoruz.


XML Ürün Kaynakları
sayfasının sağ tarafında XML tanımlama ile ilgili genel bilgilendirme alanı, sol tarafında ise daha önceden tanımlamış olduğunuz Aktif XML Kaynaklarınız ve onay sürecinde olan Bekleyen XML Entegrasyon Talepleriniz yer alır.


XML talebi oluşturmak için XML Ürün Kaynakları sayfasında bilgilendirme alanının altında bulunan Yeni XML Ürün Kaynağı Tanımla butonuna tıklıyoruz.


Açılan sayfada XML tanımlama için gerekli adımlar yer alır.

⚠️*NOT: Bilgi tanımla alanlarının üzerine geldiğinizde o alan ile ilgili bilgilendirme mesajı çıkmaktadır. Bilgilendirme mesajını okuyarak ilgili alana bilgilerinizi tanımlayabilirsiniz.

1- XML Tanımlama Süreci: XML tanımlama için işlem adımlarının yer aldığı kısımdır.
2- Bilgilendirme (IP Adresi): Bazı tedarikçiler XML kaynağına erişim izni için IP adresi bilgisi isteyebilir. Burada yazan IP Adresini tedarikçinize vererek erişim izni kontrolünü yaptırabilirsiniz.
3- XML Kaynak Adı: Ürün listesinde ürünün nereden geldiğini, hangi kaynaktan geldiğini görmek ve filtrelemek için XML kaynak adı yazılır. Bu alanın doldurulması zorunludur.
4- XML Kaynak Linki:
Tedarikçiniz tarafından verilen ürün bilgilerinin bulunduğu XML kaynağının linki yazılır. Bu alanın doldurulması zorunludur.
5- XML Ekstra Notlar:
XML ile ilgili dikkat edilmesi gereken bir konu var ise buraya yazabilirsiniz.

Tüm alanlar doldurulduktan sonra Devam Et butonuna tıklıyoruz.


Ürün Ayarları
adımında XML 'iniz ile ilgili yapılacak işlemlerin ayarlamaları yapılır.

1- Ürün Kodu Ön Eki kısmına yazdığınız değer ürünleriniz Sopyo'ya yüklenirken stok kodlarının önüne eklenir.
2- Ürün Barkodları Yeniden Oluşturulsun ayarını açarsanız ürünleriniz Sopyo'ya yüklenirken barkodları benzersiz bir şekilde yeniden eklenir.
3- Ürün Stok Güncellemesi Yapılmasın ayarını açarsanız ürünleriniz Sopyo'ya yüklendikten sonra 24 saatte bir stok güncellemesi yapılmaz.
4- Ürün Fiyat Güncellemesi Yapılmasın ayarını açarsanız ürünleriniz Sopyo'ya yüklendikten sonra 24 saatte bir fiyat güncellemesi yapılmaz.
5- Sopyo'da Olmayan Ürünler Eklenmesin ayarını açarsanız ürünleriniz Sopyo'ya yüklendikten sonra 24 saatte bir kontrol edildiğinde Sopyo'da olmayan ürün var ise ürün eklemesi yapılmaz.
6- Stok Sıfırlama Tanımı ayarı sayesinde ürünleriniz Sopyo'ya yüklendikten sonra 24 saatte bir kontrol edildiğinde XML'de stok miktarı belli bir seviyenin altına düştüğünde stoklarınızı sıfırlayıp satışa kapatır.(Kritik Stok Miktarı kısmı varsayılan olarak 3 gelir, dilerseniz değişiklik yapabilirsiniz.)
7- Kritik Stok Miktarı
kısmı Stok Sıfırlama Tanımı ayarını açarsanız aktif olur. XML'de stok miktarı burada belirttiğiniz miktara düştüğünde ürününüzün stoklarını sıfırlayıp satışa kapatır.
8- Otomatik Ürün Gönderimi Yapılsın ayarını açarsanız ürünleriniz Sopyo'ya yüklendikten sonra kategori, seçenek ve marka eşitlemeleri yapılmışsa bir sonraki aktarım kontrolünde otomatik olarak ilgili listeden seçmiş olduğunuz satış kanallarına gönderilir.

⚠️*NOT: Otomatik gönderim yapılacağı zaman ilgili satış kanallarınının entegrasyon ayarlarının yapılmış olması ve entegrasyon durumunun AKTİF olması gerekmektedir.

İlgili ayarlamaları yaptıktan sonra Devam Et butonuna tıklıyoruz.


Tanımladığınız XML Kaynağı Linki uygun değil ise bir uyarı alırsınız ve Tamam butonuna tıkladığınızda XML Ürün Kaynakları sayfasına geri yönlendirilirsiniz. Eğer XML linkinizi Destek Talebi oluşturarak iletirseniz Teknik Ekibimiz inceleyip sizlere geri dönüş yapacaklardır.


XML Kaynağı Linki uygun ise bir sonraki adıma geçer;
Fiyat Ayarları adımında ürünlerinizin fiyatı ile ilgili yapılacak işlemlerin ayarlamaları yapılır.

1- Ürünün Satış Fiyatı Etiketi kısmında ürünün tedarikçi tarafından belirlenen satış fiyatı etiketinin olduğu alan seçilmelidir. Ürün fiyatı o etiketten gelecektir, yanlış seçilir ise işlem gerçekleşemez. Bu alanın doldurulması zorunludur.
2- Ürünün Alış Fiyat Etiketi
kısmında ürünün tedarikçi tarafından belirlenen alış fiyatı etiketinin olduğu alan seçilmelidir. Ürün fiyatı o etiketten gelecektir, yanlış seçilir ise işlem gerçekleşemez.
3- Ürünün Liste(Üstü Çizili) Fiyat Etiketi kısmında ürünün tedarikçi tarafından belirlenen liste fiyatı etiketinin olduğu alan seçilmelidir. Ürün fiyatı o etiketten gelecektir, yanlış seçilir ise işlem gerçekleşemez.
4- KDV ve Fiyat Kuralları ile ilgili istenilen seçimler yapılır.


XML KDV Etiketini Kullan
kuralı seçilir ise alt kısımda açılan alandan seçeceğiniz etiket alanındaki değer KDV oranı olarak uygulanır. Alt kısmından bir seçim yapılmaz ise manuel KDV oranı kullanılır ve tüm ürünlere bu KDV oranı eklenir.


Manuel KDV Oranı Kullan
kuralı seçilir ise alt kısımda açılan alandan seçeceğiniz KDV oranı tüm ürünlere uygulanır.


Fiyat Yuvarlama Uygulanmasın
kuralı seçilir ise fiyatlarda yuvarlama işlemi yapılmaz.


Fiyat Yuvarlama Uygulansın
kuralı seçilir ise alt kısımda açılan alanlardan ilgili seçimler yapılır ve tüm ürünlere bu fiyat yuvarlama kuralı uygulanır.

Örnek; ürünlerinizde fiyatları ,99 olacak şekilde aşağı yuvarlama işlemi istiyorsanız Fiyat Yuvarlama Şekli kısmını ,99 , Fiyat Yuvarlama Yönü kısmını da Aşağı olarak seçmeniz gerekmektedir. Bu işlem sonucunda 11,23 olan fiyatınız 10,99 olacak şekilde yuvarlama işlemi gerçekleşir.


Sabit Fiyat Kuralı Uygulansın
kuralı seçilir ise alt kısımda açılan alanlardan ilgili seçimler yapılır ve tüm ürünlere bu fiyat kuralı uygulanır.

Örnek; ürünlerinizde %20 fiyat atışı ve +10₺ kargo fiyatı eklemesi yapmak istiyorsanız Kural Tipi kısmına Fiyat Artışı, İşlem Tipi kısmına Yüzdelik(%), İşlem Miktarı kısmına 20 ve Ek Fiyat(TL) kısmına da 10 yazmanız gerekmektedir.


Değişken Fiyat Kuralı Uygulansın
kuralı seçilir ise alt kısımda açılan alanlardan ilgili seçimler yapılır ve belirlenen fiyat aralığına göre olan ürünlere belirttiğiniz fiyat kuralı uygulanır.

Örnek; Fiyatı 50₺'den(50₺ dahil) büyük ve 100₺'den(100₺ dahil değil) küçük olan ürünlerinizde %15 fiyat atışı ve +10₺ ek fiyat eklemesi yapmak istiyorsanız Fiyat>= kısmına 50, <Fiyat kısmına 100, Kural Tipi kısmına Fiyat Artışı, İşlem Tipi kısmına Yüzdelik(%), İşlem Miktarı kısmına 15 ve Ek Fiyat(TL) kısmına da 10 yazmanız gerekmektedir.

Burada birden fazla kural eklemesi yapabilirsiniz. Yeni bir kural eklemek istiyorsanız alt kısımda bulunan Yeni Satır Ekle butonuna tıklayabilirsiniz. Oluşturduğunuz kuralın sağ kısmında bulunan çöp kutusu ikonuna tıklayarak kuralı silebilirsiniz.


Fiyat Ayarları
adımında istenilen ayarlamaları yaptıktan sonra Devam Et butonuna tıklıyoruz.


Onay
adımında tanımladığınız XML ile ilgili yapılan ayarlar yer gösterilir.

1- Kaynak Adı kısmında belirttiğiniz XML kaynak adı bilgisi yer alır.
2- Kalan Ürün Limitiniz kısmında tanımladığınız XML içerisinde kaç adet ürün olduğu bilgisi yer alır. ( Kaç adet ürün tanımlandığı bilgisi / Kaç adet ürün tanımlayabileceğiniz bilgisi)
3- Örnek Ürün Değişiklik Önizlemesi kısmında ürünün belirlediğiniz ayarlara göre nasıl gözükeceği önizlemesi yer alır.
4- Ürün Ayar Seçimleri kısmında ürünlerinizde yapılacak olan stok, fiyat yada barkod değişiklik izinleri yer alır.
5- XML Fiyat Ayar Seçimleri kısmında belirlediğiniz fiyat ve KDV etiketi bilgisi yer alır.
6- Fiyat Kuralı Tablosu kısmında ürünlerinize uygulanmasını istediğiniz fiyat kuralları bilgisi yer alır.

⚠️*NOT: Onay ekranında tanımlama yapılan alanların sol yanında bulunan ? ikonunun üzerine geldiğinizde o tanımlama ile ilgili bilgilendirme mesajı çıkmaktadır.

Onay adımında XML'iniz ile ilgili tüm seçimleri/kuralları kontrol ettikten sonra Onayla Ve Bitir butonuna tıklıyoruz.


Karşımıza XML tanımlama işlemi için onay ekranı çıkıyor. Burada yazılan uyarıları dikkatli bir şekilde okuyoruz ve işlemi tamamlamak için Evet butonuna tıklıyoruz.


Onay alındıktan sonra XML tanımlama işleminiz Sopyo'ya talep olarak oluşturulmaktadır. Talepleriniz 24 saat içerisinde kontrol edilir ve herhangi bir sorun olmadığı takdirde ürünlerinizin yüklenmesi için işlem başlatılır.


Tanımladığınız XML'in durumunu XML Ürün Kaynakları sayfasında yer alan Bekleyen XML Entegrasyon Talepleriniz kısmından görüntüleyebilirsiniz.


Aktif yada Bekleyen XML kaynaklarınızın sağ kısmında bulunan Düzenle butonuna tıklayarak değişiklik yapabilirsiniz.


Aktif yada Bekleyen XML kaynaklarınızı sağ kısmında bulunan Sil butonuna tıklayarak silebilirsiniz.