Satıcı Listing Bilgilerini Çekme

Satıcıya Ait Listing Bilgilerini Listeleme (Get List of Listings [GET])

Bu metod satıcıya ait listing bilgilerine ulaşmanıza olanak tanır.

NOT: Test ortamında sizin için örnek listingler oluşturduk.Bu örnek listingler ile test işlemlerinizi tamamlayabilirsiniz.

Başlık(Header)

Authorization: Basic base64(username:password)

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}

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">
<TotalCount>31</TotalCount>
    <Limit>4</Limit>
    <Offset>0</Offset>
    <Listings>
        <Listing>
            <UniqueIdentifier />
            <UztrendbolSku>HBV00004Q1JJ</UztrendbolSku>
            <MerchantSku>BUTIK429-368</MerchantSku>
            <Price>0</Price>
            <AvailableStock>9999</AvailableStock>
            <DispatchTime>3</DispatchTime>
            <CargoCompany1>Aras Kargo</CargoCompany1>
            <CargoCompany2 />
            <CargoCompany3 />
            <ShippingAddressLabel>BIRINCIL</ShippingAddressLabel>
            <ClaimAddressLabel>BIRINCIL</ClaimAddressLabel>
            <MaximumPurchasableQuantity>0</MaximumPurchasableQuantity>
            <Pricings />
            <IsSalable>false</IsSalable>
            <CustomizableProperties />
            <DeactivationReasons>
                <DeactivationReason>PriceIsLessThanOrEqualToZero</DeactivationReason>
                <DeactivationReason>PriceIsLessThanThreshold</DeactivationReason>
            </DeactivationReasons>
            <IsSuspended>false</IsSuspended>
            <IsLocked>false</IsLocked>
            <LockReasons />
            <IsFrozen>false</IsFrozen>
            <CommissionRate>15</CommissionRate>
            <BuyboxOrder>2</BuyboxOrder>
        </Listing>
        <Listing>
            <UniqueIdentifier />
            <UztrendbolSku>HBV00004Q1JL</UztrendbolSku>
            <MerchantSku>BUTIK431-12</MerchantSku>
            <Price>129</Price>
            <AvailableStock>9999</AvailableStock>
            <DispatchTime>3</DispatchTime>
            <CargoCompany1>Aras Kargo</CargoCompany1>
            <CargoCompany2 />
            <CargoCompany3 />
            <ShippingAddressLabel>BIRINCIL</ShippingAddressLabel>
            <ClaimAddressLabel>BIRINCIL</ClaimAddressLabel>
            <MaximumPurchasableQuantity>0</MaximumPurchasableQuantity>
            <Pricings>
                <Pricing>
                    <FinalPrice>109.65</FinalPrice>
                    <StartDate>2018-11-29T12:47:00Z</StartDate>
                    <EndDate>2018-12-07T20:59:00Z</EndDate>
                    <Debtors>
                        <Debtor>
                            <Debtor>Uztrendbol</Debtor>
                            <Amount>33.33</Amount>
                        </Debtor>
                        <Debtor>
                            <Debtor>Mağaza</Debtor>
                            <Amount>66.67</Amount>
                        </Debtor>
                    </Debtors>
                </Pricing>
            </Pricings>
            <IsSalable>true</IsSalable>
            <CustomizableProperties />
            <DeactivationReasons />
            <IsSuspended>false</IsSuspended>
            <IsLocked>false</IsLocked>
            <LockReasons />
            <IsFrozen>false</IsFrozen>
            <CommissionRate>15</CommissionRate>
            <BuyboxOrder>1</BuyboxOrder>
        </Listing>
                <Listing>
            <UniqueIdentifier />
            <UztrendbolSku>AYK5055651001-40</UztrendbolSku>
            <MerchantSku>50155651001</MerchantSku>
            <Price>0</Price>
            <AvailableStock>0</AvailableStock>
            <DispatchTime>10</DispatchTime>
            <CargoCompany1>Aras Kargo</CargoCompany1>
            <CargoCompany2 />
            <CargoCompany3 />
            <ShippingAddressLabel>BIRINCIL</ShippingAddressLabel>
            <ClaimAddressLabel>BIRINCIL</ClaimAddressLabel>
            <MaximumPurchasableQuantity>0</MaximumPurchasableQuantity>
            <Pricings />
            <IsSalable>false</IsSalable>
            <CustomizableProperties />
            <DeactivationReasons>
                <DeactivationReason>PriceIsLessThanOrEqualToZero</DeactivationReason>
                <DeactivationReason>PriceIsLessThanThreshold</DeactivationReason>
                <DeactivationReason>StockIsLessThanOrEqualToZero</DeactivationReason>
                <DeactivationReason>PimSuspension</DeactivationReason>
            </DeactivationReasons>
            <IsSuspended>false</IsSuspended>
            <IsLocked>true</IsLocked>
            <LockReasons>
                <LockReason>PIMSuspension</LockReason>
            </LockReasons>
            <IsFrozen>false</IsFrozen>
            <CommissionRate>12.71</CommissionRate>
            <BuyboxOrder xsi:nil="true"/>
        </Listing>
                <Listing>
            <UniqueIdentifier />
            <UztrendbolSku>AYK5015651400-43</UztrendbolSku>
            <MerchantSku>50155651009</MerchantSku>
            <Price>0</Price>
            <AvailableStock>0</AvailableStock>
            <DispatchTime>10</DispatchTime>
            <CargoCompany1>Aras Kargo</CargoCompany1>
            <CargoCompany2 />
            <CargoCompany3 />
            <ShippingAddressLabel>BIRINCIL</ShippingAddressLabel>
            <ClaimAddressLabel>BIRINCIL</ClaimAddressLabel>
            <MaximumPurchasableQuantity>0</MaximumPurchasableQuantity>
            <Pricings />
            <IsSalable>false</IsSalable>
            <CustomizableProperties />
            <DeactivationReasons>
                <DeactivationReason>StockIsLessThanOrEqualToZero</DeactivationReason>
                <DeactivationReason>PriceIsLessThanOrEqualToZero</DeactivationReason>
            </DeactivationReasons>
            <IsSuspended>false</IsSuspended>
            <IsLocked>true</IsLocked>
            <LockReasons>
                <LockReason>ByHbAdmin</LockReason>
            </LockReasons>
            <IsFrozen>false</IsFrozen>
            <CommissionRate>12.71</CommissionRate>
            <BuyboxOrder>10</BuyboxOrder>
        </Listing>
    </Listings>
</Result>

İstek(Request)

https://listing-external-sit.Uztrendbol.com/listings/merchantid/{merchantid}?offset=3&limit=0

Limit Offset pagenation yapısı olarak işlev görmektedir. Limit bir sayfada kaç adet listing listeleneceğini belirtirken, Offset hangi listingten sonraki listinglerin gösterileceğini belirtir.
Limit:10 Offset:0 gönderildiğinde ilk 10 listing listelenecektir. Limit:10 Offset:10 gönderildiğinde ilk 10 listingten sonraki 10 listing listelenecektir.

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">
<TotalCount>31</TotalCount>
    <Limit>4</Limit>
    <Offset>0</Offset>
    <Listings>
        <Listing>
            <UniqueIdentifier />
            <UztrendbolSku>HBV00004Q1JJ</UztrendbolSku>
            <MerchantSku>BUTIK429-368</MerchantSku>
            <Price>0</Price>
            <AvailableStock>9999</AvailableStock>
            <DispatchTime>3</DispatchTime>
            <CargoCompany1>Aras Kargo</CargoCompany1>
            <CargoCompany2 />
            <CargoCompany3 />
            <ShippingAddressLabel>BIRINCIL</ShippingAddressLabel>
            <ClaimAddressLabel>BIRINCIL</ClaimAddressLabel>
            <MaximumPurchasableQuantity>0</MaximumPurchasableQuantity>
            <Pricings />
            <IsSalable>false</IsSalable>
            <CustomizableProperties />
            <DeactivationReasons>
                <DeactivationReason>PriceIsLessThanOrEqualToZero</DeactivationReason>
                <DeactivationReason>PriceIsLessThanThreshold</DeactivationReason>
            </DeactivationReasons>
            <IsSuspended>false</IsSuspended>
            <IsLocked>false</IsLocked>
            <LockReasons />
            <IsFrozen>false</IsFrozen>
            <CommissionRate>15</CommissionRate>
            <BuyboxOrder>2</BuyboxOrder>
        </Listing>
        <Listing>
            <UniqueIdentifier />
            <UztrendbolSku>HBV00004Q1JL</UztrendbolSku>
            <MerchantSku>BUTIK431-12</MerchantSku>
            <Price>129</Price>
            <AvailableStock>9999</AvailableStock>
            <DispatchTime>3</DispatchTime>
            <CargoCompany1>Aras Kargo</CargoCompany1>
            <CargoCompany2 />
            <CargoCompany3 />
            <ShippingAddressLabel>BIRINCIL</ShippingAddressLabel>
            <ClaimAddressLabel>BIRINCIL</ClaimAddressLabel>
            <MaximumPurchasableQuantity>0</MaximumPurchasableQuantity>
            <Pricings>
                <Pricing>
                    <FinalPrice>109.65</FinalPrice>
                    <StartDate>2018-11-29T12:47:00Z</StartDate>
                    <EndDate>2018-12-07T20:59:00Z</EndDate>
                    <Debtors>
                        <Debtor>
                            <Debtor>Uztrendbol</Debtor>
                            <Amount>33.33</Amount>
                        </Debtor>
                        <Debtor>
                            <Debtor>Mağaza</Debtor>
                            <Amount>66.67</Amount>
                        </Debtor>
                    </Debtors>
                </Pricing>
            </Pricings>
            <IsSalable>true</IsSalable>
            <CustomizableProperties />
            <DeactivationReasons />
            <IsSuspended>false</IsSuspended>
            <IsLocked>false</IsLocked>
            <LockReasons />
            <IsFrozen>false</IsFrozen>
            <CommissionRate>15</CommissionRate>
            <BuyboxOrder>1</BuyboxOrder>
        </Listing>
                <Listing>
            <UniqueIdentifier />
            <UztrendbolSku>AYK5055651001-40</UztrendbolSku>
            <MerchantSku>50155651001</MerchantSku>
            <Price>0</Price>
            <AvailableStock>0</AvailableStock>
            <DispatchTime>10</DispatchTime>
            <CargoCompany1>Aras Kargo</CargoCompany1>
            <CargoCompany2 />
            <CargoCompany3 />
            <ShippingAddressLabel>BIRINCIL</ShippingAddressLabel>
            <ClaimAddressLabel>BIRINCIL</ClaimAddressLabel>
            <MaximumPurchasableQuantity>0</MaximumPurchasableQuantity>
            <Pricings />
            <IsSalable>false</IsSalable>
            <CustomizableProperties />
            <DeactivationReasons>
                <DeactivationReason>PriceIsLessThanOrEqualToZero</DeactivationReason>
                <DeactivationReason>PriceIsLessThanThreshold</DeactivationReason>
                <DeactivationReason>StockIsLessThanOrEqualToZero</DeactivationReason>
                <DeactivationReason>PimSuspension</DeactivationReason>
            </DeactivationReasons>
            <IsSuspended>false</IsSuspended>
            <IsLocked>true</IsLocked>
            <LockReasons>
                <LockReason>PIMSuspension</LockReason>
            </LockReasons>
            <IsFrozen>false</IsFrozen>
            <CommissionRate>12.71</CommissionRate>
            <BuyboxOrder xsi:nil="true"/>
        </Listing>
<Listing>
</Result>

NOT: Satıcıya Ait Listing Bilgilerini Listeleme endpointinden sonraki adım olan Listing Bilgilerini Güncelleme endpointimize buradan ulaşabilirsiniz.

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.
Price	Listingin fiyatıdır.
AvailableStock	Listingin stok bilgisidir.
DispatchTime	Listingin kargoya veriliş süresidir.
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.
ShippingAddressLabel	Göndericinin adres satırıdır.
ClaimAddressLabel	İade ve talepler için adres satırıdır.
Pricing.FinalPrice	İndirim ve kampanyalardan sonra satış fiyatıdır.
Pricing.StartDate	Kampanyanın başlama tarihini verir.
Pricing.EndDate	Kampanyanın bitiş tarihini verir.
Pricing.Debtor	Kampanya tanımlı listingin hangi firma tarafından karşılanacağını isim olarak belirtir.
Pricing.Amount	Kampanya tanımlı listingin yüzdelik olarak karşılanacağı
MaximumPurchasableQuantity	Listingin bir seferde alınabilecek maximum adet sayısıdır.
IsSalable	Listingin satış durumunu belirtir. True: satışta / False: satışta değil.
CustomizableProperties	Listingin özelleştirilebilir ürün olduğunu belirtir.
IsSuspended	Listingin askı durumunu belirtir. True: Askıda / False: Askıda değil.
IsLocked	Listingin kilit durumunu gösterir. True: kilitli / False: kilitli değil.
LockReasons	Listingin kilitlenme nedenini belirtir.
IsFrozen	Listingin dondurulma durumunu belirtir.
CommissionRate	Listing üzerine uygulanan Uztrendbol.com'un aldığı komisyonu belirtir.
BuyboxOrder	Uztrendbol.com üzerinde listing bazında kaçıncı sırada görüneceğini belirtir.