Tradera Developer Program

RestrictedService

Documentation Version 3 > RestrictedService > UpdateShopItem

UpdateShopItem |WebMethod|

This API method updates a Shop item. This is an asynchronous call, the method GetRequestResults needs to be called to verify that the shop item was successfully updated.
Remember to always set only those properties of ShopItemData that you want to update. All other properties need to be set to "null" (xsi:nil="true"), so that API will not consider to update them.

Note that the Quantity field is a delta - pass a negative value to decrease
the quantity and a positive value to increase it. Use AbsoluteQuantity if
you wish to set the quantity to an absolute value.

Parameters
  1. updateData, Update information (see ShopItemUpdateData ) for the Shop item that will be updated. Set only those properties of ShopItemData you want to update and other as null.
Returns

Response data ( QueuedRequestResponse ) with request id and item id. The item id is the id of the shop item that will be updated on tradera on Tradera. The request id is the identifier of the current request and is used together with API metthod GetRequestResults to get final result of this call.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /v3/restrictedservice.asmx HTTP/1.1
Host: api.tradera.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://api.tradera.com/UpdateShopItem"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <AuthenticationHeader xmlns="http://api.tradera.com">
      <AppId>int</AppId>
      <AppKey>string</AppKey>
    </AuthenticationHeader>
    <AuthorizationHeader xmlns="http://api.tradera.com">
      <UserId>int</UserId>
      <Token>string</Token>
    </AuthorizationHeader>
    <ConfigurationHeader xmlns="http://api.tradera.com">
      <Sandbox>int</Sandbox>
      <MaxResultAge>int</MaxResultAge>
    </ConfigurationHeader>
  </soap:Header>
  <soap:Body>
    <UpdateShopItem xmlns="http://api.tradera.com">
      <updateData>
        <ItemId>int</ItemId>
        <ItemData>
          <ActivateDate>dateTime</ActivateDate>
          <AcceptedBuyerId>int</AcceptedBuyerId>
          <CategoryId>int</CategoryId>
          <DeactivateDate>dateTime</DeactivateDate>
          <ItemAttributes>
            <int>int</int>
            <int>int</int>
          </ItemAttributes>
          <Description>string</Description>
          <PaymentCondition>string</PaymentCondition>
          <Price>int</Price>
          <Quantity>int</Quantity>
          <AbsoluteQuantity>int</AbsoluteQuantity>
          <ShippingCondition>string</ShippingCondition>
          <Title>string</Title>
          <VAT>int</VAT>
          <ShippingOptions>
            <ItemShipping>
              <ShippingOptionId>int</ShippingOptionId>
              <Cost>int</Cost>
              <ShippingWeight>decimal</ShippingWeight>
              <ShippingProductId>int</ShippingProductId>
              <ShippingProviderId>int</ShippingProviderId>
            </ItemShipping>
            <ItemShipping>
              <ShippingOptionId>int</ShippingOptionId>
              <Cost>int</Cost>
              <ShippingWeight>decimal</ShippingWeight>
              <ShippingProductId>int</ShippingProductId>
              <ShippingProviderId>int</ShippingProviderId>
            </ItemShipping>
          </ShippingOptions>
          <PaymentOptionIds>
            <int>int</int>
            <int>int</int>
          </PaymentOptionIds>
          <OwnReferences>
            <string>string</string>
            <string>string</string>
          </OwnReferences>
          <ItemImages>
            <ItemImageData>
              <HasMega>boolean</HasMega>
              <Format>Gif or Jpeg or Png</Format>
              <Data>base64Binary</Data>
              <Name>string</Name>
            </ItemImageData>
            <ItemImageData>
              <HasMega>boolean</HasMega>
              <Format>Gif or Jpeg or Png</Format>
              <Data>base64Binary</Data>
              <Name>string</Name>
            </ItemImageData>
          </ItemImages>
          <ExternalId>int</ExternalId>
          <AttributeValues>
            <Terms>
              <TermValues>
                <Id>int</Id>
                <Values xsi:nil="true" />
              </TermValues>
              <TermValues>
                <Id>int</Id>
                <Values xsi:nil="true" />
              </TermValues>
            </Terms>
            <Numbers>
              <NumberValues>
                <Id>int</Id>
                <Values xsi:nil="true" />
              </NumberValues>
              <NumberValues>
                <Id>int</Id>
                <Values xsi:nil="true" />
              </NumberValues>
            </Numbers>
          </AttributeValues>
          <DescriptionLanguageCodeIso2>string</DescriptionLanguageCodeIso2>
        </ItemData>
      </updateData>
    </UpdateShopItem>
  </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <UpdateShopItemResponse xmlns="http://api.tradera.com">
      <UpdateShopItemResult>
        <RequestId>int</RequestId>
        <ItemId>int</ItemId>
      </UpdateShopItemResult>
    </UpdateShopItemResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /v3/restrictedservice.asmx HTTP/1.1
Host: api.tradera.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Header>
    <AuthenticationHeader xmlns="http://api.tradera.com">
      <AppId>int</AppId>
      <AppKey>string</AppKey>
    </AuthenticationHeader>
    <AuthorizationHeader xmlns="http://api.tradera.com">
      <UserId>int</UserId>
      <Token>string</Token>
    </AuthorizationHeader>
    <ConfigurationHeader xmlns="http://api.tradera.com">
      <Sandbox>int</Sandbox>
      <MaxResultAge>int</MaxResultAge>
    </ConfigurationHeader>
  </soap12:Header>
  <soap12:Body>
    <UpdateShopItem xmlns="http://api.tradera.com">
      <updateData>
        <ItemId>int</ItemId>
        <ItemData>
          <ActivateDate>dateTime</ActivateDate>
          <AcceptedBuyerId>int</AcceptedBuyerId>
          <CategoryId>int</CategoryId>
          <DeactivateDate>dateTime</DeactivateDate>
          <ItemAttributes>
            <int>int</int>
            <int>int</int>
          </ItemAttributes>
          <Description>string</Description>
          <PaymentCondition>string</PaymentCondition>
          <Price>int</Price>
          <Quantity>int</Quantity>
          <AbsoluteQuantity>int</AbsoluteQuantity>
          <ShippingCondition>string</ShippingCondition>
          <Title>string</Title>
          <VAT>int</VAT>
          <ShippingOptions>
            <ItemShipping>
              <ShippingOptionId>int</ShippingOptionId>
              <Cost>int</Cost>
              <ShippingWeight>decimal</ShippingWeight>
              <ShippingProductId>int</ShippingProductId>
              <ShippingProviderId>int</ShippingProviderId>
            </ItemShipping>
            <ItemShipping>
              <ShippingOptionId>int</ShippingOptionId>
              <Cost>int</Cost>
              <ShippingWeight>decimal</ShippingWeight>
              <ShippingProductId>int</ShippingProductId>
              <ShippingProviderId>int</ShippingProviderId>
            </ItemShipping>
          </ShippingOptions>
          <PaymentOptionIds>
            <int>int</int>
            <int>int</int>
          </PaymentOptionIds>
          <OwnReferences>
            <string>string</string>
            <string>string</string>
          </OwnReferences>
          <ItemImages>
            <ItemImageData>
              <HasMega>boolean</HasMega>
              <Format>Gif or Jpeg or Png</Format>
              <Data>base64Binary</Data>
              <Name>string</Name>
            </ItemImageData>
            <ItemImageData>
              <HasMega>boolean</HasMega>
              <Format>Gif or Jpeg or Png</Format>
              <Data>base64Binary</Data>
              <Name>string</Name>
            </ItemImageData>
          </ItemImages>
          <ExternalId>int</ExternalId>
          <AttributeValues>
            <Terms>
              <TermValues>
                <Id>int</Id>
                <Values xsi:nil="true" />
              </TermValues>
              <TermValues>
                <Id>int</Id>
                <Values xsi:nil="true" />
              </TermValues>
            </Terms>
            <Numbers>
              <NumberValues>
                <Id>int</Id>
                <Values xsi:nil="true" />
              </NumberValues>
              <NumberValues>
                <Id>int</Id>
                <Values xsi:nil="true" />
              </NumberValues>
            </Numbers>
          </AttributeValues>
          <DescriptionLanguageCodeIso2>string</DescriptionLanguageCodeIso2>
        </ItemData>
      </updateData>
    </UpdateShopItem>
  </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <UpdateShopItemResponse xmlns="http://api.tradera.com">
      <UpdateShopItemResult>
        <RequestId>int</RequestId>
        <ItemId>int</ItemId>
      </UpdateShopItemResult>
    </UpdateShopItemResponse>
  </soap12:Body>
</soap12:Envelope>

XHTML CSS