eBay Trading APIVersion 1131

GetUserPreferencesResponseType ( AbstractResponseType )

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.

Call that uses GetUserPreferencesResponseType:

Fields



BidderNoticePreferences ( BidderNoticePreferencesType ) [0..1]
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.
See the Field Index to learn which calls use BidderNoticePreferences.

CombinedPaymentPreferences ( CombinedPaymentPreferencesType ) [0..1]
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.
See the Field Index to learn which calls use CombinedPaymentPreferences.

CrossPromotionPreferences ( CrossPromotionPreferencesType ) [0..1]
Not used by any call.

This container is deprecated.
See the Field Index to learn which calls use CrossPromotionPreferences.

DispatchCutoffTimePreference ( DispatchCutoffTimePreferencesType ) [0..1]
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: The order cutoff is may not be accurate for sellers who have opted into the Handling Time Option of eBay Guaranteed Delivery, as this field only shows a single order cutoff time, but with the Handling Time Option, a seller can set a different order cutoff time for each business day. Currently, eBay Guaranteed Delivery is only available in the US.
See the Field Index to learn which calls use DispatchCutoffTimePreference.

eBayPLUSPreference ( eBayPLUSPreferenceType ) [0..*]
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, Austria, and Australia.
See the Field Index to learn which calls use eBayPLUSPreference.

EmailShipmentTrackingNumberPreference ( boolean ) [0..1]
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.
See the Field Index to learn which calls use EmailShipmentTrackingNumberPreference.

EndOfAuctionEmailPreferences ( EndOfAuctionEmailPreferencesType ) [0..1]
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.
See the Field Index to learn which calls use EndOfAuctionEmailPreferences.

GlobalShippingProgramListingPreference ( boolean ) [0..1]
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.
See the Field Index to learn which calls use GlobalShippingProgramListingPreference.

OfferGlobalShippingProgramPreference ( boolean ) [0..1]
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.
See the Field Index to learn which calls use OfferGlobalShippingProgramPreference.

OutOfStockControlPreference ( boolean ) [0..1]
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.
See the Field Index to learn which calls use OutOfStockControlPreference.

OverrideGSPServiceWithIntlServicePreference ( boolean ) [0..1]
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.
See the Field Index to learn which calls use OverrideGSPServiceWithIntlServicePreference.

PickupDropoffSellerPreference ( boolean ) [0..1]
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.
See the Field Index to learn which calls use PickupDropoffSellerPreference.

ProStoresPreference ( ProStoresCheckoutPreferenceType ) [0..1]
Not used by any call.

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

PurchaseReminderEmailPreferences ( PurchaseReminderEmailPreferencesType ) [0..1]
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.
See the Field Index to learn which calls use PurchaseReminderEmailPreferences.

RequiredShipPhoneNumberPreference ( boolean ) [0..1]
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.
See the Field Index to learn which calls use RequiredShipPhoneNumberPreference.

SellerExcludeShipToLocationPreferences ( SellerExcludeShipToLocationPreferencesType ) [0..1]
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.
See the Field Index to learn which calls use SellerExcludeShipToLocationPreferences.

SellerFavoriteItemPreferences ( SellerFavoriteItemPreferencesType ) [0..1]
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.
See the Field Index to learn which calls use SellerFavoriteItemPreferences.

SellerPaymentPreferences ( SellerPaymentPreferencesType ) [0..1]
Container consisting of the seller's payment preferences. This container is returned when ShowSellerPaymentPreferences is included and set to true in the request.
See the Field Index to learn which calls use SellerPaymentPreferences.

SellerProfilePreferences ( SellerProfilePreferencesType ) [0..1]
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).
See the Field Index to learn which calls use SellerProfilePreferences.

SellerReturnPreferences ( SellerReturnPreferencesType ) [0..1]
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.
See the Field Index to learn which calls use SellerReturnPreferences.

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

This field is deprecated along with third-party checkout.
See the Field Index to learn which calls use SellerThirdPartyCheckoutDisabled.

UnpaidItemAssistancePreferences ( UnpaidItemAssistancePreferencesType ) [0..1]
Container consisting of a seller's Unpaid Item Assistant preferences. The Unpaid Item Assistant automatically opens an Unpaid Item dispute 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 Assistant mechanism, the ShowUnpaidItemAssistanceExclusionList field must also be included and set to true in the request. Excluded buyers can be viewed in the UnpaidItemAssistancePreferences.ExcludedUser field.
See the Field Index to learn which calls use UnpaidItemAssistancePreferences.