eBay Trading APIVersion 1031

StorefrontType

This type defines the Storefront container, which can be used by eBay Stores sellers to list an item under two primary custom categories either by category ID or category name. A custom category is a category that was created by a seller in their eBay store. This container is used by Add/Revise/Relist calls.

The Storefront container is also returned in GetItem and other Trading calls that retrieve Item data.

Note: This type is applicable only for eBay Store sellers.

Type that uses StorefrontType:

Calls that use StorefrontType:

Fields



StoreCategory2ID ( long ) [1]
Unique identifier for the secondary custom category in which to list the item. Set this field to a root-level custom category or a custom category that has no child categories (subcategories).

The system resets the value to 0 (None) in the following cases:
- The values of StoreCategoryID and StoreCategory2ID field are the same
- You specify StoreCategory2ID but not StoreCategoryID


In other words, StoreCategoryID must be set to a valid custom category and be different from StoreCategory2ID.
See the Field Index to learn which calls use StoreCategory2ID.

StoreCategory2Name ( string ) [0..1]
Name of the secondary custom category in which to list the item. Set this field to a root-level custom category or a custom category that has no child categories (subcategories).

The system resets the value to 0 (None) in the following cases:
- The values of StoreCategoryName and StoreCategory2Name field are the same
- You specify StoreCategory2Name but not StoreCategoryName


In other words StoreCategoryName must be set to a valid custom category name and be different from StoreCategory2Name.
See the Field Index to learn which calls use StoreCategory2Name.

StoreCategoryID ( long ) [1]
Unique identifier of a primary custom category in which to list the item. A custom category is a category that the seller created in their eBay Store. eBay Store sellers can create up to three levels of custom categories for their stores, but the API only supports root-level categories.

To list an item using the categories in a seller's store, you must set this field to a root-level custom category or a custom category that has no child categories (subcategories). If you attempt to list an item in a category that has subcategories, the call response contains a warning, and the item is listed in the 'Other' store category.
See the Field Index to learn which calls use StoreCategoryID.

StoreCategoryName ( string ) [0..1]
Category name of a primary custom category in which to list the item. A custom category is a category that the seller created in their eBay Store. eBay Store sellers can create up to three levels of custom categories for their stores, but the API only supports root-level categories.

To list an item using a category name from a seller's store, you must set this field to a root-level custom category or a custom category that has no child categories (subcategories). If you attempt to list an item in a category that has subcategories, the call response contains a warning, and the item is listed in the store category called 'Other'.
See the Field Index to learn which calls use StoreCategoryName.

StoreName ( string ) [0..1]
Not used by any call.

The name of the seller's eBay Store.
See the Field Index to learn which calls use StoreName.

StoreURL ( anyURI ) [0..1]
The URL of the seller's eBay Stores page.
See the Field Index to learn which calls use StoreURL.