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
| 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.
| 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:
| 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 |
| 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.
| 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:
| 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:
| 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:
| 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:
| 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 |
| 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:
| 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 | If |
|
ebay_VAT_details_restricted_to_business | If If Only to business sellers in Germany, Austria, or Switzerland who are listing in a B2B VAT-enabled category. | If |
|
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
| 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 | https://www...... |
|
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.
