Skip to main content

Attributes

Ebay requires a lsit of attributes that are mandatory (please see column M for mandatory). Besides images and other content such as descriptions, the following attributes can be used.

Please see the article Group_item_specifics_custom for specific attributes, describing the article with more values than just one.

Field Name

Comment

Meaning

M

ebay_best_offer_enabled

Accepted values: true or false

Not possible for variants

Allow you to list products under Make an offer option

ebay_discount_made_for_outlet_comparison



Applicable only if the item was specifically made for sale through dedicated eBay outlet pages (e.g., eBay Fashion Outlet).

ebay_discount_minimum_advertised_price


An agreement between suppliers and the retailers stipulating the lowest price an item is allowed to be advertised at.

ebay_discount_minimum_advertised_price_exposure

Applicable values are DuringCheckout, None, PreCheckout

For MinimumAdvertisedPrice (MAP) listings only.

ebay_discount_original_retail_price



The actual retail price set by the manufacturer (OEM).

ebay_discount_sold_off_ebay

Used by the eBay UK and eBay Germany (DE) sites

Always in reference to the seller's own price.

Indicates that the discount price (specified as StartPrice) is the price for which the seller offered the same (or similar) item for sale on a Web site or offline store other than eBay in the previous 30 days.

ebay_discount_sold_on_ebay

Used by the eBay UK and eBay Germany (DE) sites

Always in reference to the seller's own price.

Indicates that the discount price (specified as StartPrice) is the price for which the seller offered the same (or similar) item for sale on eBay within the previous 30 days.

ebay_dispatch_time_max



Maximum number of business days for preparing an item to be shipped after receiving a cleared payment. Does not include the shipping time.

ebay_free_shipping

Applies only to the first specified domestic shipping service and is ignored if set for any other shipping service.

Specifies that the seller wants to offer free shipping.

ebay_item_best_offer_auto_accept_price

If a buyer submits a Best Offer that is above this value, the offer is automatically accepted by the seller.

This applies only to items listed in categories that support the BestOfferAutoAcceptPrice feature.

The price at which Best Offers are automatically accepted.

ebay_item_brand



Brand / Manufacturer

ebay_item_buy_it_now_price

Only for Auctions; not handled by the connector

ebay_item_condition

Use the Value Mapping to avoid mistakes

  • Current Mapping for eBay DE

The article's condition (New, ...)

ebay_item_condition_description



Used to more clearly describe the condition of items that are not brand new.

ebay_item_description



The article's description

ebay_item_duration

The Connector always chooses the highest possible duration allowed in the Category where the Article is listed.

ebay_item_ean_isbn_upc

The right Identifier will be defined by the connector

Product Identifier supplied (EAN, ISBN, UPC)

ebay_item_location

Free Text

Indicates the geographical location of the item (Tthe Country field is already filled automatically!!!)

ebay_item_minimum_best_offer_price

If a buyer submits a Best Offer that is below this value, the offer is automatically declined by the seller.

This applies only to items listed in categories that support the BestOfferAutoDecline feature.

Specifies the minimum acceptable Best Offer price

ebay_item_mpn



Manufacturer Part Number

ebay_item_payment_method

1 or more allowed.

See here for valid values or use the Value Mapping function.

  • Current Mapping for eBay DE

A list of payment methods that the seller will accept when the buyer pays for the item.

ebay_item_picture_url



Contains the URL for a picture of the item.

ebay_item_picture_url_extra_[1...11]



Additional picture URLs of the item.

ebay_item_quantity



The Stock

To ensure that the stock updates are going through correctly, even though a product has a stock of 0, the seller needs to enable „Angebote bleiben aktiv, wenn der Artikel nicht mehr vorrätig ist.“ under “Verkäufereinstellungen”

x

ebay_item_sku



The Customer Article ID

ebay_item_start_price



The article's price (minimum price is 1€)

x

ebay_item_subtitle

You cannot use HTML in the Subtitle.

Subtitle to use in addition to the title. Make sure to leave it empty if you do not want to use it since ebay will charge you for this.

ebay_item_title



The article's title

x

ebay_listing_duration

Duration of the listing

Always set GTC

x

ebay_listing_type

This is automatically handled by the connector

Always set FixedPriceItem.

x

ebay_return_accepted_option

See here for valid values or use the Value Mapping function.

Indicates whether the seller allows the buyer to return the item.

ebay_return_policy_description

eBay uses this text string as-is in the Return Policy section of the View Item page:

  • Avoid HTML, and acharacter entity references

  • Use the literal UTF-8 or ISO-8559-1 character (e.g. £) for special characters

A detailed explanation of the seller's return policy.

ebay_return_refund_option

See here for valid values or use the Value Mapping function.

Indicates how the seller will compensate the buyer for a returned item.

ebay_return_shipping_costs_option

See here for valid values or use the Value Mapping function.

Set this (if ebay_return_accepted_option=ReturnsAccepted) to avoid the site to set it to a Default value, which could be Buyer!

The party who pays the shipping cost for a returned item.

ebay_return_within_option

Required if ebay_return_accepted_option=ReturnsAccepted.

See here for valid values or use the Value Mapping function.

The buyer can return the item within this period of time from the day they receive the item.

ebay_seller_payment_profile

The connector works with the PaymentProfileID

The unique identifier of a Business Policies payment profile.

ebay_seller_return_profile

The connector works with the ReturnProfileID

The unique identifier of a Business Policies return policy profile

ebay_seller_shipping_profile

The connector works with the ShippingProfileID

The unique identifier of a Business Policies shipping policy profile

ebay_shipping_additional_cost



The cost to ship each additional item if the buyer purchases multiple quantity of the same line item.

ebay_shipping_cost



The base cost of shipping the item using the value specified in ebay_shipping_service.

ebay_shipping_details_irregular

For calculated shipping only.

Whether a package is irregular and therefore cannot go through the stamping machine at the shipping service office and thus requires special or fragile handling.

ebay_shipping_details_package

for calculated shipping only.

See here for valid values.

The nature of the package used to ship the item(s).

ebay_shipping_details_package_depth

For calculated shipping only.

Depth of the package, in whole number of inches, needed to ship the item.

ebay_shipping_details_package_length

For calculated shipping only.

Length of the package, in whole number of inches, needed to ship the item.

ebay_shipping_details_package_width

For calculated shipping only.

Width of the package, in whole number of inches, needed to ship the item.

ebay_shipping_details_weight_major



With , ebay_shipping_details_weight_minor used to specify the weight of a shipping package.

ebay_shipping_details_weight_minor



With ebay_shipping_details_weight_major, used to specify the weight of a shipping package.

ebay_shipping_insurance_fee

If the buyer bought more than one of this item, this is the insurance for just a single item.

Cost of shipping insurance set by the seller.

ebay_shipping_insurance_option

  • Valid only on the following sites: AU, FR, and IT

  • Aplicable values are:

    • IncludedInShippingHandling

    • NotOffered

    • Optional

    • Required

Whether the seller offers shipping insurance and, if so, whether the insurance is optional or required.

ebay_shipping_service

1 or more allowed.

Use the Value Mapping function, as this is site (country) dependant.

  • Current Mapping for eBay DE

  • Current Mapping for eBay UK

The shipping service used to ship the item to a buyer.

ebay_store_category2_id

eBay resets the value to 0 (None) in the following cases:

  • StoreCategoryID = StoreCategory2ID

  • StoreCategory2ID specified but no StoreCategoryID

Identifier of a secondary custom category in which to list the item.

ebay_store_category2_name

eBay resets the value to 0 (None) in the following cases:

  • StoreCategoryName = StoreCategory2Name

  • StoreCategory2Name w/o StoreCategoryName

Name of the secondary custom category in which to list the item.

ebay_store_category_id

A category that the seller created in his eBay Store

Identifier of a custom primary category in which to list the item.

ebay_store_category_name

A category that the seller created in his eBay Store

Name of a primary custom category in which to list the item.

ebay_store_category2_id

eBay resets the value to 0 (None) in the following cases:

  • StoreCategoryID = StoreCategory2ID

  • StoreCategory2ID specified but no StoreCategoryID

Identifier of a secondary custom category in which to list the item.

ebay_store_category2_name

eBay resets the value to 0 (None) in the following cases:

  • StoreCategoryName = StoreCategory2Name

  • StoreCategory2Name w/o StoreCategoryName

Name of the secondary custom category in which to list the item.

ebay_item_subtitle

You cannot use HTML in the Subtitle.

Subtitle to use in addition to the title.

ebay_item_best_offer_auto_accept_price

If a buyer submits a Best Offer that is above this value, the offer is automatically accepted by the seller.

This applies only to items listed in categories that support the BestOfferAutoAcceptPrice feature.

The price at which Best Offers are automatically accepted.

ebay_item_minimum_best_offer_price

If a buyer submits a Best Offer that is below this value, the offer is automatically declined by the seller.

This applies only to items listed in categories that support the BestOfferAutoDecline feature.

Specifies the minimum acceptable Best Offer price

ebay_item_condition_description



Used to more clearly describe the condition of items that are not brand new.

ebay_free_shipping

Applies only to the first specified domestic shipping service and is ignored if set for any other shipping service.

Specifies that the seller wants to offer free shipping.

ebay_shipping_insurance_fee

If the buyer bought more than one of this item, this is the insurance for just a single item.

Cost of shipping insurance set by the seller.

ebay_shipping_insurance_option

  • Valid only on the following sites: AU, FR, and IT

  • Aplicable values are:

    • IncludedInShippingHandling

    • NotOffered

    • Optional

    • Required

Whether the seller offers shipping insurance and, if so, whether the insurance is optional or required.

ebay_return_policy_description

eBay uses this text string as-is in the Return Policy section of the View Item page:

  • Avoid HTML, and acharacter entity references

  • Use the literal UTF-8 or ISO-8559-1 character (e.g. £) for special characters

A detailed explanation of the seller's return policy.

ebay_return_refund_option

See here for valid values or use the Value Mapping function.

Indicates how the seller will compensate the buyer for a returned item.

ebay_warranty_duration_option

See here for valid values or use the Value Mapping function.

The warranty period.

ebay_warranty_offered_option

See here for valid values or use the Value Mapping function.

Indicates whether a warranty is offered for the item.

ebay_warranty_type_option

Only the eBay India site supports this field.

See here for valid values or use the Value Mapping function.

Indicates the source or type of the warranty, if any.

ebay_discount_made_for_outlet_comparison



Applicable only if the item was specifically made for sale through dedicated eBay outlet pages (e.g., eBay Fashion Outlet).

ebay_discount_minimum_advertised_price


An agreement between suppliers and the retailers stipulating the lowest price an item is allowed to be advertised at.

ebay_discount_minimum_advertised_price_exposure

Applicable values are DuringCheckout, None, PreCheckout

For MinimumAdvertisedPrice (MAP) listings only.

ebay_discount_original_retail_price



The actual retail price set by the manufacturer (OEM).

ebay_discount_sold_off_ebay

Used by the eBay UK and eBay Germany (DE) sites

Always in reference to the seller's own price.

Indicates that the discount price (specified as StartPrice) is the price for which the seller offered the same (or similar) item for sale on a Web site or offline store other than eBay in the previous 30 days.

ebay_discount_sold_on_ebay

Used by the eBay UK and eBay Germany (DE) sites

Always in reference to the seller's own price.

Indicates that the discount price (specified as StartPrice) is the price for which the seller offered the same (or similar) item for sale on eBay within the previous 30 days.

ebay_shipping_details_measurement_unit

Applicable values are English, Metric

Specifies the unit type of the weight and dimensions of a shipping package.

ebay_shipping_details_package_depth

For calculated shipping only.

Depth of the package, in whole number of inches, needed to ship the item.

ebay_shipping_details_package_length

For calculated shipping only.

Length of the package, in whole number of inches, needed to ship the item.

ebay_shipping_details_package_width

For calculated shipping only.

Width of the package, in whole number of inches, needed to ship the item.

ebay_shipping_details_irregular

For calculated shipping only.

Whether a package is irregular and therefore cannot go through the stamping machine at the shipping service office and thus requires special or fragile handling.

ebay_shipping_details_package

for calculated shipping only.

See here for valid values.

The nature of the package used to ship the item(s).

ebay_shipping_details_weight_major



With , ebay_shipping_details_weight_minor used to specify the weight of a shipping package.

ebay_shipping_details_weight_minor



With ebay_shipping_details_weight_major, used to specify the weight of a shipping package.

ebay_VAT_details_business_seller

Only to business sellers in Germany, Austria, or Switzerland who are listing in a B2B VAT-enabled category.

Must be set to true if ebay_VAT_details_restricted_to_business = true.

If true, this indicates that the seller is a business user and intends to use listing features that are offered to business users only.

ebay_VAT_details_restricted_to_business

If false (or not returned), this indicates that the seller elects to offer the item to all users.

If true, the seller must have a valid VAT-ID registered with eBay, and ebay_VAT_details_business_seller must also be true.

Only to business sellers in Germany, Austria, or Switzerland who are listing in a B2B VAT-enabled category.

If true, this indicates that the seller elects to offer the item exclusively to business users.

ebay_VAT_details_VAT_percent

To specify a VATPercent, a seller must have a VAT-ID registered with eBay and must be listing the item on a VAT-enabled site.

VAT (Value Add Tax) rate for the item, if any.

ebay_VIN

Applicable to listings in

  • US eBay Motors Cars and Trucks (6001), Motorcycles (6024), Commercial Trucks (63732), RVs and Campers (50054), ATVs (6723), Snowmobiles (42595), and UTVs (173665)

  • Cars and Trucks listings in CA, CAFR and AU eBay Motors.

Displays the Vehicle Identification Number, which is a unique serial number for a motor vehicle.

ebay_VRM



Applicable to listings in UK eBay Motors Cars and Trucks, Motorcycle, and some Powersport categories.

Vehicle Registration Mark, which is a unique identifier for a motor vehicle in the UK.

ebay_use_tax_table

Applicable to listings in eBay US. Set to "true" if we want to manage Taxes. Customer must fill that Sales TRAx Table on eBay going to "Site Preferences>Selling Preferences>Payment from Buyers (at bottom)".

How to manage Taxes from Channel Pilot

ebay_best_offer_enabled

Accepted values: true or false

Not possible for variants

Allow you to list products under Make an offer option

IncludeeBayProductDetails


Accepted values true or false,

Not possible for variants

If the EAN is already known to ebay, they will include possible data from their databse to enrichen the content

Product safety

With the entry into force of the General Product Safety Regulation (GPSR) 2023/988, the marketplace will require additional mandatory attributes as of December 13.

These can be added in the basic setting area using the Add field button.

The following attributes must be provided as follows:

Manufacturer.CityName

Manufacturer.CompanyName

Manufacturer.Country

Manufacturer.Email

Manufacturer.Phone

Manufacturer.Postalcode

Manufacturer.StateOrProvince

Manufacturer.Street1

Manufacturer.Street2

ResponsiblePerson.1.CityName

ResponsiblePerson.1.CompanyName

ResponsiblePerson.1.Country

ResponsiblePerson.1.Email

ResponsiblePerson.1.Phone

ResponsiblePerson.1.PostalCode

ResponsiblePerson.1.StateOrProvince

ResponsiblePerson.1.Street1

ResponsiblePerson.1.Street2

Regulatory Documents

Ebay offers the option of uploading regulatory documents. The document will be displayed on the product page once it has been successfully uploaded.

Please note that the maximum document size is 10MB and it must be a PDF. Anything else cannot be processed.

To ensure a successful upload, the following attributes must be transferred:

Attribut

Beschreibung

Beispiel

Value-Mapping

Regulatory.Document.1.URL

Link to the document

Regulatory.Document.1.Languages

Language of document

GERMAN

Regulatory.Document.1.Type

Type of document

OTHER_SAFETY_DOCUMENTS, INSTRUCTIONS FOR USE

x

The current status of uploads can be seen in the Show documents section.

Did this answer your question?