eBay Merchant Data APIVersion 1019

SoldReport

Lists all items that have been sold by this seller. If a buyer purchased multiple items from a single listing, the sale will result in a single Order ID for the total purchase with a separate Line Item ID for each of the purchased items. The SoldReport request returns the data for all of your new orders (newly-sold items) with Order ID and Order Line Item ID. The Sold Report includes all transactions for the past 30 days (from the transaction creation date).

The concept of an 'Order' is only used in the Trading API when a buyer makes combined payments. Each payment is a transaction. But in the Large Merchant Services solution, every sale is considered to be an Order. It is important to recognize these conceptual differences when you are working with multiple APIs.

OrderLineItemID is a based upon the combination of the eBay Trading API's ItemID and TransactionID fields. The number before the hyphen is the Item ID and the number after the hyphen is the Transaction ID. The Transaction field in the Trading API is a container that can include many types of transaction information.

See Trading API for more information.

Sellers use the information in the SoldReport to make inventory updates and start order fulfillment.

Note: After release 637, a namespace is returned in the BulkDataExchangeResponseType (top level) of the response. This container is not shown in the call output description, but you can see it in the call samples at the end of this page. See Making An API Call for more information about the BulkDataExchange Response container.



Output

See also Samples.

The box below lists all fields that might be returned in the response. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are not returned (or soon will not be returned) or are not operational (or soon will be non-operational).

<?xml version="1.0" encoding="utf-8"?>
<SoldReport xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <OrderDetails> OrderDetailsType
    <BuyerEmail> string </BuyerEmail>
    <BuyerFirstName> string </BuyerFirstName>
    <BuyerLastName> string </BuyerLastName>
    <BuyerPhone> string </BuyerPhone>
    <BuyerStaticAlias> string </BuyerStaticAlias>
    <BuyerUserID> string </BuyerUserID>
    <CheckoutSiteID> int </CheckoutSiteID>
    <CheckoutStatus> CheckoutStatusType
      <eBayPaymentStatus> PaymentStatusCodeType </eBayPaymentStatus>
      <PaymentMethod> BuyerPaymentMethodCodeType </PaymentMethod>
      <Status> CompleteStatusCodeType </Status>
    </CheckoutStatus>
    <ExternalTransaction> ExternalTransactionType
      <ExternalTransactionID> string </ExternalTransactionID>
      <ExternalTransactionStatus> PaymentTransactionStatusCodeType </ExternalTransactionStatus>
      <ExternalTransactionTime> dateTime </ExternalTransactionTime>
      <FeeOrCreditAmount currencyID="CurrencyCodeType"> AmountType (double) </FeeOrCreditAmount>
      <PaymentOrRefundAmount currencyID="CurrencyCodeType"> AmountType (double) </PaymentOrRefundAmount>
    </ExternalTransaction>
    <!-- ... more ExternalTransaction nodes allowed here ... -->
    <InsuranceCost currencyID="CurrencyCodeType"> AmountType (double) </InsuranceCost>
    <OrderCreationTime> dateTime </OrderCreationTime>
    <OrderID> string </OrderID>
    <OrderItemDetails> OrderItemDetailsType
      <OrderLineItem> OrderLineItemType
        <ActualShippingCost currencyID="CurrencyCodeType"> AmountType (double) </ActualShippingCost>
        <BuyerPaymentTransactionNumber> string </BuyerPaymentTransactionNumber>
        <InsuranceCost currencyID="CurrencyCodeType"> AmountType (double) </InsuranceCost>
        <ItemID> ItemIDType (string) </ItemID>
        <ListingSiteID> int </ListingSiteID>
        <OrderLineItemID> string </OrderLineItemID>
        <PaymentClearedTime> dateTime </PaymentClearedTime>
        <QuantitySold> int </QuantitySold>
        <SalePrice currencyID="CurrencyCodeType"> AmountType (double) </SalePrice>
        <SellingManagerSaleRecordID> int </SellingManagerSaleRecordID>
        <ShippingCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingCost>
        <SKU> SKUType (string) </SKU>
        <Status> TransactionStatusType
          <PaymentHoldStatus> PaymentHoldStatusCodeType </PaymentHoldStatus>
        </Status>
        <TaxAmount currencyID="CurrencyCodeType"> AmountType (double) </TaxAmount>
        <TaxCategory> string </TaxCategory>
        <Taxes> TaxesType
          <TaxDetails> TaxDetailsType
            <Imposition> TaxTypeCodeType </Imposition>
            <TaxAmount currencyID="CurrencyCodeType"> AmountType (double) </TaxAmount>
            <TaxDescription> TaxDescriptionCodeType </TaxDescription>
            <TaxOnHandlingAmount currencyID="CurrencyCodeType"> AmountType (double) </TaxOnHandlingAmount>
            <TaxOnShippingAmount currencyID="CurrencyCodeType"> AmountType (double) </TaxOnShippingAmount>
            <TaxOnSubtotalAmount currencyID="CurrencyCodeType"> AmountType (double) </TaxOnSubtotalAmount>
          </TaxDetails>
          <!-- ... more TaxDetails nodes allowed here ... -->
          <TotalTaxAmount currencyID="CurrencyCodeType"> AmountType (double) </TotalTaxAmount>
        </Taxes>
        <TotalCost currencyID="CurrencyCodeType"> AmountType (double) </TotalCost>
        <UnpaidItem> UnpaidItemType
          <Status> UnpaidItemCaseStatusTypeCodeType </Status>
          <Type> UnpaidItemCaseOpenTypeCodeType </Type>
        </UnpaidItem>
        <Variation> MerchantDataVariationType
          <Price currencyID="CurrencyCodeType"> AmountType (double) </Price>
          <Quantity> int </Quantity>
          <SellingStatus> MerchantDataSellingStatusType
            <QuantitySold> int </QuantitySold>
          </SellingStatus>
          <SKU> SKUType (string) </SKU>
          <VariationSpecifics> NameValueListArrayType
            <NameValueList> NameValueListType
              <Name> string </Name>
              <Value> string </Value>
              <!-- ... more Value values allowed here ... -->
            </NameValueList>
            <!-- ... more NameValueList nodes allowed here ... -->
          </VariationSpecifics>
        </Variation>
      </OrderLineItem>
      <!-- ... more OrderLineItem nodes allowed here ... -->
    </OrderItemDetails>
    <OrderTotalCost currencyID="CurrencyCodeType"> AmountType (double) </OrderTotalCost>
    <PaymentClearedTime> dateTime </PaymentClearedTime>
    <PaymentHoldStatus> PaymentHoldStatusCodeType </PaymentHoldStatus>
    <PickupDetails> PickupDetailsType
      <PickupOptions> PickupOptionsType
        <PickupMethod> token </PickupMethod>
        <PickupPriority> int </PickupPriority>
      </PickupOptions>
      <!-- ... more PickupOptions nodes allowed here ... -->
    </PickupDetails>
    <PickupMethodSelected> PickupMethodSelectedType
      <MerchantPickupCode> string </MerchantPickupCode>
      <PickupMethod> token </PickupMethod>
      <PickupStatus> PickupStatusCodeType </PickupStatus>
      <PickupStoreID> string </PickupStoreID>
    </PickupMethodSelected>
    <SellingManagerSaleRecordID> int </SellingManagerSaleRecordID>
    <ShipCityName> string </ShipCityName>
    <ShipCountryName> token </ShipCountryName>
    <ShippingCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingCost>
    <ShippingService> string </ShippingService>
    <ShippingServiceToken> string </ShippingServiceToken>
    <ShipPostalCode> string </ShipPostalCode>
    <ShipRecipientName> string </ShipRecipientName>
    <ShipReferenceId> string </ShipReferenceId>
    <ShipStateOrProvince> string </ShipStateOrProvince>
    <ShipStreet1> string </ShipStreet1>
    <ShipStreet2> string </ShipStreet2>
    <TaxAmount currencyID="CurrencyCodeType"> AmountType (double) </TaxAmount>
  </OrderDetails>
  <!-- ... more OrderDetails nodes allowed here ... -->
</SoldReport>
Return Value Type Occurrence Meaning
OrderDetails OrderDetailsType Always,
repeatable: [1..*]
Contains information about the sold item, such as: order ID, order line item ID, buyer information, shipping information, order creataion time, payment cleared time, tax amount, insurance cost, and total cost.

See OrderLineItemType for more information about the OrderLineItemID field.
OrderDetails.BuyerEmail string Always Displays the email address of the buyer (from their eBay user account). Used for off-eBay communication.
OrderDetails.BuyerFirstName string Always Displays the first name of the buyer (from their eBay user account).
OrderDetails.BuyerLastName string Always Displays the last name of the buyer (from their eBay user account).
OrderDetails.BuyerPhone string Always Buyer's primary phone number. This may return a value of "Invalid Request" if you are not authorized to see the buyer's phone number.

Also applicable to Half.com (for GetOrders).
OrderDetails.BuyerStaticAlias string Always Static anonymous email address of the buyer for eBay intermediated member-to-memmber emails. Messaging calls in the Trading API, such as GetMemeberMessages will also use this static email address.

The email address is in the form <alias>@members.ebay.<SiteDomain>. Each eBay member is assigned a static alias, which is the first part of the email address. The <SiteDomain> value is based on the buyer's registered site. For example, the email address ends in @members.ebay.de for a buyer registered on the eBay Germany site. The <SiteDomain> value can be used to help identify the user's language. If the buyer changes his registered site, then the value of <SiteDomain> will change accordingly.

See BuyerEmail.

OrderDetails.BuyerUserID string Always The buyer's eBay User ID.
OrderDetails.CheckoutSiteID int Always The eBay site that the buyer used when paying for the item(s).
OrderDetails.CheckoutStatus CheckoutStatusType Always The current checkout status of the order.
OrderDetails.CheckoutStatus
  .eBayPaymentStatus
PaymentStatusCodeType Always This value indicates the payment status of an order.

Also applicable to Half.com orders (GetOrders only).

Applicable values: See eBayPaymentStatus.
Code so that your app gracefully handles any future changes to this list.
OrderDetails.CheckoutStatus
  .PaymentMethod
BuyerPaymentMethodCodeType Always The payment method that the buyer selected to pay for the order.

This field is also applicable to Half.com orders (GetOrders only).

Applicable values: See PaymentMethod.
Code so that your app gracefully handles any future changes to this list.
OrderDetails.CheckoutStatus
  .Status
CompleteStatusCodeType Always Indicates the status of the order. This value is subject to change based on the status of the checkout flow. Generally speaking, the Status field reads 'Incomplete' when payment has yet to be initiated, 'Pending' when payment has been initiated but is in process, and 'Complete' when the payment process has completed.

Note: If the PaymentMethod is CashOnPickup, the Status value will read Complete right at Checkout, even though the seller may not have been officially paid yet, and the eBayPaymentStatus field will read NoPaymentFailure. The CheckoutStatus.Status value will remain as Complete even if the seller uses ReviseCheckoutStatus to change the checkout status to Pending. However, the eBayPaymentStatus value in GetOrders will change from NoPaymentFailure to PaymentInProcess.

This field is also applicable to Half.com orders (GetOrders only).

Applicable values:

Complete
This value indicates that the order or order line item is complete. Generally speaking, an order or order line item is complete when payment from the buyer has been initiated and has been processed.

Note: If the PaymentMethodUsed is CashOnPickup, the CheckoutStatus.Status value in GetOrders will be Complete at checkout time, even though the seller may not have been officially paid yet. The CheckoutStatus.Status value in GetOrders will remain as Complete even if the seller uses ReviseCheckoutStatus to change the checkout status to Pending. However, the eBayPaymentStatus value in GetOrders will change from NoPaymentFailure to PaymentInProcess.
CustomCode
Reserved for internal or future use
Incomplete
This value indicates that the order or order line item is in the incomplete state. Generally speaking, an order or order line item is considered incomplete when payment from the buyer has yet to be initiated.
Pending
This value indicates that the order or order line item is in the pending state. Generally speaking, an order is considered pending when payment from the buyer has been initiated but has yet to be fully processed.

Note: If the payment method is CashOnPickup, the CheckoutStatus.Status value in GetOrders will read Complete at checkout time, even though the seller may not have been officially paid yet. The CheckoutStatus.Status value in GetOrders will remain as Complete even if the seller uses ReviseCheckoutStatus to change the checkout status to Pending. However, the eBayPaymentStatus value in GetOrders will change from NoPaymentFailure to PaymentInProcess.

Code so that your app gracefully handles any future changes to this list.
OrderDetails
  .ExternalTransaction
ExternalTransactionType Always,
repeatable: [1..*]
The transaction that relates to the eBay order line item.
OrderDetails
  .ExternalTransaction
  .ExternalTransactionID
string Always Unique identifier for a PayPal payment of an eBay order. If the order was purchased with a payment method other than PayPal, "SIS" is returned, which stands for "Send Information To Seller." This field is only returned after payment has been made.
OrderDetails
  .ExternalTransaction
  .ExternalTransactionStatus
PaymentTransactionStatusCodeType Conditionally The current processing status of a PayPal payment for an eBay order.

Applicable values:

CustomCode
Reserved for internal or future use.
Failed
This value indicates that the payment transaction failed.
Pending
This value indicates that the payment transaction is pending.
Succeeded
This value indicates that the payment transaction succeeded.

Code so that your app gracefully handles any future changes to this list.
OrderDetails
  .ExternalTransaction
  .ExternalTransactionTime
dateTime Always Timestamp for payment transaction.
OrderDetails
  .ExternalTransaction
  .FeeOrCreditAmount
AmountType (double) Always Fee Amount is a positive value and Credit Amount is a negative value.
OrderDetails
  .ExternalTransaction
  .FeeOrCreditAmount
  [ attribute currencyID ]
CurrencyCodeType Always Fee Amount is a positive value and Credit Amount is a negative value.

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails
  .ExternalTransaction
  .PaymentOrRefundAmount
AmountType (double) Always If positive, the amount the buyer pays the seller through PayPal on the purchase of items. If negative, the amount refunded the buyer. Default = 0.
OrderDetails
  .ExternalTransaction
  .PaymentOrRefundAmount
  [ attribute currencyID ]
CurrencyCodeType Always If positive, the amount the buyer pays the seller through PayPal on the purchase of items. If negative, the amount refunded the buyer. Default = 0.

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.InsuranceCost AmountType (double) Always Cost of insuring the delivery of this order with the courier.
OrderDetails.InsuranceCost
  [ attribute currencyID ]
CurrencyCodeType Always Cost of insuring the delivery of this order with the courier.

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.OrderCreationTime dateTime Always The date and time that the order was created.
OrderDetails.OrderID string Always A unique identifier for a purchase or multiple purchases from the same seller. 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.

OrderLineItemID is a based upon the combination of the eBay Trading API's ItemID and TransactionID fields. The number before the hyphen is the Item ID and the number after the hyphen is the Transaction ID. The Transaction field in the Trading API is a container that can include many types of transaction information.

See Trading API for more information.
OrderDetails.OrderItemDetails OrderItemDetailsType Always Contains the data for each line item in the order.
OrderDetails.OrderItemDetails
  .OrderLineItem
OrderLineItemType Always,
repeatable: [1..*]
Specifics for the sale data for a single SKU or item.
OrderDetails.OrderItemDetails
  .OrderLineItem
  .ActualShippingCost
AmountType (double) [invalid value for Returned] This indicates the shipping cost for the order line item, and it's only emitted if promotional shipping service is selected and payment has been made.
OrderDetails.OrderItemDetails
  .OrderLineItem
  .ActualShippingCost
  [ attribute currencyID ]
CurrencyCodeType Always This indicates the shipping cost for the order line item, and it's only emitted if promotional shipping service is selected and payment has been made.

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.OrderItemDetails
  .OrderLineItem
  .BuyerPaymentTransactionNumber
string Conditionally If payment has been marked as sent (on the Buyer's MyeBay page), this field returns the transaction number assigned to the payment event by the eBay application. Sellers might use this field to determine when they can ship an item. This field is only included in the response after the Buyer has completed checkout.

If a buyer has completed checkout using PayPal, the Payment is automatically marked as sent, and the BuyerPaymentTransactionNumber will be the same number as the PayPal External Transaction ID. Otherwise, the buyer must mark the item as paid manually on the MyeBay page.
OrderDetails.OrderItemDetails
  .OrderLineItem.InsuranceCost
AmountType (double) Always Cost of insuring the delivery of this order with the courier.
OrderDetails.OrderItemDetails
  .OrderLineItem.InsuranceCost
  [ attribute currencyID ]
CurrencyCodeType Always Cost of insuring the delivery of this order with the courier.

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.OrderItemDetails
  .OrderLineItem.ItemID
ItemIDType (string) Always The ID that uniquely identifies the item listing. The ID is generated by eBay after an item is listed. You cannot choose or revise this value.
Also applicable to Half.com.
OrderDetails.OrderItemDetails
  .OrderLineItem.ListingSiteID
int Always eBay site where the seller is registered.
OrderDetails.OrderItemDetails
  .OrderLineItem.OrderLineItemID
string Always An ID that uniquely identifies each line item within an order. If the buyer only purchased one item, there will be one Order ID and one Order Line Item ID. If a buyer purchases multiple items, there will be one Order ID and multiple Order Line Item IDs.

OrderLineItemID is a based upon the combination of the eBay Trading API's ItemID and TransactionID fields. The number before the hyphen is the Item ID and the number after the hyphen is the Transaction ID. The Transaction field in the Trading API is a container that can include many types of order line item (transaction) information.

See Trading API for more information.
OrderDetails.OrderItemDetails
  .OrderLineItem
  .PaymentClearedTime
dateTime Conditionally The date and time that the payment was acknowledged. Only returned for SoldReport if payment has been marked as received.
OrderDetails.OrderItemDetails
  .OrderLineItem.QuantitySold
int Always The number of items sold to a specific buyer within a single order line item (transaction).
OrderDetails.OrderItemDetails
  .OrderLineItem.SalePrice
AmountType (double) Always Price of the item.
OrderDetails.OrderItemDetails
  .OrderLineItem.SalePrice
  [ attribute currencyID ]
CurrencyCodeType Always Price of the item.

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.OrderItemDetails
  .OrderLineItem
  .SellingManagerSaleRecordID
int Conditionally For users of the Selling Manager or Selling Manager Pro tools only. If you are not using Selling Manager or Selling Manager Pro, this field will not be returned in your response.

Unique identifier for the record, assigned by eBay. An example of a recordId: 1111:222:333:444:x.
OrderDetails.OrderItemDetails
  .OrderLineItem.ShippingCost
AmountType (double) Always Calculated shipping cost based on item weight, buyer's postal code, and shipping service.
OrderDetails.OrderItemDetails
  .OrderLineItem.ShippingCost
  [ attribute currencyID ]
CurrencyCodeType Always Calculated shipping cost based on item weight, buyer's postal code, and shipping service.

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.OrderItemDetails
  .OrderLineItem.SKU
SKUType (string) Always Stock Keeping Unit that serves as a unique identifier for an item. Many merchants assign a SKU number to an item of a specific type, size, and color. This way, they can keep track of how many products of each type, size, and color are selling, and they can re-stock their shelves according to customer demand. You can use SKU numbers to add Fixed Price Items and to keep track of your eBay inventory, instead of (or in addition to) the Item ID.
OrderDetails.OrderItemDetails
  .OrderLineItem.Status
TransactionStatusType Always Container consisting of status details of an order line item, including payment information. Several of these fields change values during the checkout flow. See TransactionStatusType for its child elements.

For SoldReport, only the PaymentHoldStatus child element is returned. The fields indicating the status of the order are actually found in the OrderDetails.CheckoutStatus container.

Not applicable to Half.com.
OrderDetails.OrderItemDetails
  .OrderLineItem.Status
  .PaymentHoldStatus
PaymentHoldStatusCodeType Always This field indicates the type and/or status of a payment hold on the item.

Applicable values: See PaymentHoldStatus.
Code so that your app gracefully handles any future changes to this list.

See Holds on PayPal Payments.

OrderDetails.OrderItemDetails
  .OrderLineItem.TaxAmount
AmountType (double) Always Calculated tax fee based on the sale price and the sales tax at the buyer's location.
OrderDetails.OrderItemDetails
  .OrderLineItem.TaxAmount
  [ attribute currencyID ]
CurrencyCodeType Always Calculated tax fee based on the sale price and the sales tax at the buyer's location.

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.OrderItemDetails
  .OrderLineItem.TaxCategory
string Conditionally A tax exception category code. This is returned only if set for the listing.
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
TaxesType Conditionally Details about taxes applicable to this order line item (transaction). Returned only if enabled for the account. (Otherwise see OrderLineItem.TaxAmount.)
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
  .TaxDetails
TaxDetailsType Conditionally,
repeatable: [0..*]
Container consisting of detailed sales tax information for an order line item, including the tax type and description, sales tax on the item cost, and sales tax related to shipping and handling.
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
  .TaxDetails.Imposition
TaxTypeCodeType Conditionally This field indicates the sales tax type. A separate TaxDetails container is required for each unique imposition (tax type).

Applicable values:

CustomCode
Reserved for internal or future use.
SalesTax
A standard sales tax charge.
WasteRecyclingFee
A charge for an electronic waste recycling fee.

Code so that your app gracefully handles any future changes to this list.
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
  .TaxDetails.TaxAmount
AmountType (double) Conditionally This value is the total amount of sales tax for the order line item for the corresponding impositiion (tax type).

TaxAmount = TaxOnSubtotalAmount + TaxOnShippingAmount + TaxOnHandlingAmount
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
  .TaxDetails.TaxAmount
  [ attribute currencyID ]
CurrencyCodeType Always This value is the total amount of sales tax for the order line item for the corresponding impositiion (tax type).

TaxAmount = TaxOnSubtotalAmount + TaxOnShippingAmount + TaxOnHandlingAmount

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
  .TaxDetails.TaxDescription
TaxDescriptionCodeType Conditionally This field indicates the description of the sales tax.

Applicable values:

CustomCode
Reserved for internal or future use.
ElectronicWasteRecyclingFee
A charge for an electronic waste recycling fee.
SalesTax
A standard sales tax charge.
TireRecyclingFee
A charge for a tire recycling fee.

Code so that your app gracefully handles any future changes to this list.
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
  .TaxDetails
  .TaxOnHandlingAmount
AmountType (double) Conditionally This value is the amount of sales tax applied based on handling costs for the order line item for the corresponding impositiion (tax type).
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
  .TaxDetails
  .TaxOnHandlingAmount
  [ attribute currencyID ]
CurrencyCodeType Always This value is the amount of sales tax applied based on handling costs for the order line item for the corresponding impositiion (tax type).

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
  .TaxDetails
  .TaxOnShippingAmount
AmountType (double) Conditionally This value is the amount of sales tax applied based on shipping costs for the order line item for the corresponding impositiion (tax type).
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
  .TaxDetails
  .TaxOnShippingAmount
  [ attribute currencyID ]
CurrencyCodeType Always This value is the amount of sales tax applied based on shipping costs for the order line item for the corresponding impositiion (tax type).

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
  .TaxDetails
  .TaxOnSubtotalAmount
AmountType (double) Conditionally This value is the amount of sales tax applied based on the unit cost of the order line item for the corresponding impositiion (tax type).
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
  .TaxDetails
  .TaxOnSubtotalAmount
  [ attribute currencyID ]
CurrencyCodeType Always This value is the amount of sales tax applied based on the unit cost of the order line item for the corresponding impositiion (tax type).

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
  .TotalTaxAmount
AmountType (double) Conditionally This value indicates the total tax amount for the order line item, including the sales tax on the item, the sales tax on shipping and handling, and any electronic waste recycling fee.
OrderDetails.OrderItemDetails
  .OrderLineItem.Taxes
  .TotalTaxAmount
  [ attribute currencyID ]
CurrencyCodeType Always This value indicates the total tax amount for the order line item, including the sales tax on the item, the sales tax on shipping and handling, and any electronic waste recycling fee.

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.OrderItemDetails
  .OrderLineItem.TotalCost
AmountType (double) Always Calculated total for all fees, tax, and sale price(s) in this order. If multiple order line items between the same buyer and seller have been combined into a Combined Payment order, the TotalCost value returned for each order line item reflects the amount paid for the Combined Payment order and not the individual order line item.
OrderDetails.OrderItemDetails
  .OrderLineItem.TotalCost
  [ attribute currencyID ]
CurrencyCodeType Always Calculated total for all fees, tax, and sale price(s) in this order. If multiple order line items between the same buyer and seller have been combined into a Combined Payment order, the TotalCost value returned for each order line item reflects the amount paid for the Combined Payment order and not the individual order line item.

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.OrderItemDetails
  .OrderLineItem.UnpaidItem
UnpaidItemType Conditionally Unpaid Item Details.
OrderDetails.OrderItemDetails
  .OrderLineItem.UnpaidItem
  .Status
UnpaidItemCaseStatusTypeCodeType Conditionally This field indicates the status of the Unpaid Item case. This field is always returned with the UnpaidItem container.

Applicable values:

ClosedWithoutPayment
This value indicates that the Unpaid Item case is closed with no payment received from the buyer.
ClosedWithPayment
This value indicates that the Unpaid Item case is closed with payment received from the buyer.
CustomCode
This value is reserved for future or internal use.
Open
This value indicates that the Unpaid Item case is open.

Code so that your app gracefully handles any future changes to this list.
OrderDetails.OrderItemDetails
  .OrderLineItem.UnpaidItem.Type
UnpaidItemCaseOpenTypeCodeType Conditionally This field indicates if the Unpaid Item case was opened manually by the customer or opened automatically by eBay's Unpaid Item Assistant feature. This field is always returned with the UnpaidItem container.

Applicable values:

Auto
This value indicates that the Unpaid Item case was opened automatically through eBay's Unpaid Item Assistant feature.
CustomCode
This value is reserved for future or internal use.
Manual
This value indicates that the seller opened an Unpaid Item case manually through the Resolution Center or by using the Trading API's AddDispute call.

Code so that your app gracefully handles any future changes to this list.

See Using Unpaid Item Assistant for more information about managing the Unpaid Item Assistant feature.

OrderDetails.OrderItemDetails
  .OrderLineItem.Variation
MerchantDataVariationType Conditionally Variations are multiple similar (but not identical) items in one fixed-price listing. For example, a clothing listing can contain items of the same brand that vary by color and size. Each variation specifies a combination of one of these colors and sizes. Each variation can have a different quantity and price. Only returned if the order line item is for a variation.
OrderDetails.OrderItemDetails
  .OrderLineItem.Variation.Price
AmountType (double) Always The fixed price of all items identified by this variation. For example, a "Blue, Large" variation price could be USD 10.00, and a "Black, Medium" variation price could be USD 5.00.

OrderDetails.OrderItemDetails
  .OrderLineItem.Variation.Price
  [ attribute currencyID ]
CurrencyCodeType Always The fixed price of all items identified by this variation. For example, a "Blue, Large" variation price could be USD 10.00, and a "Black, Medium" variation price could be USD 5.00.



For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.OrderItemDetails
  .OrderLineItem.Variation
  .Quantity
int Always For ActiveInventoryReport: The number of items available for sale that are associated with this variation.

For SoldReport: The total number of items associated with the variation (including the quantity sold). To calculate the quantity available for sale, subtract the variation's QuantitySold from this value.
OrderDetails.OrderItemDetails
  .OrderLineItem.Variation
  .SellingStatus
MerchantDataSellingStatusType Always Contains the variation's quantity sold. Always returned when variations are present.
OrderDetails.OrderItemDetails
  .OrderLineItem.Variation
  .SellingStatus.QuantitySold
int Always Total number of items sold in the variation (across the variation's lifetime). To determine the quantity sold for the order line item, use OrderLineItem.QuantitySold.
OrderDetails.OrderItemDetails
  .OrderLineItem.Variation.SKU
SKUType (string) Conditionally Stock Keeping Unit that serves as the seller's unique identifier for items within the same variation. You can use the variation's SKU instead of the variation specifics to revise a variation and to keep track of your eBay inventory.

Many merchants assign a SKU to an item of a specific type, size, and color. This way, they can keep track of how many products of each type, size, and color are selling, and they can re-stock their shelves or update the variation quantity on eBay according to customer demand.

Only returned if the seller specified a SKU for the variation.
OrderDetails.OrderItemDetails
  .OrderLineItem.Variation
  .VariationSpecifics
NameValueListArrayType Conditionally A list of name/value pairs that uniquely identify the variation within the listing. All variations specify the same set of names, and each variation provides a unique combination of values for those names. For example, if the items vary by color and size, then every variation specifies Color and Size as names, and no two variations specify the same combination of color and size values.

If a variation has no SKU, use the variation specifics as a unique ID to revise the variation and to keep track of your eBay inventory.
OrderDetails.OrderItemDetails
  .OrderLineItem.Variation
  .VariationSpecifics
  .NameValueList
NameValueListType Conditionally,
repeatable: [0..*]
For the AddItem family of calls: Contains the name and value(s) for an Item Specific. Only required when the ItemSpecifics container is specified.

For the AddFixedPriceItem family of calls: The same NameValueList schema is used for the ItemSpecifics node, the VariationSpecifics node, and the VariationSpecifcsSet node.

If the listing has varations, any name that you use in the VariationSpecifics and VariationSpecificsSet nodes can't be used in the ItemSpecifics node.
When you list with Item Variations:
  • Specify shared Item Specifics (e.g., Brand) in the ItemSpecifics node.
  • Specify up to five VariationSpecifics in each Variation node.
  • Specify all applicable names with all their supported values in the VariationSpecificSet node.
See the Variation sample in the AddFixedPriceItem call reference for examples.

For PlaceOffer: Required if the item being purchased includes Item Variations.

For more details, see Requiring Product Identifiers Mandate
OrderDetails.OrderItemDetails
  .OrderLineItem.Variation
  .VariationSpecifics
  .NameValueList.Name
string Conditionally Depending on the call and context, this value is either a name of an Item/Category/Variation Specific, a Parts Compatibility name, or a product identifier type.

For the AddItem and AddFixedPriceItem families of calls: In the ProductListingDetails.NameValueList (single-variation listing) and VariationProductListingDetails.NameValueList (multiple-variation listing) context, this value is the product identifier type, such as ISBN or UPC. Product identifier types that are supported/required for a specific category can be retrieved using the GetCategorySpecifics call.

For the AddItem and AddFixedPriceItem families of calls: In the Item.ItemSpecifics context, this can be any name that the seller wants to use. However, to help buyers find items more easily, it is a good idea to try to use a recommended name when possible (see GetCategorySpecifics). You can't specify the same name twice within the same listing.

For the AddFixedPriceItem family of calls: In the VariationSpecifics context, this can be any name that the seller wants to use, unless the VariationsEnabled flag is false for the name in the GetCategorySpecifics response. For example, for some categories eBay may recommend that you only use "Brand" as a shared name at the Item level, not in variations.

For the AddFixedPriceItem family of calls: In the Compatibility.NameValueList context, this value is a motor vehicle aspect such as Year, Make, and Model. A Compatibility.NameValueList container is applicable for motor vehicle parts and accessories listings.

For GetCategorySpecifics: This is a recommended (popular) name to use for items in the specified category (e.g., "Brand" might be recommended, not "Manufacturer").

For PlaceOffer: Required if the item being purchased includes Item Variations.

Note: If Brand and MPN (Manufacturer Part Number) are being used to identify product variations in a multiple-variation listing, the Brand must be specified at the item level (ItemSpecifics container) and the MPN for each product variation must be specified at the variation level (VariationSpecifics container). The Brand name must be the same for all variations within a single listing.
Max length: 65.
OrderDetails.OrderItemDetails
  .OrderLineItem.Variation
  .VariationSpecifics
  .NameValueList.Value
string Conditionally,
repeatable: [0..*]
Depending on the call and context, this value is either the value of an Item/Category/Variation Specific, a Parts Compatibility value, or a product identifier.

For the AddItem family of calls: If you specify multiple values for Item Specifics, eBay only stores the first one, unless GetCategorySpecifics indicates that the corresponding name supports multiple values.

For the AddItem and AddFixedPriceItem families of calls: In the ProductListingDetails.NameValueList (single-variation listing) and VariationProductListingDetails.NameValueList (multiple-variation listing) context, this value is the product identifier, such as ISBN or UPC. Product identifier types that are supported/required for a specific category can be retrieved using the GetCategorySpecifics call.

For the AddFixedPriceItem family of calls: If you specify multiple values for Item Specifics or Variation Specifics, eBay only stores the first one, unless GetCategorySpecifics indicates that the corresponding name supports multiple values.

In VariationSpecificSet, you typically specify multiple Value fields for each name. For example, if Name = Size, you would specify all size values that you wan to offer in the listing.

For the Compatibility.NameValueList context, this is the corresponding value of a motor vehicle aspect such as Year, Make, and Model. A Compatibility.NameValueList container is applicable for motor vehicle parts and accessories listings.

For GetCategorySpecifics: The most highly recommended values are returned first. For these calls, Value is only returned when recommended values are available.

For PlaceOffer: Required if the item being purchased includes Item Variations.


Max length: 65.
OrderDetails.OrderTotalCost AmountType (double) Always Calculated total for all fees, tax, and sale price(s) in this order.
OrderDetails.OrderTotalCost
  [ attribute currencyID ]
CurrencyCodeType Always Calculated total for all fees, tax, and sale price(s) in this order.

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails
  .PaymentClearedTime
dateTime Conditionally 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.
OrderDetails.PaymentHoldStatus PaymentHoldStatusCodeType Always Contains the status of a PayPal payment hold on the item.

Applicable values: See PaymentHoldStatus.
Code so that your app gracefully handles any future changes to this list.
OrderDetails.PickupDetails PickupDetailsType Conditionally Contains all local pickup related information.
OrderDetails.PickupDetails
  .PickupOptions
PickupOptionsType Conditionally,
repeatable: [0..*]
Container consisting of a pickup method and the priority of the pickup method. The priority of each pickup method controls the order (relative to other pickup methods) in which the corresponding pickup method will appear in the View Item and Checkout page.

This container is always returned prior to order payment if the seller created/revised/relisted the item with the EligibleForPickupInStore and/or EligibleForPickupDropOff flag in the call request set to 'true'. If and when the In-Store pickup method (US only) or 'Click and Collect' pickup method (UK and Australia only) is selected by the buyer and payment for the order is made, this container will no longer be returned in the response, and will essentially be replaced by the PickupMethodSelected container.

Note: At this time, the In-Store Pickup and Click and Collect features are generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings.
OrderDetails.PickupDetails
  .PickupOptions.PickupMethod
token Conditionally This value indicates an available pickup method. This field is always returned with the PickupOptions container.

Note: At this time, 'InStorePickup' and 'PickUpDropOff' are the only available pickup methods; however, additional pickup methods may be added to the list in future releases.

Note: A seller must be eligible for the In-Store Pickup or Click and Collect feature to list an item that is eligible for In-Store Pickup or Click and Collect. At this time, these features are generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings.

Applicable values: See PickupMethodCodeType
OrderDetails.PickupDetails
  .PickupOptions.PickupPriority
int Conditionally This integer value indicates the priority of the pickup method. The priority of each pickup method controls the order (relative to other pickup methods) in which the corresponding pickup method will appear in the View Item and Checkout page. This field is always returned with the PickupOptions container.

Note: A seller must be eligible for the In-Store Pickup or Click and Collect features to list an item that is eligible for In-Store Pickup or Click and Collect. At this time, these features are generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings.
OrderDetails
  .PickupMethodSelected
PickupMethodSelectedType Conditionally Contains the information about buyer selected pickup method
OrderDetails
  .PickupMethodSelected
  .MerchantPickupCode
string Conditionally The unique reference number defined by the merchant to track In-Store Pickup orders. The MerchantPickupCode is picked up by eBay if it is set by the merchant through the payload of a notification sent to eBay through the Inbound Notifications API. This field is only returned with the PickupMethodSelected container if it set by the merchant.

For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the real reference number is only returned to the buyer or seller, and a string value of Unavailable will be returned to all third parties.

Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API.
OrderDetails
  .PickupMethodSelected
  .PickupMethod
token Conditionally This value indicates the local pickup method that was selected by the buyer at checkout. This field is always returned with the PickupMethodSelected container.

Note: Merchants must be eligible for the In-Store Pickup or "Click and Collect" feature to list items that are eligible for these local pickup methods.

Applicable values: See PickupMethodCodeType
OrderDetails
  .PickupMethodSelected
  .PickupStatus
PickupStatusCodeType Conditionally This field indicates the current status of the local pickup order. The value of the PickupStatus field can change during the lifecycle of the order based on the notifications that a merchant sends to eBay through the Inbound Notifications API. This field is always returned with the PickupMethodSelected container.

Note: A seller must be eligible for the In-Store Pickup or Click and Collect features to list an item that is eligible for these features. At this time, these features are generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API.

Applicable values: See PickupStatus.
Code so that your app gracefully handles any future changes to this list.
OrderDetails
  .PickupMethodSelected
  .PickupStoreID
string Conditionally The unique identifier of the merchant's store where the item will be picked up. The PickupStoreID is picked up by eBay based on the LocationID value that is set by the merchant in the Inventory Management API. This field is always returned with the PickupMethodSelected container.

Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API.
OrderDetails
  .SellingManagerSaleRecordID
int Conditionally For users of the Selling Manager or Selling Manager Pro tools only. If you are not using Selling Manager or Selling Manager Pro, this field will not be returned in your response.

Unique identifier for the record, assigned by eBay. An example of a recordId: 1111:222:333:444:x.
OrderDetails.ShipCityName string Conditionally Displays the buyer's city name (from the shipping address on their eBay user account). 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.
OrderDetails.ShipCountryName token Conditionally Displays the buyer's ISO 3166 country code (from the shipping address on their eBay user account). Only returned if payment has been marked as sent.

Applicable values: See CountryCodeType
OrderDetails.ShippingCost AmountType (double) Always Calculated shipping cost based on item weight, buyer's postal code, and shipping service.
OrderDetails.ShippingCost
  [ attribute currencyID ]
CurrencyCodeType Always Calculated shipping cost based on item weight, buyer's postal code, and shipping service.

For a list of possible enumeration values, see CurrencyCodeType.
OrderDetails.ShippingService string Always Name of the shipping service for display purposes.

Note that this value can change for aesthetic purposes, whereas the ShippingServiceToken will not. Therefore, for all practical purposes, use ShippingServiceToken when programmatically reading and processing.

See ShippingServiceToken.

OrderDetails
  .ShippingServiceToken
string Always Value used for the shipping service. For a list of valid values, call GeteBayDetails with DetailName set to ShippingServiceDetails.lt;br>
Related fields:
Item.ShippingDetails.InternationalShippingServiceOption.ShippingService in AddFixedPriceItem
Item.ShippingDetails.ShippingServiceOptions.ShippingService in AddFixedPriceItem
OrderDetails.ShipPostalCode string Conditionally Displays the buyer's postal code or zip code (from the shipping address on their eBay user account). Only returned if payment has been marked as sent.
OrderDetails.ShipRecipientName string Conditionally Displays the buyer's recipient name for shipping (from the shipping address on their eBay user account). Only returned if payment has been marked as sent.
OrderDetails.ShipReferenceId string Conditionally Uniquely identifies an order shipped using the Global Shipping Program. This value is generated by eBay when the order is completed. The international shipping provider uses the ReferenceID as the primary reference when processing the shipment. Sellers must include this value on the package immediately above the street address of the international shipping provider. Example: "Reference #1234567890123456"
OrderDetails
  .ShipStateOrProvince
string Conditionally Displays the buyer's state or province name (from the shipping address on their eBay user account). Only returned if payment has been marked as sent.
OrderDetails.ShipStreet1 string Conditionally Displays the buyer's street name (from the shipping address on their eBay user account). Only returned if payment has been marked as sent.
OrderDetails.ShipStreet2 string Conditionally Displays the second line of a buyer's street name (if one exists in the shipping address on their eBay user account). Only returned if payment has been marked as sent.
OrderDetails.TaxAmount AmountType (double) Always Calculated tax fee based on the sale price and the sales tax at the seller's location.
OrderDetails.TaxAmount
  [ attribute currencyID ]
CurrencyCodeType Always Calculated tax fee based on the sale price and the sales tax at the seller's location.

For a list of possible enumeration values, see CurrencyCodeType.



Samples

New to making API calls? Please see Making a Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Sample: Basic Call

Lists the sold items for a specific seller ID (ID associated with the auth token) and returns an Order ID and Order Line Item ID for each item.

This sample represents a data file that you will download using the Bulk Data Exchange Service and File Transfer Service.

Description

User megaonlinemerchant wants to see a list of her sold eBay items. She sends a Bulk Data Exchange startDownloadJob request with the SoldReport parameter, uses a Bulk Data Exchange getJobStatus request to see if her report is ready to download, and then sends a File Transfer Service downloadJob request to retrieve the report data.

Input

Since a Large Merchant Services report returns a pre-determined set of elements, there is no input request for a report. Instead, the report type is specified as a parameter of a Bulk Data Exchange startDownloadJob call.

XML format.

 
Do not send a request file for reports. See description above.

Output

The response returns Order or Line Item details for each sold item. Every time you receive a Sold Report it will contain all of the items that you have sold, unless you acknowledge each order or line item using an OrderAck request. After you acknowledge an order, it will no longer show up in your Sold Reports.

XML format.
<?xml version="1.0" encoding="utf-8"?>
<BulkDataExchangeResponses xmlns="urn:ebay:apis:eBLBaseComponents">
  <SoldReport>
    <OrderDetails>
      <OrderID>110035808425-23344921001</OrderID>
      <BuyerUserID>430096</BuyerUserID>
      <BuyerFirstName>Sean</BuyerFirstName>
      <BuyerLastName>Brown</BuyerLastName>
      <BuyerEmail>test_user@company.com</BuyerEmail>
      <BuyerPhone>1-800-111-1111</BuyerPhone>
      <ShippingService>UPS Ground</ShippingService>
      <CheckoutSiteID>0</CheckoutSiteID>
      <OrderCreationTime>2008-11-25T16:57:46.000Z</OrderCreationTime>
      <TaxAmount currencyID="USD">0.00</TaxAmount>
      <InsuranceCost currencyID="USD">0.00</InsuranceCost>
      <ShippingCost currencyID="USD">0.00</ShippingCost>
      <OrderTotalCost currencyID="USD">100.00</OrderTotalCost>
      <OrderItemDetails>
        <OrderLineItem>
          <OrderLineItemID>110035808425-23344921001</OrderLineItemID>
          <ItemID>110035808425</ItemID>
          <SKU>1122334455-12-1</SKU>
          <QuantitySold>2</QuantitySold>
          <SalePrice currencyID="USD">50.00</SalePrice>
          <TaxAmount currencyID="USD">0.00</TaxAmount>
          <ShippingCost currencyID="USD">0.00</ShippingCost>
          <TotalCost currencyID="USD">100.00</TotalCost>
          <InsuranceCost currencyID="USD">0.00</InsuranceCost>
          <ListingSiteID>0</ListingSiteID>
          <SellingManagerSalesRecordID>103</SellingManagerSalesRecordID>
        </OrderLineItem>
      </OrderItemDetails>
    </OrderDetails>
    <OrderDetails>
      <OrderID>110035808425-23344920001</OrderID>
      <BuyerUserID>430096</BuyerUserID>
      <BuyerFirstName>Sean</BuyerFirstName>
      <BuyerLastName>Brown</BuyerLastName>
      <BuyerEmail>test_user@company.com</BuyerEmail>
      <BuyerPhone>1-800-111-1111</BuyerPhone>
      <ShippingService>UPS Ground</ShippingService>
      <CheckoutSiteID>0</CheckoutSiteID>
      <OrderCreationTime>2008-11-25T16:57:25.000Z</OrderCreationTime>
      <TaxAmount currencyID="USD">0.00</TaxAmount>
      <InsuranceCost currencyID="USD">0.00</InsuranceCost>
      <ShippingCost currencyID="USD">0.00</ShippingCost>
      <OrderTotalCost currencyID="USD">50.00</OrderTotalCost>
      <OrderItemDetails>
        <OrderLineItem>
          <OrderLineItemID>110035808425-23344920001</OrderLineItemID>
          <ItemID>110035808425</ItemID>
          <SKU>1122334455-12-1</SKU>
          <QuantitySold>1</QuantitySold>
          <SalePrice currencyID="USD">50.00</SalePrice>
          <TaxAmount currencyID="USD">0.00</TaxAmount>
          <ShippingCost currencyID="USD">0.00</ShippingCost>
          <TotalCost currencyID="USD">50.00</TotalCost>
          <InsuranceCost currencyID="USD">0.00</InsuranceCost>
          <ListingSiteID>0</ListingSiteID>
          <SellingManagerSalesRecordID>104</SellingManagerSalesRecordID>
        </OrderLineItem>
      </OrderItemDetails>
    </OrderDetails>
    <OrderDetails>
      <OrderID>110035808425-23344919001</OrderID>
      <BuyerUserID>430096</BuyerUserID>
      <BuyerFirstName>Sean</BuyerFirstName>
      <BuyerLastName>Brown</BuyerLastName>
      <BuyerEmail>test_user@company.com</BuyerEmail>
      <BuyerPhone>1-800-111-1111</BuyerPhone>
      <ShippingService>UPS Ground</ShippingService>
      <CheckoutSiteID>0</CheckoutSiteID>
      <OrderCreationTime>2008-11-25T16:57:13.000Z</OrderCreationTime>
      <TaxAmount currencyID="USD">0.00</TaxAmount>
      <InsuranceCost currencyID="USD">0.00</InsuranceCost>
      <ShippingCost currencyID="USD">0.00</ShippingCost>
      <OrderTotalCost currencyID="USD">50.00</OrderTotalCost>
      <OrderItemDetails>
        <OrderLineItem>
          <OrderLineItemID>110035808425-23344919001</OrderLineItemID>
          <ItemID>110035808425</ItemID>
          <SKU>1122334455-12-1</SKU>
          <QuantitySold>1</QuantitySold>
          <SalePrice currencyID="USD">50.00</SalePrice>
          <TaxAmount currencyID="USD">0.00</TaxAmount>
          <ShippingCost currencyID="USD">0.00</ShippingCost>
          <TotalCost currencyID="USD">50.00</TotalCost>
          <InsuranceCost currencyID="USD">0.00</InsuranceCost>
          <ListingSiteID>0</ListingSiteID>
          <SellingManagerSalesRecordID>105</SellingManagerSalesRecordID>
        </OrderLineItem>
      </OrderItemDetails>
    </OrderDetails>
    <OrderDetails>
      <OrderID>110035808513-23323318001</OrderID>
      <BuyerUserID>132943282</BuyerUserID>
      <BuyerFirstName>Test</BuyerFirstName>
      <BuyerLastName>User</BuyerLastName>
      <BuyerEmail>test_user@company.com</BuyerEmail>
      <BuyerPhone>1-800-111-1111</BuyerPhone>
      <ShippingService>NotSelected</ShippingService>
      <CheckoutSiteID>0</CheckoutSiteID>
      <OrderCreationTime>2008-11-20T17:45:35.000Z</OrderCreationTime>
      <TaxAmount currencyID="USD">0.00</TaxAmount>
      <InsuranceCost currencyID="USD">0.00</InsuranceCost>
      <ShippingCost currencyID="USD">0.00</ShippingCost>
      <OrderTotalCost currencyID="USD">50.00</OrderTotalCost>
      <OrderItemDetails>
        <OrderLineItem>
          <OrderLineItemID>110035808513-23323318001</OrderLineItemID>
          <ItemID>110035808513</ItemID>
          <SKU>1122334455-12-1</SKU>
          <QuantitySold>1</QuantitySold>
          <SalePrice currencyID="USD">50.00</SalePrice>
          <TaxAmount currencyID="USD">0.00</TaxAmount>
          <ShippingCost currencyID="USD">0.00</ShippingCost>
          <TotalCost currencyID="USD">50.00</TotalCost>
          <InsuranceCost currencyID="USD">0.00</InsuranceCost>
          <ListingSiteID>0</ListingSiteID>
          <SellingManagerSalesRecordID>106</SellingManagerSalesRecordID>
        </OrderLineItem>
      </OrderItemDetails>
    </OrderDetails>
    <OrderDetails>
      <OrderID>110035817938-23323316001</OrderID>
      <BuyerUserID>132943282</BuyerUserID>
      <BuyerFirstName>Test</BuyerFirstName>
      <BuyerLastName>User</BuyerLastName>
      <BuyerEmail>test_user@company.com</BuyerEmail>
      <BuyerPhone>1-800-111-1111</BuyerPhone>
      <ShippingService>NotSelected</ShippingService>
      <CheckoutSiteID>0</CheckoutSiteID>
      <OrderCreationTime>2008-11-20T17:42:52.000Z</OrderCreationTime>
      <TaxAmount currencyID="USD">0.00</TaxAmount>
      <InsuranceCost currencyID="USD">4.30</InsuranceCost>
      <ShippingCost currencyID="USD">0.00</ShippingCost>
      <OrderTotalCost currencyID="USD">110.00</OrderTotalCost>
      <OrderItemDetails>
        <OrderLineItem>
          <OrderLineItemID>110035817938-23323316001</OrderLineItemID>
          <ItemID>110035817938</ItemID>
          <SKU>1122334455-13</SKU>
          <QuantitySold>2</QuantitySold>
          <SalePrice currencyID="USD">55.00</SalePrice>
          <TaxAmount currencyID="USD">0.00</TaxAmount>
          <ShippingCost currencyID="USD">0.00</ShippingCost>
          <TotalCost currencyID="USD">110.00</TotalCost>
          <InsuranceCost currencyID="USD">4.30</InsuranceCost>
          <ListingSiteID>0</ListingSiteID>
          <SellingManagerSalesRecordID>107</SellingManagerSalesRecordID>
        </OrderLineItem>
      </OrderItemDetails>
    </OrderDetails>
    <OrderDetails>
      <OrderID>110035817828-23317658001</OrderID>
      <BuyerUserID>397681</BuyerUserID>
      <BuyerFirstName>TestLastName</BuyerFirstName>
      <BuyerLastName>TestFirstName</BuyerLastName>
      <BuyerEmail>test_user@company.com</BuyerEmail>
      <BuyerPhone>1-800-111-1111</BuyerPhone>
      <ShippingService>Expedited Int'l Flat Rate Shipping</ShippingService>
      <CheckoutSiteID>0</CheckoutSiteID>
      <OrderCreationTime>2008-11-18T22:21:12.000Z</OrderCreationTime>
      <TaxAmount currencyID="USD">0.00</TaxAmount>
      <InsuranceCost currencyID="USD">3.50</InsuranceCost>
      <ShippingCost currencyID="USD">15.20</ShippingCost>
      <OrderTotalCost currencyID="USD">23.70</OrderTotalCost>
      <OrderItemDetails>
        <OrderLineItem>
          <OrderLineItemID>110035817828-23317658001</OrderLineItemID>
          <ItemID>110035817828</ItemID>
          <SKU>cmg00002</SKU>
          <QuantitySold>1</QuantitySold>
          <SalePrice currencyID="USD">5.00</SalePrice>
          <TaxAmount currencyID="USD">0.00</TaxAmount>
          <ShippingCost currencyID="USD">15.20</ShippingCost>
          <TotalCost currencyID="USD">23.70</TotalCost>
          <InsuranceCost currencyID="USD">3.50</InsuranceCost>
          <ListingSiteID>0</ListingSiteID>
          <SellingManagerSalesRecordID>108</SellingManagerSalesRecordID>
        </OrderLineItem>
      </OrderItemDetails>
    </OrderDetails>
    <OrderDetails>
      <OrderID>110035808177-23317657001</OrderID>
      <BuyerUserID>397681</BuyerUserID>
      <BuyerFirstName>TestLastName</BuyerFirstName>
      <BuyerLastName>TestFirstName</BuyerLastName>
      <BuyerEmail>test_user@company.com</BuyerEmail>
      <BuyerPhone>1-800-111-1111</BuyerPhone>
      <ShippingService>NotSelected</ShippingService>
      <CheckoutSiteID>0</CheckoutSiteID>
      <OrderCreationTime>2008-11-18T22:16:34.000Z</OrderCreationTime>
      <TaxAmount currencyID="USD">0.00</TaxAmount>
      <InsuranceCost currencyID="USD">2.15</InsuranceCost>
      <ShippingCost currencyID="USD">0.00</ShippingCost>
      <OrderTotalCost currencyID="USD">50.00</OrderTotalCost>
      <OrderItemDetails>
        <OrderLineItem>
          <OrderLineItemID>110035808177-23317657001</OrderLineItemID>
          <ItemID>110035808177</ItemID>
          <SKU>1122334455-12</SKU>
          <QuantitySold>1</QuantitySold>
          <SalePrice currencyID="USD">50.00</SalePrice>
          <TaxAmount currencyID="USD">0.00</TaxAmount>
          <ShippingCost currencyID="USD">0.00</ShippingCost>
          <TotalCost currencyID="USD">50.00</TotalCost>
          <InsuranceCost currencyID="USD">2.15</InsuranceCost>
          <ListingSiteID>0</ListingSiteID>
          <SellingManagerSalesRecordID>109</SellingManagerSalesRecordID>
        </OrderLineItem>
      </OrderItemDetails>
    </OrderDetails>
    <OrderDetails>
      <OrderID>110035817827-23317655001</OrderID>
      <BuyerUserID>397681</BuyerUserID>
      <BuyerFirstName>TestLastName</BuyerFirstName>
      <BuyerLastName>TestFirstName</BuyerLastName>
      <BuyerEmail>test_user@company.com</BuyerEmail>
      <BuyerPhone>1-800-111-1111</BuyerPhone>
      <ShippingService>NotSelected</ShippingService>
      <CheckoutSiteID>0</CheckoutSiteID>
      <OrderCreationTime>2008-11-18T22:04:58.000Z</OrderCreationTime>
      <TaxAmount currencyID="USD">0.00</TaxAmount>
      <InsuranceCost currencyID="USD">1.00</InsuranceCost>
      <ShippingCost currencyID="USD">0.00</ShippingCost>
      <OrderTotalCost currencyID="USD">65.00</OrderTotalCost>
      <OrderItemDetails>
        <OrderLineItem>
          <OrderLineItemID>110035817827-23317655001</OrderLineItemID>
          <ItemID>110035817827</ItemID>
          <SKU>cmg00001</SKU>
          <QuantitySold>1</QuantitySold>
          <SalePrice currencyID="USD">65.00</SalePrice>
          <TaxAmount currencyID="USD">0.00</TaxAmount>
          <ShippingCost currencyID="USD">0.00</ShippingCost>
          <TotalCost currencyID="USD">65.00</TotalCost>
          <InsuranceCost currencyID="USD">1.00</InsuranceCost>
          <ListingSiteID>0</ListingSiteID>
          <SellingManagerSalesRecordID>110</SellingManagerSalesRecordID>
        </OrderLineItem>
      </OrderItemDetails>
    </OrderDetails>
  </SoldReport>
</BulkDataExchangeResponses>



Change History

Change Date Description
955
2016-02-12
  • BuyerPaymentMethodCodeType (modified): The Moneybookers, ProPay, and Paymate enumeration values have been deprecated, and will no longer be returned in any calls.
879
2014-06-17
  • PickuMethodCodeType (modified): 'PickUpDropOff' value added to handle the use case when the buyer selects "Click and Collect" as the pickup method. The "Click and Collect" feature is currently only available on the eBay UK site.
843
2013-09-24
  • OrderDetails.PaymentClearedTime, OrderDetails.ShipCityName, OrderDetails.ShipCountryName, OrderDetails.ShipPostalCode, OrderDetails.ShipRecipientName, OrderDetails.ShipStateOrProvince, OrderDetails.ShipStreet1, OrderDetails.ShipStreet2 (doc change): The previously described condition for these fields to be returned was incorrect. They are returned only if payment for the order has been cleared.
841
2013-09-19
  • OrderDetails.ShipCityName, OrderDetails.ShipCountryName, OrderDetails.ShipPostalCode, OrderDetails.ShipRecipientName, OrderDetails.ShipStateOrProvince, OrderDetails.ShipStreet1, OrderDetails.ShipStreet2 (modified): These fields are only returned if the downloadRequestFilter.soldReportFilter is set in the corresponding startDownloadJob call of the Bulk Data Exchange API.
837
2013-08-29
  • PickupDetails (added): This In-Store Pickup container is now returned in SoldReport.
  • PickupMethodSelected (added): This In-Store Pickup container is now returned in SoldReport.
799
2012-11-07
  • OrderDetails (modified): When an order ships via the Global Shipping Program, the following fields returned in the OrderDetails container now contain information specific to the domestic leg of the shipment: OrderTotalCost, ShipCityName, ShipCountryName, ShippingCost, ShippingService, ShippingServiceToken, ShipPostalCode, ShipStateOrProvince, ShipStreet1 and ShipStreet2. For more information, see the descriptions of the individual fields.
  • OrderLineItem (modified): When an order ships via the Global Shipping Program, the ShippingCost and TotalCost fields returned in the OrderLineItem container now contain information specific to the domestic leg of the shipment. For more information, see the descriptions of the fields.
797
2012-10-24
  • OrderLineItem.UnpaidItem (added): This container is only returned if an Unpaid Item case has been opened against the corresponding order line item. The fields in this container report the status of the case and whether the case was opened manually be the seller, or if the case was opened automatically through the Unpaid Item Assistant mechanism.
  • OrderDetails.ShipReferenceId (added): A unique identifier that is used by the international shipping provider for an order that is being shipped using the Global Shipping Program. This value is generated by eBay after checkout is complete. The seller must input this value on the shipping label just above the street address of the international shipping provider.
787
2012-08-15
  • ActualShippingCost (added): The actual shipping cost for an order line item. This field is returned only if a seller-defined promotional shipping rule is applied to the order, and only after payment is made by the buyer.
783
2012-07-18
  • ShippingCost (modified): For order line items with Calculated shipping type, the correct shipping cost is returned only after buyer payment, as part of the total cost in OrderDetails.ShippingCost. For order line items with Flat shipping type, the correct shipping cost is returned for the order line item in OrderDetails.OrderItemDetails.OrderLineItem.ShippingCost, and before buyer payment in OrderDetails.ShippingCost. It is returned as part of the total cost, after buyer payment in OrderDetails.ShippingCost.
675
2010-06-23
  • OrderDetails.OrderItemDetails.OrderLineItem.Taxes (added): Reserved for future use.
673
2010-6-9
  • OrderDetails.BuyerStaticAlias (added): Buyer's static email address. Used for for eBay intermediated emails.
657
2010-2-17
  • Price, Variations (added): New Variations node for details that apply to multi-variation listings. Also note that SKUDetails.Price might not be returned when Variation.Price is present.
  • OrderLineItemType.TaxCategory (added): Added to support future account functionality.
  • All Amount Values (modified): All amount values will now be returned as xs:double.
  • All (modified): Schema elements were re-ordered to match report output.
639
2009-10-14
  • OrderDetailsType.SellingManagerSaleRecordID, OrderLineItemType.SellingManagerSaleRecordID (added): New Selling Manager or Selling Manager Pro element included in the order and line item details.
589
2008-11-29
  • (added) New call.