Spezifische Artikeldaten für eBay

Navigation:  WebService Calls > Options for Growth > fetchItems > Plattformspezifische Daten >

Spezifische Artikeldaten für eBay

Previous pageReturn to chapter overviewNext page

Texte ein-/ausblenden

Beschreibung

Die XML-Struktur welche die spezifischen Artikeldaten für die Verkaufsplattform eBay enthält muss als Kindelement in das Element specific_item_data in den Response-Daten von fetchItems eingebettet sein. Sie besitzt folgende Struktur:

Beispiel Response

Code

Feldliste Response

Name

Beschreibung        

Anz.

Typ

sonstiges

ebay_item_data

Wrapper-Element, das die spezifischen Artikeldaten für die Verkaufsplattform eBay enthält.

0..N

Element


site

Bezeichner der länderspezifischen eBay-Seite

1

string

Feste Werte

 

ebay_category_id_1

ID der ersten zugeordneten eBay-Kategorie

1

integer


ebay_category_id_2

ID der zweiten zugeordneten eBay-Kategorie

1

integer


item_condition

Bezeichner für den Artikelzustand gemäß eBay-Spezifikation.

1

string

Feste Werte

 

item_condition_description

Genauere Bezeichnung des Artikelzustands. Diese kann bei allen item_conditions außer "NEW" gepflegt sein.

0..1

string


attributes

Attribute-Element, das die seitenspezifischen Daten der eBay-Attribute zusammenfasst.

0..1

Element


attribute

Attribute-Element, das die seitenspezifischen Daten der eBay-Attribute nach ihren Schlüsseln zusammenfasst.

0..N

Element


attribute_key

Der Name, den das Attribute hat

1

string


attribute_value

Der Wert, den das Attribute hat

1

string


item_compatibilities

Wrapper-Element, das Informationen über

die Kompatibiltitäten des Artikels zusammenfasst.

0..1

Element


compatibility

Wrapper-Element, das die Daten einer Kompatibilität zusammenfasst.

1

Element


compatibility_notes

Kommentar zur Kompatibilität

0..1

string


compatibility_properties

Wrapper-Element, das Schlüssel-/Wert-Paare, mit Informationen zur Kompatibilität enthält.

0..1

Element


property

Wrapper-Element, das einen Schlüssel und einen Wert mit Informationen zur Kompatibilität enthält.

0..N

Element


key

Bezeichner der Eigenschaft

1

string

Feste Werte:

„HSN“ |

„TSN“ |

„KType“ |

„ePID“

value

Wert der Eigenschaft

1

string


account_specific_data

Wrapper-Element, das die Account-spezifischen Daten des eBay-Artikels nach ihren Accounts zusammenfasst.

0..1

Element


account_specific

Wrapper-Element, das die Account-spezifischen Daten eines Accounts zusammenfasst.

0..N

Element


account

Wrapper-Element, das Informationen über den Account enthält.

1

Element


account_id

Element von account. ID des Accounts.

1

integer


account_identifier

Element von account. Bezeichner des Accounts

1

String

Länge:

0 – 50 Zeichen

title

Titel des Artikels

0..1

string

Länge:

0 – 55 Zeichen

sub_title

Untertitel des Artikels

0..1

string

Länge:

0 – 55 Zeichen

shop_category_id_1

ID der ersten zugeordneten Shopkategorie (fetchAccountCategories) des Artikels

0..1

integer


shop_category_id_2

ID der zweiten zugeordneten Shopkategorie (fetchAccountCategories) des Artikels

0..1

integer


minimal_bid

Startgebot des Artikels

0..1

decimal


minimal_price

Legt einen Mindestpreis fest unterhalb von dem der Artikel nicht verkauft wird. Achtung: Dies ist nur für manche eBay-Sites und Kategorien gültig!

0..1

decimal


buy_it_now_price

Preis der Sofort-Kaufen-Option

0..1

decimal


discount_price_info

Wrapper-Element, das die Vergleichspreis/UVP-Option zusammenfasst

0..1

Element


treatment

Gibt die Art der discount_price_info an

1

string

Fester Wert: "STP" = Streichpreis

style

Gibt das Aussehen des Streichpreises an

1

integer


original_price

Preis der discount_price_info


decimal

Feste Werte

best_offer_accept_threshold

Preisschranke ab der ein Preisvorschlag des Kunden bei entsprechend aktivierter Vorschlags-Option automatisch akzeptiert wird.

0..1

decimal


best_offer_reject_threshold

Preisschranke bis zu der ein Preisvorschlag des Kunden bei entsprechend aktivierter Vorschlags-Option automatisch abgelehnt wird.

0..1

decimal


auction_template_id

ID des Templates das für Auktionen mit diesem Artikel verwendet wird.

0..1

integer


buy_it_now_template_id

ID des Templates das für Festpreisangebote dieses Artikels verwendet wird.

0..1

integer


immediate_pay

Gibt an, ob die Option "Sofortige Bezahlung mit PayPal" aktiviert ist.

Wird die Option aktiviert, wird automatisch die Zahlungsart PayPal gesetzt.

0..1

boolean


available_payment_methods

Wrapper-Element, das Zahlungsarten unter eBay für diese Artikel, Site und Accountkombination zusammenfasst.

1

Element


payment_method

Bezeichner der Zahlungsart gemäß eBay-Spezifikation.

0..N

string

Feste Werte

 

payment_info

Informationen zur Zahlungsart

0..1

string


pay_pal_email_address

eMail-Adresse für die Bezahlung per PayPal

0..1

string

Länge:

0 – 255 Zeichen

buy_it_now_enabled

Gibt an ob die Option „Sofort kaufen“ für diese Artikel, Site und Accountkombination aktiviert ist.

0..1

boolean


best_offer_enabled

Gibt an ob die Option „Preis vorschlagen“ für diese Artikel, Site und Accountkombination aktiviert ist.

0..1

boolean


ebay_images

Wrapper-Element, das Bilder für die Verkaufsplattform eBay zusammenfasst.

0..1

Element


ebay_image

Wrapper-Element, das die Informationen eines Bildes zusammenfasst.

0..N

Element


image_id

ID des Bildes

1

integer


image_module_type_id

ID des Bildbausteintyps

1

integer


is_gallery_image

Gibt an ob dieses Bild als Galleriebild verwendet wird.

0..1

boolean


active_status_number

Legt fest ob das Bild aktiv ist und gibt gleichzeitig die Bildreihenfolge bei mehreren Bildern an.

1

integer

0 = deaktiviert

>0 = aktiviert + Reihenfolge

shipping_options

Wrapper-Element, das die Versandoptionen für den Artikel zusammenfasst.

1

Element


no_shipping

Ist diese Option aktiv, so steht nur "Selbstabholung" zur Verfügung.

0..1

boolean


national_shipping_options

Wrapper-Elment, das die nationalen Versandkosten zusammenfasst.

0..1

Element


national_shipping_option

Wrapper-Element, das eine von drei Versandkosten zusammenfasst.

0..4

Element


shipping_service

Versandservice der Versandoption

0..1

string


shipping_serivce_cost

Versandkosten der Versandoption

0..1

decimal


shipping_service_cost_

additional

Zusätzliche Versandkosten der Versandoption

0..1

decimal


international_shipping_

options

Wrapper-Element, das die internationalen Versandkosten zusammenfasst.

0..1

Element


international_shipping_

option

Wrapper-Element, das eine von drei Versandkosten zusammenfasst.

0..5

Element


shipping_service

Versandservice der Versandoption

0..1

string


shipping_serivce_cost

Versandkosten der Versandoption

0..1

decimal


shipping_service_cost_

additional

Zusätzliche Versandkosten der Versandoption

0..1

decimal


ship_to_locations

Wrapper-Element, das die Lieferorte für die Versandkosten definiert.

0..1

Element


location

Zielort

0..N

string

Feste Werte

handling_time

Bearbeitungszeit

0..1

integer


ship_to_locations

Wrapper-Element, das die zusätzlichen Lieferorte zusammenfasst.

0..1

Element


location

Zusätzliche Lieferorte

0..N

string

Werte nach "ISO 3166 ALPHA-2"

Z. B. "DE"

exclude_locations

Aktiviert die Option "Lieferorte ausschließen"

0..1

boolean


excluded_locations

Wrapper-Element, das die ausgeschlossenen Lieferorte zusammenfasst.

0..1

Element


location

Ausgeschlossener Lieferort

0..N

string

Werte nach "ISO 3166 ALPHA-2"

Z. B. "DE"

und "Packstation"

item_location_country_code_iso

Land des Artikelstandorts

0..1

string


item_location_postal_code

Postleitzahl des Artikelstandorts

0..1

string


item_location_city

Ort des Artikelstandorts

0..1

string


shipping_discount_profile_id_national

Versandrabatt-ID des nationalen Versands

0..1

integer


shipping_discount_profile_

id_international

Versandrabatt-ID des internationalen Versands

0..1

integer


rate_table_national

Setzt die Versandkostentabelle für den nationalen Versand

0..1

string

Fester Wert:

"Default" = Standart

rate_table_international

Setzt die Versandkostentabelle für den internationalen Versand

0..1

string

Fester Wert:

"Default" = Standart

promotional_shipping_

discount_id_national

Setzt die "Versand zum Sonderpreis" Option für den nationalen Versand

0..1

integer

Fester Wert:

"1" = aktiv

promotional_shipping_

discount_id_international

Setzt die "Versand zum Sonderpreis" Option für den internationalen Versand

0..1

integer

Fester Wert:

"1" = aktiv

listing_settings

Wrapper-Element welches die Einstellmengen für diesen Artikel, die Plattform und den Account festlegt.

0..1

Element


pickup_in_store_eligible

Aktiviert "im Store abholbar"

0..1

boolean


pickup_in_store_fulfillment_time

Zeitspannen nach ISO 8601 ab wann Ware im Store abgeholt werden kann

0..1

string


ship_to_store_fulfillment_time

Zeitspannen nach ISO 8601 bis wann Ware im Store eintrifft

0..1

string


returns_shippingcost_paid_by_option

Wrapper-Element, das die Informationen zur Zahlung der Rücksendung beinhaltet.

0..1

Element


site_id

ID der zugehörigen eBay-Site.

1

integer

Feste Werte.

api_value

Wert der an die eBay-API übergeben wird.

1

string


description

Eine Beschreibung der Option.

1

string


expired

Gibt an ob die Option bei eBay noch gültig ist.

1

boolean

Hinweis

returns_within_option

Wrapper-Element, das die Informationen zur Rücknahmefrist beinhaltet.

0..1

Element


site_id

ID der zugehörigen eBay-Site.

1

integer

Feste Werte.

api_value

Wert der an die eBay-API übergeben wird.

1

string


description

Eine Beschreibung der Option.

1

string


expired

Gibt an ob die Option bei eBay noch gültig ist.

1

boolean

Hinweis

returns_accepted_option

Wrapper-Element, das die Informationen zur Rückgabe-Akzeptanz beinhaltet.

0..1

Element


site_id

ID der zugehörigen eBay-Site.

1

integer

Feste Werte.

api_value

Wert der an die eBay-API übergeben wird.

1

string


description

Eine Beschreibung der Option.

1

string


expired

Gibt an ob die Option bei eBay noch gültig ist.

1

boolean

Hinweis

return_policy_description

Beinhaltet Text zur Widerrufsbelehrung und / oder zur Rücknahme von Artikeln.

1

string


branch_stock_availability_id

ID für die Verfügbarkeit in den Filialen

0..1

integer

Feste Werte

ebay_plus

GIbt an ob der Artikel für eBay-Plus verwendet wird. ("inherited" bedeutet das der vererbte Wert aus der Warengruppe verwendet wird.)

1

string

Feste Werte: "allowed" | "denied" | "inherited"

primary

Legt den primären Verkaufskanal fest

1

integer

Feste Werte:

1 = primär. |

0 = nicht primär

placing_count

Legt die initiale Einstellmenge für den Artikel fest

1

integer


refill_count

Legt die Menge fest, ab der wieder aufgefüllt wird.

1

integer


Hinweise

Wenn das Feld best_offer_accept_threshold einen höheren Wert als best_offer_reject_threshold zugewiesen hat entsteht ein Bereich innerhalb dem manuelle entschieden werden muss ob der Preisvorschlag angenommen oder abgelehnt wird.

Das Flag is_gallery_image darf nur für ein einziges Bild pro Artikel, Site und Accountkombination verwendet werden.

Optionen die mit expired = 1 gekennzeichnet sind stellen alte Stammdaten dar. Diese werden aus der Datenbank aus Kompatibilitätsgründen nicht entfernt, sondern nur markiert. Für aktuelle Artikel/Angebote sind diese Optionen nichtmehr zu verwenden.

Wertetabelle(n)

Die aufgeführten Werte gelten für das Feld site.

Wert

Beschreibung

eBay.de

eBay Deutschland

eBay.co.uk

eBay Großbritannien

eBay.com

eBay USA

eBay.fr

eBay Frankreich

eBay.it

eBay Italien

eBay.at

eBay Österreich

eBay.es

eBay Spanien

eBay.nl

eBay Niederlande

eBay.pl

eBay Polen

eBay.ie

eBay Irland

eBay.ch

eBay Schweiz

benl.eBay.be

eBay Belgien (niederländische Sprache)

befr.eBay.be

eBay Belgien (französische Sprache)

eBay.ca

eBay Kanada (englische Sprache)

cafr.eBay.ca

eBay Kanada (französische Sprache)

eBay.com.au

eBay Australien

eBay Motors

Motors

Aufgeführte Werte gelten für das Feld item_condition. Dabei ist zu beachten, dass nicht jeder Artikelzustand für jede Kategorie verfügbar ist. Nähere Details dazu können der eBay-Hilfe entnommen werden.

Wert

Beschreibung

NEW

Neu

NEW_OTHER

Neu mit Einschränkungen. (z.B. Schuhe ohne Schachtel)

NEW_DEFECTS

Neu mit Fehlern

MANUFACTURER_REFURBISHED

Vom Hersteller wiederaufbereitet.

SELLER_REFURBISHED

Vom Verkäufer wiederaufbereitet.

USED

Gebraucht.

LIKE_NEW

Gebraucht. Wie neu.

VERY_GOOD

Gebraucht. Sehr gut erhalten.

GOOD

Gebraucht. Gut erhalten.

ACCEPTABLE

Gebraucht. Akzeptabel.

NOT_WORKING

Defekt

Durchgestrichene Einträge gelten als veraltet und werden von eBay nicht mehr akzeptiert.

Aufgeführte Werte gelten für das Feld payment_method. Dabei ist zu beachten, dass nicht jede Zahlungsart für jede Site verfügbar ist. Nähere Details dazu können der eBay-Hilfe entnommen werden.

Wert

Beschreibung

CashOnPickup

Barzahlung bei Abholung

CCAccepted

Kreditkarte

COD

Nachnahme

MoneyXferAcceptedInCheckout

Überweisung

PaymentSeeDescription

Sonstige / Siehe Artikelbeschreibung

PayPal

PayPal

MOCC

Postanweisung / Bankscheck

PersonalCheck

Barscheck

AmEx

American Express Kreditkarte

Discover

Discover Kreditkarte

IntegratedMerchantCreditCard

Kundenkarte

VisaMC

Visa oder Mastercard Kreditkarte

MoneyXferAccepted

Banküberweisung

Aufgeführte Werte gelten für das Feld style des Wrappers discount_price_info

Wert

Beschreibung

10

UVP

20

alter Verkaufspreis (eBay)

30

alter Verkaufspreis (andere Plattform)

Aufgeführte Werte gelten für das Feld: location

Wert

Beschreibung

Americas

Nord- und Südamerika

Asia

Asien

AT

Österreich

AU

Australien

BE

Belgien

BR

Brasilien

CA

Kanada

CH

Schweiz

CN

Volksrepublik China

DE

Deutschland

ES

Spanien

Europe

Europa

EuropeanUnion

Europäische Union

FR

Frankreich

GB

Großbritannien

GR

Griechenland

HK

Honkong

IE

Irland

IT

Italien

JP

Japan

MX

Mexiko

NL

Niederlande

None

Kein Land

NZ

Neuseeland

PL

Polen

RU

Russland

TW

Republik China (Taiwan)

US

Vereinigte Staaten von Amerika

Worldwide

Weltweit

Aufgeführte Werte gelten für das Feld branch_stock_availability_id.

ID

API-Value

Beschreibung

10

IN_STOCK

Filiale hat Bestand

20

OUT_OF_STOCK

Filiale hat keinen Bestand

30

SHIP_TO_STORE

Filiale hat keinen Bestand, kann aber beliefert werden

40

ALWAYS_SHIP_TO_STORE

Filiale hat keinen Bestand, kann aber beliefert werden, auch wenn der Artikel aktuell keinen Bestand hat

50

ONLY_SHIP_TO_STORE_IF_SHIP_TO_HOME_STOCK

Filiale hat keinen Bestand, kann aber beliefert werden, sobald der Artikel im Zentrallager ist

60

SHIP_TO_STORE_FROM_SPECIFIC_WAREHOUSE

Filiale hat keinen Bestand, kann aber von einem bestimmten Lager beliefert werden

Die aufgeführten Werte gelten für das Feld site_id.

ID

Bezeichnung

1

eBay.de

2

eBay.co.uk

3

eBay.com

4

eBay.fr

5

eBay.it

6

eBay.at

7

eBay.es

8

eBay.nl

9

eBay.pl

10

eBay.ie

11

eBay.ch

12

benl.eBay.be

13

cafr.eBay.ca

14

befr.eBay.be

15

eBay.ca

16

eBay.com.au

17

Motors

Änderungsübersicht

Version

Änderungsbeschreibung

3.2.9.75

Redaktionelle Überarbeitung

3.2.9.100

Erweiterung um shipping_options

3.3.2.90

Erweiterung der eBay spezifischen Daten um Streichpreise

3.3.2.90

Erweiterung der Versandoptionen um Versandkostentabelle

3.3.45.41

Erweiterung der eBay spezifischen Daten um Fahrzeug-Kompatibilitäten

3.4.16.1

Erweiterung der eBay spezifischen Daten um item_condition_description

3.4.25.1

Kardinalität von nationalen Versandoptionen von 3 auf 4 und internationalen Versandoptionen von 3 auf 5 geändert.

3.4.25.1

Erweiterung der eBay spezifischen Daten um immediate_pay

3.4.35.1

Erweiterung der eBay spezifischen Daten um Pickup- und Versandzeitinformationen

3.4.48.1

Erweiterung der eBay spezifischen Daten um Rücknahmebedingungen.

3.4.51.1

Erweiterung der eBay spezifischen Daten um branch_stock_availability_id und Wertetabelle

3.5.37

Erweiterung des Calls um eBay-Plus Flag.

4.8.12

Der Artikelzustand (item_condition) LIKE_NEW gilt als veraltet und wurde dementsprechend markiert.