Spezifische Artikeldaten für eBay

Navigation:  WebService Calls > Options for Growth > updateItems > 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 Request-Daten von updateItems eingebettet sein.

Beispiel Request

Code

Feldliste Request

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

0..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 werden.

0..1

string


product_id

ePID zur Auswahl eines Produkts im eBay Produktkatalog

0..1

string


attributes

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

0..1

Element


attributes_count

Gibt an wie viel Attribute im Request stehen.

1

integer

Bei „0“ werden die Attribute gelöscht.

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..N

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_id

ID des Accounts

0..1

integer


mandator_id

ID des Mandanten. Wird nur benötigt wenn account_identifier verwendet wird.

0..1

integer


account_identifier

Bezeichner des Accounts

0..1

string

Länge:

0 – 50 Zeichen

title

Titel des Artikels

0..1

string

Länge:

0 – 80 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

Feste Werte

original_price

Preis der discount_price_info

1

decimal


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_module_type_id

ID des Bildbausteintyps

1

integer


is_gallery_image

Gibt an ob dieses Bild als Galleriebild verwendet wird.

Veraltetes Feld: Hat keine Auswirkung mehr auf das verwendete Galleriebild.

Grund: Wird durch eBay nicht mehr unterstützt.

Alternative: Erstes Bild der Bildreihenfolge (active_status_number) wird als Galleriebild herangezogen.

0..1

boolean


active_status_number

Legt fest ob das Bild aktiv ist und gibt gleichzeitig die Bildreihenfolge bei mehreren Bildern an. Das erste Bild der Bildreihenfolge wird als Galleriebild herangezogen. Doppelte Werte oder Lücken in der Reihenfolge werden durch eine Sortierung behoben.

1

integer

0 = deaktiviert

>0 = aktiviert + Reihenfolge

shipping_options

Wrapper-Element, das die Versandoptionen zusammenfast.

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_service_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_service_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

string


shipping_discount_profile_

id_international

Versandrabatt-ID des internationalen Versands

0..1

string


rate_table_national

Setzt die Versandkostentabelle für den nationalen Versand

0..1

string

Fester Wert:

"Default" = Standard

rate_table_international

Setzt die Versandkostentabelle für den internationalen Versand

0..1

string

Fester Wert:

"Default" = Standard

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

payment_profile_id

Dient zum Setzen der Zahlungsbedingungen. Die Rahmenbedingungen müssen vorab für den eBay-Account gepflegt werden.

0..1

long


shipping_profile_id

Dient zum Setzen der Versandbedingungen. Die Rahmenbedingungen müssen vorab für den eBay-Account gepflegt werden.

0..1

long


return_policy_profile_id

Dient zum Setzen der Rücknahmebedingungen. Die Rahmenbedingungen müssen vorab für den eBay-Account gepflegt werden.

0..1

long


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 Filialabholung

0..1

boolean


pickup_in_store_fulfillment_time

Zeitspannen nach ISO 8601 ab wann Ware in der Filiale abgeholt werden kann.

0..1

string


ship_to_store_fulfillment_time

Zeitspannen nach ISO 8601 bis wann Ware in der Filiale eintrifft.

0..1

string


returns_shippingcost_paid_by_option

Legt fest wer die Kosten für die Rücksendung übernimmt.

0..1

string


returns_within_option

Legt die Dauer fest, wie lange ein Artikel zurückgegeben werden kann.

0..1

string

Feste Werte: "Months_1" | "Days_14"

returns_accepted_option

Legt fest ob Rückgaben akzeptiert werden.

0..1

string


returns_policy_description

Beinhaltet weitere Angaben zur Rücknahme und/oder den Widerrufsbelehrungen.

0..1

string


branch_stock_availability_id

ID für die Verfügbarkeit in den Filialen

0..1

integer

Feste Werte

delete

Attribut von branch_stock_availability_id zum Löschen der Information

0..1

boolean

Standardwert: false

ebay_plus

Setzt das eBay-Plus-Flag. ("inherited" sorgt dafür das der bereits bei eBay hinterlegte Wert weiterhin verwendet wird.)



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

primary

Legt den primären Verkaufskanal fest

1

Element

Feste Werte:

1 = primär. |

0 = nicht primär

placing_count

Legt die initiale Einstellmenge für den Artikel fest

1

integer

Hinweise

refill_count

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

1

integer


transfer_to_offer

Ist die Option aktiv, so wird die angegebene Einstellmenge an laufende Angebote übertragen.

0..1

boolean


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.

0..N

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“

value

Wert der Eigenschaft

1

string


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

Hinweise

Die Felder account_id und account_identifier dürfen nicht gleichzeitig genutzt werden.

Wenn das Feld account_identifier genutzt wird muss gleichzeitig vorher das Feld mandator_id genutzt werden.

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.

Eine Einstellmenge (placing_count) von -1 deaktiviert den interaktiven Angebotsbestandsabgleich für diesen Artikel und die daraus resultierenden Angebote.

Ä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.6.3205

Erweiterung um ePID

3.4.16.1

is_gallery_image als "veraltet" markiert

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.25.1

Erweiterung der eBay spezifischen Daten um eBay-Rahmenbedingungen

3.4.35.1

Erweiterung der eBay spezifischen Daten um Pickup- und Versandzeitinformationen

3.4.48.1

Erweiterung der eBay spezifischen Daten um die Rücknahmebedingungen.

3.4.51.1

Erweiterung des Calls um das eBay-spezifische Feld branch_stock_availability_id.

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.