OrderDetailsType
Contains information about the sold item, such as: order id, buyer information, shipping information, order creation time, payment cleared time, tax amount, insurance cost, and total cost.
Type that uses OrderDetailsType:
Call that uses OrderDetailsType:
Fields
CheckoutSiteID ( int )
The eBay site that the buyer used when paying for the item(s).
See the Field Index to learn which calls use CheckoutSiteID.
Cost of insuring the delivery of this order with the courier.
See the Field Index to learn which calls use InsuranceCost.
The date and time that the order was created.
See the Field Index to learn which calls use OrderCreationTime.
A unique identifier for a single or multiple line item order. When a buyer purchases multiple items from the same listing, each item purchased will have an Order Line Item ID and all items in that purchase will have the same Order ID.
Note: In June 2019, eBay introduced a new order ID format, but allowed developers/sellers to decide whether to immediately adopt the new format, or to continue working with the old format. Users who wanted to adopt the new format, could either use a Trading WSDL Version 1113 (or newer), or they could even use an older Trading WSDL but set the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header value to
Note that the unique identifier of a 'non-immediate payment' order will change as it goes from an unpaid order to a paid order. Due to this scenario, all calls that accept Order ID values as filters in the request payload, including the GetOrders call, will support the identifiers for both unpaid and paid orders. The new order ID 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.
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.
Note: In June 2019, eBay introduced a new order ID format, but allowed developers/sellers to decide whether to immediately adopt the new format, or to continue working with the old format. Users who wanted to adopt the new format, could either use a Trading WSDL Version 1113 (or newer), or they could even use an older Trading WSDL but set the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header value to
1113 in API calls. Beginning in June 2020, only the new order ID format will be returned in response payloads for paid orders, regardless of the WSDL version number or compatibility level. Note that the unique identifier of a 'non-immediate payment' order will change as it goes from an unpaid order to a paid order. Due to this scenario, all calls that accept Order ID values as filters in the request payload, including the GetOrders call, will support the identifiers for both unpaid and paid orders. The new order ID 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.
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.
See the Field Index to learn which calls use OrderID.
OrderItemDetails ( OrderItemDetailsType ) [0..1]
Contains the data for each line item in the order.
See the Field Index to learn which calls use OrderItemDetails.
Amount seller charged to buyer, not amount of fees that seller owes eBay.
See the Field Index to learn which calls use OrderSalePrice.
The total cost of the order, which includes the sale price of all order line items, shipping costs, and taxes.
See the Field Index to learn which calls use OrderTotalCost.
The date and time that the payment was acknowledged. Only returned if payment has been marked as sent (checkout is complete). If a buyer has completed checkout using PayPal, the Payment is automatically marked as sent. Otherwise, the buyer must mark it manually on the MyeBay page.
See the Field Index to learn which calls use PaymentClearedTime.
Calculated shipping cost based on item weight, buyer's postal code, and shipping service.
See the Field Index to learn which calls use ShippingCost.
Calculated tax fee based on the sale price and the sales tax at the seller's location.
See the Field Index to learn which calls use TaxAmount.
This boolean field is returned as
More and more US states are mandating the collection of sales tax for Internet sales. For a full list of affected states and effective dates, see the eBay sales tax collection help page.
true if the OrderTotalCost value includes eBay 'Collect and Remit' taxes. eBay 'Collect and Remit' taxes include US state-mandated sales tax and 'Goods and Services' taxes that are applicable to orders from Australian and New Zealand sellers. More and more US states are mandating the collection of sales tax for Internet sales. For a full list of affected states and effective dates, see the eBay sales tax collection help page.
See the Field Index to learn which calls use TotalIncludeseBayCollectedTax.