eBay Trading API
Version 1359


complexType "GetUserPreferencesResponseType"
Namespace:
urn:ebay:apis:eBLBaseComponents
Derived By:
Content:
complex, 34 elements, elem. wildcard
Defined:
in ebaySvc.wsdl/Schema
Includes:
declarations of 19 elements
Referenced:
Component Diagram

Content Element Model:
Component
Type / Value
Occurs
Required?
Nillable?
Description
SEQUENCE
1..1
yes
dateTime
0..1
no
no
This value represents the date and time when eBay processed the request. »
 Ack
AckCodeType : enumeration of token
0..1
no
no
A token representing the application-level acknowledgement code that indicates the response status (e.g., success). »
string
0..1
no
no
Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. »
0..∞
no
no
A list of application-level errors (if any) that occurred when eBay processed the request.
string
0..1
no
no
Supplemental information from eBay, if applicable. »
string
0..1
no
no
The version of the response payload schema. »
string
0..1
no
no
This refers to the specific software build that eBay used when processing the request and generating the response. »
string
0..1
no
no
Event name of the notification. »
0..1
no
no
Information that explains a failure due to a duplicate InvocationID being passed in.
string
0..1
no
no
Recipient user ID of the notification. »
string
0..1
no
no
Unique Identifier of Recipient user ID of the notification. »
string
0..1
no
no
A Base64-encoded MD5 hash that allows the recipient of a Platform Notification to verify this is a valid Platform Notification sent by eBay.
string
0..1
no
no
Expiration date of the user's authentication token. »
0..1
no
no
This container is conditionally returned in the PlaceOffer call response if eBay wants to challenge the user making the call to ensure that the call is being made by a real user and not a bot. »
string
0..1
no
no
An application subscribing to notifications can include an XML-compliant string, not to exceed 256 characters, which will be returned. »
from any namespace
0..∞
no
 BidderNoticePreferences
0..1
no
no
Container consisting of the seller's preference for receiving contact information for unsuccessful bidders. This container is returned when ShowBidderNoticePreferences is included and set to true in the request. This preference is only applicable for auction listings.
 CombinedPaymentPreferences
0..1
no
no
Container consisting of the seller's Combined Invoice preferences. These preferences are used to allow Combined Invoice orders. This container is returned when ShowCombinedPaymentPreferences is included and set to true in the request.
 SellerPaymentPreferences
0..1
no
no
Container consisting of the seller's payment preferences. This container is returned when ShowSellerPaymentPreferences is included and set to true in the request.
 SellerFavoriteItemPreferences
0..1
no
no
Container consisting of the seller's preferences for displaying items on a buyer's Favorite Sellers' Items page or Favorite Sellers' Items digest. This container is returned when ShowSellerFavoriteItemPreferences is included and set to true in the request.
 EndOfAuctionEmailPreferences
0..1
no
no
Container consisting of the seller's preferences for the end-of-auction email sent to the winning bidder. This container is returned when ShowEndOfAuctionEmailPreferences is included and set to true in the request. These preferences are only applicable for auction listings.
 EmailShipmentTrackingNumberPreference
boolean
0..1
no
no
Container consisting of the seller's preference for sending an email to the buyer with the shipment tracking number. This container is returned when ShowEmailShipmentTrackingNumberPreference is included and set to true in the request.
 RequiredShipPhoneNumberPreference
boolean
0..1
no
no
Container consisting of the seller's preference for requiring that the buyer supply a shipping phone number upon checkout. Some shipping carriers require the receiver's phone number. This container is returned when ShowRequiredShipPhoneNumberPreference is included and set to true in the request.
 UnpaidItemAssistancePreferences
0..1
no
no
Container consisting of a seller's Unpaid Item preferences. The Unpaid Item preferences can be used to automatically cancel an unpaid order and relist the item on the behalf of the seller. This container is returned if ShowUnpaidItemAssistancePreference is included and set to true in the request.

Note: To return the list of buyers excluded from the Unpaid Item preferences, the ShowUnpaidItemAssistanceExclusionList field must also be included and set to true in the request. Excluded buyers can be viewed in the UnpaidItemAssistancePreferences.ExcludedUser field.
 SellerExcludeShipToLocationPreferences
0..1
no
no
Container consisting of a list of the seller's excluded shipping locations. The returned list mirrors the seller's current Exclude shipping locations list in My eBay's shipping preferences. An excluded shipping location in My eBay can be an entire geographical region (such as Middle East) or only an individual country (such as Iraq).

Sellers can override these default settings for an individual listing by using the Item.ShippingDetails.ExcludeShipToLocation field in the Add/Revise/Relist calls. This container is returned if the ShowSellerExcludeShipToLocationPreference field is included and set to true in the request.
 PurchaseReminderEmailPreferences
0..1
no
no
Container consisting of a seller's preference for sending a purchase reminder email to buyers. This container is returned if the ShowPurchaseReminderEmailPreferences field is included and set to true in the request.
 SellerProfilePreferences
0..1
no
no
Parent response container consisting of high-level information for all Business Policies defined for the user's account. This container is returned if ShowSellerProfilePreferences is included and set to true in the GetUserPreferences request (and one or more Business Policies are defined for the user's account).
 SellerReturnPreferences
0..1
no
no
Container consisting of the OptedIn flag that indicates whether or not the seller has opted in to eBay Managed Returns. This container is only returned if ShowSellerReturnPreferences is included and set to true in the request.
 OfferGlobalShippingProgramPreference
boolean
0..1
no
no
This flag indicates whether the seller has opted in to the Global Shipping Program and is able to offer global shipping to international buyers. Returned when ShowGlobalShippingProgramPreference is included and set to true.
 DispatchCutoffTimePreference
0..1
no
no
Contains information about a seller's order cutoff time preferences for same-day shipping. If the seller specifies a value of '0' in Item.DispatchTimeMax to offer same-day handling when listing an item, the seller's shipping time commitment depends on the order cutoff time set for the listing site, as indicated by DispatchCutoffTimePreference.CutoffTime. Returned when ShowDispatchCutoffTimePreferences is included and set to true.

Note: For sellers opted in to the feature that supports different order cutoff times for each business day, the order cutoff time returned in this container may not be accurate. In order for the seller to confirm the actual order cutoff time for same-day handling, that seller should view Shipping Preferences in My eBay.
 GlobalShippingProgramListingPreference
boolean
0..1
no
no
If the ShowGlobalShippingProgramListingPreference field is submitted and set to true, this flag is returned. A returned value of true indicates that the seller's new listings will enable the Global Shipping Program by default.
 OverrideGSPServiceWithIntlServicePreference
boolean
0..1
no
no
If the ShowOverrideGSPServiceWithIntlServicePreference field is submitted and set to true, this flag is returned. A returned value of true indicates that for the seller's listings that specify an international shipping service for any Global Shipping-eligible country, the specified service will take precedence and be the listing's default international shipping option for buyers in that country, rather than the Global Shipping Program.

A returned value of false indicates that the Global Shipping program will take precedence over any international shipping service as the default option in Global Shipping-eligible listings for shipping to any Global Shipping-eligible country.
 PickupDropoffSellerPreference
boolean
0..1
no
no
This boolean field is returned if the ShowPickupDropoffPreferences field is included and set to true in the request. This field will be returned as true if the seller has enabled the Click and Collect feature at the account level. All of the seller's new listings will by default be eligible to be evaluated for the Click and Collect feature. With the Click and Collect feature, a buyer can purchase certain items on eBay and collect them at a local store. Buyers are notified by eBay once their items are available. The Click and Collect feature is only available to large merchants on the eBay UK (site ID 3), eBay Australia (Site ID 15), and eBay Germany (Site ID 77) sites.

Note: The Click and Collect program no longer allows sellers to set the Click and Collect preference at the listing level.
 OutOfStockControlPreference
boolean
0..1
no
no
This boolean field is returned if the ShowOutOfStockControlPreference field is included and set to true in the request. This field will be returned as true if the seller has set SetUserPreferences.OutOfStockControlPreference to true.
 eBayPLUSPreference
0..∞
no
no
Contains information about each country where the seller is eligible to offer eBay Plus on listings (one eBayPLUSPreference container per country), as well as the seller's opt-in status and listing preference for each country.

eBay Plus is a premium account option for buyers, which provides benefits such as fast free domestic shipping and free returns on selected items. Top Rated eBay sellers must opt in to eBay Plus to offer the program on a per-listing basis.

Note: Currently, eBay Plus is available only to buyers in Germany and Australia. In Australia, the seller has no control/responsibility over setting the eBay Plus feature for a listing. Instead, eBay will evaluate/determine whether a listing is eligible for eBay Plus.
Description
Contains some or all of the authenticated user's preferences. The preferences are grouped in sets and are returned according to the flag settings in the request.
Referenced By
Type Definition Detail
Type Derivation Tree
AbstractResponseType (extension)
  GetUserPreferencesResponseType


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