Changes since
the last release

com.ebay.sdk.call
Class ReviseSellingManagerSaleRecordCall

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

public class ReviseSellingManagerSaleRecordCall
extends ApiCall

Wrapper class of the ReviseSellingManagerSaleRecord 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 - Unique identifier for an eBay listing. A listing can have multiple order line items, but only one ItemID value. An ItemID can be paired up with a corresponding TransactionID and used as an input filter for ReviseSellingManagerSaleRecord. The ItemID/TransactionID pair corresponds to a Selling Manager SaleRecordID, which can be retrieved with the GetSellingManagerSaleRecord call.

Unless an OrderLineItemID is used to identify an order line item, or the OrderID is used to identify an order, the ItemID/TransactionID pair must be specified. If OrderID or OrderLineItemID are specified, the ItemID/TransactionID pair is ignored if present in the same request.
Input property: TransactionID - Unique identifier for an eBay sales transaction. This identifier is created once there is a commitment to buy (bidder wins the auction, buyer clicks buy button, or buyer purchases item through PlaceOffer call). Since an auction listing can only have one sales transaction during the duration of the listing, the TransactionID value for auction listings is always 0.

The ItemID/TransactionID pair can be used to identify an order line item in a ReviseSellingManagerSaleRecord call. The ItemID/TransactionID pair corresponds to a Selling Manager SaleRecordID, which can be retrieved with the GetSellingManagerSaleRecord call.

Unless an OrderLineItemID is used to identify an order line item, or the OrderID is used to identify an order, the ItemID/TransactionID pair must be specified. If OrderID or OrderLineItemID are specified, the ItemID/TransactionID pair is ignored if present in the same request.
Input property: OrderID - A unique identifier that identifies a single line item or multiple line item order associated with the Selling Manager sale record(s).

If an OrderID is used in the request, the OrderLineItemID and ItemID/TransactionID pair are ignored if they are specified in the same request.

Note: As of June 2019, eBay has changed the format of order identifier values. The new format is a non-parsable string, globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. Unlike in the past, instead of just being known and exposed to the seller, these unique order identifiers will also be known and used/referenced by the buyer and eBay customer support.

For developers and sellers who are already integrated with the Trading API's order management calls, this change shouldn't impact your integration unless you parse the existing order identifiers (e.g., OrderID or OrderLineItemID), or otherwise infer meaning from the format (e.g., differentiating between a single line item order versus a multiple line item order). Because we realize that some integrations may have logic that is dependent upon the old identifier format, eBay is rolling out this Trading API change with version control to support a transition period of approximately 9 months before applications must switch to the new format completely.

During the transition period, for developers/sellers using a Trading WSDL older than Version 1113, they can use the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header in API calls to control whether the new or old OrderID format is returned in call response payloads. To get the new OrderID format, the value of the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header must be set to 1113. During the transition period and even after, the new and old OrderID formats will still be supported/accepted in all Trading API call request payloads. After the transition period (which will be announced), only the new OrderID format will be returned in all Trading API call response payloads, regardless of the Trading WSDL version used or specified compatibility level.

Note: For sellers integrated with the new order ID format, please note that the identifier for an order will change as it goes from unpaid to paid status. When using a ReviseSellingManagerSaleRecord call, either of these order IDs (paid or unpaid status) can be used to update a Sale Record.
Input property: SellingManagerSoldOrder - Container consisting of order costs, shipping details, order status, and other information. The changes made under this container will update the order in Selling Manager.
Input property: OrderLineItemID - A unique identifier for an eBay order line item. This identifier is created once there is a commitment to buy (bidder wins the auction, buyer clicks buy button, or buyer purchases item through PlaceOffer call).

Unless an ItemID/TransactionID pair is used to identify an order line item, or the OrderID is used to identify an order, the OrderLineItemID must be specified. For a multiple line item order, OrderID should be used. If OrderLineItemID is specified, the ItemID/TransactionID pair are ignored if present in the same request.

Version:
1.0
Author:
Ron Murphy

Field Summary
 
Fields inherited from class com.ebay.sdk.ApiCall
apiException, sendReqListeners
 
Constructor Summary
ReviseSellingManagerSaleRecordCall()
          Constructor.
ReviseSellingManagerSaleRecordCall(ApiContext apiContext)
          Constructor.
 
Method Summary
 java.lang.String getItemID()
          Gets the ReviseSellingManagerSaleRecordRequestType.itemID.
 java.lang.String getOrderID()
          Gets the ReviseSellingManagerSaleRecordRequestType.orderID.
 java.lang.String getOrderLineItemID()
          Gets the ReviseSellingManagerSaleRecordRequestType.orderLineItemID.
 SellingManagerSoldOrderType getSellingManagerSoldOrder()
          Gets the ReviseSellingManagerSaleRecordRequestType.sellingManagerSoldOrder.
 java.lang.String getTransactionID()
          Gets the ReviseSellingManagerSaleRecordRequestType.transactionID.
 void reviseSellingManagerSaleRecord()
          Request type containing the input fields for the ReviseSellingManagerSaleRecord call.
 void setItemID(java.lang.String itemID)
          Sets the ReviseSellingManagerSaleRecordRequestType.itemID.
 void setOrderID(java.lang.String orderID)
          Sets the ReviseSellingManagerSaleRecordRequestType.orderID.
 void setOrderLineItemID(java.lang.String orderLineItemID)
          Sets the ReviseSellingManagerSaleRecordRequestType.orderLineItemID.
 void setSellingManagerSoldOrder(SellingManagerSoldOrderType sellingManagerSoldOrder)
          Sets the ReviseSellingManagerSaleRecordRequestType.sellingManagerSoldOrder.
 void setTransactionID(java.lang.String transactionID)
          Sets the ReviseSellingManagerSaleRecordRequestType.transactionID.
 
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

ReviseSellingManagerSaleRecordCall

public ReviseSellingManagerSaleRecordCall()
Constructor.


ReviseSellingManagerSaleRecordCall

public ReviseSellingManagerSaleRecordCall(ApiContext apiContext)
Constructor.

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

reviseSellingManagerSaleRecord

public void reviseSellingManagerSaleRecord()
                                    throws ApiException,
                                           SdkException,
                                           java.lang.Exception
Request type containing the input fields for the ReviseSellingManagerSaleRecord call. The standard Trading API deprecation process is not applicable to this call. The user must have a Selling Manager Pro subscription to use this call.

Throws:
ApiException
SdkException
java.lang.Exception

getItemID

public java.lang.String getItemID()
Gets the ReviseSellingManagerSaleRecordRequestType.itemID.

Returns:
String

setItemID

public void setItemID(java.lang.String itemID)
Sets the ReviseSellingManagerSaleRecordRequestType.itemID.

Parameters:
itemID - String

getOrderID

public java.lang.String getOrderID()
Gets the ReviseSellingManagerSaleRecordRequestType.orderID.

Returns:
String

setOrderID

public void setOrderID(java.lang.String orderID)
Sets the ReviseSellingManagerSaleRecordRequestType.orderID.

Parameters:
orderID - String

getOrderLineItemID

public java.lang.String getOrderLineItemID()
Gets the ReviseSellingManagerSaleRecordRequestType.orderLineItemID.

Returns:
String

setOrderLineItemID

public void setOrderLineItemID(java.lang.String orderLineItemID)
Sets the ReviseSellingManagerSaleRecordRequestType.orderLineItemID.

Parameters:
orderLineItemID - String

getSellingManagerSoldOrder

public SellingManagerSoldOrderType getSellingManagerSoldOrder()
Gets the ReviseSellingManagerSaleRecordRequestType.sellingManagerSoldOrder.

Returns:
SellingManagerSoldOrderType

setSellingManagerSoldOrder

public void setSellingManagerSoldOrder(SellingManagerSoldOrderType sellingManagerSoldOrder)
Sets the ReviseSellingManagerSaleRecordRequestType.sellingManagerSoldOrder.

Parameters:
sellingManagerSoldOrder - SellingManagerSoldOrderType

getTransactionID

public java.lang.String getTransactionID()
Gets the ReviseSellingManagerSaleRecordRequestType.transactionID.

Returns:
String

setTransactionID

public void setTransactionID(java.lang.String transactionID)
Sets the ReviseSellingManagerSaleRecordRequestType.transactionID.

Parameters:
transactionID - 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.