Changes since
the last release

com.ebay.sdk.call
Class GetItemTransactionsCall

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

public class GetItemTransactionsCall
extends ApiCall

Wrapper class of the GetItemTransactions 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. When you use ItemID alone, eBay returns all order line items that are associated with the ItemID. If you pair ItemID with a specific TransactionID, data on a specific order line item is returned. An OrderLineItemID value can be used instead of an ItemID/TransactionID pair to identify an order line item, and if an OrderLineItemID is specified in the request, any ItemID/TransactionID pair specified in the same request is ignored.

Note: GetItemTransactions doesn't support SKU as an input because this call requires an identifier that is unique across your active and ended listings. Even when InventoryTrackingMethod is set to SKU in a listing, the SKU is only unique across your active listings (not your ended listings). To retrieve order line items by SKU, use GetSellerTransactions or GetOrderTransactions instead.
Input property: ModifiedTimeFilter - Helper wrapper to set GetItemTransactionsRequestType ModTimeFrom, ModTimeTo: TimeFrom sets GetItemTransactionsRequestType.ModTimeFrom: The ModTimeFrom and ModTimeTo fields specify a date range for retrieving order line items associated with the specified ItemID value. The ModTimeFrom field is the starting date range. All of the listing's order line items that were generated (or last modified)within this date range are returned in the output. The maximum date range that may be specified is 30 days. This value cannot be set back more than 90 days in the past, as this call cannot retrieve sales older than 90 days old. The maximum date range that may be specified is 30 days. This field is not applicable (and is ignored) if the user is looking for a specific order line item by either using an ItemID/TransactionID pair, or an OrderLineItemID value. TimeTo sets GetItemTransactionsRequestType.ModTimeTo: The ModTimeFrom and ModTimeTo fields specify a date range for retrieving order line items associated with the specified ItemID value. The ModTimeTo field is the ending date range. All eBay order line items that were generated (or last modified) within this date range are returned in the output. The maximum date range that may be specified is 30 days. If the ModTimeFrom field is used and the ModTimeTo field is omitted, the ModTimeTo value defaults to the present time or to 30 days after the date specified with the ModTimeFrom value (if ModTimeFrom value is more than 30 days in the past). This field is not applicable (and is ignored) if the user is looking for a specific order line item by either using an ItemID/TransactionID pair, or an OrderLineItemID value.
Input property: TransactionID - Include a TransactionID field in the request if you want to retrieve the data for a specific order line item for the listing specified in the ItemID field. This field is really only applicable for a multiple-quantity or multiple-variation, fixed-price listing that may have multiple sales. An auction listing or a single-quantity, fixed-price listing will only result in one order line item, so this field is not needed in these two cases. If an OrderLineItemID value is used instead to identify an order line item, this field is ignored.

If this field is used, any specified date filter is ignored.
Input property: Pagination - This container controls how many order line items should be returned per page of data, as well as which page of data to return (if there are multiple pages of order line items). Use the EntriesPerPage property to control the number of order line items to return per call and the PageNumber property to specify the specific page of data to return. If multiple pages of order line items are returned based on input criteria and Pagination properties, GetItemTransactions will need to be called multiple times (with the PageNumber value being increased by 1 each time) to scroll through all results.
Input property: IncludeFinalValueFee - 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.


Input property: IncludeContainingOrder - This field is included and set to true if the user wants to view order-level details, including the unique identifier of the order and the status of the order. The order-level details will be shown in the ContainingOrder container in the response.

Input property: Platform - Note: This field is should no longer be used, as its purpose in the past was to give the user the ability to retrieve only eBay marketplace order line items or only Half.com listings, and since the Half.com site no longer exists, this field is no longer relevant.
Input property: NumberOfDays - This date range filter specifies the number of days (24-hour periods) in the past to search for order line items. All eBay order line items that were either created or modified within this period are returned in the response. If specified, NumberOfDays will override any date range specified with the ModTimeFrom/ModTimeTo date range filters. This field is not applicable if a specific order line item is specified either through an ItemIDTransactionID pair or an OrderLineItemID value.
Input property: IncludeVariations - If this field is included in the request and set to true, details on all variations defined in the specified multiple-variation listing are returned, including variations that have no sales. If this field is not included in the request or set to false, the variations with sales are still returned in separate Transaction nodes. This information is intended to help sellers to reconcile their local inventory with eBay's records, while processing order line items (without requiring a separate call to GetItem).
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). If you want to retrieve data on a specific order line item, you can use an OrderLineItemID value in the request instead of an ItemID/TransactionID pair. If an OrderLineItemID is provided, any specified date range filter is ignored.
Output property: PaginationResult - Contains the total number of pages (TotalNumberOfPages) and the total number of entries (TotalNumberOfEntries) that could be returned given repeated calls that use the same selection criteria as the call that returned this response.
Output property: HasMoreTransactions - Indicates whether there are additional order line items to retrieve. That is, indicates whether more pages of data are available to be returned, given the filters that were specified in the request. Returns false for the last page of data.
Output property: ReturnedTransactionsPerPage - Number of order line items returned per page (per call). May be a higher value than ReturnedTransactionCountActual if the page returned is the last page and more than one page of data exists.
Output property: ReturnedPageNumber - Page number for the page of order line items the response returned.
Output property: ReturnedTransactionCountActual - Number of order line items retrieved in the current page of results just returned. May be a lower value than TransactionsPerPage if the page returned is the last page and more than one page of data exists.
Output property: Item - Item object that spawned the order line item. It is a purchase from this item's listing that the order line item represents.
Output property: ReturnedTransactions - List of Transaction objects representing the order line items resulting from the listing. Each Transaction object contains the data for one purchase (of one or more items in the same listing). The Transaction.Item field is not returned because the Item object is returned at the root level of the response. See the reference guide for more information about the fields that are returned.
Output property: PayPalPreferred - Indicates whether the item's seller has the preference enabled that shows that the seller prefers PayPal as the method of payment for an item. This preference is indicated on an item's View Item page and is intended to influence a buyer to use PayPal to pay for the item.

Version:
1.0
Author:
Ron Murphy

Field Summary
 
Fields inherited from class com.ebay.sdk.ApiCall
apiException, sendReqListeners
 
Constructor Summary
GetItemTransactionsCall()
          Constructor.
GetItemTransactionsCall(ApiContext apiContext)
          Constructor.
 
Method Summary
 TransactionType[] getEntireItemTransactions()
          Get all item transactions in specified date range.
 boolean getHasMoreTransactions()
          Valid after executing the API.
 java.lang.Boolean getIncludeContainingOrder()
          Gets the GetItemTransactionsRequestType.includeContainingOrder.
 java.lang.Boolean getIncludeFinalValueFee()
          Gets the GetItemTransactionsRequestType.includeFinalValueFee.
 java.lang.Boolean getIncludeVariations()
          Gets the GetItemTransactionsRequestType.includeVariations.
 ItemType getItem()
          Valid after executing the API.
 java.lang.String getItemID()
          Gets the GetItemTransactionsRequestType.itemID.
 TransactionType[] getItemTransactions()
          This call retrieves details on one or more order line items for a specified eBay listing.
 TransactionType[] getItemTransactions(java.lang.String itemID, TimeFilter modifiedTimeFilter)
          Execute the API call.
 TimeFilter getModifiedTimeFilter()
          Gets the GetItemTransactionsRequestType.modifiedTimeFilter.
 java.lang.Integer getNumberOfDays()
          Gets the GetItemTransactionsRequestType.numberOfDays.
 java.lang.String getOrderLineItemID()
          Gets the GetItemTransactionsRequestType.orderLineItemID.
 PaginationType getPagination()
          Gets the GetItemTransactionsRequestType.pagination.
 PaginationResultType getPaginationResult()
          Valid after executing the API.
 boolean getPayPalPreferred()
          Valid after executing the API.
 TransactionPlatformCodeType getPlatform()
          Gets the GetItemTransactionsRequestType.platform.
 java.lang.Integer getReturnedPageNumber()
          Valid after executing the API.
 int getReturnedTransactionCountActual()
          Valid after executing the API.
 TransactionType[] getReturnedTransactions()
          Valid after executing the API.
 java.lang.Integer getReturnedTransactionsPerPage()
          Valid after executing the API.
 java.lang.String getTransactionID()
          Gets the GetItemTransactionsRequestType.transactionID.
 void setIncludeContainingOrder(java.lang.Boolean includeContainingOrder)
          Sets the GetItemTransactionsRequestType.includeContainingOrder.
 void setIncludeFinalValueFe(java.lang.Boolean includeFinalValueFee)
          Backward compatible function - do not use
 void setIncludeFinalValueFee(java.lang.Boolean includeFinalValueFee)
          Sets the GetItemTransactionsRequestType.includeFinalValueFee.
 void setIncludeVariations(java.lang.Boolean includeVariations)
          Sets the GetItemTransactionsRequestType.includeVariations.
 void setItemID(java.lang.String itemID)
          Sets the GetItemTransactionsRequestType.itemID.
 void setModifiedTimeFilter(TimeFilter modifiedTimeFilter)
          Sets the GetItemTransactionsRequestType.modifiedTimeFilter.
 void setNumberOfDays(java.lang.Integer numberOfDays)
          Sets the GetItemTransactionsRequestType.numberOfDays.
 void setOrderLineItemID(java.lang.String orderLineItemID)
          Sets the GetItemTransactionsRequestType.orderLineItemID.
 void setPagination(PaginationType pagination)
          Sets the GetItemTransactionsRequestType.pagination.
 void setPlatform(TransactionPlatformCodeType platform)
          Sets the GetItemTransactionsRequestType.platform.
 void setTransactionID(java.lang.String transactionID)
          Sets the GetItemTransactionsRequestType.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

GetItemTransactionsCall

public GetItemTransactionsCall()
Constructor.


GetItemTransactionsCall

public GetItemTransactionsCall(ApiContext apiContext)
Constructor.

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

getItemTransactions

public TransactionType[] getItemTransactions()
                                      throws ApiException,
                                             SdkException,
                                             java.lang.Exception
This call retrieves details on one or more order line items for a specified eBay listing. Auctions and single-quantity, fixed-price listings can only have one order line item, but a multiple-quantity and/or multiple-variation, fixed-priced listing can have numerous order line items.

To find one or more order line items for an eBay listing, an ItemID value can be passed in. If a user wanted to retrieve a specific order line item, an ItemID value and a an TransactionID value can be passed in, or an OrderLineItemID value can be passed in instead of an ItemID/TransactionID pair.

The NumberOfDays or the ModTimeFrom and ModTimeTo date range filters can be used to retrieve order line items generated (or last modified) within a specific range of time. The maximum date range that can be set is 30 days, and the ModTimeFrom date value cannot be set any further back than 90 days in the past. If no date range filters are used, all order line items (associated with the specified listing) generated (or last modified) in the last 30 days are retrieved. Date ranges are generally only used for multiple-quantity or multiple-variation, fixed-price listings that can have multiple order line items.

There are also pagination filters available that allow the user to control how many and which order line items are returned on each page of a results set.

Returns:
The TransactionType[] object.
Throws:
ApiException
SdkException
java.lang.Exception

getIncludeContainingOrder

public java.lang.Boolean getIncludeContainingOrder()
Gets the GetItemTransactionsRequestType.includeContainingOrder.

Returns:
Boolean

setIncludeContainingOrder

public void setIncludeContainingOrder(java.lang.Boolean includeContainingOrder)
Sets the GetItemTransactionsRequestType.includeContainingOrder.

Parameters:
includeContainingOrder - Boolean

getIncludeFinalValueFee

public java.lang.Boolean getIncludeFinalValueFee()
Gets the GetItemTransactionsRequestType.includeFinalValueFee.

Returns:
Boolean

setIncludeFinalValueFee

public void setIncludeFinalValueFee(java.lang.Boolean includeFinalValueFee)
Sets the GetItemTransactionsRequestType.includeFinalValueFee.

Parameters:
includeFinalValueFee - Boolean

getIncludeVariations

public java.lang.Boolean getIncludeVariations()
Gets the GetItemTransactionsRequestType.includeVariations.

Returns:
Boolean

setIncludeVariations

public void setIncludeVariations(java.lang.Boolean includeVariations)
Sets the GetItemTransactionsRequestType.includeVariations.

Parameters:
includeVariations - Boolean

getItemID

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

Returns:
String

setItemID

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

Parameters:
itemID - String

getModifiedTimeFilter

public TimeFilter getModifiedTimeFilter()
Gets the GetItemTransactionsRequestType.modifiedTimeFilter.

Returns:
TimeFilter

setModifiedTimeFilter

public void setModifiedTimeFilter(TimeFilter modifiedTimeFilter)
Sets the GetItemTransactionsRequestType.modifiedTimeFilter.

Parameters:
modifiedTimeFilter - TimeFilter

getNumberOfDays

public java.lang.Integer getNumberOfDays()
Gets the GetItemTransactionsRequestType.numberOfDays.

Returns:
Integer

setNumberOfDays

public void setNumberOfDays(java.lang.Integer numberOfDays)
Sets the GetItemTransactionsRequestType.numberOfDays.

Parameters:
numberOfDays - Integer

getOrderLineItemID

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

Returns:
String

setOrderLineItemID

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

Parameters:
orderLineItemID - String

getPagination

public PaginationType getPagination()
Gets the GetItemTransactionsRequestType.pagination.

Returns:
PaginationType

setPagination

public void setPagination(PaginationType pagination)
Sets the GetItemTransactionsRequestType.pagination.

Parameters:
pagination - PaginationType

getPlatform

public TransactionPlatformCodeType getPlatform()
Gets the GetItemTransactionsRequestType.platform.

Returns:
TransactionPlatformCodeType

setPlatform

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

Parameters:
platform - TransactionPlatformCodeType

getTransactionID

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

Returns:
String

setTransactionID

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

Parameters:
transactionID - String

getEntireItemTransactions

public TransactionType[] getEntireItemTransactions()
                                            throws ApiException,
                                                   SdkException,
                                                   java.lang.Exception
Get all item transactions in specified date range. It handles pagination internally and ignores the Pagination property. GetItemTransactionsCall.ItemID and GetItemTransactionsCall.ModifiedTimeFilter will be ignored.

Parameters:
modifiedTimeFilter - TimeFilter
Returns:
TransactionType[]
Throws:
ApiException
SdkException
java.lang.Exception

getItemTransactions

public TransactionType[] getItemTransactions(java.lang.String itemID,
                                             TimeFilter modifiedTimeFilter)
                                      throws ApiException,
                                             SdkException,
                                             java.lang.Exception
Execute the API call. GetItemTransactionsCall.ItemID and GetItemTransactionsCall.ModifiedTimeFilter will be ignored.

Parameters:
itemID - String Unique ID of item that you are retrieving transactions for.
modifiedTimeFilter - TimeFilter Range of transactions that you are retrieving.
Returns:
TransactionType[]
Throws:
ApiException
SdkException
java.lang.Exception

setIncludeFinalValueFe

public void setIncludeFinalValueFe(java.lang.Boolean includeFinalValueFee)
Backward compatible function - do not use


getHasMoreTransactions

public boolean getHasMoreTransactions()
Valid after executing the API. Gets the returned GetItemTransactionsResponseType.hasMoreTransactions.

Returns:
boolean

getItem

public ItemType getItem()
Valid after executing the API. Gets the returned GetItemTransactionsResponseType.item.

Returns:
ItemType

getPaginationResult

public PaginationResultType getPaginationResult()
Valid after executing the API. Gets the returned GetItemTransactionsResponseType.paginationResult.

Returns:
PaginationResultType

getPayPalPreferred

public boolean getPayPalPreferred()
Valid after executing the API. Gets the returned GetItemTransactionsResponseType.payPalPreferred.

Returns:
boolean

getReturnedPageNumber

public java.lang.Integer getReturnedPageNumber()
Valid after executing the API. Gets the returned GetItemTransactionsResponseType.returnedPageNumber.

Returns:
Integer

getReturnedTransactionCountActual

public int getReturnedTransactionCountActual()
Valid after executing the API. Gets the returned GetItemTransactionsResponseType.returnedTransactionCountActual.

Returns:
int

getReturnedTransactions

public TransactionType[] getReturnedTransactions()
Valid after executing the API. Gets the returned GetItemTransactionsResponseType.returnedTransactions.

Returns:
TransactionType[]

getReturnedTransactionsPerPage

public java.lang.Integer getReturnedTransactionsPerPage()
Valid after executing the API. Gets the returned GetItemTransactionsResponseType.returnedTransactionsPerPage.

Returns:
Integer

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.