eBay Trading APIVersion 1349
 

TransactionType

Contains information about a sales transaction from an eBay listing. This identifier is automatically created by the eBay system once a buyer has committed to make a purchase in an auction or fixed-price listing. A fixed-priced listing (single or multiple-variation) with multiple quantity can spawn one or more sales transactions.

Types that use TransactionType:

Calls that use TransactionType:

Fields

ListingCheckoutRedirectPreference ( ListingCheckoutRedirectPreferenceType )
RefundArray ( RefundArrayType )


ActualHandlingCost ( AmountType (double) ) [0..1]
The handling cost that the seller has charged for the order line item. This field is only returned after checkout is complete.

The value of this field is returned as zero dollars (0.0) if the seller did not specify a handling cost for the listing.
See the Field Index to learn which calls use ActualHandlingCost.

ActualShippingCost ( AmountType (double) ) [0..1]
The shipping cost paid by the buyer for the order line item. This field is only returned after checkout is complete.
See the Field Index to learn which calls use ActualShippingCost.

AdjustmentAmount ( AmountType (double) ) [0..1]
This value indicates the dollar amount by which the buyer has adjusted the the total cost of the sales transaction. Adjustments to sales transaction costs may include shipping and handling, buyer discounts, or added services. A positive amount indicates the amount is an extra charge being paid to the seller by the buyer. A negative value indicates this amount is a credit given to the buyer by the seller.

This field is always returned, even if there was no cost adjustment to the sales transaction. Its value will just be '0.0' if there was no cost adjustment.
See the Field Index to learn which calls use AdjustmentAmount.

AmountPaid ( AmountType (double) ) [0..1]
The total amount the buyer paid for the order line item. This amount includes all costs such as item cost, shipping/handling charges, and sales tax that is applied to the order by the seller. If the seller allowed the buyer to change the total for an order, the buyer is able to change the total up until the time when Checkout status is Complete. Determine whether the buyer changed the amount by retrieving the order line item data and comparing the AmountPaid value to what the seller expected. If multiple order line items between the same buyer and seller have been combined into a 'Combined Invoice' order, the AmountPaid value returned for each line item in the order reflects the total amount paid for the entire order, and not for the individual order line item. In a GetItemTransactions or GetSellerTransactions call, you can determine which order line items belong to the same 'Combined Invoice' order by checking to see if the ContainingOrder.OrderID value is the same.
See the Field Index to learn which calls use AmountPaid.

BestOfferSale ( boolean ) [0..1]
Indicates whether or not the sales transaction resulted from the seller accepting a Best Offer (or Counter Offer) from a buyer.
See the Field Index to learn which calls use BestOfferSale.

BundlePurchase ( boolean ) [0..1]
Not used by any call.

Boolean value indicating whether or not an order line item is part of a bundle purchase using Product Configurator.
See the Field Index to learn which calls use BundlePurchase.

Buyer ( UserType ) [0..1]
Container consisting of user and shipping details for the order's buyer. To be returned by GetItemsAwaitingFeedback the seller must be the one making the request.

For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this container 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, real data is only returned to the buyer or seller, and dummy/masked data will be returned to all third parties.
See the Field Index to learn which calls use Buyer.

BuyerCheckoutMessage ( string ) [0..1]
This field is returned if a buyer left a comment for the seller during the left by buyer during the checkout flow.

For 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, real data is only returned to the buyer or seller, and a string value of Unavailable will be returned to all third parties.
See the Field Index to learn which calls use BuyerCheckoutMessage.

BuyerMessage ( string ) [0..1]
Not used by any call.

Display message from buyer. This field holds transient data that is only being returned in Checkout-related notifications.
See the Field Index to learn which calls use BuyerMessage.

BuyerPackageEnclosures ( BuyerPackageEnclosuresType ) [0..1]
This container is returned in GetOrders (and other order management calls) if the 'Pay Upon Invoice' option is being offered to the buyer, and the seller is including payment instructions in the shipping package(s) for the order. The 'Pay Upon Invoice' option is only available on the Germany site.
See the Field Index to learn which calls use BuyerPackageEnclosures.

BuyerPaidStatus ( PaidStatusCodeType ) [0..1]
Specifies the paid status of the order.
See the Field Index to learn which calls use BuyerPaidStatus.

CartID ( string ) [0..1]
Not used by any call.

This field is no longer applicable as Shopping.com listings are no longer created or managed with eBay APIs.
See the Field Index to learn which calls use CartID.

CodiceFiscale ( string ) [0..1]
This field is returned if the IncludeCodiceFiscale flag is included in the request and set to true, and if the buyer has provided this value at checkout time.

This field is only applicable to buyers on the Italy and Spain sites. The Codice Fiscale number is unique for each Italian and Spanish citizen and is used for tax purposes.
See the Field Index to learn which calls use CodiceFiscale.

ContainingOrder ( OrderType ) [0..1]
This container is returned in a GetItemTransactions or GetSellerTransactions response if the IncludeContainingOrder field is included in the call request payload and set to 'true'. This container will be returned whether the order line item is the only line item in the order, or if the order has multiple line items.

Note: The new OrderLineItemCount field is automatically returned if the user is using Version 1113 of the Trading WSDL (or newer, as versions roll out). If the user is using Versions 1107 or 1111 of the Trading WSDL, the OrderLineItemCount field will only be returned if the user includes the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header and sets its value to 1113. If a user is using a Trading WSDL older than 1107, the OrderLineItemCount field will not be returned.
See the Field Index to learn which calls use ContainingOrder.

ConvertedAdjustmentAmount ( AmountType (double) ) [0..1]
This field shows the converted value of AdjustmentAmount in the currency of the site that returned the response. Refresh this value every 24 hours to pick up the current conversion rates.

This field is always returned, even if there was no cost adjustment to the sales transaction. Its value will just be '0.0' if there was no cost adjustment. This value should be the same as the value in AdjustmentAmount if the eBay listing site and the site that returned the response are the same, or use the same currency.
See the Field Index to learn which calls use ConvertedAdjustmentAmount.

ConvertedAmountPaid ( AmountType (double) ) [0..1]
This field shows the converted value of AmountPaid in the currency of the site that returned the response. Refresh this value every 24 hours to pick up the current conversion rates.

This field is always returned for paid orders. This value should be the same as the value in AmountPaid if the eBay listing site and the site that returned the response are the same, or use the same currency.
See the Field Index to learn which calls use ConvertedAmountPaid.

ConvertedTransactionPrice ( AmountType (double) ) [0..1]
This field shows the converted value of TransactionPrice in the currency of the site that returned the response. Refresh this value every 24 hours to pick up the current conversion rates.

This field is always returned for sales transactions. This value should be the same as the value in TransactionPrice if the eBay listing site and the site that returned the response are the same, or use the same currency.
See the Field Index to learn which calls use ConvertedTransactionPrice.

CreatedDate ( dateTime ) [0..1]
This timestamp indicates date/time when the sales transaction occurred. A sales transaction is created when there is a commitment to buy, or when the buyer purchases the item through a 'Buy it Now' option. For auction listings, a sales transaction is created when that listing ends with a high bidder whose bid meets or exceeds the Reserve Price (if set). For a fixed-price listing or a 'Buy It Now' auction listing, a sales transaction is created once the buyer clicks the Buy button.
See the Field Index to learn which calls use CreatedDate.

DepositType ( DepositTypeCodeType ) [0..1]
This value indicates whether or not the seller requires a deposit for the purchase of a motor vehicle. This field is only applicable to motor vehicle listings that require an initial deposit. A value of 'OtherMethod' will be returned if the motor vehicle listing requires an initial deposit, or a value of 'None' if an initial deposit is not required.
See the Field Index to learn which calls use DepositType.

DigitalDeliverySelected ( DigitalDeliverySelectedType ) [0..1]
This container is only returned by GetOrders and other order management calls if the buyer purchased a digital gift card for themselves, or is giving the digital gift card to someone else as a gift (in this case, the Gift boolean field will be returned with a value of true). The DigitalDeliverySelected container consists of information related to the digital gift card order line item, including the delivery method, delivery status, and recipient of the gift card (either the buyer, or another individual that is receiving the gift card as a gift from the buyer.
See the Field Index to learn which calls use DigitalDeliverySelected.

DutchAuctionBid ( AmountType (double) ) [0..1]
Not used by any call.

This field is deprecated.
See the Field Index to learn which calls use DutchAuctionBid.

eBayCollectAndRemitTax ( boolean ) [0..1]
This boolean field is returned as true if the line item is subject to a tax (US sales tax or Australian Goods and Services tax) that eBay will collect and remit to the proper taxing authority on the buyer's behalf. This field is also returned if false (not subject to eBay Collect and Remit). An eBayCollectAndRemitTaxes container is returned if the order line item is subject to such a tax, and the type and amount of this tax is displayed in the eBayCollectAndRemitTaxes.TaxDetails container.

Australian 'Goods and Services' tax (GST) is automatically charged to buyers outside of Australia when they purchase items on the eBay Australia site. Sellers on the Australia site do not have to take any extra steps to enable the collection of GST, as this tax is collected by eBay and remitted to the Australian government. For more information about Australian GST, see the Taxes and import charges help topic.

As of January 2023, buyers in all US states will automatically be charged sales tax for purchases, and the seller does not set this rate. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. For more US state-level information on sales tax, see the eBay sales tax collection help topic.
See the Field Index to learn which calls use eBayCollectAndRemitTax.

eBayCollectAndRemitTaxes ( TaxesType ) [0..1]
This container is returned if the order line item is subject to a tax (US sales tax or Australian Goods and Services tax) that eBay will collect and remit to the proper taxing authority on the buyer's behalf. The type of tax will be shown in the TaxDetails.Imposition and TaxDetails.TaxDescription fields, and the amount of this tax will be displayed in the TaxDetails.TaxAmount field.

Australian 'Goods and Services' tax (GST) is automatically charged to buyers outside of Australia when they purchase items on the eBay Australia site. Sellers on the Australia site do not have to take any extra steps to enable the collection of GST, as this tax is collected by eBay and remitted to the Australian government. For more information about Australian GST, see the Taxes and import charges help topic.

As of January 2023, buyers in all US states will automatically be charged sales tax for purchases, and the seller does not set this rate. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. For more US state-level information on sales tax, see the eBay sales tax collection help topic.
See the Field Index to learn which calls use eBayCollectAndRemitTaxes.

eBayPaymentID ( string ) [0..1]
The generated eBay payment ID used by the buyer when he/she chooses electronic transfer as payment method for paying the seller. This field is only applicable to the eBay Germany site (Site ID 77).
See the Field Index to learn which calls use eBayPaymentID.

eBayPlusTransaction ( boolean ) [0..1]
If true, the buyer of the order line item has a eBay Plus program subscription, and is eligible to receive the benefits of this program, such as fast, free shipping and free returns. Top-Rated eBay sellers must opt in to eBay Plus to be able offer the program on qualifying listings. Sellers must commit to next-day delivery of those items.

Note: Currently, eBay Plus is available only to buyers in Germany and Australia.
See the Field Index to learn which calls use eBayPlusTransaction.

ExtendedOrderID ( string ) [0..1]
A unique identifier for an eBay order. This field is only returned for paid orders, and not unpaid orders.
Note: ExtendedOrderID was first created when eBay changed the format of Order IDs back in June 2019. For a short period, the OrderID field showed the old Order ID format and the ExtendedOrderID field showed the new Order ID format. For paid orders, both OrderID and ExtendedOrderID now show the same Order ID value.
For GetOrders 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 correct Order ID is returned to the buyer or seller, but a dummy Order ID value of 1000000000000 will be returned to all third parties.
See the Field Index to learn which calls use ExtendedOrderID.

FeedbackLeft ( FeedbackInfoType ) [0..1]
This container consists of Feedback left by the caller for their order partner. This container is only returned if the order is complete and feedback on the order line item has been left by the caller.
See the Field Index to learn which calls use FeedbackLeft.

FeedbackReceived ( FeedbackInfoType ) [0..1]
This container consists of Feedback received by the caller from their order partner. This container is only returned if the order is complete and feedback on the order line item has been received by the caller.
See the Field Index to learn which calls use FeedbackReceived.

FinalValueFee ( AmountType (double) ) [0..1]
A Final Value Fee is calculated and charged to a seller's account immediately upon creation of an order line item. Note that this fee is created before the buyer makes a payment. As long as the IncludeFinalValueFee field is included in the call request and set to 'true', the Final Value Fee for each order line item is returned, regardless of the checkout status.

If a seller requests a Final Value Fee credit, the value of Transaction.FinalValueFee will not change if a credit is issued. The credit only appears in the seller's account data.
See the Field Index to learn which calls use FinalValueFee.

Gift ( boolean ) [0..1]
This boolean field is returned as true if the seller is giving a digital gift card to another individual as a gift. This field is only applicable for digital gift card order line items.
See the Field Index to learn which calls use Gift.

GiftSummary ( GiftSummaryType ) [0..1]
This container is returned in GetOrders and other order management calls if a buyer has purchased a digital gift card but has sent it to another individual as a gift, and has left a message for the recipient. The GiftSummary container consists of the message that the buyer wrote for the recipient of the digital gift card. A digital gift card line item is indicated if the DigitalDeliverySelected container is returned in the response, and if the digital gift card is sent to another individual as a gift, the Gift boolean field will be returned with a value of true.
See the Field Index to learn which calls use GiftSummary.

GuaranteedDelivery ( boolean ) [0..1]
This field is deprecated, and can be ignored if returned. The Guaranteed Delivery program is no longer supported on any eBay marketplace.
See the Field Index to learn which calls use GuaranteedDelivery.

GuaranteedShipping ( boolean ) [0..1]
Note: This field is for future use, as the eBay Guaranteed Shipping feature has been put on hold. eBay Guaranteed Shipping should not be confused with eBay Guaranteed Delivery, which is a completely different feature. This field is returned as true if the seller chose to use eBay's Guaranteed Shipping feature at listing time. With eBay's Guaranteed Shipping, the seller will never pay more for shipping than what is charged to the buyer. eBay recommends the shipping service option for the seller to use based on the dimensions and weight of the shipping package.
See the Field Index to learn which calls use GuaranteedShipping.

IntangibleItem ( boolean ) [0..1]
This flag indicates whether or not the order line item is an intangible good, such as an MP3 track or a mobile phone ringtone.
See the Field Index to learn which calls use IntangibleItem.

InventoryReservationID ( string ) [0..1]
The unique identifier of the inventory reservation.
See the Field Index to learn which calls use InventoryReservationID.

InvoiceSentTime ( dateTime ) [0..1]
This field indicates the date/time that an order invoice was sent from the seller to the buyer. This field is only returned if an invoice (containing the order line item) was sent to the buyer.
See the Field Index to learn which calls use InvoiceSentTime.

IsMultiLegShipping ( boolean ) [0..1]
Order line items requiring multiple shipping legs include items being shipped through the Global Shipping Program or through eBay International Shipping, as well as order line items subject to/eligible for the Authenticity Guarantee program. For both international shipping options, the address of the shipping logistics provider is shown in the MultiLegShippingDetails.SellerShipmentToLogisticsProvider.ShipToAddress container. Similarly, for Authenticity Guarantee orders, the authentication partner's shipping address is shown in the same container.

If an order line item is subject to the Authenticity Guarantee service, the Transaction.Program container will be returned.
See the Field Index to learn which calls use IsMultiLegShipping.

Item ( ItemType ) [0..1]
This container consists of relevant details about the listing associated with the sales transaction. Which listing fields are returned under this container will depend on the listing, the eBay marketplace, and the API call.

In an AddOrder call, only the unique identifier of the listing (ItemID) is needed to help identify the sales transaction to combine into a 'Combined Invoice' order.
See the Field Index to learn which calls use Item.

LinkedLineItemArray ( LinkedLineItemArrayType ) [0..1]
Note: This array is only returned if the order has associated linked line items. Container consisting of an array of linked line item objects.
See the Field Index to learn which calls use LinkedLineItemArray.

ListingCheckoutRedirectPreference ( ListingCheckoutRedirectPreferenceType ) [0..1]
Not used by any call.

This field is no longer applicable
See the Field Index to learn which calls use ListingCheckoutRedirectPreference.

LogisticsPlanType ( token ) [0..1]
This field will be returned at the order line item level only if the buyer purchased a digital gift card, which is delivered by email, or if the buyer purchased an item that is enabled with the 'Click and Collect' feature.

Currently, LogisticsPlanType has two applicable values: PickUpDropOff, which indicates that the buyer selected the 'Click and Collect' option. With Click and Collect, buyers are able to purchase from thousands of sellers on the eBay UK and Australia sites, and then pick up their order from the nearest 'eBay Collection Point', including over 750 Argos stores in the UK. The Click and Collect feature is only available on the eBay UK and Australia sites; or, DigitalDelivery, which indicates that the order line item is a digital gift card that will be delivered to the buyer or recipient of the gift card by email.
See the Field Index to learn which calls use LogisticsPlanType.

MonetaryDetails ( PaymentsInformationType ) [0..1]
Contains information about each monetary transaction that occurs for the order line item, including order payment, any refund, a credit, etc. Both the payer and payee are shown in this container.

Note: MonetaryDetails can already be used instead of the older ExternalTransaction container, and the ExternalTransaction container may eventually get deprecated. Due to this possibility, you are encouraged to start using MonetaryDetails as soon as it is convenient.
See the Field Index to learn which calls use MonetaryDetails.

MultiLegShippingDetails ( MultiLegShippingDetailsType ) [0..1]
This container consists of details related to the first leg of an order requiring multiple shipping legs. Types of orders that require multiple shipping legs include international orders going through the Global Shipping Program or through eBay International Shipping, as well as orders subject to/eligible for the Authenticity Guarantee program.

If the item is subject to the Authenticity Guarantee service program, the seller ships the item to the authentication partner, and if the item passes an authentication inspection, the authentication partner ships it directly to the buyer.

This container is only returned if the order has one or more order line items requiring multiple shipping legs.
See the Field Index to learn which calls use MultiLegShippingDetails.

OrderLineItemID ( string ) [0..1]
A unique identifier for an eBay order line item. This identifier is created as soon as there is a commitment to buy from the seller, or the buyer actually purchases the item using a 'Buy it Now' option.

For GetOrders 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, order line item ID is only returned to the buyer or seller, and a dummy value of 10000000000000 will be returned to all third parties.
See the Field Index to learn which calls use OrderLineItemID.

PaidTime ( dateTime ) [0..1]
Indicates the time when the buyer paid for the order and/or order was marked as 'Paid' by the seller. This field is returned once payment has been made by the buyer.

This value will only be visible to the user on either side of the order. An order can be marked as 'Paid' in the following ways:
  • Automatically when a payment is made through eBay's system
  • Seller marks the item as paid in My eBay or through Selling Manager Pro
  • Programmatically by the seller through the CompleteSale call.
See the Field Index to learn which calls use PaidTime.

PaisaPayID ( string ) [0..1]
This field is deprecated.
See the Field Index to learn which calls use PaisaPayID.

PickupDetails ( PickupDetailsType ) [0..1]
Container consisting of an array of PickupOptions containers. Each PickupOptions container consists of the pickup method and its priority. 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: A seller must be eligible for the In-Store Pickup feature or Click and Collect feature to list an item that is eligible for In-Store Pickup or Click and Collect. 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 multiple-quantity, fixed-price listings.
See the Field Index to learn which calls use PickupDetails.

PickupMethodSelected ( PickupMethodSelectedType ) [0..1]
This container consists of details related to the selected In-Store pickup method, including the pickup method, the merchant's store ID, the status of the In-Store pickup, and the pickup reference code (if provided by merchant).
See the Field Index to learn which calls use PickupMethodSelected.

This value indicates the site on which the sales transaction originated.

Note: Currently, the only value that should be returned in this field is eBay, as the Half.com marketplace no longer exists.
See the Field Index to learn which calls use Platform.

This container gives the status of an order line item going through the Authenticity Guarantee service process. In the Authenticity Guarantee service program, a third-party authenticator must verify the authenticity of the item before it can be sent to the buyer.

This container is only returned for order line items subject to the Authenticity Guarantee service process, and if it is returned, the seller must make sure to send the item to the third-party authenticator's address (shown in the MultiLegShippingDetails.SellerShipmentToLogisticsProvider.ShipToAddress field), and not to the buyer's shipping address. If the item is successfully authenticated, the authenticator will ship the item to the buyer.
See the Field Index to learn which calls use Program.

QuantityPurchased ( int ) [0..1]
This value indicates the quantity of the line item purchased at the same time by the same buyer from one listing. For auction listings, this value is always '1'. For fixed-price, non-variation listings, this value can be greater than 1.
See the Field Index to learn which calls use QuantityPurchased.

RefundAmount ( AmountType (double) ) [0..1]
Not used by any call.

This field is deprecated.
See the Field Index to learn which calls use RefundAmount.

RefundArray ( RefundArrayType ) [0..1]
Not used by any call.

Note: This container is only applicable for Half.com order refunds, and since the Half.com site has been shut down, this field is no longer applicable.
See the Field Index to learn which calls use RefundArray.

RefundStatus ( string ) [0..1]
Not used by any call.

This field is deprecated.
See the Field Index to learn which calls use RefundStatus.

SellerContactBuyerByEmail ( boolean ) [0..1]
Not used by any call.

This field is no longer applicable as Shopping.com listings are no longer created or managed with eBay APIs.
See the Field Index to learn which calls use SellerContactBuyerByEmail.

SellerDiscounts ( SellerDiscountsType ) [0..1]
A container consisting of name and ID of the seller's discount campaign, as well as the discount amount that is being applied to the order line item. This container is only returned if the order line item is eligible for seller discounts.
See the Field Index to learn which calls use SellerDiscounts.

SellerPaidStatus ( PaidStatusCodeType ) [0..1]
Specifies the paid status of the order.
See the Field Index to learn which calls use SellerPaidStatus.

ShippedTime ( dateTime ) [0..1]
Indicates the time when the line item was marked as 'Shipped'. This value will only be visible to the user on either side of the order. An order can be marked as 'Shipped' by purchasing an eBay shipping label, providing shipment tracking in My eBay or through Selling Manager Pro, or programmatically by the seller through the CompleteSale call.

Note: This field does not appear in Merchant Data API's OrderReport responses, because once shipment tracking information is provided to the buyer (or marked as shipped), the order/order line item is considered acknowledged, and acknowledged orders do not show up in OrderReport responses.
See the Field Index to learn which calls use ShippedTime.

ShippingConvenienceCharge ( AmountType (double) ) [0..1]
Not used by any call.

Note: This field is no longer applicable/used. It was previously used for eBay Now and 'eBay On Demand Delivery' orders - two features that have been deprecated.
See the Field Index to learn which calls use ShippingConvenienceCharge.

ShippingDetails ( ShippingDetailsType ) [0..1]
Container consisting of shipping-related details for a sales transaction. Shipping details may include shipping rates, package dimensions, handling costs, excluded shipping locations (if specified), shipping service options, sales tax information (if applicable), and shipment tracking details (if shipped).

Note: For GetOrders, a ShippingDetails container is returned at the order at line item level.
See the Field Index to learn which calls use ShippingDetails.

ShippingServiceSelected ( ShippingServiceOptionsType ) [0..1]
The shipping service actually selected by the buyer from the shipping services offered by the seller. The buyer typically selects the shipping service at checkout/payment time.
See the Field Index to learn which calls use ShippingServiceSelected.

Container consisting of checkout/payment status details for an order line item. Several of these fields change values during the checkout flow.

For GetOrders, only a limited number of applicable fields are returned at the order line item level. The fields indicating the status of the order are actually found in the OrderArray.Order.CheckoutStatus container.
See the Field Index to learn which calls use Status.

Taxes ( TaxesType ) [0..1]
A container consisting of detailed tax information (sales tax, Goods and Services tax, or VAT) for a sales transaction. The Taxes container is returned if the order line item is subject to any taxes on the buyer's purchase. The information in this container supercedes/overrides any sales tax information in the ShippingDetails.SalesTax container.
See the Field Index to learn which calls use Taxes.

TotalPrice ( AmountType (double) ) [0..1]
This field indicates the total price for a sales transaction. Before payment, this dollar value will be the price before a shipping service option is selected. Once a shipping service option is selected, the price in this field will be updated to reflect the shipping and handling costs associated with that shipping service option.
See the Field Index to learn which calls use TotalPrice.

TotalTransactionPrice ( AmountType (double) ) [0..1]
The sale price of the order line item. This amount does not take into account shipping and handling charges, sales tax, or any other costs related to the order line item. If multiple units were purchased through a non- variation, fixed-price listing, this value will reflect that. So, if the base cost of the order line item was $15.00, and a quantity of two were purchased (Transaction.QuantityPurchased) the value in this field would show as 30.00.

To see the full price of the order line item, including any shipping and handling charges, and any sales tax, the (Transaction.TotalPrice) field value should be viewed instead. However, note that the TotalPrice field value is only updated after a shipping service option is selected and payment is made. And if the seller is offering free shipping, the values in the TotalTransactionPrice and the TotalPrice fields may be the same.
See the Field Index to learn which calls use TotalTransactionPrice.

TransactionID ( string ) [0..1]
Unique identifier for an eBay sales transaction. This identifier is created once there is a commitment from a buyer to purchase an item, or if/when the buyer actually purchases the line item through a 'Buy it Now' option. An ItemID/TransactionID pair can be used and referenced during an order checkout flow to identify a line item.

The TransactionID value for auction listings is always 0 since there can be only one winning bidder/one sale for an auction listing.

For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer and seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, transaction ID is only returned to the buyer and seller, and a dummy value of 10000000000000 will be returned to all third parties.
See the Field Index to learn which calls use TransactionID.

TransactionPrice ( AmountType (double) ) [0..1]
The sale price for one unit of the line item. This price does not include any other costs like shipping charges or sales tax, and its value will remain the same before and after payment. If multiple units were purchased through a single-variation, fixed-price listing, to get the subtotal of the units purchased, the TransactionPrice value would have to be multiplied by the Transaction.QuantityPurchased value.

For a motor vehicle listing that required a deposit/down payment, the amount in the TransactionPrice is actually the deposit amount.

For GetMyeBaySelling: this field is only returned if the transaction came as a result of a buyer's Best Offer accepted by the seller. Otherwise, the Transaction.TotalPrice field should be viewed instead.
See the Field Index to learn which calls use TransactionPrice.

TransactionSiteID ( SiteCodeType ) [0..1]
The site upon which the line item was purchased.
See the Field Index to learn which calls use TransactionSiteID.

Variation ( VariationType ) [0..1]
In a fixed-priced listing, a seller can offer variations of the same item. For example, the seller could create a fixed-priced listing for a t-shirt design, and offer the shirt in different colors and sizes. In this case, each color and size combination is a separate variation. Each variation can have a different quantity and price. Due to the possible price differentiation, buyers can buy multiple items from this listing at the same time, but all of the items must be of the same variation. One order line item is created whether one or multiple quanity of the same variation are purchased.

The Variation node contains information about which variation was purchased. Therefore, applications that process orders should always check to see if this node is present.
See the Field Index to learn which calls use Variation.

VATPercent ( decimal ) [0..1]
Not used by any call.

VAT rate for the line item. When the VATPercent is specified, the item's VAT information appears on the item's listing page. In addition, the seller can choose to print an invoice that includes the item's net price, VAT percent, VAT amount, and total price. Since VAT rates vary depending on the item and on the user's country of residence, a seller is responsible for entering the correct VAT rate; it is not calculated by eBay. To specify a VATPercent, a seller must have a VAT-ID registered with eBay and must be listing the item on a VAT-enabled site. Max precision 3 decimal places. Max length 5 characters. Note: The View Item page displays the precision to 2 decimal places with no trailing zeros. However, the full value you send in is stored.
See the Field Index to learn which calls use VATPercent.