Changes since
the last release

com.ebay.sdk.call
Class GetOrderTransactionsCall

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

public class GetOrderTransactionsCall
extends ApiCall

Wrapper class of the GetOrderTransactions 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: ItemTransactionIDArray - This container is used if the seller wants to retrieve for one or more order line items. An ItemTransactionID container is required for each order line item that is to be retrieved. An order line item can be identified with an ItemID/TransactionID pair, with an OrderLineItemID value, or with a SKU value (if a SKU is defined for the order line item).
Input property: OrderIDArray - This container is used if the seller wants to search for one or more orders. An OrderID field is required for each order that is to be retrieved. Up to 20 OrderID fields can be used.

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. Sellers can check to see if an order has been paid by looking for a value of 'Complete' in the CheckoutStatus.Status field in the response of GetOrders or GetOrderTransactions call, or in the Status.CompleteStatus field in the response of GetItemTransactions or GetSellerTransactions call. Sellers should not fulfill orders until buyer has made payment. When using a GetOrders or GetOrderTransactions call to retrieve specific order(s), either of these order IDs (paid or unpaid status) can be used to retrieve an order.
Input property: Platform - Note: This field should no longer be used since its sole purpose was to allow the seller to filter between eBay orders and Half.com orders, and the Half.com site no longer exists.
Input property: IncludeFinalValueFees - This field is included and set to true if the user wants to view the Final Value Fee (FVF) for all order line items in the response. The Final Value Fee is returned in the Transaction.FinalValueFee field. The Final Value Fee is assessed right after the creation of an order line item.

Output property: ReturnedOrderArray - This container consists of an array of eBay orders that match the input criteria that was passed into the call request.

Version:
1.0
Author:
Ron Murphy

Field Summary
 
Fields inherited from class com.ebay.sdk.ApiCall
apiException, sendReqListeners
 
Constructor Summary
GetOrderTransactionsCall()
          Constructor.
GetOrderTransactionsCall(ApiContext apiContext)
          Constructor.
 
Method Summary
 java.lang.Boolean getIncludeFinalValueFees()
          Gets the GetOrderTransactionsRequestType.includeFinalValueFees.
 ItemTransactionIDArrayType getItemTransactionIDArray()
          Gets the GetOrderTransactionsRequestType.itemTransactionIDArray.
 OrderIDArrayType getOrderIDArray()
          Gets the GetOrderTransactionsRequestType.orderIDArray.
 OrderArrayType getOrderTransactions()
          The base request type for the GetOrderTransactions call.
 TransactionPlatformCodeType getPlatform()
          Gets the GetOrderTransactionsRequestType.platform.
 OrderArrayType getReturnedOrderArray()
          Valid after executing the API.
 void setIncludeFinalValueFees(java.lang.Boolean includeFinalValueFees)
          Sets the GetOrderTransactionsRequestType.includeFinalValueFees.
 void setItemTransactionIDArray(ItemTransactionIDArrayType itemTransactionIDArray)
          Sets the GetOrderTransactionsRequestType.itemTransactionIDArray.
 void setOrderIDArray(OrderIDArrayType orderIDArray)
          Sets the GetOrderTransactionsRequestType.orderIDArray.
 void setPlatform(TransactionPlatformCodeType platform)
          Sets the GetOrderTransactionsRequestType.platform.
 
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

GetOrderTransactionsCall

public GetOrderTransactionsCall()
Constructor.


GetOrderTransactionsCall

public GetOrderTransactionsCall(ApiContext apiContext)
Constructor.

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

getOrderTransactions

public OrderArrayType getOrderTransactions()
                                    throws ApiException,
                                           SdkException,
                                           java.lang.Exception
The base request type for the GetOrderTransactions call. This call retrieves detailed information about one or more orders or order line items created (or modified) in the last 90 days.

Unlike GetOrders, which can be used to retrieve specific orders, or orders created (or modified) within a specific time period, the GetOrderTransactions call only supports the retrieval of specific orders and/or order line items.

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

getIncludeFinalValueFees

public java.lang.Boolean getIncludeFinalValueFees()
Gets the GetOrderTransactionsRequestType.includeFinalValueFees.

Returns:
Boolean

setIncludeFinalValueFees

public void setIncludeFinalValueFees(java.lang.Boolean includeFinalValueFees)
Sets the GetOrderTransactionsRequestType.includeFinalValueFees.

Parameters:
includeFinalValueFees - Boolean

getItemTransactionIDArray

public ItemTransactionIDArrayType getItemTransactionIDArray()
Gets the GetOrderTransactionsRequestType.itemTransactionIDArray.

Returns:
ItemTransactionIDArrayType

setItemTransactionIDArray

public void setItemTransactionIDArray(ItemTransactionIDArrayType itemTransactionIDArray)
Sets the GetOrderTransactionsRequestType.itemTransactionIDArray.

Parameters:
itemTransactionIDArray - ItemTransactionIDArrayType

getOrderIDArray

public OrderIDArrayType getOrderIDArray()
Gets the GetOrderTransactionsRequestType.orderIDArray.

Returns:
OrderIDArrayType

setOrderIDArray

public void setOrderIDArray(OrderIDArrayType orderIDArray)
Sets the GetOrderTransactionsRequestType.orderIDArray.

Parameters:
orderIDArray - OrderIDArrayType

getPlatform

public TransactionPlatformCodeType getPlatform()
Gets the GetOrderTransactionsRequestType.platform.

Returns:
TransactionPlatformCodeType

setPlatform

public void setPlatform(TransactionPlatformCodeType platform)
Sets the GetOrderTransactionsRequestType.platform.

Parameters:
platform - TransactionPlatformCodeType

getReturnedOrderArray

public OrderArrayType getReturnedOrderArray()
Valid after executing the API. Gets the returned GetOrderTransactionsResponseType.returnedOrderArray.

Returns:
OrderArrayType

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.