Trading_VerifyAddItemResponseType Class Reference
Inherits from | Trading_AbstractResponseType : NSObject |
Declared in | Trading_VerifyAddItemResponseType.h Trading_VerifyAddItemResponseType.m |
Overview
Returns the estimated fees that would be applicable for a new listing
(were the item actually listed to eBay with AddItem).
@ingroup EBayAPIInterface
Tasks
-
itemID
Represents the item ID for the new listing. VerifyAddItem does not
property
actually list an item, so 0 is returned instead of a normal item ID.
Note:
Although we represent item IDs as strings in the schema, we recommend you store
them as 64-bit signed integers. If you choose to store item IDs as strings,
allocate at least 19 characters (assuming decimal digits are used) to hold them.
eBay will increase the size of IDs over time. Your code should be prepared to
handle IDs of up to 19 digits. For more information about item IDs, see
Common FAQs on eBay Item IDs and other eBay IDs in the Knowledge Base.
-
fees
Child Fee containers provide the listing feature names, fees, and possible discounts
property
for the new item listing. The fees do not include the Final Value Fee (FVF), which
cannot be determined until an item is sold.
There is no guarantee that a PromotionalDiscount returned with VerifyAddItem will
be realized when the seller uses AddItem to list the same item. This is the result
of the timing of certain promotions.
Note:
Starting with version 619, the behavior of VerifyAddItem changed to match that of
AddItem. With a request version of 619 or higher, the value of Fees.Fee.Fee
for VerifyAddItem represents the actual cost of the respective feature, with any
discounts subtracted from the posted feature price. With a request version lower
than 619, VerifyAddItem returns the full price of the feature in the Fee element,
regardless of whether or not a discount was applied.
-
expressListing
Indicates whether the item would be listed on eBay Express.
property
See ExpressItemRequirements for hints about why this
value is true or false for a given item. -
expressItemRequirements
Contains details about why an item does or doesn't
property
qualify as an eBay Express listing. Only returned when
IncludeExpressRequirements is true the request.
The item requirements are assessed in this order:
- SellerExpressEligible
- ExpressOptOut
- ExpressApproved
- All other settings -
categoryID
ID of the primary category in which the item would be listed.
property
Only returned if you set Item.CategoryMappingAllowed to true in the request
and the ID you passed in PrimaryCategory was mapped to a new ID by eBay.
If the primary category has not changed or it has expired with no replacement,
CategoryID does not return a value. -
category2ID
ID of the secondary category in which the item would be listed.
property
Only returned if you set Item.CategoryMappingAllowed to true in the request
and the ID you passed in SecondaryCategory was mapped to a new ID by eBay.
If the secondary category has not changed or it has expired with no replacement,
Category2ID does not return a value. -
discountReason
The nature of the discount, if a discount would have applied
property
had this actually been listed at this time. -
productSuggestions
Provides a list of products recommended by eBay which match the item information
property
provided by the seller.
Not applicable to Half.com.
Properties
category2ID
ID of the secondary category in which the item would be listed.
Only returned if you set Item.CategoryMappingAllowed to true in the request
and the ID you passed in SecondaryCategory was mapped to a new ID by eBay.
If the secondary category has not changed or it has expired with no replacement,
Category2ID does not return a value.
@property (nonatomic, retain) NSString *category2ID
Discussion
ID of the secondary category in which the item would be listed.
Only returned if you set Item.CategoryMappingAllowed to true in the request
and the ID you passed in SecondaryCategory was mapped to a new ID by eBay.
If the secondary category has not changed or it has expired with no replacement,
Category2ID does not return a value.
type : NSString, wrapper for primitive string
Declared In
Trading_VerifyAddItemResponseType.h
categoryID
ID of the primary category in which the item would be listed.
Only returned if you set Item.CategoryMappingAllowed to true in the request
and the ID you passed in PrimaryCategory was mapped to a new ID by eBay.
If the primary category has not changed or it has expired with no replacement,
CategoryID does not return a value.
@property (nonatomic, retain) NSString *categoryID
Discussion
ID of the primary category in which the item would be listed.
Only returned if you set Item.CategoryMappingAllowed to true in the request
and the ID you passed in PrimaryCategory was mapped to a new ID by eBay.
If the primary category has not changed or it has expired with no replacement,
CategoryID does not return a value.
type : NSString, wrapper for primitive string
Declared In
Trading_VerifyAddItemResponseType.h
discountReason
The nature of the discount, if a discount would have applied
had this actually been listed at this time.
@property (nonatomic, retain) NSMutableArray *discountReason
Discussion
The nature of the discount, if a discount would have applied
had this actually been listed at this time.
entry type : string constant in Trading_DiscountReasonCodeType.h
Declared In
Trading_VerifyAddItemResponseType.h
expressItemRequirements
Contains details about why an item does or doesn't
qualify as an eBay Express listing. Only returned when
IncludeExpressRequirements is true the request.
The item requirements are assessed in this order:
- SellerExpressEligible
- ExpressOptOut
- ExpressApproved
- All other settings
@property (nonatomic, retain) Trading_ExpressItemRequirementsType *expressItemRequirements
Discussion
Contains details about why an item does or doesn't
qualify as an eBay Express listing. Only returned when
IncludeExpressRequirements is true the request.
The item requirements are assessed in this order:
- SellerExpressEligible
- ExpressOptOut
- ExpressApproved
- All other settings
type : class Trading_ExpressItemRequirementsType
Declared In
Trading_VerifyAddItemResponseType.h
expressListing
Indicates whether the item would be listed on eBay Express.
See ExpressItemRequirements for hints about why this
value is true or false for a given item.
@property (nonatomic, retain) NSNumber *expressListing
Discussion
Indicates whether the item would be listed on eBay Express.
See ExpressItemRequirements for hints about why this
value is true or false for a given item.
type : NSNumber, wrapper for primitive bool
Declared In
Trading_VerifyAddItemResponseType.h
fees
Child Fee containers provide the listing feature names, fees, and possible discounts
for the new item listing. The fees do not include the Final Value Fee (FVF), which
cannot be determined until an item is sold.
There is no guarantee that a PromotionalDiscount returned with VerifyAddItem will
be realized when the seller uses AddItem to list the same item. This is the result
of the timing of certain promotions.
Note:
Starting with version 619, the behavior of VerifyAddItem changed to match that of
AddItem. With a request version of 619 or higher, the value of Fees.Fee.Fee
for VerifyAddItem represents the actual cost of the respective feature, with any
discounts subtracted from the posted feature price. With a request version lower
than 619, VerifyAddItem returns the full price of the feature in the Fee element,
regardless of whether or not a discount was applied.
@property (nonatomic, retain) Trading_FeesType *fees
Discussion
Child Fee containers provide the listing feature names, fees, and possible discounts
for the new item listing. The fees do not include the Final Value Fee (FVF), which
cannot be determined until an item is sold.
There is no guarantee that a PromotionalDiscount returned with VerifyAddItem will
be realized when the seller uses AddItem to list the same item. This is the result
of the timing of certain promotions.
Note:
Starting with version 619, the behavior of VerifyAddItem changed to match that of
AddItem. With a request version of 619 or higher, the value of Fees.Fee.Fee
for VerifyAddItem represents the actual cost of the respective feature, with any
discounts subtracted from the posted feature price. With a request version lower
than 619, VerifyAddItem returns the full price of the feature in the Fee element,
regardless of whether or not a discount was applied.
type : class Trading_FeesType
Declared In
Trading_VerifyAddItemResponseType.h
itemID
Represents the item ID for the new listing. VerifyAddItem does not
actually list an item, so 0 is returned instead of a normal item ID.
Note:
Although we represent item IDs as strings in the schema, we recommend you store
them as 64-bit signed integers. If you choose to store item IDs as strings,
allocate at least 19 characters (assuming decimal digits are used) to hold them.
eBay will increase the size of IDs over time. Your code should be prepared to
handle IDs of up to 19 digits. For more information about item IDs, see
Common FAQs on eBay Item IDs and other eBay IDs in the Knowledge Base.
@property (nonatomic, retain) NSString *itemID
Discussion
Represents the item ID for the new listing. VerifyAddItem does not
actually list an item, so 0 is returned instead of a normal item ID.
Note:
Although we represent item IDs as strings in the schema, we recommend you store
them as 64-bit signed integers. If you choose to store item IDs as strings,
allocate at least 19 characters (assuming decimal digits are used) to hold them.
eBay will increase the size of IDs over time. Your code should be prepared to
handle IDs of up to 19 digits. For more information about item IDs, see
Common FAQs on eBay Item IDs and other eBay IDs in the Knowledge Base.
type : NSString, wrapper for primitive string
Declared In
Trading_VerifyAddItemResponseType.h
productSuggestions
Provides a list of products recommended by eBay which match the item information
provided by the seller.
Not applicable to Half.com.
@property (nonatomic, retain) Trading_ProductSuggestionsType *productSuggestions
Discussion
Provides a list of products recommended by eBay which match the item information
provided by the seller.
Not applicable to Half.com.
type : class Trading_ProductSuggestionsType
Declared In
Trading_VerifyAddItemResponseType.h