Skip to main content
Published: March 29 2007, 7:50:00 PMUpdated: November 28 2020, 3:16:52 PM

What are the rules for using BuyerRequirements in an AddItem call in conjunction with the global MyeBay Buyer Requirements preferences?

Detailed Description

There are 2 distinct ways to list with Buyer Requirements through the API AddItem call.

  • Indicating exactly which Buyer Requirements are desired within the AddItem request
    The following AddItem call is an example of indicating Buyer Requirements using the BuyerRequirements container:

    <?xml version="1.0" encoding="utf-8"?> 
    <AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents"> 
      <WarningLevel>High</WarningLevel>
      <Item>
        <Country>US</Country>
        <Currency>USD</Currency>
        <Description>test - do not bid.</Description>
        <DispatchTimeMax>3</DispatchTimeMax>
        <ListingDuration>Days_5</ListingDuration>
        <PostalCode>95125</PostalCode>
        <BuyerRequirementDetails>
          <LinkedPayPalAccount>true</LinkedPayPalAccount>
          <MaximumItemRequirements>
            <MaximumItemCount>2</MaximumItemCount>
            <MinimumFeedbackScore>5</MinimumFeedbackScore>
          </MaximumItemRequirements>
          <MaximumUnpaidItemStrikesInfo>
            <Count>4</Count>
            <Period>Days_30</Period>
          </MaximumUnpaidItemStrikesInfo>
          <MinimumFeedbackScore>-1</MinimumFeedbackScore>
          <ShipToRegistrationCountry>true</ShipToRegistrationCountry>
        </BuyerRequirementDetails
    >
        <PaymentMethods>PayPal</PaymentMethods>
        <PayPalEmailAddress>test@test.com</PayPalEmailAddress>
        <PrimaryCategory>
          <CategoryID>1463</CategoryID>
        </PrimaryCategory>
        <Quantity>1</Quantity>
        <StartPrice>1.0</StartPrice>
        <ShippingDetails>
          <ShippingServiceOptions>
            <ShippingServicePriority>1</ShippingServicePriority>
            <ShippingService>UPS2ndDay</ShippingService>
            <ShippingServiceCost>5</ShippingServiceCost>
          </ShippingServiceOptions>
        </ShippingDetails>
        <Title>test - do not bid</Title>
        <ReturnPolicy>
          <ReturnsAcceptedOption>ReturnsAccepted</ReturnsAcceptedOption>
          <RefundOption>MoneyBack</RefundOption>
          <ReturnsWithinOption>Days_30</ReturnsWithinOption>
          <Description>Text description of return policy details</Description>
          <ShippingCostPaidByOption>Buyer</ShippingCostPaidByOption>
        </ReturnPolicy> 
      </Item>
      <RequesterCredentials>
        <eBayAuthToken>*****</eBayAuthToken>
      </RequesterCredentials>
    </AddItemRequest>

    The listing will have all of the Buyer Requirements indicated in this call.
    If there are global MyeBay preferences set for BuyerRequirements, they will not be honored for this item.
    This means that the AddItem call will override all of the MyeBay Buyer Requirements preferences.
    There is no way to mix and match requirements that are globally set with requirements that are only in the AddItem call.
    The AddItem call must indicate all of the requirements desired in the listing, even if they are already set in the global preferences.
  • Using the global MyeBay Buyer Requirements preferences
    Listing with Buyer Requirements by using the global MyeBay Buyer Requirements preferences is done by not including the BuyerRequirements container in the AddItem request.
    When no BuyerRequirements container is included in an AddItem request, all of the seller's global preferences with respect to Buyer Requirements are automatically picked up by the listing.

Additional Resources

How well did this answer your question?
Answers others found helpful