You are here: Inventory managment > Feed definitions > Distribution feed definitions

Distribution feed definitions

This topic provides definitions for the fields in the distribution feed.

The distribution feed is a subset of the product feed.

Links to CSV, XML, and XSD feed and response sample files are located on the Sample feed and response files page in this manual.

If you require category-specific data in your product, distribution and/or combined feeds, eBay provides an Item Specifics Lookup Tool that you can use to look up category IDs and retrieve item specifics metadata for your category selection.

CSV field name

XML field name

Example Values

Config-Spec Field name

Description

Data type

Use

SKU

SKU

N/A

DISTRIBUTION.SKU

Stock Keeping Unit. An SKU must be unique across your entire inventory.

string

Required

Channel ID

channelID

EBAY_AU
EBAY_AT
EBAY_BE_FR
EBAY_BE_NL
EBAY_CA
EBAY_CH
EBAY_DE
EBAY_ES
EBAY_FR
EBAY_HK
EBAY_IN
EBAY_IT
EBAY_MY
EBAY_NL
EBAY_PH
EBAY_PL
EBAY_RU
EBAY_UK
EBAY_US
EBAY_Motors

DISTRIBUTION.createChannelDetails(channelID).ChannelID

The unique identifier of the sales channel, such as  EBAY_USEBAY_UK , or EBAY_DE.

You can list the same item/SKU on multiple eBay sites / channels by copying the item to another line in the feed file and changing the channelID. For example:

SKU      ChannelID
CAM1    EBAY_US
CAM1    EBAY_UK
CAM1    EBAY_AU

string

Conditional

(If you are selling on only one channel, leave this empty and MIP will automatically populate the default channel)

Category

Category

N/A

DISTRIBUTION.createChannelDetails(channelID).Category

Identification number of the eBay category. See Category Lookup Tool under Tools and Sandboxes at the top of this page.

integer

Required

Shipping Policy

Shipping Policy

shippingPolicyName (1)

N/A

DISTRIBUTION.createChannelDetails(channelID).ShippingPolicyName

 

string

Required

Payment Policy

Payment Policy

paymentPolicyName (1)

N/A

DISTRIBUTION.createChannelDetails(channelID).PaymentPolicyName

Unique identifier of a payment business policy. If used, the values in the referenced payment business policy will only be used for the specified product and will not affect the default payment business policy used for other products.

Business policy IDs can be obtained in your eBay account preferences.

string

Required

Return Policy

Return Policy

returnPolicyName (1)

N/A

DISTRIBUTION.createChannelDetails(channelID).ReturnPolicyName

Unique identifier of a return business policy. If used, the values in the referenced return business policy will only be used for the specified product and won’t affect the default return business policy used for other products.

Business policy IDs can be obtained in your eBay account preferences.

string

Required

List Price

List Price

N/A

DISTRIBUTION.createChannelDetails(channelID).ListPrice

To add and update the list price for the specified product across listings.

decimal

Required

Max Quantity Per Buyer

Max Quantity Per Buyer

N/A

DISTRIBUTION.createChannelDetails.(channelID).MaxQuantityPerBuyer

The maximum quantity of a product that one buyer can purchase in a 10-day period.

integer

Optional

Strike Through Price

Strikethrough Price

N/A

DISTRIBUTION.createChannelDetails.(channelID).OriginalRetailPrice

The original price of the product before the product was discounted. The new price is shown in the List Price field.

On the View Item page, the strikeThroughPrice value will have a line through it to help emphasize the amount of the discount to prospective buyers.

decimal

Optional

Minimum Advertised Price

Minimum Advertised Price

N/A

DISTRIBUTION.createChannelDetails
(channelID).MinimumAdvertisedPrice

The Minimum Advertised Price (MAP) is an agreement between suppliers (or OEMs) and retailers stipulating the lowest price a product is allowed to be advertised. You can offer prices below the MAP through other discounts. The value specified in this field won’t affect other products in multi-variation listings.

decimal

Optional

Minimum Advertised Price Handling

Minimum Advertised Price Handling

PRE_CHECKOUT

Shows the discounted MAP price if the buyer clicks a link (or a button) on the View Item page to display the discounted MAP price in a pop-up window.

 

DURING_CHECKOUT

Shows the discounted MAP price when the buyer commits to buy the product, but not before.

 

NONE

The discounted MAP price isn’t shown to the buyer during the checkout flow.

DISTRIBUTION.createChannelDetails(channelID).
MinimumAdvertisedPriceExposure

Set if using the Minimum Advertised Price feature. It controls the display of the discounted MAP price ( List Price  value) during the checkout flow.

string

Conditional

(Required when using Minimum Advertised Price)

Store Category 1

Store Category Name 1

storeCategory1Name (1)

N/A

DISTRIBUTION.createChannelDetails(channelID).

StoreCategory1

eBay store category.

string

Optional

Store Category 2

Store Category Name 2

storeCategory2Name (1)

N/A

DISTRIBUTION.createChan

nelDetails

(channelID).StoreCategory2

eBay store category.

string

Optional

Sold Off Ebay

Sold Off Ebay

N/A

DISTRIBUTION.createChannelDetails(channelID).SoldOffEbay

Indicates that you offered the same (or similar) product for the same sale price (listPrice value) on a Web site or offline store other than eBay in the previous 30 days.

boolean

Optional

Sold On Ebay

Sold On Ebay

N/A

DISTRIBUTION.createChannelDetails(channelID).SoldOnEbay

Indicates you offered the same (or similar) product for the same sale price (listPrice value) on an eBay site in the previous 30 days.

This field is only applicable for products selling on the eBay UK and eBay Germany (DE) sites. If this field is included and set to True, eBay displays Was* in the UK, and Ursprunglich* in Germany, next to the discounted price of the item.

If the SoldOffeBay and soldOneBay fields are both set, soldOneBaytakes precedence.

boolean

Optional

Apply Tax

Apply Tax

N/A

DISTRIBUTION.createChannelDetails(channelID).ApplyTax

The sales tax that applied if sales tax is set up in your account preferences. To override the sales tax settings for the product, include a boolean value of false.

boolean

Optional

Tax Category

Tax Category

N/A

DISTRIBUTION.createChannelDetails(channelID).TaxCategory

Tax exception category code. This is to be used only by sellers who have opted into sales tax being calculated by a sales tax calculation vendor like Vertex.

string

Optional

VATPercent

VAT Percent

N/A

DISTRIBUTION.createChannelDetails(channelID).VATPercent

Value Added Tax percentage of the sale price. For EU only.

percentage

Optional

Shipping Cost Overrides

US Shipping P1-P4 Cost

US Shipping P1-P4 Additional Cost

US Shipping P1-P4 Surcharge

 

International Shipping P1-P5 Cost

International Shipping P1-P5 Additional Cost

International Shipping P1-P5 Surcharge

N/A

DISTRIBUTION.createChannelDetails(channelID).PolicyOverride

Overrides the flat-rate shipping costs for all US and/or all international shipping services currently defined for the product in a shipping business policy, either defined at the listing level or referenced through the shipping policy name. Shipping costs include the cost to ship one item, the cost to ship each additional identical item, and any shipping surcharges applicable to US shipping services.

You can set up to four shipping options in your own country and up to five shipping options to ship to other countries.

To remove a shipping cost override, delete it from the distribution feed, and then upload the feed.

decimal, integer, string

Optional

TemplateName

DescriptionTemplate.html

 

TemplateName

Description templates are optional user-created HTML files that set up the look and feel of their product listings on the eBay site. They contain layout, font, and color information, and can use CSS files to define the parameters. Description templates are generally created by experienced eBay sellers users who want custom layouts for their products or store.

string

Conditional

CustomFields

descriptionTitle=Great new product|Features=ceramic, drilled and slotted|Shipping=free

 

CustomFields

Custom fields allow sellers to specify data elements that are not part of the product definition but can be referred in the template when generating a description.

string

Conditional

Note: 1. This name is backwards compatible with old MIP column