Tradera.com API Documentation - [WebService] RestrictedService

Services that require authorization from the Tradera user being impersonated.

The following operations are supported. For a formal definition, please review the Service Description.

AddItem
Adds an ItemRequest to the queue.
If uploading images, set the property AutoCommit to false, call AddItemImage for every image, and then
call AddItemCommit after the last image.
Parameters
1. itemRequest, Object containing the values for the new Item
Returns
The reserved Id of the Item request
Tutorials
- Adding an Item (Auction)
- Adding an Item (Tradera Direct)
AddItemCommit
Commits the Item-request so that it can be processed into the Tradera system.
Call this method after uploading all images.
Parameters
1. itemId, The reserved Id of an Item request, created with a call to AddItem or AddItemXml
Tutorials
- Adding an Item (Auction)
- Adding an Item (Tradera Direct)
AddItemImage
Uploads an image, and attaches it to a previously created ItemRequest .
Please note that the ItemRequest must be set to AutoCommit == false.
Parameters
1. itemId, The reserved Id of an Item request, created with a call to AddItem or AddItemXml
2. imageData, The image data, including file headers and so on
3. imageFormat, The type/format of image being uploaded
4. hasMega, If the image should have a Mega-image (extra large)
Tutorials
- Adding an Item (Auction)
- Adding an Item (Tradera Direct)

Adds an ItemRequest to the queue, using an XML string. SOAP clients are encouraged to use the AddItem method instead.
If uploading images, set the element AutoCommit to false, call AddItemImage for every image, and then
call AddItemCommit after the last image. For more information about the different elements in the Request XML,
see the ItemRequest class.

Parameters

createItemRequestXml, XML data containing the values for the new Item. XML format:


            <CreateItemRequest>

            	<Title>string</Title>	

            	<OwnRef>string</OwnRef>

            	<CategoryId>int</CategoryId>

            	<Duration>int</Duration>

            	<Restarts>int</Restarts>

            	<StartPrice>int</StartPrice>

            	<ReservePrice>int</ReservePrice>

            	<BuyItNowPrice>int</BuyItNowPrice>

            	<Description>string</Description>

            	<PaymentOptionId>int</PaymentOptionId>

            	<ShippingOptionId>int</ShippingOptionId>

            	<AcceptedBidderId>int</AcceptedBidderId>

            	<AutoCommit>bool</AutoCommit>

             

            	<ExpoItemIds>

            		<ExpoItemId>int</ExpoItemId>

            		<ExpoItemId>int</ExpoItemId>

            	</ExpoItemIds>

             

            	<InternetPaymentIds>

            		<InternetPaymentId>int</InternetPaymentId>

            		<InternetPaymentId>int</InternetPaymentId>

            	</InternetPaymentIds>

             

             <BuyerPaysShippingType>int</BuyerPaysShippingType>

             <BuyerPaysShippingCost>int</BuyerPaysShippingCost>

             <ItemType>int</ItemType>

             <StartQuantity>int</StartQuantity>

            

            </CreateItemRequest>

See the ItemRequest class for a description of the parameters.

Returns

The reserved Id of the Item request

EndItem
Ends an Item immediately if no bids, or if the type is Direct.
Parameters
1. itemId, The Id of the Item to end
Returns
True if the Item was ended, otherwise false
GetItem
Gets an Item for the current seller.
Parameters
1. itemId, The Id of the Item (auction)
Returns
Item (auction) object
GetItemFees
Gets the fees for an Item.
Parameters
1. itemId, The Id of the item
Returns
Array of Fee objects
GetSellerItems
Gets items for the current seller.
Parameters
1. categoryId, The Id of the category to look for items in (use 0 for all categories)
2. filterType, The filter to use:
  0 = All (max 60 days old items),
  1 = Only active items (EndDate > NOW),
  2 = Only inactive items (EndDate < NOW)
  
  Can be overridden with either the minEndDate or maxEndate parameters.
3. minEndDate, Will return items with EndDate > than this parameter.
  Either send NULL or a DateTime <= DateTime.MinValue (0001-01-01 00:00:00) if not used.
  Note that no items older than 60 days will be returned regardless of minEndDate sent.
4. maxEndDate, Will return items with EndDate < than this parameter.
  Either send NULL or a DateTime >= DateTime.MaxValue (9999-12-31 00:00:00) if not used.
Returns
Array of items
Tutorials
- Using the RestrictedService
GetSellerTransactions
Returns all transactions that have taken place within the specified constraints.
Parameters
1. minTransactionDate, Will return items with transaction date > than this parameter.
  Either send NULL or a DateTime <= DateTime.MinValue (0001-01-01 00:00:00) if not used.
  Note that no transactions older than 60 days will be returned regardless of minEndDate sent.
2. maxTransactionDate, Will return items with maxTransactionDate < than this parameter.
  Either send NULL or a DateTime >= DateTime.MaxValue (9999-12-31 00:00:00) if not used.
Returns
Array of Transaction objects
LeaveFeedback
Leaves feedback for a transaction. If impersonated user is seller,
leaves feedback for the buyer, otherwise leaves feedback for the seller.
Parameters
1. transactionId, The transaction to leave feedback for
2. comment, A freetext comment (80 characters)
3. type, Positive or negative feedback
Returns
True if feedback was inserted, false if auction
has not ended or feedback already left
MarkTransactionPaid
Marks a transaction as paid.
Parameters
1. transactionId, The Id of the transaction
MarkTransactionSent
Marks a transaction as sent.
Parameters
1. transactionId, The Id of the transaction

Tradera Developer Program

RestrictedService