Wrapper class of the GetItem call of eBay SOAP API.
Title: SOAP API wrapper library.
Description: Contains wrapper classes for eBay SOAP APIs.
Copyright: Copyright (c) 2009
Company: eBay Inc.
Input property: ItemID
- Specifies the
ItemID that uniquely identifies the item listing for which to retrieve the data.
ItemID is a required input in most cases.
SKU can be used instead in certain cases (see the description of SKU). If both
ItemID and
SKU are specified for items where the inventory tracking method is
ItemID,
ItemID takes precedence.
Input property: IncludeWatchCount
- Indicates if the caller wants to include watch count for that item in the response. You must be the seller of the item to retrieve the watch count.
Input property: IncludeCrossPromotion
- This flag should no longer be used as eBay Store Cross Promotions are no longer supported by the Trading API.
Specifies whether or not to include cross-promotion information for the item in the call response.
Input property: IncludeItemSpecifics
- If
true
, the response returns the
ItemSpecifics node (if the listing has custom Item Specifics).
Item Specifics are well-known aspects of items in a given category. For example, items in a washer and dryer category might have an aspect like Type=Top-Loading; whereas items in a jewelry category might have an aspect like Gemstone=Amber.
Including this field set to
true
also returns the
UnitInfo node, which enables European Union sellers to provide the required price-per-unit information so buyers can accurately compare prices for certain types of products.
(This does not cause the response to include ID-based attributes. To also retrieve ID-based attributes, pass
DetailLevel in the request with the value
ItemReturnAttributes or
ReturnAll.)
Input property: IncludeTaxTable
- If true, an associated tax table is returned in the response. If no tax table is associated with the item, then no tax table is returned, even if
IncludeTaxTable is set to true.
Input property: SKU
- Retrieves an item that was listed by the user identified in AuthToken and that is being tracked by this SKU.
A SKU (stock keeping unit) is an identifier defined by a seller. Some sellers use SKUs to track complex flows of products and information on the client side. eBay preserves the SKU on the item, enabling you to obtain it before and after an order line item is created. (SKU is recommended as an alternative to ApplicationData.)
In
GetItem,
SKU can only be used to retrieve one of your own items, where you listed the item by using
AddFixedPriceItem or
RelistFixedPriceItem, and you set
Item.InventoryTrackingMethod to
SKU at the time the item was listed. (These criteria are necessary to uniquely identify the listing by a SKU.)
Either
ItemID or
SKU is required in the request. If both are passed, they must refer to the same item, and that item must have
InventoryTrackingMethod set to
SKU.
Input property: VariationSKU
- Variation-level SKU that uniquely identifes a Variation within the listing identified by
ItemID. Only applicable when the seller listed the item with Variation-level SKU (
Variation.SKU) values. Retrieves all the usual
Item fields, but limits the
Variations content to the specified Variation. If not specified, the response includes all Variations.
Input property: VariationSpecifics
- Name-value pairs that identify one or more Variations within the listing identified by
ItemID. Only applicable when the seller listed the item with Variations. Retrieves all the usual
Item fields, but limits the Variations content to the specified Variation(s). If the specified pairs do not match any Variation, eBay returns all Variations.
To retrieve only one variation, specify the full set of name/value pairs that match all the name-value pairs of one Variation.
To retrieve multiple variations (using a wildcard), specify one or more name/value pairs that partially match the desired variations. For example, if the listing contains Variations for shirts in different colors and sizes, specify Color as Red (and no other name/value pairs) to retrieve all the red shirts in all sizes (but no other colors).
Input property: TransactionID
- A unique identifier for an order line item (transaction). An order line item is created when a buyer commits to purchasing an item.
Since you can change active multiple-quantity fixed-price listings even after one of the items has been purchased, the
TransactionID is associated with a snapshot of the item data at the time of the purchase.
After one item in a multi-quantity listing has been sold, sellers can not change the values in the Title, Primary Category, Secondary Category, Listing Duration, and Listing Type fields. However, all other fields are editable.
Specifying a
TransactionID in the
GetItem request allows you to retrieve a snapshot of the listing as it was when the order line item was created.
Input property: IncludeItemCompatibilityList
- This field is used to specify whether to retrieve Parts Compatiblity information. If
true
, any compatible applications associated with the item will be returned in the response (
Item.ItemCompatibilityList). If no compatible applications have been specified for the item, no item compatibilities will be returned.
If
false
or not specified, the response will return a compatibility count (
ItemCompatibilityCount) when parts compatibilities have been specified for the item.
Parts Compatibility is supported in limited Parts & Accessories categories, for the eBay US Motors (100), UK (3), AU (15) and DE (77) sites only.
Output property: ReturnedItem
- ItemType object that contains the data for the specified item.
@author Ron Murphy
@version 1.0