GetOrders is the recommended call to use for order (sales) management. Use this call to retrieve all orders in which the authenticated caller is either the buyer or seller. The order types that can be retrieved with this call are discussed below:
- Single line item orders: With the introduction of the OrderLineItemID field and other enhancements, GetOrders can now return single line item orders (traditionally known as transactions in eBay listings). In the API, a Transaction object, including a TransactionID and an OrderLineItemID, is generated by eBay as soon as the buyer commits to a purchase in an eBay listing. The OrderLineItemID value is actually a concatenation of ItemID and TransactionID with a hyphen separating the two values. The OrderLineItemID value is very versatile as it can substitute for any ItemID/TransactionID pair when these values are used as input filters, and its value can be passed into the OrderID field when OrderID is used as an input filter.
- Multiple line item orders: A multiple line item order is what has been traditionally known as a Combined Payment order. If multiple unpaid orders exist between the same buyer and seller, either the buyer or seller can combine these multiple order line items into a Combined Payment order. Combined Payment orders can be created on the Web site by the buyer or seller, and by the seller using the AddOrder call. In the AddOrder request, the caller passes in two or more order line items in the TransactionArray container and an eBay-generated OrderID value is returned in the response, and then can be used in the OrderID field of the GetOrders request.
- Half.com orders: single line item and multiple line item Half.com orders can also be retrieved with GetOrders. To retrieve Half.com orders, the ListingType field must be included in the request and set to Half.