商品固有の識別情報（Product Identifiers）の必須化

2015.06.29

2015年6月29日より、US,UK,ドイツ、オーストラリアのeBayサイトの一部のカテゴリにおいて新品の商品を出品する際、商品識別コード(UPC, EAN, ISBN)、メーカー製品番号(MPN)の入力が必須になります。 これに伴い、APIを利用して出品を行う際の対応方法を紹介します。

特定のカテゴリで必須になっている商品識別コードを確認する

Trading APIのGetCategoryFeaturesコールを使って、必須になっている商品識別コードを確認します。 リクエストパイロードは下記のように入力します。


<?xml version="1.0" encoding="utf-8"?>
<GetCategoryFeaturesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <RequesterCredentials>
    <eBayAuthToken>***</eBayAuthToken>
  </RequesterCredentials>
    <FeatureID>EANEnabled</FeatureID>
    <FeatureID>ISBNEnabled</FeatureID>
    <FeatureID>UPCEnabled</FeatureID>
    <CategoryID>9355</CategoryID>
    <DetailLevel>ReturnAll</DetailLevel>
</GetCategoryFeaturesRequest>
するとレスポンスは下記のように取得され、UPCが必須になっていることが分かります。 
<GetCategoryFeaturesResponse xmlns="urn:ebay:apis:eBLBaseComponents">
 ...
 ...
<Category>
    <CategoryID>9355</CategoryID>
    <UPCEnabled>Required</UPCEnabled>
</Category>
<SiteDefaults />
<FeatureDefinitions />
</GetCategoryFeaturesResponse>

メーカー製品番号(MPN)が必須になっているかどうかを確認する

GetCategorySpecificsコールを使って、必須になっているItem Specificsを確認します。 レスポンスの中で、MPNのMinValues属性が1以上であれば、必須になっています。 
 <NameRecommendation>
        <Name>MPN</Name>
        <ValidationRules>
            <ValueType>Text</ValueType>
            <MinValues>1</MinValues>
            <MaxValues>1</MaxValues>
            <SelectionMode>FreeText</SelectionMode>
        </ValidationRules>
    </NameRecommendation>

商品識別コード、メーカー製品番号を出品時に指定する

固定価格商品を出品するAddFixedPriceItemで指定するサンプルを幾つか紹介します。

バリエーションがない商品の出品例 

<AddFixedPriceItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
...
...
<ConditionID>1000</ConditionID>
<PrimaryCategory>
       <CategoryID>9355</CategoryID>
</PrimaryCategory>
 <ProductListingDetails>
        <UPC>885909727476</UPC>
    </ProductListingDetails>
 <ItemSpecifics>
        <NameValueList>
            <Name>MPN</Name>
            <Value>ME299LL/A</Value>
        </NameValueList>
        <NameValueList>
            <Name>Brand</Name>
            <Value>Apple</Value>
        </NameValueList>
 </ItemSpecifics>
...
...
<RequesterCredentials>
<eBayAuthToken>******</eBayAuthToken>
   </RequesterCredentials>
</AddFixedPriceItemRequest>

バリエーションのある商品の出品例１ 

<AddFixedPriceItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
...
...
<Variations>
    <Variation>
        <SKU>SKU-123</SKU>
        <StartPrice currencyID="USD">41.95</StartPrice>
        <Quantity>1</Quantity>
        <VariationSpecifics>
            <NameValueList>
               <Name>Color</Name>
               <Value>Yellow</Value>
            </NameValueList>
        </VariationSpecifics>
        <VariationProductListingDetails>
            <UPC>6955165629174</UPC>
        </VariationProductListingDetails>        
    </Variation>
    <VariationSpecificsSet>
        <NameValueList>
            <Name>Color</Name>
            <Value>Yellow</Value>              
        </NameValueList>
    </VariationSpecificsSet>
    </Variations>
...
...
<RequesterCredentials>
<eBayAuthToken>******</eBayAuthToken>
   </RequesterCredentials>
</AddFixedPriceItemRequest>

バリエーションのある商品の出品例２ 

<AddFixedPriceItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
...
...
<Variations>
    <Variation>
        <SKU>SKU-123</SKU>
        <StartPrice currencyID="USD">41.95</StartPrice>
        <Quantity>1</Quantity>
        <VariationSpecifics>
           <NameValueList>
              <Name>Color</Name>
              <Value>Yellow</Value>
           </NameValueList>
        </VariationSpecifics>
        <VariationProductListingDetails>
        <UPC>6955165629174</UPC>
        </VariationProductListingDetails>        
    </Variation>

    <Variation>
        <SKU>SKU-234</SKU>
        <StartPrice currencyID="USD">41.95</StartPrice>
        <Quantity>1</Quantity>
        <VariationSpecifics>
           <NameValueList>
              <Name>Color</Name>
              <Value>Blue</Value>
           </NameValueList>
        </VariationSpecifics>
        <VariationProductListingDetails>
        <UPC>885909727476</UPC>
        </VariationProductListingDetails>        
    </Variation>

    <Variation>
        <SKU>SKU-456</SKU>
        <StartPrice currencyID="USD">41.95</StartPrice>
        <Quantity>1</Quantity>
        <VariationSpecifics>
           <NameValueList>
              <Name>Color</Name>
              <Value>Green</Value>
           </NameValueList>
        </VariationSpecifics>
        <VariationProductListingDetails>
        <UPC>Not Applicable</UPC>
        </VariationProductListingDetails>        
    </Variation>

    <VariationSpecificsSet>
    <NameValueList>
        <Name>Color</Name>
        <Value>Yellow</Value>              
        <Value>Blue</Value>
        <Value>Green</Value>
    </NameValueList>
    </VariationSpecificsSet>
</Variations>
...
...
<RequesterCredentials>
<eBayAuthToken>******</eBayAuthToken>
   </RequesterCredentials>
</AddFixedPriceItemRequest>

商品識別コードが存在しない商品の場合

必須とされている商品識別コードがない場合は、 
<UPC>Does not apply</UPC>
のように「Does not apply」を指定できます。 ただし、本来商品識別コードが存在する商品の場合、検索結果の表示順で不利になるのでご注意下さい。 本件について更に詳しい情報は、英語サイトDevelopers Programm’s Blogを参照下さい。