Skip to main content

Market listing

Syncs of the type Market listing allow you to import listing data into plentymarkets. Go to Data » Import to create a new sync.

1. Fields for matching market listings

The matching field Market listing ID is available for matching item data.

2. Fields for mapping market listings

This chapter explains the fields that are available for mapping market listings.

2.1. Listing

Table 1 lists the fields that are available for importing listings. During the import, plentymarkets checks if the imported data record already exists based on the matching field.

Table 1. Mapping fields for importing listings
Mapping field Permitted import values Explanation

Listing type ID

1
2
3

The listing type ID.

  • 1 = auction

  • 2 = fixed price

  • 3 = shop item

Stock dependence ID

0
1
2
3

The stock dependence ID.

  • 0 = unlimited (with synchronisation)

  • 1 = limited (with reservation)

  • 2 = limited (without reservation)

  • 3 = unlimited (without synchronisation)

Content ID

Numeric

The listing’s content ID.

2.2. Listing property

Table 2 lists the fields that are available for importing listing properties. Select a value for the listing property from the drop-down list that appears when you select the mapping field Value.

During the import, plentymarkets checks if the imported data record already exists based on the matching field.

Table 2. Mapping fields for importing listing properties
Value Permitted import values Explanation

Tie to item price

Y
N

  • Y = Tie fixed price to item

  • N = Use price from the listing settings

Number per lot

Numeric

Transfer as item number

none
EAN
ISBN
MPN
EPID
GTIN
UPC
no-name

Transfer of the item number type.

  • none

  • EAN = EAN

  • ISBN = ISBN

  • MPN = manufacturer number

  • EPID = eBay product ID

  • GTIN = GTIN

  • UPC = UPC

  • no-name = custom-made item or no-name product

2.3. Market listing

Table 3 lists the fields that are available for importing market listings. During the import, plentymarkets checks if the imported data record already exists based on the matching field.

Table 3. Mapping fields for importing market listings
Mapping field Permitted import values Explanation

Platform ID

eBay:
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022

Hood:

3001

Ricardo:

2001

The ID of the platform.

eBay:

  • 1001 = US,

  • 1002 = CA,

  • 1003 = UK,

  • 1004 = AU,

  • 1005 = AT,

  • 1006 = BEFR,

  • 1007 = FR,

  • 1008 = DE,

  • 1009 = MOTOR,

  • 1010 = IT,

  • 1011 = BENL,

  • 1012 = NL,

  • 1013 = ES,

  • 1014 = CH,

  • 1015 = HK,

  • 1016 = IN,

  • 1017 = IE,

  • 1018 = MY,

  • 1019 = CAFR,

  • 1020 = PH,

  • 1021 = PL,

  • 1022 = SG

Hood:

  • 3001 = hood.de

Ricardo:

  • 2001 = ricardo.ch

Account ID

Numeric

The ID of your eBay account.

Directory ID

Numeric

The ID of the directory.

Active

Y
N

Indicates whether the listing is active.

  • Y = Active

  • N = Not active

Duration

Numeric

Duration in days or GTC.

Maximum quantity for sale

Numeric

The maximum number of items to be sold on the market.

List with all variations

Y
N

Important: This value may only be activated for items with variations.

  • Y = Yes

  • N = No

Delete

0
1

Delete listing.

  • 0 = Do not delete listing ID for the corresponding market

  • 1 = Delete listing ID for the corresponding market

2.4. Market listing property

Table 4 lists the fields that are available for importing market listing properties. During the import, plentymarkets checks if the imported data record already exists based on the matching field.

Table 4. Mapping fields for importing market listing properties
Mapping field Permitted import values Explanation

Name

Alphanumeric

eBay properties/name

Value

Alphanumeric

eBay properties/values

Delete

1
0

Delete eBay property.

  • 1 = Delete eBay property

  • 0 = Do not delete eBay property

2.5. Market listing text

Table 5 lists the fields that are available for importing market listing texts. During the import, plentymarkets checks if the imported data record already exists based on the matching field.

Table 5. Mapping fields for importing market listing texts
Mapping field Permitted import values Explanation

Title

Alphanumeric

The market listing’s title.

Subtitle

Alphanumeric

The market listing’s subtitle.

Description

Alphanumeric

The market listing’s description text.

2.6. Market listing property

Table 4 lists the fields that are available for importing market listing properties. Select a value for the market listing property from the drop-down list that appears when you select the mapping field Value.

During the import, plentymarkets checks if the imported data record already exists based on the matching field.

Table 6. Mapping fields for importing market listing properties
Value Permitted import values Explanation

Shipping profile ID

Numeric

The ID of the shipping profile.

Order status

Numeric

The order status ID.

Layout template ID

Numeric

The ID of the layout template.

Maximum number of images

Numeric, 1-12

The maximum number of images.

Warehouse ID

Numeric

The warehouse ID.

Add unit price specification

YES
NO
TITLE_START
TITLE_END
SUBTITLE

  • YES = Add unit price specification

  • NO = Unit price is not specified

  • TITLE_START = Unit price at the beginning of the title

  • TITLE_END = Unit price at the end of the title

  • SUBTITLE = Unit price in the subtitle

VAT rate

Numeric

The VAT rate.

VAT country ID

Numeric

The country ID.

Language

de
en
etc.

  • de = German

  • en = English
    etc.

Number per lot

Numeric

The quantity of items offered in a single listing.

Layout template ID

Numeric

The ID of the layout template.

Transfer as item number

none
EAN
ISBN
MPN
EPID
GTIN
UPC
no-name

Transfer of the item number type.

  • none = none

  • EAN = EAN

  • ISBN = ISBN

  • MPN = manufacturer number

  • EPID = eBay product ID

  • GTIN = GTIN

  • UPC = UPC

  • no-name =Custom-made item or no-name product

Relisted external listing ID

Numeric

Offer number of the restarted listing.

Second Chance Offer

Y
N
Created

Indicates whether a second chance offer is available.

  • Y = Yes

  • N = No

  • Created = Created

Promotion

Y
N

Indicates whether a special sale is available.

  • Y = Special sale is available

  • N = No special sale is available

UUID

Numeric

Identification number

Listing faulty

Y
N

  • Y = An error occurred while updating the listing

  • N = No error occurred

List with all variations

Y
N

Indicates whether variations are listed.

  • Y = Listing with variations

  • N = Listing without variations

Created by

start
import
sync
order

Indicates how the listing was created in plentymarkets.

  • start = Start listing

  • import = Import active listing

  • sync = Synchronisation between eBay and plentymarkets

  • order = Order

Payment methods

ricardo payment methods:
0
8192
262144
1073741824

Hood payment methods:
cash
cashOnDelivery
payPal
moneyBookers
moneyBookersEscrow
seeDescription
escrow
wireTransfer
invoice
Sofortueberweisung
BillSAFE

ricardo payment methods:

  • 0 = Other

  • 8192 = Wire transfer via bank / post

  • 262144 = Credit card / PostFinance card

  • 1073741824 = Cash payment

Hood payment methods:

  • cash = Cash payment upon pickup

  • cashOnDelivery = Cash on delivery

  • payPal = PayPal

  • moneyBookers = Skrill

  • moneyBookersEscrow = Skrill Escrow

  • seeDescription = Other - see item description

  • escrow = Escrow

  • wireTransfer = Cash in advance via bank transfer

  • invoice = Invoice

  • Sofortueberweisung = Sofortüberweisung

  • BillSAFE = BillSAFE

Category ID 1

Numeric

Category ID 2

Numeric

Shop category ID 1

Numeric

Shop category ID 2

Numeric

Shop category ID 3

Numeric

Additional options

Additional options for eBay:
ProPackPlusBundle
ValuePackBundle

Additional options for Hood:
auctionNameSubTitle
featureBoldTitle
featureBackGroundColor
featureGallery
featureCategory
featureHomePage
featureHomePageImage
featureNoAds
featureXXLImage

Additional options for eBay and Hood.
Separate multiple options with commas.

Additional options for eBay:

  • ProPackPlusBundle = Feature pack

  • ValuePackBundle = Value pack bundle

Additional options for Hood:

  • auctionNameSubTitle = Subtitle

  • featureBoldTitle = Bold font in item lists

  • featureBackGroundColor = Background colour in item lists

  • featureGallery = Premium gallery in item lists

  • featureCategory = Featured plus

  • featureHomePage = Home page feature

  • featureHomePageImage = Home page feature with an image

  • featureNoAds = Do not display advertisements

  • featureXXLImage = Supersize picture

Parts compatibility listing ID

Numeric

The parts compatibility listing ID for eBay.

eBay market listings active at the same time

0
1-8

The maximum number of active listings.

  • 0 = Endless lister deactivated

  • 1-8 = Activated, number

eBay private auction

Y
N

Indicates whether it is an eBay private auction.

  • Y = Yes

  • N = No

eBay gallery image

none
featured
gallery
plus

The eBay gallery type.

  • none = none

  • featured = Featured first

  • gallery = Normal display

  • plus = Enlarged display

eBay featured first

days_7
lifetime

Featured first.

  • days_7 = 7 days

  • lifetime = Permanent

eBay transfer RRP

Y
N
D

eBay, transfer RRP.

  • Y = Transfer RRP to eBay

  • N = Do not transfer

  • D = Do not transfer, but display as discounted

eBay hit counter

1
3
4
0

eBay, displays the number of page views for the listing.

  • 1 = Regular style

  • 3 = Invisible

  • 4 = Retro computer style

  • 0 = Deactivated

eBay condition ID

Numeric

The eBay item condition.

eBay description of the condition

Alphanumeric

The description of the item condition for eBay.

eBay best offer

Y
N

Indicates whether the best offer is activated for eBay.

  • Y = Activate eBay best offer.

  • N = Deactivate eBay best offer.

eBay reject minimum price

Numeric

eBay price that should be rejected automatically.

eBay accept minimum price

Numeric

eBay price that should be accepted automatically.

eBay Plus

Global
No
Yes

Indicates whether eBay Plus is activated.

  • Global = Use basic settings

  • No = no eBay Plus

  • Yes = Activate eBay Plus

eBay Click & Collect

YES
NO
GLOBAL

Indicates whether Click & Collect is used.

  • YES = YES

  • NO = NO

  • GLOBAL = Use the basic setting

Use eBay image service

Y
N

Indicates whether the eBay image service is used.

  • Y = The eBay image service is used

  • N = The eBay image service is not used

Display on Hood store homepage

P
Y
N

Show on Hood shop start page.

  • P = Visible with an image on the seller’s homepage

  • Y = Visible with text

  • N = Not visible

Hood shipping discount

Numeric

Hood delivery time when in stock from (in days)

Numeric

The minimum delivery time for Hood in days when stock is available.

Hood delivery time when in stock from (in days)

Numeric

The maximum delivery time for Hood in days when stock is available.

Hood delivery time when out of stock from (in days)

Numeric

The minimum delivery time for Hood in days when out of stock.

Hood delivery time when out of stock to (in days)

Numeric

The maximum delivery time for Hood in days when out of stock.

ricardo warranty ID

0
1

The ricardo warranty ID.

  • 0 = According to the description

  • 1 = No warranty

ricardo delivery conditions

1
2
3
4
5
6
8
9
10
11
12
0

The ricardo shipping ID.

  • 1 = Letters, A Mail (Swiss Post)

  • 2 = Letters, B Mail (Swiss Post)

  • 3 = Packages, A Mail (Swiss Post)

  • 4 = Packages, B Mail (Swiss Post)

  • 5 = Registered mail

  • 6 = Cash on delivery (only possible for companies)

  • 8 = Pick-up by buyer

  • 9 = Delivery by seller

  • 10 = Shipping from a foreign country

  • 11 = Freight forwarder

  • 12 = Courier

  • 0 = According to the description

ricardo availability ID

0
1
2
3
4
5

The ricardo item availability ID.

  • 0 = Immediately deliverable

  • 1 = Within 5 business days

  • 2 = Within 10 business days

  • 3 = Within 15 business days

  • 4 = Within 30 business days

  • 5 = Within 60 business days

ricardo payment condition ID

0
1
5

The ricardo payment condition ID.

  • 0 = As described

  • 1 = Payment upon pickup

  • 5 = In advance

ricardo increment

Numeric

Amount by which customers must outbid the current offer.

ricardo condition ID

0
1
3
4
5

The ricardo item condition.

  • 0 = New (according to the description)

  • 1 = New and in original packaging

  • 3 = Used

  • 4 = Antique

  • 5 = Defective

ricardo number of reactivations

Numeric

Indicates how often items should be reactivated.

ricardo individual shipping costs for each item

Y
N

Indicates whether shipping costs should be calculated for each item that was sold.

  • Y = Yes

  • N = No

ricardo package size

Numeric

ricardo use secondary language

Y
N

Indicates whether an alternative language should be used.

  • Y = Yes

  • N = No

ricardo template ID

Numeric

The ricardo template ID.

ricardo reactivate until sold out

Y
N

Indicates whether items should be reactivated until they are sold out.

  • Y = Yes

  • N = No

To top