GetSoldItems Request
Home / API Calls Reference / GetSoldItems > GetSoldItems Request

GetSoldItems Request



Request XML:

Code:
<?xml version="1.0" encoding="utf-8"?>
<Request>
  ---- Global tags
  <AfterbuyGlobal>
    <PartnerToken> String </PartnerToken>
    <AccountToken> String </AccountToken>
    <CallName> String </CallName>
    <DetailLevel> Integer </DetailLevel>
    <ErrorLanguage> String </ErrorLanguage>
  </AfterbuyGlobal>
  <RequestAllItems> Integer </RequestAllItems>
  <MaxSoldItems> Integer </MaxSoldItems>
  <DataFilter>
   <Filter>
    <FilterName> String </FilterName>
    <FilterValues>
      <DateFrom> Date </DateFrom>
      <DateTo> Date </DateTo>
      <FilterValue> String </FilterValue>
      <ValueFrom> Integer </ValueFrom>
      <ValueTo> Integer </ValueTo>
    </FilterValues>
   </Filter>
  </DataFilter>
</Request>


Request Definition


ItemData typeRequiredMeaning
Global parameters
AfterbuyGlobalContainer
Y
Container with credentials
...PartnerTokenString
Y/N
Afterbuy partner token
...AccountTokenString
Y/N
Afterbuy account token
...CallNameString
Y
Action
...DetailLevelString
Y
Restrictions of the data
...ErrorLanguageString
Y
Country identification for error messages and warnings
Call-specific parameters
RequestAllItemsInteger
N
If the option is set, all orders are returned including those without a VorgangsID.
(The VorgangsID is set when the feedback date of the transaction is set). If filter 'RangeID' with 'ValueFrom' is used, no items without VorgangsID will be returned. The 'FilterValue' tag in the 'OrderID' filter must be 0 if only items without VorgangsID are to be returned. If no 'RangeID' and 'OrderID' filters are passed, all items with and without VorgangsID will be returned. To ensure correct assignment of orders it is not recommended to use this option.
MaxSoldItemsInteger
N
Specifies how many orders are returned per call-off (1 - 250). Default = 250
OrderDirectionInteger
N
Specifies the sorting direction of the results. Default Ascending (ACS), 1 = Descending (DESC).
Note: the sort direction can be used only if MaxSoldItems value is <= 100. If the value is greater the sort direction is set to default.
ReturnHiddenItemsInteger
N
If this option is set (=1), hidden items will also be returned.
DataFilterContainer
Y
Container with filters
...FilterContainer
Y
Container with filter data
...Filter.FilterName = 'DateFilter'
[...]...FilterValues.DateFromDate
Y/N
Start Date
[...]...FilterValues.DateToDate
Y/N
End Date
[...]...FilterValues.FilterValueString
Y/N
Reference
Possible values:
          AuctionEndDate - End time of the order.
          FeedbackDate - Feedback date of the order
          PayDate - Payment date of the order
          ShippingDate - Shipping date of the order
          InvoiceDate - Invoice date of the order
          ModDate - Modification date of the order
          XmlDate - XML export date of the order
          MailDate - Mail dispatch date
          ReminderDate - Reminder date
...Filter.FilterName = 'OrderID'
[...]...FilterValues.FilterValueInteger
Y
VorgangsID's. If 'RequestAllItems' = 1 the value 0 can be passed here to retrieve all items without a VorgangsID.
...Filter.FilterName = 'Plattform'
[...]...FilterValues.FilterValueString
Y
Internal type. E.g. ebay, amazon, azubo, auvito, gutschrift...
The values can be negated with a preceding "not_" (e.g. "not_ebay").
...Filter.FilterName = 'RangeID'
[...]...FilterValues.ValueFromInteger
Y
Greater than VorgangsID (so that LastOrderID can be used directly).
[...]...FilterValues.ValueToInteger
Y
to VorgangsID
...Filter.FilterName = 'DefaultFilter'
[...]...FilterValues.FilterValueString
Y
Default filter name
Possible values:
        NewAuctions - New transactions (No feedback date, No first contact mail sent, No payment date).
        ReadyToShip - Ready to ship
        CompletedAuctions - Completed transactions (NumberDate set, ShipmentDate set, Complete price is paid)
        PaidAuctions - Paid transactions (payment date set, complete price is paid)
        InvoicePrinted - transactions with printed invoice
        NoXMLDate - Transactions without XML date
The values can be negated with a preceding "not_" (e.g. "not_NewAuctions").
...Filter.FilterName = 'AfterbuyUserID'
[...]...FilterValues.FilterValueInteger
Y
Afterbuy Buyer IDs
...Filter.FilterName = 'UserDefinedFlag'
[...]...FilterValues.FilterValueInteger
Y
ID of the own seller flag.
The flags can be retrieved with the GetUserDefinedFlags call.
...Filter.FilterName = 'AfterbuyUserEmail'
[...]...FilterValues.FilterValueString
Y
Buyer Email
...Filter.FilterName = 'ShopId'
[...]...FilterValues.FilterValueInteger
Y
Ids of the Afterbuy shops that are available in the account. Sales can be retrieved separately per store.
Max. 5 shops are allowed in the filter.
...Filter.FilterName = 'Tag'
[...]...FilterValues.FilterValueString
N
Output of the associated tags
...Filter.FilterName = 'InvoiceNumber'
[...]...FilterValues.FilterValueInteger
N
Output of the transactions with specified invoice numbers. Maximum 10 values allowed.
...Filter.FilterName = 'AlternativeItemNumber1'
[...]...FilterValues.FilterValueString
N
Output of operations with specified alternative item number 1. Maximum 10 values allowed. Maximum length per value: 50 characters.
...Filter.FilterName = 'AlternativeItemNumber2'
[...]...FilterValues.FilterValueString
N
Output of operations with specified alternative item number 2. 10 values maximum allowed. Maximum length per value: 20 characters.

GetSoldItems Detaillevel:

ValueDescription
0Only operation information will be returned.
2Only payment information will be returned.
4Only buyer information will be returned.
8Only article information will be returned.
16Only shipping information will be returned.
32Only article information + selected attributes will be returned.

The DetailLevel values can also be specified to return only required data. This saves traffic and increases the transmission speed.

More information about DetailLevel: General information
© Copyright 2003 - 2023 ViA-Online GmbH – All rights reserved | www.afterbuy.de