Type Changes Coming: Store IDs May Reach 64-Bit in 2007

IDs used for eBay Stores may reach 64-bit values by July 2007 (or later).

Developer impact: to help you prepare for this in advance, we will change the types of the elements below from xs:int to xs:long in an upcoming schema release in early Q1 2007. The eBay SDKs will also be modified to support these type changes in Q1 2007.

What you need to do:

• You are not required to update your schema or your SDK in Q1 2007. However, if you do, you should be aware that these changes could affect you.
• If you use any of these elements (or store these values in your database), we recommend that you modify your code and database to support 64-bit values by July 1, 2007 to avoid unexpected errors later.
• If you are using SOAP (or the SDK) and you have coded against compiled language objects generated by the schema, we recommend that you update to a recent version of the schema by July 1, 2007.

The type changes will affect these calls:

• GetStore, SetStore, SetStoreCategories
• GetStoreCustomPage, SetStoreCustomPage
• GetPromotionRules, SetPromotionRules
• AddItem, RelistItem, ReviseItem, VerifyAddItem, GetItemRecommendations
• GetItem, GetBidderList, GetSellerList, GetSearchResults
• GetUserPreferences, SetUserPreferences

These are the elements whose types will change from xs:int to xs:long:

Element: CategoryID
Used by: StoreCustomCategoryType (GetStore, SetStore, SetStoreCategories)

Element: HomePage
Used by: StoreType (GetStore, SetStore)

Element: DestinationParentCategoryID, ItemDestinationCategoryID
Used by: SetStoreCategoriesRequestType (SetStoreCategories)

Element: PageID
Used by: StoreCustomPageType (GetStoreCustomPage, SetStoreCustomPage)

Element: PromotedStoreCategoryID, ReferringStoreCategoryID
Used by: PromotionRuleType (SetPromotionRules, GetPromotionRules)

Element: RootCategoryID
Used by: GetStoreRequestType (GetStore)

Element: StoreCategoryID
Used by: GetPromotionRulesRequestType (GetPromotionRules)

Element: StoreCategoryID
Used by: SellerFavoriteItemPreferencesType (GetUserPreferences, setUserPreferences)

Element: StoreCategoryID, StoreCategory2ID
Used by: StorefrontType (AddItem/GetItem family of calls, GetSearchResults)

After we make the schema changes, please refer to the documentation (or diff the schema) for the
complete list of elements that changed.

Please note that when these IDs eventually reach 64-bit values, we will return the actual values regardless of your request version. Also note that July 2007 is the earliest we expect to see these IDs reach 64-bit values, but the changes could occur later than this. We will do our best to keep track of the status and remind you to expect this change before the IDs actually reach 64-bit values.