Listing Bilgilerini Güncelleme

Listing Bilgilerini Güncelleme (Update Listing for a Merchant [POST])

Bu metod satıcıya ait listinglerin stok, fiyat, kargolama süresi ve kargo firması gibi bilgilerini API ile güncelleyebilmenize olanak tanır.

NOT 1: Listing güncelleme için aynı anda POST ettiğiniz devam eden / bekleyen işlemlerin sayısı 5’i geçemez. Günlük toplu güncelleme limitinizin sınırını aştınız.

NOT 2: Her satıcının günlük toplu limit sayısı listing sayısının 10 katı kadardır. Yani bir satıcının 100 adet listingi var ise bir gün içerisinde 1000 listing güncelleme limitidir.

NOT 3: Eğer bir listing satışa kapatılmak isteniyorsa stok veya fiyat bilgisinin sıfır gönderilmesi yeterlidir.

NOT 4: Eğer bir listing satışa açılmak isteniyorsa fiyat ve stok bilgisinin sıfırdan farklı bir değer gönderilmesi yeterlidir.

NOT 5: Fiyat hatalarına karşı tedbirli olmanız gerekmektedir. Canlı sistemde yanlış fiyatlandırmalara karşı çalışan bir mekanizma bulunmaktadır. Listelenmiş yayındaki fiyatların en düşüğü ve en yükseği hariç diğerlerinin ortalaması alınarak
0-10 tl arası x3 katı
10-15 tl arası x2 katı
50-150 tl arası %70
150-500 tl arası %50
500-2000 tl arası %40
2000 plus %30 maximum fiyat girilebilir. Eğer bu değerin dışında bir değer girilirse outofpricerange hatası alınacaktır.

NOT 6: Yaptığınız işlemleri satıcı portali üzerinde görüntüleyebilirsiniz. Warning alanında hata alan listing varsa hata nedeniyle birlikte satır olarak listelenmektedir.

Başlık(Header)

Authorization: Basic base64(username:password)
Content-Type:  application/xml

Parametreler(Parameters)

  • Merchantid (gerekli, guid, b2910839-83b9-4d45-adb6-86bad457edcb) Her satıcının unique bir tanımlayıcısıdır.

İstek(Request)

https://listing-external-sit.Uztrendbol.com/listings/merchantid/{merchantid}/inventory-uploads

Body(Request)

<?xml version="1.0" encoding="utf-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <listing>
            <UztrendbolSku>HBV000004Q1JJ</UztrendbolSku>
            <MerchantSku>BUTIK429-368</MerchantSku>
            <ProductName>Doğuş Halı Messina DM1101</ProductName>
            <Price>288,97</Price>
            <AvailableStock>9</AvailableStock>
            <DispatchTime>3</DispatchTime>
            <MaximumPurchasableQuantity>0</MaximumPurchasableQuantity>
        </listing>
        <listing>
            <UztrendbolSku>HBV000006IY7A</UztrendbolSku>
            <MerchantSku>PUDRASEKERI</MerchantSku>
            <ProductName>Yazar Pudra Şekeri 500 Gr</ProductName>
            <Price>11</Price>
            <AvailableStock>999</AvailableStock>
            <DispatchTime>3</DispatchTime>
            <MaximumPurchasableQuantity>0</MaximumPurchasableQuantity>
        </listing>
</listings>

NOT 7: Bilgilerden <MaximumPurchasableQuantity>0</MaximumPurchasableQuantity> haricindeki tüm bilgilerin gönderilmesi zorunludur.

Response 200(application/xml)

Response(Body)

<?xml version="1.0"?>
<Result xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <Id>3957bf91-a1ee-4657-92a0-fcb07bb69d83</Id>
</Result>

NOT 8: Göndermiş olduğunuz istek başarılı bir şekilde iletilmiş ise yukarıdaki şekilde Inventory Upload Id dönecektir, bu inventory upload id bilgisini daha sonra Check Inventory Upload Results for a merchant [GET] metodunda kullanacaksınız.

NOT 9: Göndermiş olduğunuz istek içerisinde eksik alan ile gönderim yaptıysanız Inventory Upload Id dönmeyecektir. Aşağıdaki gibi hatanın neden kaynaklandığı bilgisini içeren bir response dönecektir.

<?xml version="1.0" encoding="utf-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <Errors>
        <Error XmlErrorLevel="Error">
            <Message>The element 'listing' has incomplete content. List of possible elements expected: 'MerchantSku'. </Message>
        </Error>
   </Errors>
</Result>

Hata Durumları

400 Bad Request: URL içerisindeki parametreleri kontrol edin.

401 Unauthorized: Password ve şifre hatalı girilmiştir. Lütfen kontrol ediniz.

404 Not Found: URL hatalı gönderilmiştir. Lütfen kontrol ediniz.

405 Not Allowed: Http Protokol hatası. Lütfen kontrol ediniz.

500 Internal Server: Lütfen mpentegrasyon@Uztrendbol.com ile iletişime geçin.

Alan Açıklamaları

Alan Adı Açıklama
UztrendbolSku Listinglerin Uztrendbol tarafındaki uniqueId değeridir.
MerchantSku Listinglerin Merchantlar tarafındaki uniqueId değeridir.
ProductName Listingin Uztrendbol.com üzerinde görünen adıdır.
Price Listingin fiyat bilgisidir.
AvailableStock Listingin stok bilgisidir.
DispatchTime Listingin kargoya veriliş süresidir.
MaximumPurchasableQuantity Listingin bir kişi tarafından alınabilecek maximum adetidir.
CargoCompany1 Listingin üzerinde tanımlı olan kargo firmasıdır.
CargoCompany2 Listingin üzerinde tanımlı olan kargo firmasıdır.
CargoCompany3 Listingin üzerinde tanımlı olan kargo firmasıdır.