ebay-api - 由于缺少项目特定类型，无法在 eBay API 上添加项目

Question

调用 eBay AddItemRequest API 时出现以下错误

缺少项目特定类型。将类型添加到此列表，输入有效值，然后重试。21919303

<?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <RequesterCredentials>
    <eBayAuthToken>XXXXXXXXXXX</eBayAuthToken>
  </RequesterCredentials>
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
  <Item>
    <Title>test-800</Title>
    <Description>test 800</Description>
    <PrimaryCategory>
      <CategoryID>176971</CategoryID>
    </PrimaryCategory>
    <StartPrice>200</StartPrice>
    <CategoryMappingAllowed>true</CategoryMappingAllowed>
    <ConditionID>1000</ConditionID>
    <Country>US</Country>
    <Currency>USD</Currency>
    <DispatchTimeMax>3</DispatchTimeMax>
    <ListingDuration>GTC</ListingDuration>
    <ListingType>FixedPriceItem</ListingType>
    <PictureDetails>
      <GalleryType>Gallery</GalleryType>
      <PictureURL>https://eznetcrm.net/img/eZnetLogo.png</PictureURL>
    </PictureDetails>
    <PostalCode>32746</PostalCode>
    <ProductListingDetails>
      <UPC></UPC>
      <BrandMPN>
        <Brand>HP</Brand>
        <MPN>845418-B21</MPN>
      </BrandMPN>
      <IncludeStockPhotoURL>true</IncludeStockPhotoURL>
      <IncludePrefilledItemInformation>true</IncludePrefilledItemInformation>
      <UseFirstProduct>true</UseFirstProduct>
      <UseStockPhotoURLAsGallery>true</UseStockPhotoURLAsGallery>
      <ReturnSearchResultOnDuplicates>true</ReturnSearchResultOnDuplicates>
    </ProductListingDetails>
    <Quantity>5</Quantity>
    <ItemSpecifics>
      <NameValueList>
<Name>Brand</Name>
<Value>HP</Value>
  </NameValueList>
  <NameValueList>
<Name>MPN</Name>
<Value>845418-B21</Value>
  </NameValueList>
    </ItemSpecifics>
    <ReturnPolicy>
      <ReturnsAcceptedOption>ReturnsAccepted</ReturnsAcceptedOption>
      <RefundOption>MoneyBack</RefundOption>
      <ReturnsWithinOption>Days_30</ReturnsWithinOption>
      <ShippingCostPaidByOption>Buyer</ShippingCostPaidByOption>
    </ReturnPolicy>
    <ShippingDetails>
      <ShippingType>Flat</ShippingType>
      <ShippingServiceOptions>
        <ShippingServicePriority>1</ShippingServicePriority>
        <ShippingService>USPSMedia</ShippingService>
       <ShippingServiceAdditionalCost>0</ShippingServiceAdditionalCost>
        <ShippingServiceCost>0</ShippingServiceCost>
      </ShippingServiceOptions>
    </ShippingDetails>
    <Site>US</Site>
  </Item>
</AddItemRequest>

我们正尝试通过 eBay API 添加使用上述 XML 的项目，但无法这样做。我们在 XML 格式中做错了什么？此外，我们在遇到错误时添加了特定数据。

Answer 1

添加 ItemSpecifics 时，您需要检查是否有任何 ItemSpecific 条目对于您的 CategoryID 是必需的。这可以从 GetCategorySpecifics 中检查API。

在您的例子中，类别 ID 是 176971 并且在 XML 负载中，有两个现有的 ItemSpecifics:Brand 和 MPN。正如您从 eBay 上的 GetCategorySpecifics API 获得并确认的错误消息所建议的那样，很明显您需要添加名称为 Type 的 ItemSpecific/strong> 在你的 ItemSpecifics 中。这样做之后，您的 ItemSpecifics 应该如下所示:

  <ItemSpecifics>
     <NameValueList>
        <Name>Brand</Name>
        <Value>HP</Value>
     </NameValueList>

     <NameValueList>
        <Name>Type</Name>
        <Value>CustomTypeNameHere</Value>
     </NameValueList>

     <NameValueList>
        <Name>MPN</Name>
        <Value>845418-B21</Value>
     </NameValueList>
  </ItemSpecifics>

添加 Type ItemSpecific 后，您可以使用 VerifyAddItemResponse API 验证调用。

一般来说，要确定给定的 CategoryId 需要哪些 ItemSpecific，您可以引用以下文档 ( Listing with Required Item Specifics 。但是，非常简单地确定需要哪些项目细节，调用 GetCategorySpecifics 以检索针对您正在发布的类别的项目特定建议。在响应中，为每个建议查找这些字段:

• 类别需要此项目的特定名称:Recommendations.NameRecommendation.ValidationRules.MinValues
• 您只能使用 eBay 定义的这些值之一(在响应中返回):Recommendations.NameRecommendation.ValidationRules.SelectionMode=SelectionOnly