http://developer.ebay.com/DevZone/XML/docs/WebHelp/eBayMotors-Listing_US_and_CA_eBay_Motors_Items.html
Specialty and International Sites > eBay Motors > Listing US and CA eBay Motors Items 
 



Listing US and CA eBay Motors Items

Certain rules for listing items to or retrieving items from the eBay Motors US site are different from the rules for listing to the main eBay US site.

If you have downloaded this documentation locally, please refer to the documentation on the eBay Developers Program Web site for the latest rules and details.

eBay Developer Documentation Center
http://developer.ebay.com/support/docs/

This section covers the following topics:

Specifying Categories for eBay Motors Listings

Specifying a Listing Format for eBay Motors Listings

eBay Motors and eBay Stores

Shipping Details for eBay Motors

Local Market Listings

Using Item Specifics in eBay Motors US Listings

Valid Item Specifics for Listing eBay Motors US Cars & Trucks

Specifying the Vehicle Manufacturer and Model

Specifying a Subtitle for a Motors Vehicle Listing

Specifying a Vehicle Deposit and Deposit Amount

Requiring Immediate Payment of a Vehicle Deposit

Vehicle Condition Guarantee By Seller

Short-Term Service Agreement (Limited Warranty)

Vehicle Purchase Protection

Payment Methods for Motors

Listing eBay Motors US Items in eBay Stores

Revising US Motors Listings

Specifying Categories for eBay Motors Listings

eBay Motors has a distinct category hierarchy in which items are listed, and categories and their IDs are not the same as on any other eBay site. When you retrieve the eBay Motors category hierarchy using GetCategories, you need to specify the eBay Motors site instead of the main eBay site. To do this, specify a value of 100 in the X-EBAY-API-SITEID header (for the XML API) or in the request URL (for the SOAP API) (see Routing the Request (Gateway URLs)) and set CategorySiteID to "100".

Similarly, when you list an eBay Motors US item using a call like AddItem, you need to specify the eBay Motors site instead of the main eBay site. To do this, pass a site ID of 100 as described above, and set Item.Site to eBayMotors.

Listing eBay Motors Items in Two Categories

The rules for listing in one or two categories depends on the category:

Specialized Fields (Item Specifics) for Vehicle Categories

Certain fields that are required for listings in US and CA eBay Motors vehicle categories must be set using Item Specifics. See Using Item Specifics in eBay Motors US Listings for more information.

Specifying a Listing Format for eBay Motors Listings

eBay Motors items within the Parts & Accessories and the Everything Else categories can be listed in Chinese Auction, Store Inventory, or Basic Fixed-Price formats.

When you list nationally, eBay Motors items within vehicle categories can be listed in an auction-style formats, but cannot be listed in the Fixed Price or Store Inventory formats.

See Local Market Listings for listing format rules when you list vehicles as Local Market listings.

eBay Motors and eBay Stores

Items that an eBay Stores seller lists to the eBay Motors US site also appear in the seller's eBay Store. As with any listing, Stores sellers can define custom store categories for their eBay Motors listings.

Shipping Details for eBay Motors

For eBay Motors listings, shipping details depend on the category:

Local Market Listings

Sellers can list vehicles for the eBay Motors Local Market only. The Local Market is defined as the area within a set radius about a specified postal code. Local Market listings can be Best Offer Only, if the Listing Type is set to 'Lead Generation'. Buyers can retrieve Local Market vehicle listings in searches only when they supply a postal code.

Note: Local Market listings are supported for vehicle categories on the eBay Motors US site only and for US postal codes only.

Options to list as 'Fixed Price', 'Buy It Now' or 'Buy It Now + Best Offer' are no longer available for Local Market listings. If you have existing listings that use these categories, they will remain on the site and you can revise them until they expire.

Adding Local Market Listings

To add a Local Market listing, use Item.ListingDetails.LocalListingDistance to specify a distance (the radius about the item location that constitutes the Local Market) and set Item.ListingType to "FixedPriceItem" in an AddItem request. Buyers can set the local listing distance to one of the preset values, such as 25, 50, 75, or 100. Use FeatureID.LocalListingDistances in GetCategoryFeatures to retrieve a list of valid values for local listing distance by category.

You can specify additional seller information such as: Address/Dealer Location, Telephone number (CallBright), and Contact Hours using an AddItem request. If the seller does not specify an address/dealer location, the vehicle location specified in the shipping section will be used.

Optionally, the listing can use the Lead Generation selling format by setting Item.ListingType to LeadGeneration and setting Item.BestOfferDetails.BestOfferEnabled to true. This creates a Best Offer Only listing that requires a StartPrice, which will be displayed as the Advertised Price to buyers.

Note the following when creating a Local Market listing:

Revising and Relisting Local Market Listings

Note the following call-specific differences when revising or relisting a Local Market listing:

Relisting local vehicle listings is subject to the current restrictions for relisting items in eBay Motors, unless otherwise specified.

Best Offer Only

Best Offer Only listings are created using the Lead Generation format. This special format picks up all of the current functionality of a listing for which Best Offer has been enabled.

For example, GetBestOffers and RespondToBestOffer handle a Best Offer Only local market listing the same as the other listings that support best offers.

In the GetCrossPromotions call response, the PromotionPriceType field is set to "BestOfferOnlyPrice" when a promoted item is a Best Offer Only listing.

Additionally, GetMyeBayBuying handles a Best Offer Only local market listing the same as the other listings that support best offers. Local market listing items will be returned in BestOfferList of the GetMyeBayBuying response, and included in the BuyingSummary.BestOfferCount value. Likewise, GetMyeBaySelling handles a Best Offer Only local market listing the same as the other listings that support best offers and returns the listing in relevant lists: ScheduledList, ActiveList, SoldList, or UnsoldList.

Sellers cannot end a Best Offer Only local vehicle listing early if there are active best offers.

Retrieving Lead Information

When a buyer is interested in a Classified Ad vehicle listing in eBay Motors or Motors categories, he can leave information for the seller via the Ask Seller a Question or eBay lead form on the View Item page. This lead information includes data like name, email address, telephone, best time to contact, trade-in information, interest in financing, and the buyer's time frame for purchasing.

The seller can use the GetAdFormatLeads request to retrieve lead data for his listings.

Using Item Specifics in eBay Motors US Listings

On the eBay Motors US site, you use a set of Item Specfics (attributes) to fill in vehicle details like Mileage and Exterior Color.

The eBay Motors US Web site UI supports two listing flows:

If you are using the XML API or the SOAP API, the next sections describe the basic process you use to list vehicles to eBay Motors US. (The SDKs include an Attributes Library that simplifies this process.)

Using GetCategories to Retrieve eBay Motors Categories

First, use GetCategories to retrieve all the available eBay Motors categories. Be sure to specify the eBay Motors US site instead of the main eBay site. To do this, specify a value of 100 in the X-EBAY-API-SITEID header (for the XML API) or in the request URL (for the SOAP API). (See Routing the Request (Gateway URLs).)

Example 33-1 shows a typical GetCategories request, using the XML API.

Example 33-1 GetCategories Request (XML API) 
<?xml version="1.0" encoding="utf-8"?> 
<GetCategoriesRequest xmlns="urn:ebay:apis:eBLBaseComponents"> 
  <RequesterCredentials> 
    <eBayAuthToken>YOURTOKENHERE</eBayAuthToken> 
  </RequesterCredentials> 
  <CategorySiteID>100</CategorySiteID> 
  <DetailLevel>ReturnAll</DetailLevel> 
  <ViewAllNodes>true</ViewAllNodes> 
</GetCategoriesRequest>

As usual for this call, store the response locally. In most cases, eBay Motors categories are associated with specific makes and models, like "Pontiac : Trans Am". You will use a category ID to identify the make and model in Item.PrimaryCategory.CategoryID when you list the item.

Example 33-2 shows the Pontiac category and the Trans Am category in the GetCategories response for the eBay Motors US site.

GetCategories doesn't specifically indicate "make" or "model", but for vehicles the leaf category is the model. (The example also shows that 6377's parent is 6001, which is Cars & Trucks, so we know this is a vehicle category.).

Example 33-2 Categories in the GetCategories Response (XML API)  
<Category> 
  <BestOfferEnabled>true</BestOfferEnabled> 
  <AutoPayEnabled>true</AutoPayEnabled> 
  <CategoryID>6377</CategoryID> 
  <CategoryLevel>3</CategoryLevel> 
  <CategoryName>Pontiac</CategoryName> 
  <CategoryParentID>6001</CategoryParentID> 
  <Expired>false</Expired> 
  <IntlAutosFixedCat>false</IntlAutosFixedCat> 
  <LeafCategory>false</LeafCategory> 
  <Virtual>false</Virtual> 
  <SellerGuaranteeEligible>true</SellerGuaranteeEligible> 
  <ORPA>false</ORPA> 
  <LSD>true</LSD> 
</Category> 

<Category> 
  <BestOfferEnabled>true</BestOfferEnabled> 
  <AutoPayEnabled>true</AutoPayEnabled> 
  <CategoryID>6427</CategoryID> 
  <CategoryLevel>4</CategoryLevel> 
  <CategoryName>Trans Am</CategoryName> 
  <CategoryParentID>6377</CategoryParentID> 
  <Expired>false</Expired> 
  <IntlAutosFixedCat>false</IntlAutosFixedCat> 
  <LeafCategory>true</LeafCategory> 
  <Virtual>false</Virtual> 
  <SellerGuaranteeEligible>true</SellerGuaranteeEligible> 
  <ORPA>false</ORPA> 
  <LSD>true</LSD> 
</Category>

Using GetCategory2CS and GetAttributesCS to Retrieve Available Item Specifics

Different groups of categories can support different sets of Item Specifics. For example, some Motorcycles attributes are different from Cars & Trucks attributes. A motorcycle would have an attribute like "Engine Size (cc)", and car/truck would have an attribute like "Number of Cylinders". In the API, a set of Item Specifics is called an attribute set or a characteristic set. (The semantics are explained in Summary of the Attributes Model, but for the purposes of these examples you can treat them as equivalent).

Like categories, attribute sets have IDs. In general, car and truck categories are mapped to attribute set 1137, and motorcycle categories are mapped to attribute set 1146. (There are other vehicle attribute sets as well, like Commercial Trucks.) However, you should use GetCategory2CS to determine which categories are currently mapped to each attribute set ID. Although you can retrieve the mappings for one particular category, it's usually best to retrieve all the mappings and store them locally. Example 33-3 shows a GetCategory2CS request that retrieves all the mappings, using the XML API. .

Example 33-3 GetCategory2CS Request (XML API) 
<?xml version="1.0" encoding="utf-8"?> 
<GetCategory2CSRequest xmlns="urn:ebay:apis:eBLBaseComponents"> 
  <RequesterCredentials> 
    <eBayAuthToken>YOURTOKENHERE</eBayAuthToken> 
  </RequesterCredentials> 
  <DetailLevel>ReturnAll</DetailLevel> 
</GetCategory2CSRequest>

Store the GetCategory2CS response data locally so that you can look up the right attribute set ID for the category you are listing in. Example 33-4 shows that category 6427 (Trans Am) is mapped to attribute set 1137 (Cars & Trucks).

Example 33-4 A Category in the GetCategory2CS Response (XML API) 
<Category> 
  <CategoryID>6427</CategoryID> 
   <CharacteristicsSets> 
    <Name>Cars &amp; Trucks</Name> 
    <AttributeSetID>1137</AttributeSetID> 
    <AttributeSetVersion>41357</AttributeSetVersion> 
  </CharacteristicsSets> 
</Category>

Next, you need to retrieve all the attributes, their values, and rules (collectively called attribute meta-data in this documentation) for the attribute set of interest. You can retrieve a specific attribute set, but usually it's best to retrieve all the meta-data for the site and store it locally. To retrieve all attribute sets on the eBay Motors US site, use GetAttributesCS. Example 33-5 shows a GetAttributesCS request, using the XML API.

Example 33-5 GetAttributesCS Request (XML API) 
<?xml version="1.0" encoding="utf-8"?> 
<GetAttributesCSRequest xmlns="urn:ebay:apis:eBLBaseComponents"> 
  <DetailLevel>ReturnAll</DetailLevel> 
  <RequesterCredentials> 
    <eBayAuthToken>YOURTOKENHERE</eBayAuthToken> 
  </RequesterCredentials> 
</GetAttributesCSRequest>

In this case, GetAttributesCS returns all attribute meta-data that is defined in the system for eBay Motors US. Use this meta-data to determine how to pass attributes in AddItem. However, please note that the meta-data also includes attributes that have no effect when passed in AddItem and related calls:

For Cars & Trucks, see Valid Item Specifics for Listing eBay Motors US Cars & Trucks for a table of the attributes you can pass in AddItem.

To match the attributes in the table to the GetAttributesCS response, find characteristic set 1137 (Cars & Trucks) in the GetAttributesCS response. Example 33-6 shows the outer nodes of this characteristic set. This call returns the XML as an embedded string, so the XML markup elements are escaped with character entity references. You can unescape them to work with the XML.

Example 33-6 Cars & Trucks Characteristic Set in GetAttributesCS (XML API) 
&lt;CharacteristicsSet id='1137'  order='8' &gt; 
  &lt;DomainName&gt;&lt;![CDATA[Cars &amp; Trucks]]&gt;&lt;/DomainName&gt; 
  &lt;PresentationInstruction&gt; 
... 
  &lt;/PresentationInstruction&gt; 
  &lt;CharacteristicsList&gt; 
... 
  &lt;/CharacteristicsList&gt; 
&lt;/CharacteristicsSet&gt;

Within this attribute set, look for the attributes whose IDs match the ones in the table in Valid Item Specifics for Listing eBay Motors US Cars & Trucks. For example, Example 33-7 shows attribute 10718 (Number of Cylinders) in the GetAttributesCS response.

Many attributes include a list of predefined values a seller can choose from. For example, Number of Cylinders defines values like "2- Cyl.", "8 - Cyl", etc. These values also have IDs, like 1032 (8 - Cyl.). You use these IDs when you specify a value in AddItem.

Example 33-7 Number of Cylinders Attribute in GetAttributesCS (XML API) 
&lt;Attribute IsRequired='true'  labelVisible='true'  id='10718' &gt; 
  &lt;Label&gt;&lt;![CDATA[Number of Cylinders]]&gt;&lt;/Label&gt; 
  &lt;EditType&gt;0&lt;/EditType&gt;&lt;Type&gt;&lt;![CDATA[1]]&gt;&lt;/Type&gt; 
  &lt;ValueList count='10' &gt; 
    &lt;Value id='-10' &gt; 
      &lt;Name&gt;&lt;![CDATA[-]]&gt;&lt;/Name&gt; 
    &lt;/Value&gt; 
    &lt;Value id='1026' &gt; 
      &lt;Name&gt;&lt;![CDATA[2]]&gt;&lt;/Name&gt; 
      &lt;DisplayName&gt;&lt;![CDATA[2 - Cyl.]]&gt;&lt;/DisplayName&gt; 
    &lt;/Value&gt; 
    <!-- ... more Value nodes here ... --> 
    &lt;Value id='1032' &gt; 
      &lt;Name&gt;&lt;![CDATA[8]]&gt;&lt;/Name&gt; 
      &lt;DisplayName&gt;&lt;![CDATA[8 - Cyl.]]&gt;&lt;/DisplayName&gt; 
    &lt;/Value&gt; 
    &lt;Value id='1034' &gt; 
      &lt;Name&gt;&lt;![CDATA[10]]&gt;&lt;/Name&gt; 
      &lt;DisplayName&gt;&lt;![CDATA[10 - Cyl.]]&gt;&lt;/DisplayName&gt; 
    &lt;/Value&gt; 
    &lt;Value id='1173' &gt; 
      &lt;Name&gt;&lt;![CDATA[12]]&gt;&lt;/Name&gt; 
      &lt;DisplayName&gt;&lt;![CDATA[12 - Cyl.]]&gt;&lt;/DisplayName&gt; 
    &lt;/Value&gt; 
    &lt;Value id='-12' &gt; 
      &lt;Name&gt;&lt;![CDATA[Unspecified]]&gt;&lt;/Name&gt; 
    &lt;/Value&gt; 
  &lt;/ValueList&gt; 
  &lt;ValidationRules&gt; 
    &lt;Rule&gt; 
      &lt;Name&gt;RequiredRule&lt;/Name&gt;&lt;Required/&gt; 
    &lt;/Rule&gt; 
  &lt;/ValidationRules&gt; 
&lt;/Attribute&gt;

Some value lists also define "Other" as a value. There are a few flavors of "Other". Some let you specify your own value in the listing, and others don't. (If the value ID is -6, you can specify your own literal value in AddItem.) See Other-Value ("Other") Characteristics.

Some attributes don't have predefined value lists, because the values aren't standard or they can't be predicted by eBay. (We call these free-text attributes.) Example 33-8 shows attribute 10236 (VIN) in the GetAttributesCS response. It has no value list.

Example 33-8 The VIN Attribute in the GetAttributesCS Response (XML API) 
&lt;Attribute labelVisible='true'  id='10236' &gt; 
  &lt;Label&gt;&lt;![CDATA[Vehicle Identification Number (VIN)]]&gt;&lt;/Label&gt; 
  &lt;MessageBottom&gt;&lt;![CDATA[Required for all vehicles with a model year of 1981 or later.  17 
character limit, not case sensitive.]]&gt;&lt;/MessageBottom&gt; 
  &lt;EditType&gt;0&lt;/EditType&gt; 
  &lt;Type&gt;&lt;![CDATA[2]]&gt;&lt;/Type&gt; 
  &lt;ValidationRules&gt; 
  &lt;/ValidationRules&gt; 
&lt;/Attribute&gt;

For details about all the elements in the GetAttributesCS response, see The Attribute Meta-Data Model.

Using AddItem to List a Vehicle with Item Specifics

Now that you know the available attributes, you select the ones you want to specify in the listing, and use the attribute set ID, attribute ID, and value ID(s) to fill in the AttributeSetArray node in AddItem.

Example 33-9 shows a partial AddItem request, where the Item Specifics are filled in based on the meta-data described in Using GetCategory2CS and GetAttributesCS to Retrieve Available Item Specifics. For Number of Cylinders, it shows attribute 10718 with ValueID set to 1032 (8 - Cyl.). When attribute values are predefined by eBay, you only specify their IDs in AddItem, not their literal names. For the VIN, it shows attribute 10236 with ValueID set to -3, and a VIN as free text in ValueLiteral.

Example 33-9 Number of Cylinders Attribute in an AddItem Request (XML API) 
<?xml version="1.0" encoding="utf-8"?> 
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents"> 
  <RequesterCredentials> 
    <eBayAuthToken>YOURTOKENHERE</eBayAuthToken> 
  </RequesterCredentials> 
  <Item> 
    <BuyItNowPrice currencyID="USD">10000.00</BuyItNowPrice> 
    <CategoryMappingAllowed>true</CategoryMappingAllowed> 

    <!-- more fields here ... --> 

    <PaymentDetails> 
      <HoursToDeposit>48</HoursToDeposit> 
      <DaysToFullPayment>7</DaysToFullPayment> 
    </PaymentDetails> 
    <PrimaryCategory> 
      <CategoryID>6427</CategoryID> 
    </PrimaryCategory> 
    <Quantity>1</Quantity> 
    <Site>eBayMotors</Site> 
    <StartPrice currencyID="USD">2000.00</StartPrice> 
    <Title>eBay Motors drops this title value</Title> 
    <AttributeSetArray> 
      <AttributeSet attributeSetID="1137"> 

        <Attribute attributeID="10718"> 
          <Value> 
            <ValueLiteral>8</ValueLiteral> 
            <ValueID>1032</ValueID> 
          </Value> 
        </Attribute> 
        <Attribute attributeID="10236"> 
          <Value> 
            <ValueLiteral>2V87T4N147728</ValueLiteral> 
            <ValueID>-3</ValueID> 
          </Value> 
        </Attribute> 

        <!-- more fields here ... --> 
      </AttributeSet> 
    </AttributeSetArray> 
  </Item> 
</AddItemRequest>

For a more complete AddItem sample, see "eBay Motors US Listing (Post-1981 Model Year)" on page 1070.

In several cases, eBay takes the attributes you pass in and uses them to compute additional (or alternative) attributes to display the data on the eBay Motors US Web site. GetItem may return both the original attributes and the computed attributes, or just the computed attributes. The computed attributes have different IDs, and they can't be used as input to AddItem.

Valid Item Specifics for Listing eBay Motors US Cars & Trucks

The following table specifies Cars & Trucks (formerly called Passenger Vehicles) attributes that are valid as input to AddItem (as of October 2006) and that eBay should display in a predictable way when buyers view your listing in the eBay Motors Web site UI. Use GetAttributesCS to determine valid values for each of these attributes.

Note: This list was updated in October 2006. As attributes are subject to change, this list could become outdated over time. If you believe this has occurred, please contact the Documentation team by using the Documentation forum. It is also a good idea to check the Knowledge Base for the latest FAQs about Motors listings. See Feedback and Support.

Some of the following attributes are not rendered when you use the Item Specifics SYI XSL stylesheet to create the Item Specifics form, but they may still be required. Other attributes can only be used under certain circumstances. For such attributes, the table below provides references to additional information that describes these special cases. The information in the Required column below is intended to be consistent with the requirements specified in the eBay Motors Web site UI.

Table 33-1 Cars & Trucks (1137) Attributes (eBay Motors US)
Attribute Name
Attribute ID
Required?
Usage Notes (call GetAttributesCS for valid values)
Air Bag
25842
No
No longer affects View Item when passed in via eBay Web Services; use Safety Features (25918) instead.
Cab Type
56740
Conditionally
Appears in the Item Specifics section of the View Item page.
Only applicable when a Body Type value is also specified.
Body Type
56739
No
Appears in the Item Specifics section of the View Item page.
Condition
10244
Yes
Appears in the Item Specifics section of the View Item page and in search results (depending on the user's search preferences).
Deposit Amount
10733
Conditionally
See Specifying a Vehicle Deposit and Deposit Amount for information on when to use this attribute.
Appears in Shipping, payment details and return policy section of the View Item page (not in the Item Specifics section). If specified, PayPal must be offered as the payment method for the deposit.
Deposit Type
10734
Conditionally
See Specifying a Vehicle Deposit and Deposit Amount for information on when to use this attribute.
Appears in Shipping, payment details and return policy section of the View Item page (not in the Item Specifics section). If specified, PayPal must be offered as the payment method for the deposit.
Drivetrain
25839
No
No longer affects View Item when passed in via eBay Web Services; use Options (10446) instead.
Engine Type
25846
No
Free-text string value to supplement the Number of Cylinders attribute. Use this to add more details about the engine (e.g., 2-liter).
The value is displayed in the (second) Engine field in the Item Specifics section of the View Item page.
Exterior Color
10719
Yes
Appears as Exterior field in the Item Specifics section of the View Item page.
Fuel Type
39705
No
Appears in the Item Specifics section of the View Item page.
Interior Color
10720
No
Appears as Interior field in the Item Specifics section of the View Item page.
Is There an Existing Warranty?
10242
Yes
The value (Existing or No) is displayed in a Warranty field in the Item Specifics section of the View Item page. (Value 10721 is shown as "Existing" and value 10722 is shown as "No".)
Manufacturer
39
No
In most cases, eBay pre-fills the value based on the category, so you should not pass this in. See Specifying the Vehicle Manufacturer and Model for information on when to use this attribute.
eBay uses this attribute to generate the listing title at the top of the View Item page, in the Item Specifics section, and in search results.
Mileage
85
Yes
Appears as Miles field in the Item Specifics section of the View Item page.
Appears in a separate column in search results on the eBay Motors Web site when you use a product finder search.
Model
41
Conditionally
In most cases, eBay pre-fills the value based on the category, so you should not pass this in. See Specifying the Vehicle Manufacturer and Model for information on when to use this attribute.
eBay uses this attribute to generate the listing title at the top of the View Item page, in the Item Specifics section, and in search results.
Number of Cylinders
10718
Yes
Choose from a list of predefined values. For Rotary engines, use "Unspecified" (-12) as the value. The selected value is displayed in the (first) Engine field in the View Item page, just below the Transmission attribute.
Also see the Engine Type attribute for specifying a free-text value.
Number of Doors
10240
No
Appears as the Doors field in the Item Specifics section of the View Item page. If you choose "2", it may be displayed as "2 doors or more".
No longer affects View Item when passed in via eBay Web Services; use Body Type (56739) instead.
Optional Equipment
10248
No
No longer affects View Item when passed in via eBay Web Services; use Options (10446) instead.
Options
10446
No
Appears in Options list in the Item Specifics section of the View Item page. (eBay may use a computed attribute to display the values you specify.)
Power Options
25919
No
Appears in the Options list in the Item Specifics section of the View Item page. (eBay may use a computed attribute to display the values you specify.)
Power Seat
25841
No
No longer affects View Item when passed in via eBay Web Services; see Power Options instead.
Roofs
25840
No
No longer affects View Item when passed in via eBay Web Services; use Options (10446) instead.
Safety Features
25918
No
Appears in the Options list in the Item Specifics section of the View Item page. (eBay may use a computed attribute to display the values you specify.)
Seller Guarantee
214
No
See Vehicle Condition Guarantee By Seller for information on when to use this attribute.
If a seller guarantee is offered, a special Condition Guarantee by Seller logo and informational links appear in the listing.
Standard Equipment
10247
 
No longer affects View Item when passed in via eBay Web Services; see Options (10446) instead.
Sub Model (optional)
10241
No
eBay appends this value to the computed listing title in View Item and in search results on the Web site. See Specifying the Vehicle Manufacturer and Model.
Also appears in the heading of the Item Specifics section of the View Item page.
Not appended to the generated title in GetItem.
Subtitle
10246
No
Use this to add a subtitle to the listing. See Specifying a Subtitle for a Motors Vehicle Listing for information on when to use this attribute.
Appears below the generated heading in the Item Specifics section of the View Item page, not at the top of the View Item page. Also appended to Item Title in search results on the eBay Motors Web site.
Transmission
10239
Yes
Appears in the Item Specifics section of the View Item page.
Type of Vehicle Title
10243
Yes
Appears as a Title field in the Item Specifics section of the View Item page.
Vehicle Identification Number (VIN)
10236
Conditionally
Required for vehicles from model year 1981 or later. Appears as VIN Number in the Item Specifics section of the View Item page.
eBay auto-fills attribute 26589 with a link the Vehicle History Report based on the VIN you specify in 10236. If no vehicle history report is available, eBay may auto-fill attribute 26589 with a plain-text copy of the VIN you specify in 10236. (If you pass attribute 26589 as input in production, the value is ignored.) GetItem returns the attribute you passed in and the auto-filled attribute. For attribute 26589, it returns the (escaped) HTML in the ValueLiteral element, if any.
Note: For rules that are specific to Australia eBay Motors, see Specifying the VIN and Registration Date.
Vehicle Inspection
10245
No
Appears in the Item Specifics section of the View Item page.
If you specify -13 as the value for attribute 10245, eBay auto-fills attribute 27773 to display the text "Inspected" along with a ribbon icon in the listing. GetItem returns the attribute you passed in and the auto-filled attribute. For attribute 27773, it returns the (escaped) HTML in the ValueLiteral element, if any:
&lt;font face="Arial" size="2"&gt;&lt;b&gt;Inspected&lt;img src="http://pics.ebaystatic.com/aw/pics/motors/saturn/ribbon_16x18.jpg" border="0" alt="Inspected" align="absmiddle"&gt;&lt;/b&gt;&lt;/font&gt;
Year
38
Yes
Appears in the computed listing title at the top of the View Item page and in a Year field in the Item Specifics section.
Not appended to the generated title in GetItem.
Appears in a separate column in search results on the eBay Motors Web site when you use a product finder search.

Specifying the Vehicle Manufacturer and Model

When you submit a Cars & Trucks listing to the eBay Motors US site, we strongly recommend that you avoid specifying the Manufacturer and Model attributes in most cases. In most cases, this information will be pre-filled based on the category you select.

Specifying a Subtitle for a Motors Vehicle Listing

On the eBay Motors site, the listing title is filled in automatically by eBay for certain vehicle categories (e.g., Cars & Trucks). To specify a seller's personalized title that will appear on the View Item page and that can be used to differentiate the item in search results, use the Subtitle attribute.

For Cars & Trucks, the Subtitle attribute (attribute ID 10246) is a required field. The subtitle appears in the Item Specifics section of a listing. However, it is not rendered by the Item Specifics SYI XSL stylesheet. You can render this attribute as desired within your application. In an item-listing request (e.g., using AddItem) specify the Subtitle attribute along with the other attributes that you specify with the Motors Item Specifics.

Payment Methods for Motors

Payment methods for items are defined in the BuyerPaymentMethod code list. This code list includes several methods that can be used for items on the eBay Motors US site. There are specialized payment provisions and methods for selling vehicles on the eBay Motors US site (except in the Parts and Accessories category) and on the eBay Canada site for motors.

When you list a vehicle, at least one full payment method that applies to vehicle listings is required. Specifically, one or more of the following payment methods must be used: MOCC, PersonalCheck, LoanCheck, CashInPerson, and/or PaymentSeeDescription. The LoanCheck and CashInPerson payment methods are specific to vehicle listings. Buyers cannot make full payments by credit card or PayPal.

Note: If a vehicle listing offers PayPal or a credit card, then the listing must also specify deposit attributes (because PayPal and credit cards cannot be used for full payments). See Specifying a Vehicle Deposit and Deposit Amount.

DaysToFullPayment can be used to specify the number of days after the auction closes that the buyer can take to pay for the item. The choices are 3, 7, 10, and 14, and the default is 7.

On the eBay Motors US site, a deposit can be specified. (The eBay Motors Canada site doesn't support deposits). If you specify a deposit, you can also use HoursToDeposit to specify the number of hours after an auction closes that the buyer can put down a deposit on the item. See Specifying a Vehicle Deposit and Deposit Amount.

Specifying a Vehicle Deposit and Deposit Amount

When you require a vehicle deposit, the completed listing displays an option (such as a Pay button) to enable the buyer to pay the deposit online.

Use the Deposit Amount attribute to specify the amount of a vehicle deposit (a non-zero value up to $2000.00) . Pass a value of 1 in the Deposit Type attribute's ValType.ValueLiteral element to indicate that a deposit amount was specified.

The Deposit Amount (attribute ID 10733) and Deposit Type (attribute ID 10734) attributes do not appear in the Item Specifics section of a listing, so they are not rendered by the Item Specifics SYI XSL stylesheet. You can render these attributes as desired within your application. In an item-listing request (e.g., using AddItem), specify these attributes along with other attributes that you specify with the Motors Item Specifics.

If a deposit amount is specified:

Also see Requiring Immediate Payment of a Vehicle Deposit.

When revising a vehicle listing, additional validation rules apply:

Requiring Immediate Payment of a Vehicle Deposit

When listing a vehicle on the eBay Motors US site, a seller who is eligible to offer Immediate Payment can choose to require Immediate Payment of the vehicle deposit for eligible listings. See Requirements for Using Immediate Payment with AddItem for standard eligibility requirements.

If the seller chooses to require Immediate Payment of the deposit, follow all the same rules that are described in Specifying a Vehicle Deposit and Deposit Amount, and also set AutoPay to true (to indicate that Immediate Payment is required).

Vehicle Condition Guarantee By Seller

Sellers who qualify with eBay are allowed to offer monetary guarantees when attempting to sell cars (but not motorcycles or other vehicles) on the eBay Motors US site. For general information about this program, vehicle eligibility, and seller eligibility, please see the eBay online help.

Condition Guarantee by Seller Overview
http://pages.motors.ebay.com/services/conditionguarantee.html
Frequently Asked Questions
http://pages.motors.ebay.com/services/conditionguarantee2.html
Eligibility Checklist
http://pages.motors.ebay.com/services/conditionguarantee3.html
Become a Condition Guarantee by Seller Program member
http://pages.motors.ebay.com/services/best-building.html

When you retrieve category data using GetCategories, the Category.SellerGuaranteeEligible flag returns true for each category that supports this feature.

To determine the maximum level of guarantee the seller is authorized to offer, retrieve the seller's user details by using GetUser and examine the User.SellerInfo.SellerGuaranteeLevel property.

When listing, revising, or relisting an item, use the Seller Guarantee attribute to specify a particular guarantee level that they are willing to offer (see Valid Item Specifics for Listing eBay Motors US Cars & Trucks). This attribute is also returned in listing's Item Specifics when you use GetItem.

On the eBay Motors US site, when you use GetItem, the Seller Guarantee attribute (214) is returned with a value that describes the the seller guarantee. Other sites that support this feature and that use Item Specifics for vehicles return similar information. Use GetAttributesCS to determine the applicable attribute and value IDs.

Short-Term Service Agreement (Limited Warranty)

For certain vehicles, eBay offers a free 1 month/1,000 mile Short-Term Service Agreement (also referred to as a limited warranty). Only vehicles that are not disqualified as having certain modifications and that are not classified as special vehicle types (e.g., Corvette ZR1) are eligible for this limited warranty.

When listing a Motors vehicle, your application must provide the seller with an opportunity to indicate whether the vehicle has not been modified and is not a special type:

For a complete list of vehicle modifications and special vehicle types that are not eligible for the limited warranty, see the eBay Motors site:

Short Term Service Agreement Coverage Plan Details
http://pages.motors.ebay.com/help/buyandsell/lw_details.html

Present the following options to the seller as part of the listing process. If you present the options as radio buttons, use this text (where the parentheses "(  )" represent radio buttons):

Please check one of the following:

(X) The vehicle listed has no modifications and is not a special vehicle type.

(   ) The vehicle listed has been modified and/or is a special vehicle type.

In listing requests, use the LimitedWarrantyEligible flag to indicate the seller's selection. If LimitedWarrantyEligible is passed in, it means your application has presented the seller with options to indicate this information. If the value is true, the seller has verified that the vehicle has not been modified and is not a special type. If false, the seller has verified that vehicle has been modified or it is a special type.

Passing a value of true does not guarantee that eBay will offer a limited warranty. It only makes the listing eligible for consideration.

On the eBay Motors US site, when you use GetItem, the Limited Warranty attribute (26738) is returned with a value of -14 (No) if the limited warranty is not available, or -13 (Yes) if it is available. Other sites that support this feature and that use Item Specifics for vehicles return similar information. Use GetAttributesCS to determine the applicable attribute and value IDs.

Vehicle Purchase Protection

In addition to the Short-Term Service Agreement, eBay also offers Vehicle Purchase Protection, which ensures that you receive the vehicle you paid for, with coverage up to $20,000 against fraud or material misrepresentation.

For information about vehicle categories that support Vehicle Purchase Protection, please refer to the following help pages:

Vehicle Purchase Protection (US)
http://pages.motors.ebay.com/services/purchase-protection.html
Passenger Vehicle Purchase Protection (CA)
http://pages.ebay.ca/ebaymotors/help/education/buying/purchase-protection.html

On the eBay Motors US site, when you use GetItem, the Purchase Protection attribute (213) is returned with a value of 31492 (false) if no Vehicle Purchase Protection is available, or 31493 (true) if it is available. Other sites that support this feature and that use Item Specifics for vehicles return similar information. Use GetAttributesCS to determine the applicable attribute and value IDs.

Listing eBay Motors US Items in eBay Stores

Items that an eBay Stores seller lists to the eBay Motors US site (site ID of eBayMotors) also appear in the seller's eBay Store.

eBay Motors items within the Parts & Accessories and the Everything Else categories can be listed in Chinese Auction, Store Inventory, or Basic Fixed-Price formats. eBay Motors items within vehicle categories can be listed in Chinese Auction, or Fixed Price formats, but cannot be listed in the eBay Store Inventory format.

Revising US Motors Listings

See Revising US eBay Motors Listings.

Also see Revising and Relisting Local Market Listings.




User-Contributed Notes

   
 
 
 



 
Specialty and International Sites > eBay Motors > Listing US and CA eBay Motors Items 
http://developer.ebay.com/DevZone/XML/docs/WebHelp/eBayMotors-Listing_US_and_CA_eBay_Motors_Items.html
© 2004–2010 eBay Inc. All rights reserved. Version 659