Changes since
the last release

com.ebay.sdk.call
Class ReviseInventoryStatusCall

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

public class ReviseInventoryStatusCall
extends ApiCall

Wrapper class of the ReviseInventoryStatus 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: InventoryStatus - Contains the updated quantity and/or price of a listing being revised. You should not modify the same listing twice (by using a duplicate ItemID or SKU) in the same request; otherwise, you may get an error or unexpected results. (For example, you should not use one InventoryStatus node to update the quantity and another InventoryStatus node to update the price of the same item.) You can pass up to 4 InventoryStatus nodes in a single request.
Output property: ReturnedInventoryStatus - Confirms the quantity and price associated with a listing or variation that was revised.
Output property: ReturnedFees - Child elements contain the estimated listing fees for a listing that was revised. Use the ItemID to correlate the Fees data with the InventoryStatus data in the response. The fees do not include the Final Value Fee (FVF), which can't be determined until the listing has sales.

If you revise a variation in a multi-variation listing, the fees are for the entire listing. The insertion fee and listing fee are affected by the highest priced variation in the listing (which is not necessarily the variation that you passed in the request).

Also note that the call returns only one Fees node per listing. For example, if you revise 4 variations from the same multi-variation listing, the response includes 4 InventoryStatus nodes and 1 Fees node.

Version:
1.0
Author:
Ron Murphy

Field Summary
 
Fields inherited from class com.ebay.sdk.ApiCall
apiException, sendReqListeners
 
Constructor Summary
ReviseInventoryStatusCall()
          Constructor.
ReviseInventoryStatusCall(ApiContext apiContext)
          Constructor.
 
Method Summary
 InventoryStatusType[] getInventoryStatus()
          Gets the ReviseInventoryStatusRequestType.inventoryStatus.
 InventoryFeesType[] getReturnedFees()
          Valid after executing the API.
 InventoryStatusType[] getReturnedInventoryStatus()
          Valid after executing the API.
 InventoryStatusType[] reviseInventoryStatus()
          Enables a seller to change the price and quantity of a currently- active, fixed-price listing.
 void setInventoryStatus(InventoryStatusType[] inventoryStatus)
          Sets the ReviseInventoryStatusRequestType.inventoryStatus.
 
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, removeSendRequestListener, setApiContext, setBotBlock, setCallRetry, setDetailLevel, setEnableCompression, 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

ReviseInventoryStatusCall

public ReviseInventoryStatusCall()
Constructor.


ReviseInventoryStatusCall

public ReviseInventoryStatusCall(ApiContext apiContext)
Constructor.

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

reviseInventoryStatus

public InventoryStatusType[] reviseInventoryStatus()
                                            throws ApiException,
                                                   SdkException,
                                                   Exception
Enables a seller to change the price and quantity of a currently- active, fixed-price listing. Using ReviseInventoryStatus to modify data qualifies as revising the listing.

Inputs are the item IDs or SKUs of the listings being revised, and the price and quantity that are being changed for each revision. Only applicable to fixed-price listings.

Changing the price or quantity of a currently- active, fixed-price listing does not reset the Best Match performance score. For Best Match information related to multi-variation listings, see the Best Match information at the following topic: Multi-quantity Fixed Price listings with variations.

As with all listing calls, the site you specify in the request URL (for SOAP) or the X-EBAY-API-SITEID HTTP header (for XML) should match the original listing's Item.Site value. In particular, this is a best practice when you submit new and revised listings.

For Large Merchant Services users: When you use ReviseInventoryStatus within a Merchant Data file, it must be enclosed within two BulkDataExchangeRequest tags. After release 637, a namespace is returned in the BulkDataExchangeResponseType (top level) of the response. The BulkDataExchange tags are not shown in the call input/output descriptions.

Returns:
The InventoryStatusType[] object.
Throws:
ApiException
SdkException
Exception

getInventoryStatus

public InventoryStatusType[] getInventoryStatus()
Gets the ReviseInventoryStatusRequestType.inventoryStatus.

Returns:
InventoryStatusType[]

setInventoryStatus

public void setInventoryStatus(InventoryStatusType[] inventoryStatus)
Sets the ReviseInventoryStatusRequestType.inventoryStatus.

Parameters:
inventoryStatus - InventoryStatusType[]

getReturnedFees

public InventoryFeesType[] getReturnedFees()
Valid after executing the API. Gets the returned ReviseInventoryStatusResponseType.returnedFees.

Returns:
InventoryFeesType[]

getReturnedInventoryStatus

public InventoryStatusType[] getReturnedInventoryStatus()
Valid after executing the API. Gets the returned ReviseInventoryStatusResponseType.returnedInventoryStatus.

Returns:
InventoryStatusType[]

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.