Reminder: Old Item Condition Values Start Breaking Listings July 27

Written by Ebay No Comments
Last Updated: July 15th, 2010
As of July 27, 2010, several categories are requiring that you specify the new, more granular Item Condition values using the new ConditionID field. This is a mandatory code change for developers.

We suggest:

Call GetCategoryFeatures for your category and site to determine if the new Item Condition values are required for that category. GetCategoryFeatures will also tell you what the possible values are.

Example request:
```
  
  
  ABC...123
  
  63861
  675
 
```
Example response:
```
...

  12345
  Required
  
    
      1000
      Brand New
    
    
      1500
      New other (see details)
    
    
      2000
      Manufacturer refurbished
    
    
      2500
      Seller refurbished
    
    
      3000
      Used
    
    
      7000
      For parts or not working
    
    http://pages.ebay.com/help/sell/contextual/condition_1.html
  

...
```
ConditionEnabled=Required means that the category requires the new way of specifying Item Condition.

ID=1000 means that, to specify that the item is brand new, you should use ConditionID=1000 in your AddItem request.

DisplayName=Brand New means that you should display the value “Brand New” to your users when they are choosing their Item Condition value. You will pass the corresponding ID value in your AddItem request.

ConditionHelpURL is the help page that describes the criteria for the different conditions. For example, a “Brand New” item is described as “A brand-new, unused, unopened, undamaged item in its original packaging (where packaging is applicable). Packaging should be the same as what is found in a retail store, unless the item is handmade or was packaged by the manufacturer in non-retail packaging, such as an unprinted box or plastic bag. See the seller’s listing for full details.”

We recommend that you provide this URL to your user during the listing flow so they can verify that their item meets the expected criteria.

Example AddItem request:
```
  
  
  ABC...123
  
  en_US
  High
  
   ...
  1000
   ...
```
ConditionID contains the value you got from the GetCategoryFeatures ID field.

When you call GetItem, you will also see the new values returned:

Example GetItem response:
```
  
2010-07-15T00:38:23.311Z
Success
675
E675_CORE_BUNDLED_11481347_R1

...
1000
Brand New
```
After July 27:

New listings: If the new condition ID values are required, and you do not pass them in, the listing will fail.

Existing listings: If the new condition ID values are required and you try to revise the listing without passing in the new values, the revise will fail. For example, if you try to update price or quantity without also including the new item condition values, the revise will fail. The listing will continue to exist on the site, but it will not have the new price or quantity.

For more information, see:
Reminder: Old Item Condition Values Start Breaking Listings July 27