Item Specifics Updates in June and July for Clothing, Shoes & Accessories

(Updated June 26, 2011 -- Color will not be required, but it is strongly recommended. Note that support for ID-based attributes in these categories has been extended to July 20, 2011. Also, GetCategorySpecifics returns required custom item specifics for applicable categories as of early June 2011.)

From April through July 2011, eBay is making changes in fashion categories for fashion enthusiasts. Here’s what developers need to know to support these changes. (These changes will affect eBay US and international sites.)

No ID-Based Attributes in Clothing, Shoes & Accessories

When we enabled custom item specifics for Clothing, Shoes & Accessories in 2009, we announced that the ID-based attributes in these categories would be deprecated in about a year. Support for ID-based attributes (Item.AttributeSetArray) is ending soon (late July) in Clothing, Shoes & Accessories. Use custom item specifics (Item.ItemSpecifics) in AddItem and related calls instead.  (All areas of Clothing, Shoes & Accessories have supported the new custom item specifics format for the past year or more.)

If you still had Clothing, Shoes & Accessories listings with ID-based attributes as of April 2011, eBay converted those existing listings to custom item specifics for you. However, as the item specifics have changed since April, these conversions will no longer occur.

Category Structure Changes in Clothing, Shoes & Accessories

A number of changes have been made to the Clothing, Shoes & Accessories category structure. Category structure changes eliminate redundancies, improve coverage, and meet buyers’ shopping experience expectations.  Your (or your sellers') listings falling under impacted categories may have been moved to new categories based on existing category ID and item specifics. The category structure updates were effective on April 5th. Please revise your GTC listings if you feel a different category is a better fit.

In addition to the category structure changes, we have tailored custom item specific values in Clothing, Shoes & Accessories.  The values were improved to meet sellers’ needs and to help with item specifics relevance. For example, some subcategories moved out of the Clothing, Shoes & Accessories category structure and into item specifics instead. (Some new categories are being added, as well.) 

GetCategorySpecifics identifies the available custom item specifics for leaf categories, as well as dependencies between item specifics. After the metadata changes are available in the system, see NameRecommendation.ValidationRules.MinValues to identify required item specifics, and NameRecommendation.ValidationRules.Relationship for any dependencies. GetItemRecommendations will also be updated.

Note: Although GetCategory2CS and GetAttributesCS may still return ID-based attribute data for these categories, avoid using these calls for Clothing, Shoes & Accessories. As a general rule, if GetCategoryFeatures shows that a category supports custom item specifics (ItemSpecificsEnabled) or a category has been converted from ID-based attributes to custom item specifics (AttributeConversionEnabled), you should use custom item specifics instead of ID-based attributes.

Required Item Specifics Coming in June and July in Clothing, Shoes & Accessories

Starting July 20, 2011 all new and revised listings in Clothing, Shoes & Accessories categories must include the following item specifics: Brand, Size Type, Size, and Style in the ItemSpecifics (name/value) format. Required item specifics may vary by category.

Color is not required (updated from original announcement, based on community feedback), but both Color and Shade help establish consistent color across categories. Sellers are highly encouraged to provide details on both aspects. Specifying Color will enable buyers find your items when searching for items by color.

As of the end of June 2011, eBay is giving more visibility to these refinements in Fashion categories, so we recommend that you start using custom item specifics now if you don't already.

These calls will fail for listings that are missing required item specifics:

  • AddItem and AddFixedPriceItem
  • RelistItem and RelistFixedPriceItem
  • ReviseItem and ReviseFixedPriceItem (even if your revision does not touch the item specifics)

The following cases will not be blocked for now. However, we recommend that sellers include the required item specifics in these listings in order to benefit from the new buyer experience:

  • ReviseInventoryStatus (for changing price and quantity) won't be blocked regardless of whether existing listings in Clothing, Shoes & Accessories categories have the required item specifics.
  • Good 'Til Canceled (GTC) listings that you don't revise; they will continue to renew automatically for the next several months even if they are missing required item specifics.

Early Access Info: Starting in June 2011, GetCategorySpecifics and GetItemRecommendations will identify the required item specifics for leaf categories, before they become mandated on July 20. (Alternatively, see the lookup table for developers (link below) to view the mandated item specifics).

In general, if ValidationRules.MinValues is set to 1, it means the item specific is required for that category. For Clothing, Shoes & Accessories categories, it means that the item specific will be required after July 20.

AddItem and related calls will not enforce these required item specifics in fashion categories until July 20. However, we encourage you to start using the required item specifics as early as possible.

Also note that if ValidationRules.SelectionMode is set to "SelectionOnly", it means you must choose from eBay's recommended values, instead of specifying you own custom value. (This occurs for Style, Occasion, and Color in some categories.) This requirement is already in effect. However, if your application does not yet support using SelectionOnly values in GetCategorySpecifics, you can omit the item specific entirely in the short term while you adjust your application. AddItem and related calls will not block fashion listings that omit item specifics, until July 20.

More Information On These Fashion Category Changes

Item Specifics Lookup Table (All Categories) for Developers
http://developer.ebay.com/DevZone/itemspecificslookup/

Site changes for Fashion Pages - April 2011
http://pages.ebay.com/categorychanges/CSA-2011.html

Item specifics required in Fashion categories
http://pages.ebay.com/sellerinformation/news/clothingshoesaccessories.html

Required Item Specifics Lookup Table for Sellers
http://pages.ebay.com/sellerinformation/increaseyoursales/csalookup.html

Review the category, catalog and item specific updates coming April and May
http://pages.ebay.com/sellerinformation/news/CategoryUpdatesSpring2011.html

 

June 9, 2011 in Best Practices, Business News, Categories and Item Specifics, Certified Provider, Critical Notes from Tech Support, Documentation, Product News, Seller Releases, Trading API | Permalink

Item Specifics Updates for Clothing, Shoes & Accessories

(Updated June 7, 2011 -- Note that support for ID-based attributes in these categories has been extended to July 20, 2011. Also, GetCategorySpecifics returns required custom item specifics for applicable categories as of early June 2011.)

From April through July 2011, eBay is making changes in fashion categories for fashion enthusiasts. Here’s what developers need to know to support these changes. (These changes will affect eBay US and international sites.)

No ID-Based Attributes in Clothing, Shoes & Accessories

Support for ID-based attributes (Item.AttributeSetArray) is ending soon (late July) in Clothing, Shoes & Accessories. Use custom item specifics (Item.ItemSpecifics) in AddItem and related calls instead.  (All areas of Clothing, Shoes & Accessories have supported the new custom item specifics format for the past year or more.)

If you still have Clothing, Shoes & Accessories listings with ID-based attributes, eBay will convert those existing listings to custom item specifics for you.

Category Structure Changes in Clothing, Shoes & Accessories

A number of changes have been made to the Clothing, Shoes & Accessories category structure. Category structure changes will eliminate redundancies, improve coverage, and meet buyers’ shopping experience expectations.  Your (or your sellers') listings falling under impacted categories may have been moved to new categories based on existing category ID and item specifics. After the category structure updates are effective (on April 5th), please revise your listings if you feel a different category is a better fit.

In addition to the category structure changes, we are tailoring custom item specific values in Clothing, Shoes & Accessories.  The values are being improved to meet sellers’ needs and to help with item specifics relevance. For example, some subcategories are moving out of the Clothing, Shoes & Accessories category structure and into item specifics instead. (Some new categories are being added, as well.)

GetCategorySpecifics identifies the available custom item specifics for leaf categories, as well as dependencies between item specifics. After the metadata changes are available in the system, see NameRecommendation.ValidationRules.MinValues to identify required item specifics, and NameRecommendation.ValidationRules.Relationship for any dependencies. GetItemRecommendations will also be updated.

Note: Although GetCategory2CS and GetAttributesCS may still return ID-based attribute data for these categories, we recommend that you avoid using these calls for Clothing, Shoes & Accessories. As a general rule, if GetCategoryFeatures shows that a category supports custom item specifics (ItemSpecificsEnabled) or a category has been converted from ID-based attributes to custom item specifics (AttributeConversionEnabled), you should use custom item specifics instead of ID-based attributes.

Required Item Specifics Coming in June and July in Clothing, Shoes & Accessories

Starting July 20, 2011 all new and revised listings in Clothing, Shoes & Accessories categories must include the following custom item specifics: Brand, Size Type, Size, Style, and Color. Required item specifics may vary by category.

These calls will fail if listings in the above categories are missing required item specifics:

  • AddItem and AddFixedPriceItem
  • RelistItem and RelistFixedPriceItem
  • ReviseItem and ReviseFixedPriceItem (even if your revision does not touch the item specifics)

The following cases will not be blocked for now. However, we recommend that sellers include the required item specifics in these listings in order to benefit from the new buyer experience:

  • ReviseInventoryStatus (for changing price and quantity) won't be blocked regardless of whether existing listings in Clothing, Shoes & Accessories categories have the required item specifics.
  • Good 'Til Canceled (GTC) listings that you don't revise, they will continue to renew automatically for the next several months even if they are missing required item specifics.

Early Access Info: Starting in June 2011, GetCategorySpecifics and GetItemRecommendations will identify the required custom item specifics for leaf categories, before they become mandated on July 20. (Alternatively, see the lookup table for developers (link below) to view the mandated item specifics).

In general, if ValidationRules.MinValues is set to 1, it means the item specific is required for that category. For Clothing, Shoes & Accessories categories, it means that the item specific will be required after July 20.

AddItem and related calls will not enforce these required item specifics in fashion categories until July 20. However, we encourage you to start using the required item specifics as early as possible.

More Information On These Fashion Category Changes

Site changes for Fashion Pages - April 2011
http://pages.ebay.com/categorychanges/CSA-2011.html

Item specifics required in Fashion categories
http://pages.ebay.com/sellerinformation/news/clothingshoesaccessories.html

Required Item Specifics Lookup Table for Sellers
http://pages.ebay.com/sellerinformation/increaseyoursales/csalookup.html

Review the category, catalog and item specific updates coming April and May
http://pages.ebay.com/sellerinformation/news/CategoryUpdatesSpring2011.html

Item Specifics Lookup Table (All Categories) for Developers
http://developer.ebay.com/DevZone/itemspecificslookup/

 

April 4, 2011 in Best Practices, Categories and Item Specifics, Large Merchant Services, Product News, Seller Releases, Trading API | Permalink

Motors Parts & Accessories: Required Return Policy, Handling Time, Item Condition

Beginning May 9, 2011, AddItem, AddFixedPriceItem, RelistItem, and RelistFixedPriceItem must include ReturnPolicy, DispatchTimeMax (handling time), and ConditionID for all US eBay (site 100) Motors Parts & Accessories items that are newly listed or relisted.

We encourage you to also start adding this information to existing Good 'Til Cancelled (GTC) listings, which will require these changes in early 2012.

In GetCategoryFeatures, see ReturnPolicyEnabled, HandlingTimeEnabled, ConditionEnabled (and ConditionValues) to determine which categories require these fields. For a list of the handling time values allowed for each site, use DispatchTimeMaxDetails in GeteBayDetails.

For general information about these changes, see this 2011 Spring Seller Update:

Return policy, handling time and item condition required for all new listings and relistings
http://pages.ebay.com/sellerinformation/news/motorspaupdate.html

Also, as previously announced in the Trading API release notes, Parts & Accessories categories on the US eBay Motors site support the ability to allow buyers to return Parts & Accessories items within 60 days, and the ability for the seller to choose whether the seller or buyer pays return shipping costs.

Return Policy Updates for Motors Parts & Accessories (API Release Notes)
http://developer.ebay.com/DevZone/XML/docs/WebHelp/ReleaseNotes.html#709RtrnPlcyMtrsPnA

 

April 3, 2011 in Best Practices, eBay Motors, Product News, Seller Releases, Trading API | Permalink

Coming Soon: New VeriSign Certificate for Open eBay Apps

Attention Open eBay developers: the VeriSign certificate used for subscription calls between Open eBay and your application will expire in early March.

Before that happens, the Open eBay team will publish a new certificate for your application to use, and instructions for its use, here: http://developer.ebay.com/DevZone/open-ebay-apps/Concepts/OpeneBayUGDev.html#signature.

Watch this space for updates, and if you have any questions, please file a support ticket: http://developer.ebay.com/support/developersupport/request/default.aspx

Thanks,

-Open eBay team

February 9, 2011 in Authentication & Authorization, Developer Community, Open eBay, Product News | Permalink

New API for Browsing Inventory on Half.com

Half.com is launching a brand new Half Finding API, which will help streamline the search and browse functionality for items listed on Half.com. The API includes the findHalfItems call, which returns a paginated list of items for a specific product ID, sorted by price. In addition, you can filter items based on item condition and seller. You can retrieve a maximum of 1500 items for a given product through this API.

See the Half Finding API documentation for more information.

February 3, 2011 in Business News, Product News | Permalink

GetMyMessages Now Returns Message Body in Text Format

You asked, we heard!

Text-only versions of message content are now returned in GetMyMessages, in Messages.Message.Content field. This makes retrieving message content simple - no need to write and maintain a script to parse and extract the text content from the HTML content.

Sample Request

<?xml version="1.0"  encoding="utf-8"?>
  <GetMyMessagesRequest  xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Specify ReturnSummary, ReturnHeaders, or ReturnMessages -->
  <DetailLevel>ReturnMessages</DetailLevel>
  <!-- Either AlertIDs or MessageIDs should be included (or both) if the  
ReturnMessages detail level is specified. --> <RequesterCredentials> <eBayAuthToken>token</eBayAuthToken> </RequesterCredentials> <MessageIDs> <MessageID>28886479892</MessageID> </MessageIDs> </GetMyMessagesRequest>

Sample Response

<?xml version="1.0"  encoding="utf-8"?>
  <GetMyMessagesResponse  xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2010-09-21T00:00:20.742Z</Timestamp>
  <Ack>Success</Ack>
  <Version>687</Version>
  <Build>E687_CORE_BUNDLED_12073818_R1</Build>
  <Messages>
  <Message>
  <Sender>abc123</Sender>
  <SendingUserID>184765903</SendingUserID>
  <RecipientUserID>jdoe</RecipientUserID>
  <SendToName>jdoe</SendToName>
  <Subject>abc123 has sent a question  about item #150485679913, that 
ended on Sep-02-10 15:53:00 PDT - !!!This is a test - DO NOT BID!!!
- GET IT FAST</Subject> <MessageID>28886479892</MessageID> <ExternalMessageID>27868355013</ExternalMessageID> <Text>HTML content is returned here</Text> <Flagged>false</Flagged> <Read>false</Read> <ReceiveDate>2010-09-07T01:48:41.000Z</ReceiveDate> <ExpirationDate>2011-09-07T01:48:40.000Z</ExpirationDate> . . . <Content>                         ----------------------------------------------------------------- eBay sent this message to John Doe (jdoe). Your registered name is included to show this message originated from eBay. Learn more at http://pages.ebay.com/help/confidence/name-userid-emails.html ----------------------------------------------------------------- ----------------------------------------------------------------- This member has a question for you. ----------------------------------------------------------------- Do not respond to the sender if this message requests that you complete the transaction outside of eBay. This type of offer is against eBay policy, may be fraudulent, and is not covered by buyer protection programs. Learn More at http://pages.ebay.com/help/policies/rfe-spam-non-ebay-sale.html Dear jdoe, I see the item says Local Pickup. Will you be able to help load this item? -abc123 ================================================================= Answer the question http://rover.ebay.com/rover/0/e11050.m44.l1139/7?euid=1482aa92b3c
8487aa0ae8a3050ba7aeb&amp;loc=http%3A%2F%2Fcontact.ebay.com%2Fws%2F
eBayISAPI.dll%3FM2MContact%26item%3D150485679913%26requested%3Dabc1
23%26qid%3D27868355013%26redirect%3D0%26ssPageName%3DADME%3AX%3AAAQ%
3AUS%3A1139
================================================================= </Content> </GetMyMessagesResponse>

For more information, see Improvements to My Messages Functionality

October 7, 2010 in Product News, Trading API | Permalink

Developer Impact: Duplicate Listing Policy

Yesterday, Dinesh Lathi announced a new Duplicate Listing policy on eBay (US, CA, CAFR) and eBay Motors. Starting October 26, a seller’s duplicate listings may be removed unless they are "significantly different in buyer benefit and value from items offered in their other Fixed Price listings." This policy does not apply to auction format.

Developers may want to consolidate listings for their sellers. The easiest thing to do is take duplicate single-quantity listings, increase the quantity of one listing, and end the other listings. If the other listings are ended on Oct 26, insertion fees will be credited.

Duplicate listings can also be consolidated into multi-variation listings, or fitment listings (in Motors P&A). It is not possible to directly convert the format, so the original duplicate listings will need to be ended, and the consolidated item listed as a new multi-variation or fitment listing.

Sellers who continue to create duplicate listings may be subject to a range of additional actions including "listing cancellation, loss of fees, limits on account privileges, loss of seller status, and account suspension." Developers will want to make sure that they consolidate seller listings to avoid subjecting their sellers to penalties.

For more details on this new policy, including example duplicate listings, see:

Also see,

September 22, 2010 in Best Practices, Large Merchant Services, Product News, Trading API | Permalink

Announcing the newest member of the eBay Developers Program

Sergeheadshot
We are very excited to announce and welcome the newest member of the eBay Developers Program, Sergio “Serge” Gonzales. Serge is joining the team as the Head of the eBay Developers Program. Serge succeeds Kumar Kandaswamy, who headed up the Developers Program for many years.

Serge is no newbie to the eBay world having been with the company since 2003. Most recently, Serge returns to the U.S. after a 3-year assignment at Marktplaats, an eBay-owned Classifieds site in the Netherlands. While there, he managed different cross-functional parts of the organization and his roles have included: Head of CS Business Applications, Head of Application Delivery, Head of QA, Head of Mobile and Innovation Strategy, and acting co-CTO.

When asked about his goals for the program, Serge says: “As a Buyer, Seller, and sometime Developer myself I want to make sure our customers get the greatest value possible from the eBay platform. I am looking forward to partnering with our Developer Community to help make the eBay platform the most profitable opportunity for developing applications. We have a responsibility to our existing partners to help them grow their businesses, and I look forward to getting new Developers excited about building their applications with eBay services. We have a lot of work ahead of us but I couldn’t ask for a more passionate and talented team to help make this happen.”

August 9, 2010 in Developer Community, Product News | Permalink

AdCommerce Discontinued in eBay US & CA, Still Available for eBay EU & AU

As we announced in early July, the AdCommerce pay-per-click ad program that allowed eBay sellers to purchase pay-per-click advertisements on search result pages linking to their eBay stores and listings will be retired for eBay.com and eBay.ca as of August 4, 2010.

The service will continue for eBay sellers using AdCommerce in Europe and Australia, and it will continue for e-commerce retailers worldwide as it has in the past.

The AdCommerce API is still available through the Developer's Program and we encourage you to check it out. It currently supports all ad creation, management and reporting functionality, enabling developers to provide additional services to their e-commerce customers and assist in improving their performance. There's more to come for developers interested in using AdCommerce later this summer, including an API Sandbox for testing, so stay tuned for more info.

Thank you,
eBay AdCommerce team

July 28, 2010 in International, Partner News, Product News | Permalink

Developer Impact: eBay Buyer Protection in US, UK, DE

eBay DE just announced that a new eBay Buyer Protection program will be available on the DE site starting in September.

Developers will find that there is currently an issue retrieving new eBay Buyer Protection cases (for item not received and not as described problems) that were filed in the eBay Resolution Center. These cases are not being returned via the Trading API call GetUserDisputes. As a workaround, sellers today can view all their cases on the eBay website.

In September, we are releasing a way to retrieve the eBay Buyer Protection cases with a new ResolutionCaseManagement API. You will be able to subscribe to notifications that will send a message to your server when a case is opened, closed, or changes state.

In a future release, we will provide a single API that allows you to manage cases from both the old and new eBay Buyer Protection systems.

The new eBay Buyer Protection is currently live on the US and UK sites. In September it will be live for DE as well.

July 16, 2010 in Best Practices, International, Product News, Trading API | Permalink