Changes since
the last release

com.ebay.sdk.call
Class VerifyAddFixedPriceItemCall

java.lang.Object
  extended by com.ebay.sdk.ApiCall
      extended by com.ebay.sdk.call.VerifyAddFixedPriceItemCall

public class VerifyAddFixedPriceItemCall
extends ApiCall

Wrapper class of the VerifyAddFixedPriceItem 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: Item - Root container holding all values that define a new fixed-price listing.
Output property: ReturnedItemID - Represents the item ID for the new fixed-price listing. VerifyAddFixedPriceItem does not actually list an item, so 0 is returned instead of a normal item ID.
Output property: ReturnedSKU - Item-level SKU for the new listing, if the seller specified tem.SKU in the request. Variation SKUs are not returned (see GetItem instead).
Output property: ReturnedFees - Child elements contain the estimated listing fees for the new item listing. The fees do not include the Final Value Fee (FVF), which cannot be determined until an item is sold.
Output property: ReturnedExpressListing - This field is deprecated.
Output property: ReturnedExpressItemRequirements - This field is deprecated.
Output property: ReturnedCategoryID - 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.
Output property: ReturnedCategory2ID - 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.
Output property: ReturnedDiscountReason - The nature of the discount, if a discount would have applied had this actually been listed at this time.
Output property: ReturnedListingRecommendations - Container consisting of one or more Recommendation containers. Each Recommendation container provides a message to the seller on how a listing can be improved or brought up to standard in regards to top-rated seller/listing requirements, mandated or recommended Item Specifics, picture quality requirements, pricing and/or listing format recommendations, recommended keywords and/or Item Specifics in a Title, and/or a recommendation to offer fast handling (same-day handling or handling time of 1 day) and/or a free shipping option in order to qualify the listing for a Fast 'N Free badge.

This container is only returned if the IncludeRecommendations flag was included and set to 'true' in the VerifyAddFixedPriceItem request, and if at least one listing recommendation exists for the listing about to be listed. If one or more listing recommendations are returned, it will be at the seller's discretion about whether to revise the listing based on eBay's listing recommendation(s) before actually creating the listing through an AddFixedPriceItem call.

Version:
1.0
Author:
Ron Murphy

Field Summary
 
Fields inherited from class com.ebay.sdk.ApiCall
apiException, sendReqListeners
 
Constructor Summary
VerifyAddFixedPriceItemCall()
          Constructor.
VerifyAddFixedPriceItemCall(ApiContext apiContext)
          Constructor.
 
Method Summary
 ItemType getItem()
          Gets the VerifyAddFixedPriceItemRequestType.item.
 java.lang.String[] getPictureFiles()
          Gets list of picture files for the item.
 java.lang.String getReturnedCategory2ID()
          Valid after executing the API.
 java.lang.String getReturnedCategoryID()
          Valid after executing the API.
 DiscountReasonCodeType[] getReturnedDiscountReason()
          Valid after executing the API.
 ExpressItemRequirementsType getReturnedExpressItemRequirements()
          Valid after executing the API.
 java.lang.Boolean getReturnedExpressListing()
          Valid after executing the API.
 FeesType getReturnedFees()
          Valid after executing the API.
 java.lang.String getReturnedItemID()
          Valid after executing the API.
 ListingRecommendationsType getReturnedListingRecommendations()
          Valid after executing the API.
 java.lang.String getReturnedSKU()
          Valid after executing the API.
 void setItem(ItemType item)
          Sets the VerifyAddFixedPriceItemRequestType.item.
 void setPictureFiles(java.lang.String[] pictureFiles)
          Sets list of picture files for the item.
 FeesType verifyAddFixedPriceItem()
          Enables a seller to test the definition of a new fixed-price listing by submitting the definition to eBay without creating an actual listing.
 FeesType verifyAddFixedPriceItem(ItemType item)
          Executes the API call.
 
Methods inherited from class com.ebay.sdk.ApiCall
addDetailLevel, addSendRequestListener, execute, executeByApiName, getApiContext, getApiException, getBotBlock, getCallRetry, getDetailLevel, getEnableCompression, getEndUserIP, getErrorHandling, getInvocationID, getMessageID, getOutputSelector, getRequestXml, getResponseObject, getResponseXml, getSite, getWarningLevel, hasError, hasWarning, isEnableoAuthTokenHTTPHeader, removeSendRequestListener, setApiContext, setBotBlock, setCallRetry, setDetailLevel, setEnableCompression, setEnableoAuthTokenHTTPHeader, setEndUserIP, setErrorHandling, setInvocationID, setMessageID, setOutputSelector, setSite, setWarningLevel
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

VerifyAddFixedPriceItemCall

public VerifyAddFixedPriceItemCall()
Constructor.


VerifyAddFixedPriceItemCall

public VerifyAddFixedPriceItemCall(ApiContext apiContext)
Constructor.

Parameters:
apiContext - The ApiContext object to be used to make the call.
Method Detail

verifyAddFixedPriceItem

public FeesType verifyAddFixedPriceItem()
                                 throws ApiException,
                                        SdkException,
                                        java.lang.Exception
Enables a seller to test the definition of a new fixed-price listing by submitting the definition to eBay without creating an actual listing.

Returns:
The FeesType object.
Throws:
ApiException
SdkException
java.lang.Exception

getItem

public ItemType getItem()
Gets the VerifyAddFixedPriceItemRequestType.item.

Returns:
ItemType

setItem

public void setItem(ItemType item)
Sets the VerifyAddFixedPriceItemRequestType.item.

Parameters:
item - ItemType

getPictureFiles

public java.lang.String[] getPictureFiles()
Gets list of picture files for the item.

Returns:
String[]

setPictureFiles

public void setPictureFiles(java.lang.String[] pictureFiles)
Sets list of picture files for the item. Before listing the item, the attached picture service object (setPictureService()) to upload these picture files then set the picture property of the item object.

Parameters:
pictureFiles - String[]

verifyAddFixedPriceItem

public FeesType verifyAddFixedPriceItem(ItemType item)
                                 throws ApiException,
                                        SdkException,
                                        java.lang.Exception
Executes the API call. The picture files that you provided will not be uploaded and some dummy urls will be used instead.

Parameters:
item - ItemType
Returns:
FeesType The estimated fees information.
Throws:
ApiException
SdkException
java.lang.Exception

getReturnedCategory2ID

public java.lang.String getReturnedCategory2ID()
Valid after executing the API. Gets the returned VerifyAddFixedPriceItemResponseType.returnedCategory2ID.

Returns:
String

getReturnedCategoryID

public java.lang.String getReturnedCategoryID()
Valid after executing the API. Gets the returned VerifyAddFixedPriceItemResponseType.returnedCategoryID.

Returns:
String

getReturnedDiscountReason

public DiscountReasonCodeType[] getReturnedDiscountReason()
Valid after executing the API. Gets the returned VerifyAddFixedPriceItemResponseType.returnedDiscountReason.

Returns:
DiscountReasonCodeType[]

getReturnedExpressItemRequirements

public ExpressItemRequirementsType getReturnedExpressItemRequirements()
Valid after executing the API. Gets the returned VerifyAddFixedPriceItemResponseType.returnedExpressItemRequirements.

Returns:
ExpressItemRequirementsType

getReturnedExpressListing

public java.lang.Boolean getReturnedExpressListing()
Valid after executing the API. Gets the returned VerifyAddFixedPriceItemResponseType.returnedExpressListing.

Returns:
Boolean

getReturnedFees

public FeesType getReturnedFees()
Valid after executing the API. Gets the returned VerifyAddFixedPriceItemResponseType.returnedFees.

Returns:
FeesType

getReturnedItemID

public java.lang.String getReturnedItemID()
Valid after executing the API. Gets the returned VerifyAddFixedPriceItemResponseType.returnedItemID.

Returns:
String

getReturnedListingRecommendations

public ListingRecommendationsType getReturnedListingRecommendations()
Valid after executing the API. Gets the returned VerifyAddFixedPriceItemResponseType.returnedListingRecommendations.

Returns:
ListingRecommendationsType

getReturnedSKU

public java.lang.String getReturnedSKU()
Valid after executing the API. Gets the returned VerifyAddFixedPriceItemResponseType.returnedSKU.

Returns:
String

Changes since
the last release

The information contained in this document is proprietary and confidential. Use of this information and the eBay API requires a Non-Disclosure Agreement (NDA) between the user and eBay Inc. For information regarding a qualifying NDA, contact Developer Relations: developer-relations@ebay.com
© 2004-2009 eBay Inc. All rights reserved.