Tradera Developer Program

RestrictedService

Documentation Version 3 > RestrictedService > AddShopItem

AddShopItem |WebMethod|

This API method is used to create new Shop item on Tradera. This is an asynchronous call which
means that the provided ShopItemData data will go through a first step validation and
then be added to a processing queue. The method will then return.

The item will be processed as soon as possible depending on the current system load. To be certain
that the item was successfully added on Tradera the method GetRequestResults needs
to be called to verify the final result of the request (see RequestResult ).

Parameters
  1. shopItemData, Shop item data
Returns

Response data ( QueuedRequestResponse ) with request id and item id. The item id is the id of the new shop item 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. ha

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/AddShopItem"

<?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>
    <AddShopItem xmlns="http://api.tradera.com">
      <shopItemData>
        <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>
                <string>string</string>
                <string>string</string>
              </Values>
            </TermValues>
            <TermValues>
              <Id>int</Id>
              <Values>
                <string>string</string>
                <string>string</string>
              </Values>
            </TermValues>
          </Terms>
          <Numbers>
            <NumberValues>
              <Id>int</Id>
              <Values>
                <decimal>decimal</decimal>
                <decimal>decimal</decimal>
              </Values>
            </NumberValues>
            <NumberValues>
              <Id>int</Id>
              <Values>
                <decimal>decimal</decimal>
                <decimal>decimal</decimal>
              </Values>
            </NumberValues>
          </Numbers>
        </AttributeValues>
        <DescriptionLanguageCodeIso2>string</DescriptionLanguageCodeIso2>
      </shopItemData>
    </AddShopItem>
  </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>
    <AddShopItemResponse xmlns="http://api.tradera.com">
      <AddShopItemResult>
        <RequestId>int</RequestId>
        <ItemId>int</ItemId>
      </AddShopItemResult>
    </AddShopItemResponse>
  </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>
    <AddShopItem xmlns="http://api.tradera.com">
      <shopItemData>
        <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>
                <string>string</string>
                <string>string</string>
              </Values>
            </TermValues>
            <TermValues>
              <Id>int</Id>
              <Values>
                <string>string</string>
                <string>string</string>
              </Values>
            </TermValues>
          </Terms>
          <Numbers>
            <NumberValues>
              <Id>int</Id>
              <Values>
                <decimal>decimal</decimal>
                <decimal>decimal</decimal>
              </Values>
            </NumberValues>
            <NumberValues>
              <Id>int</Id>
              <Values>
                <decimal>decimal</decimal>
                <decimal>decimal</decimal>
              </Values>
            </NumberValues>
          </Numbers>
        </AttributeValues>
        <DescriptionLanguageCodeIso2>string</DescriptionLanguageCodeIso2>
      </shopItemData>
    </AddShopItem>
  </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>
    <AddShopItemResponse xmlns="http://api.tradera.com">
      <AddShopItemResult>
        <RequestId>int</RequestId>
        <ItemId>int</ItemId>
      </AddShopItemResult>
    </AddShopItemResponse>
  </soap12:Body>
</soap12:Envelope>

XHTML CSS