eBay Trading APIVersion 1379
 

AccountEntryType

Type defining the AccountEntry container returned in the GetAccount response. Each AccountEntry container consists of detailed information for a single credit or debit transaction, or an administrative action which occurred on the eBay user's account.

Type that uses AccountEntryType:

Call that uses AccountEntryType:

Fields



AccountDetailsEntryType ( AccountDetailEntryCodeType ) [0..1]
This enumeration value indicates the type of transaction or administrative action that occurred on the eBay user's account. Possible values are defined in the AccountDetailEntryCodeType enumerated type.
See the Field Index to learn which calls use AccountDetailsEntryType.

Balance ( AmountType (double) ) [0..1]
This field is no longer returned. If the eBay user has an outstanding balance owed to eBay, the owed amount will be displayed in the AccountSummary.CurrentBalance field in the GetAccount response.
See the Field Index to learn which calls use Balance.

ConversionRate ( AmountType (double) ) [0..1]
The rate used for the currency conversion for a transaction.
See the Field Index to learn which calls use ConversionRate.

Date ( dateTime ) [0..1]
Timestamp indicating the date and time that the entry was posted to the account, in GMT.
See the Field Index to learn which calls use Date.

Description ( string ) [0..1]
The category of the monetary transaction or administrative action applied to an eBay account.
See the Field Index to learn which calls use Description.

DiscountDetail ( DiscountDetailType ) [1]
This container is an array of one or more discounts applied to the corresponding accounty entry. This container will not be returned if there are no discounts applied to the corresponding accounty entry.
See the Field Index to learn which calls use DiscountDetail.

GrossDetailAmount ( AmountType (double) ) [0..1]
Gross fees that are assessed by eBay (net fees plus VAT, if any). Returned even if VAT does not apply. The value is positive for debits and negative for credits.
See the Field Index to learn which calls use GrossDetailAmount.

ItemID ( ItemIDType (string) ) [0..1]
If the account entry is associated with an eBay listing, this field shows the eBay ItemID value. If there is no correlation between the account entry and one of the user's eBay listings, '0' is returned in this field.
See the Field Index to learn which calls use ItemID.

Memo ( string ) [0..1]
Memo line for the account entry. It can be an empty string.
See the Field Index to learn which calls use Memo.

NetDetailAmount ( AmountType (double) ) [0..1]
Net fees that are assessed by eBay, excluding additional surcharges and VAT (if any). Returned even if VAT does not apply. The value is positive for debits (user pays eBay) and negative for credits (eBay pays user).
See the Field Index to learn which calls use NetDetailAmount.

Netted ( boolean ) [0..1]
This boolean field is returned with each account entry if the IncludeNettedEntries field is included in the request and set to true. The value indicates whether or not the corresponding account entry value (charge or credit) is a part of the 'Total Netted Charge Amount' or 'Total Netted Credit Amount' values returned in the AccountSummary.NettedTransactionSummary container.

If this value is true, it indicates that the corresponding fee was deducted from a seller payout. If the value is false, it indicates that the fee or credit was invoiced to the seller instead.
See the Field Index to learn which calls use Netted.

OrderId ( string ) [0..1]
This field is returned if the account fee or credit is associated with an entire (single or multiple line item) order, and not necessarily for a single line item within the order.
See the Field Index to learn which calls use OrderId.

OrderLineItemID ( string ) [0..1]
OrderLineItemID is a unique identifier for an eBay order line item. This field is only returned if the account entry is associated with an order line item.
See the Field Index to learn which calls use OrderLineItemID.

ReceivedTopRatedDiscount ( boolean ) [0..1]
This boolean field is returned as true if the seller received a discount on the Final Value Fee for the order line item. Only Top-Rated sellers are eligible for this Final Value Fee discount. The Final Value Fee discount percentage varies by country. For more information on becoming a Top-Rated Seller in the US and the requirements for Top-Rated Plus listings, see the Becoming a Top Rated Seller help topic.

This field will not be returned until eBay bills the seller for the Final Value Fee for the eligible order line item.
See the Field Index to learn which calls use ReceivedTopRatedDiscount.

RefNumber ( string ) [0..1]
This value is the unique identifier for the account entry. This value is created by eBay once the transaction occurs on the user's account.
See the Field Index to learn which calls use RefNumber.

Title ( string ) [0..1]
A description or comment about the monetary transaction or administrative action applied to an eBay user account.
See the Field Index to learn which calls use Title.

TransactionID ( string ) [0..1]
The unique identifier of an order line item. This field is only returned if the account entry is associated with an order 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.

Note: Beginning in July 2024, non-zero transaction IDs will start being returned for auction listings. If necessary, update code to handle non-zero transaction IDs for auction transactions before this time.
See the Field Index to learn which calls use TransactionID.

VATPercent ( decimal ) [0..1]
The applicable rate that was used to calculate the VAT (Value-Added Tax) for the transaction. When the VATPercent is specified for a listing, the item's VAT information appears on the View Item 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. VAT is only applicable to sellers located in a European Union (EU) country. If VAT does not apply to the account entry, this field is still returned but it's value will be '0'.
See the Field Index to learn which calls use VATPercent.