eBay Trading APIVersion 1267
 

BuyerRequirementDetailsType

Note: In October 2022, the container for Add/Revise/Relist calls will be decommisioned, as listing-level buyer requirements will no longer be supported. If this container is used for Add/Revise/Relist calls after it has been decommisioned, it will be ignored and dropped, and a warning message will be returned to the seller.
Type defining the BuyerRequirementDetails container, which indicates if the seller has set any buyer requirements. Sellers use buyer requirements if they want to avoid working with 'risky' buyers, who may be brand new to eBay, have low/poor Feedback scores, or who have some unpaid item strikes.

Type that uses BuyerRequirementDetailsType:

Calls that use BuyerRequirementDetailsType:

Fields

MaximumItemRequirements ( MaximumItemRequirementsType ) [0..1]
The seller uses this container as a mechanism to restrict the number of items (specifying a MaximumItemCount value) a prospective buyer can purchase from the seller during a 10-day period. The seller also has the option of setting a MinimumFeedbackScore requirement. If both fields of the MaximumItemRequirements container are set, the MaximumItemCount limit will only apply to those prospective buyers that don't equal or exceed the specified minimum Feedback Score.
See the Field Index to learn which calls use MaximumItemRequirements.

MaximumUnpaidItemStrikesInfo ( MaximumUnpaidItemStrikesInfoType ) [0..1]
The seller uses this container as a mechanism to block prospective buyers who have one or more Unpaid Item strikes on their account during a specified time period. A buyer receives an Unpaid Item strike if a seller files an Unpaid Item case against the buyer, and eBay rules in favor of the seller.
See the Field Index to learn which calls use MaximumUnpaidItemStrikesInfo.

ShipToRegistrationCountry ( boolean ) [0..1]
The seller includes and sets this field to true as a mechanism to block bidders who reside (according to their eBay primary shipping address) in countries that are on the ship-to exclusion list. Sellers add countries or regions to their ship-to exclusion list by adding those countries or regions using one or more ExcludeShipToLocation fields in an Add/Revise/Relist call.
See the Field Index to learn which calls use ShipToRegistrationCountry.

ZeroFeedbackScore ( boolean ) [0..1]
This Buyer Requirements feature is only available to sellers on the China site, and is only applicable to fixed-price or auction Buy It Now items.

The seller includes and sets this field to true as a mechanism to block prospective buyers with a feedback score of 0 from buying items with a price of 100 RMB or higher.
See the Field Index to learn which calls use ZeroFeedbackScore.