Component 
SUMMARY: XML REP | DERIVED | USE
DETAIL: DESC | XML SRC | TYPE | ATTR | CHILD
eBay Trading API

complexType "ns:GetAccountRequestType"
Namespace:
Content:
complex, 23 elements, elem. wildcard
Defined:
globally in Schema in ebaySvc.wsdl; see XML source
Includes:
definitions of 13 elements
Used:
Component Diagram
XML Representation Summary
<...>
   
Content: 
</...>
All Direct / Indirect Based Elements (1):
Known Usage Locations
Annotation
Returns a seller's invoice data for their eBay account, including the account's summary data.
Type Definition Detail
Type Derivation Tree
ns:AbstractRequestType (extension)
  ns:GetAccountRequestType
XML Source (w/o annotations (14); see within schema source)
<xs:complexType name="GetAccountRequestType">
<xs:complexContent>
<xs:extension base="ns:AbstractRequestType">
<xs:sequence>
<xs:element minOccurs="0" name="AccountHistorySelection" type="ns:AccountHistorySelectionCodeType"/>
<xs:element minOccurs="0" name="InvoiceDate" type="xs:dateTime"/>
<xs:element minOccurs="0" name="BeginDate" type="xs:dateTime"/>
<xs:element minOccurs="0" name="EndDate" type="xs:dateTime"/>
<xs:element minOccurs="0" name="Pagination" type="ns:PaginationType"/>
<xs:element minOccurs="0" name="ExcludeBalance" type="xs:boolean"/>
<xs:element minOccurs="0" name="ExcludeSummary" type="xs:boolean"/>
<xs:element minOccurs="0" name="IncludeConversionRate" type="xs:boolean"/>
<xs:element minOccurs="0" name="IncludeNettedEntries" type="xs:boolean"/>
<xs:element minOccurs="0" name="AccountEntrySortType" type="ns:AccountEntrySortTypeCodeType"/>
<xs:element minOccurs="0" name="Currency" type="ns:CurrencyCodeType"/>
<xs:element minOccurs="0" name="ItemID" type="ns:ItemIDType"/>
<xs:element minOccurs="0" name="OrderID" type="xs:string"/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
Content Element Detail (all declarations defined in this component; 13/24)
ns:AccountEntrySortType
Type:
Specifies how account entries should be sorted in the response, by an element and then in ascending or descending order.
XML Representation Summary
<ns:AccountEntrySortType>
   
Content: 
{ enumeration of xs:token }
</ns:AccountEntrySortType>
Simple Content
Enumeration:
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="AccountEntrySortType" type="ns:AccountEntrySortTypeCodeType"/>

ns:AccountHistorySelection
Type:
Specifies the report format in which to return account entries.
XML Representation Summary
<ns:AccountHistorySelection>
   
Content: 
{ enumeration of xs:token }
</ns:AccountHistorySelection>
Simple Content
Enumeration:
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="AccountHistorySelection" type="ns:AccountHistorySelectionCodeType"/>

ns:BeginDate
Type:
xs:dateTime, predefined, simple content
This field is used to retrieve all account entries dating back to the timestamp passed into this BeginDate field up until the timestamp passed into the EndDate field. The BeginDate value can not be set back any further than four months into the past.

The allowed date formats are YYYY-MM-DD and YYYY-MM-DD HH:mm:ss The BeginDate value must be less than or equal to the EndDate value. The user might use the same values in both fields if that user wanted to retrieve all account entries from a specific day (if YYYY-MM-DD format used) or wanted to retrieve a specific account entry (if YYYY-MM-DD HH:mm:ss format used).

This field is only applicable if the AccountHistorySelection value is set to 'BetweenSpecifiedDates'; otherwise, this field will be ignored. fiedDates' is used, both the BeginDate and EndDate must be included.
XML Representation Summary
<ns:BeginDate>
   
Content: 
{ xs:dateTime }
</ns:BeginDate>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="BeginDate" type="xs:dateTime"/>

ns:Currency
Type:
ns:CurrencyCodeType, simple content
Specifies the currency used in the account report. Do not specify Currency in the request unless the following conditions are met. First, the user has or had multiple accounts under the same UserID. Second, the account identified in the request uses the currency you specify in the request. An error is returned if no account is found that uses the currency you specify in the request.
XML Representation Summary
<ns:Currency>
   
Content: 
{ enumeration of xs:token }
</ns:Currency>
Simple Content
Enumeration:
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="Currency" type="ns:CurrencyCodeType"/>

ns:EndDate
Type:
xs:dateTime, predefined, simple content
This field is used to retrieve all account entries dating up to the timestamp passed into this EndDate field dating back to the timestamp passed into the BeginDate field. The EndDate value can not be set for a future date.

The allowed date formats are YYYY-MM-DD and YYYY-MM-DD HH:mm:ss The EndDate value must be more than or equal to the BeginDate value. The user might use the same values in both fields if that user wanted to retrieve all account entries from a specific day (if YYYY-MM-DD format used) or wanted to retrieve a specific account entry (if YYYY-MM-DD HH:mm:ss format used).

This field is only applicable if the AccountHistorySelection value is set to 'BetweenSpecifiedDates'; otherwise, this field will be ignored. If 'BetweenSpecifiedDates' is used, both the BeginDate and EndDate must be included.
XML Representation Summary
<ns:EndDate>
   
Content: 
{ xs:dateTime }
</ns:EndDate>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="EndDate" type="xs:dateTime"/>

ns:ExcludeBalance
Type:
xs:boolean, predefined, simple content
By default, the current balance of the user's account will not be returned in the call response. To retrieve the current balance of their account, the user should include the ExcludeBalance flag in the request and set its value to 'false'. The current balance on the account will be shown in the AccountSummary.CurrentBalance field in the call response.
XML Representation Summary
<ns:ExcludeBalance>
   
Content: 
{ xs:boolean }
</ns:ExcludeBalance>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="ExcludeBalance" type="xs:boolean"/>

ns:ExcludeSummary
Type:
xs:boolean, predefined, simple content
Specifies whether to return account summary information in an AccountSummary node. Default is true, to return AccountSummary.
XML Representation Summary
<ns:ExcludeSummary>
   
Content: 
{ xs:boolean }
</ns:ExcludeSummary>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="ExcludeSummary" type="xs:boolean"/>

ns:IncludeConversionRate
Type:
xs:boolean, predefined, simple content
Specifies whether to retrieve the rate used for the currency conversion for usage transactions.
XML Representation Summary
<ns:IncludeConversionRate>
   
Content: 
{ xs:boolean }
</ns:IncludeConversionRate>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="IncludeConversionRate" type="xs:boolean"/>

ns:IncludeNettedEntries
Type:
xs:boolean, predefined, simple content
An eBay managed payments seller includes this field and sets it to true to retrieve the total net amount of all charges/fees that have been deducted from seller payouts instead of being invoiced to the seller. The total net amount of any seller credits related to these fees is also shown. These fees and credit amounts will be shown in the AccountSummary.NettedTransactionSummary container in the response.

The seller's account has to be enabled for managed payments and the fee netting mechanism must be enabled for the managed payments account in order to retrieve the fee netted amounts. A seller can check their status for the fee netting mechanism by checking the value in the FeeNettingStatus field.

Note: For a limited number of managed payments sellers, final value fees and payment processing fees will start getting deducted from seller payouts as early as mid-June 2020, but for many other managed payments sellers, these fees won't start getting deducted from seller payouts until mid-July 2020.
XML Representation Summary
<ns:IncludeNettedEntries>
   
Content: 
{ xs:boolean }
</ns:IncludeNettedEntries>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="IncludeNettedEntries" type="xs:boolean"/>

ns:InvoiceDate
Type:
xs:dateTime, predefined, simple content
This field is used to retrieve all account entries from a specific invoice, which is identified through this InvoiceDate field with the timestamp of the account invoice. This field is only applicable if the AccountHistorySelection value is set to 'SpecifiedInvoice'; otherwise, this field will be ignored.
XML Representation Summary
<ns:InvoiceDate>
   
Content: 
{ xs:dateTime }
</ns:InvoiceDate>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="InvoiceDate" type="xs:dateTime"/>

ns:ItemID
Type:
ns:ItemIDType, simple content
Specifies the item ID for which to return account entries. If ItemID is used, all other filters in the request are ignored. If the specified item does not exist or if the requesting user is not the seller of the item, an error is returned.
XML Representation Summary
<ns:ItemID>
   
Content: 
{ xs:string }
</ns:ItemID>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="ItemID" type="ns:ItemIDType"/>

ns:OrderID
Type:
xs:string, predefined, simple content
The unique identifier of an eBay order. This field must be included if the value of the AccountHistorySelection filter is set to OrderId. A user can filter by order ID to see if there are specific account entries related to a specific eBay order.

It is possible that no account entries will be found directly related to the specified order ID, and if this is the case, no AccountEntries container will be returned, and the ack value will still be Success.

Note: In June 2019, eBay introduced a new order ID format, but allowed developers/sellers to decide whether to immediately adopt the new format, or to continue working with the old format. Users who wanted to adopt the new format, could either use a Trading WSDL Version 1113 (or newer), or they could even use an older Trading WSDL but set the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header value to 1113 in API calls. Beginning in June 2020, only the new order ID format will be returned in response payloads for paid orders, regardless of the WSDL version number or compatibility level.

Note that the unique identifier of a 'non-immediate payment' order will change as it goes from an unpaid order to a paid order. Due to this scenario, all calls that accept Order ID values as filters in the request payload, including the GetAccount call, will support the identifiers for both unpaid and paid orders. The new order ID format is a non-parsable string, globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. Unlike in the past, instead of just being known and exposed to the seller, these unique order identifiers will also be known and used/referenced by the buyer and eBay customer support.

Sellers can check to see if an order has been paid by looking for a value of 'Complete' in the CheckoutStatus.Status field in the response of GetOrders or GetOrderTransactions call, or in the Status.CompleteStatus field in the response of GetItemTransactions or GetSellerTransactions call. Sellers should not fulfill orders until buyer has made payment.
XML Representation Summary
<ns:OrderID>
   
Content: 
{ xs:string }
</ns:OrderID>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="OrderID" type="xs:string"/>

ns:Pagination
Type:
ns:PaginationType, complex content
This container is used to control how many account entries are returned on each page of data in the response. PaginationType is used by numerous Trading API calls, and the default and maximum values for the EntriesPerPage field differs with each call. For the GetAccount call, the default value is 500 (account entries) per page, and maximum allowed value is 2000 (account entries) per page.
Component Diagram
XML Representation Summary
<ns:Pagination>
   
Content: 
</ns:Pagination>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="Pagination" type="ns:PaginationType"/>

 Component 
SUMMARY: XML REP | DERIVED | USE
DETAIL: DESC | XML SRC | TYPE | ATTR | CHILD
eBay Trading API

WSDL documentation generated with FlexDoc/XML 1.13 using FlexDoc/XML WSDLDoc 1.2.5 template set. All XSD diagrams generated by FlexDoc/XML DiagramKit.