Skip to main content
Published: July 11 2011, 5:00:00 PMUpdated: November 28 2020, 9:53:49 PM

 

Detailed Description

    When an item is listed with ExternalProductID, the eBay API server returns Error 12025 if more than one product matches the value passed in ExternalProductID.Value. To get all matching product IDs, you can set ExternalProductID.ReturnSearchResultOnDuplicates flag to true so that AddItemResponse returns both the error message and all matching ProductIDs. Please keep in mind that the flag is defaulted to false.
 

AddItem Request Sample:

<?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <Version>599</Version>
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
  <Item>
    <ExternalProductID>
      <ReturnSearchResultOnDuplicates>true</ReturnSearchResultOnDuplicates>
      <Type>UPC</Type>
      <Value>014633145892</Value>
    </ExternalProductID>
    <CategoryMappingAllowed>true</CategoryMappingAllowed>
    <Country>US</Country>
    <Currency>USD</Currency>
    <ListingDuration>Days_7</ListingDuration>
    <ListingType>Chinese</ListingType>
      <Country>US</Country>
    <Currency>USD</Currency>
    <Description>ISDA TEST -  FlatSimple</Description>
    <DispatchTimeMax>3</DispatchTimeMax>
    <ListingDuration>Days_7</ListingDuration>
    <Location>San Jose, CA</Location>
      <PaymentMethods>PayPal</PaymentMethods>
    <PayPalEmailAddress>test@aol.com</PayPalEmailAddress>
    <Quantity>1</Quantity>
    <StartPrice>1</StartPrice>
    <BuyItNowPrice>10</BuyItNowPrice>
    <Title>TEST -  FlatSimple</Title>
    <ShippingDetails>
      <ShippingType>Flat</ShippingType>
      <InsuranceDetails>
        <InsuranceOption>Optional</InsuranceOption>
        <InsuranceFee>3.5</InsuranceFee>
      </InsuranceDetails>
      <InternationalInsuranceDetails>
        <InsuranceOption>Required</InsuranceOption>
        <InsuranceFee>5.5</InsuranceFee>
      </InternationalInsuranceDetails>
      <ShippingServiceOptions>
        <ShippingServicePriority>1</ShippingServicePriority>
        <ShippingService>UPS2ndDay</ShippingService>
        <ShippingServiceCost>5</ShippingServiceCost>
        <ShippingServiceAdditionalCost>1</ShippingServiceAdditionalCost>
        <ShippingSurcharge>1</ShippingSurcharge>
      </ShippingServiceOptions>
      <InternationalShippingServiceOption>
        <ShippingServicePriority>1</ShippingServicePriority>
        <ShippingService>USPSPriorityMailInternational</ShippingService>
        <ShippingServiceCost>15</ShippingServiceCost>
        <ShippingServiceAdditionalCost>11</ShippingServiceAdditionalCost>
        <ShipToLocation>Worldwide</ShipToLocation>
      </InternationalShippingServiceOption>
    </ShippingDetails>
    <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>XXX<//eBayAuthToken>  </RequesterCredentials>
</AddItemRequest>

Below is the AddItemResponse returned with the request above:

<Errors>
<ShortMessage>Too many matches found.</ShortMessage>
<LongMessage>Search found too many matches with product identifier <014633145892>, type <UPC>.</LongMessage><ErrorCode>12025</ErrorCode>
<SeverityCode>Error</SeverityCode>
<ErrorParameters ParamID="0"><Value>014633145892</Value></ErrorParameters>
<ErrorParameters ParamID="1"><Value>UPC</Value></ErrorParameters>
<ErrorParameters ParamID="2"><Value></Value></ErrorParameters>
<ErrorClassification>RequestError</ErrorClassification>
</Errors>

When receiving the error 12025, you can do the following :
1. pass the same ExternalProductID.Value in Shopping FindProducts API call as below to retrieve catalog details for the matching Products.
<?xml version="1.0" encoding="utf-8"?>
<FindProductsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<ProductID type="UPC">014633145892</ProductID>
<MaxEntries>50</MaxEntries>
<AvailableItemsOnly>true</AvailableItemsOnly>
</FindProductsRequest>


The above request returns two products:
<FindProductsResponse xmlns="urn:ebay:apis:eBLBaseComponents">
   <Timestamp>2011-07-11T22:55:33.150Z</Timestamp>
   <Ack>Success</Ack>
   <Build>E729_CORE_BUNDLED_13450508_R1</Build>
   <Version>729</Version>
   <ApproximatePages>1</ApproximatePages>
   <MoreResults>false</MoreResults>
   <PageNumber>1</PageNumber>
   <Product>
      <DomainName>Video Games</DomainName>
      <DetailsURL>http://syicatalogs.ebay.ca/ws/eBayISAPI.dll?PageSyiProductDetails&amp;IncludeAttributes=1&amp;ShowAttributesTable=1&amp;ProductMementoString=117496:2:1051:620094773:337084193:748c240a7606c0d2d4399d3bd3b128d5:1:1:1:1121271493</DetailsURL>
      <DisplayStockPhotos>true</DisplayStockPhotos>
      <ProductID type="Reference">9183</ProductID>
      <ProductID type="UPC">014633145892</ProductID>
      <ItemSpecifics>
         <NameValueList>
            <Name>Platform</Name>
            <Value>Nintendo GameCube</Value>
         </NameValueList>
         <NameValueList>
            <Name>Publisher</Name>
         </NameValueList>
         <NameValueList>
            <Name>Rating</Name>
            <Value>E - Everyone</Value>
         </NameValueList>
      </ItemSpecifics>
      <ReviewCount>11</ReviewCount>
      <StockPhotoURL>http://i.ebayimg.com/20/!!e!Uc,QBWM~$(KGrHqZ,!l!Ez+zlYbw9BNP3Sqmn+g~~_6.JPG?set_id=89040003C1</StockPhotoURL>
      <Title>Tiger Woods PGA Tour 2003  (Nintendo GameCube, 2002)</Title>
   </Product>
   <Product>
      <DomainName>Video Games</DomainName>
      <DetailsURL>http://syicatalogs.ebay.ca/ws/eBayISAPI.dll?PageSyiProductDetails&amp;IncludeAttributes=1&amp;ShowAttributesTable=1&amp;ProductMementoString=117496:2:1051:3336443064:335802544:6e90fb84eb99673669bfb4b63bb87890:1:1:1:1182049752</DetailsURL>
      <DisplayStockPhotos>true</DisplayStockPhotos>
      <ProductID type="Reference">6484434</ProductID>
      <ProductID type="UPC">14633145892</ProductID>
      <ItemSpecifics>
         <NameValueList>
            <Name>Platform</Name>
            <Value>Apple</Value>
         </NameValueList>
         <NameValueList>
            <Name>Publisher</Name>
            <Value>Aspyr</Value>
         </NameValueList>
         <NameValueList>
            <Name>Rating</Name>
            <Value>E - Everyone</Value>
         </NameValueList>
      </ItemSpecifics>
      <ReviewCount>0</ReviewCount>
      <StockPhotoURL>http://i.ebayimg.com/06/!!eBq)GgEGM~$(KGrHqJ,!mIEz+0E27skBNQ0j-01J!~~_6.JPG?set_id=89040003C1</StockPhotoURL>
      <Title>Tiger Woods PGA Tour 2003 (Mac)</Title>
   </Product>
   <TotalProducts>2</TotalProducts>
</FindProductsResponse>
  
2. plug either of the ProductIDs returned in FindProducts response to the ProductListingDetails.ProductReferenceID in AddItem request to list the item.

<?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <Version>727</Version>
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
  <Item>
...
    <ProductListingDetails>
      <ProductReferenceID>6484434</ProductReferenceID>
    </ProductListingDetails>
...
</AddItemRequest>

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